diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 0deacb8..609e20c 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -4,7 +4,7 @@ - **Getting started** - [Onboard to TechPass](onboard-to-techpass.md) - [Sign up and onboard to TechPass](sign-up-and-onboard-to-techpass) - - [Get invited and onboard to TechPass](get-invited-and-onboard-to-techpass) + - [Get invited and onboard to TechPass (vendors and offshore)](get-invited-and-onboard-to-techpass) - **Verify TechPass login** - [Log in with TechPass](log-in-with-techpass) - **TechPass Portal** diff --git a/docs/assets/images/invite_vendor_v2.gif b/docs/assets/images/invite_vendor_v2.gif new file mode 100644 index 0000000..8ef8a47 Binary files /dev/null and b/docs/assets/images/invite_vendor_v2.gif differ diff --git a/docs/get-invited-and-onboard-to-techpass.md b/docs/get-invited-and-onboard-to-techpass.md index 941d897..2630687 100644 --- a/docs/get-invited-and-onboard-to-techpass.md +++ b/docs/get-invited-and-onboard-to-techpass.md @@ -1,139 +1,100 @@ -# Get invited and onboard to TechPass +# Get invited and onboard to TechPass (vendors and offshore users) -This article guides you how to request for a TechPass account and onboard to it. +This guide explains how vendors and offshore users can request a TechPass account and complete onboarding. -?>- Alternatively, public officers with a non-SE GSIB device can access the [**TechBiz Portal**](https://portal.techbiz.suite.gov.sg) to request for TechPass and SEED provisioning, which is optional.
- For more information, see [**TechBiz documentation**](https://docs.developer.tech.gov.sg/docs/techbiz-documentation/). +?> For offshore users, SEED provisioning is **mandatory** unless you belong to an offshore development centre (ODC). +--- -## Audience +## Audience +Vendors and offshore users who require a TechPass account. -Users who require a TechPass account but do not have a WOG account or a non-SE GSIB device. +--- -## Prerequisites +## Prerequisites -You need the following to get invited to TechPass and complete the onboarding: +Ensure you have: +- A **standard organisational email address** (not LiteMail). +- Received the **TechPass onboarding email** (valid for 30 days). -- Check the flowchart on the [Onboard to TechPass](onboard-to-techpass) page to see if you're eligible to sign up via the Portal. If you can't sign up for TechPass account via TechPass Portal, you need to request to get invited. -- Your organisational email address which has a standard mailbox and not a LiteMail. -- Before you onboard, ensure you have received the TechPass onboarding email and is still valid. +?> Failure to register within **5 days** invalidates the link, and you must request a new invitation. -?>- TechPass does not support email accounts which does not have an inbox. For example, LiteMail accounts. If you use such an email account, upgrade it to a standard mailbox before requesting for TechPass.
- If you do not see the TechPass onboarding email in your inbox, please check your Junk Email, Deleted Items or Archive folder.
- The onboarding email is valid for 30 days. If you do not onboard to TechPass within this 30 days, we will terminate your TechPass account, and you need to sign up again. +--- +## Step 1: Request a TechPass account -## Step 1: Request for TechPass account +1. Contact your **project manager** or **reporting officer** to request TechPass and SEED provisioning. +2. Provide the following details: + - Organisational email address + - Mobile phone number + - Project name -1. Contact your project manager or the reporting officer to request for the provisioning of TechPass and SEED, which is optional. +?> For offshore users not in an ODC, provide: +- Offshore reporting officer’s name and email +- Offshore company address - !> To access services such as SGTS and GCC 2.0 resources through an Internet Device, you need to onboard that device to SEED. +3. If the invitation is successful, you will receive a **registration email**. -2. Provide the required details in this request such as your organisational email address, mobile phone number and project name. +--- - Project manager or the reporting officer contacts the sponsoring agency or the tenant admin to invite you to TechPass. +## Step 2: Complete the registration - > **Additional information**: - > - > **If your request for TechPass provisioning - is successful**: - > - >- A TechPass account is provisioned for you and is in pending state. - >- We'll send the TechPass onboarding email with your TechPass account or log in ID. - >- You need to activate the account within 30 days. - >- Your TechPass log in ID's domain is ```techpass.gov.sg```. - >- We'll send the initial password by SMS to the registered mobile number. - > - > **If your request for SEED provisioning is successful**: - > - >- We'll send the SEED onboarding email immediately. - >- This email is valid only for 30 days. - >- Ensure that you have activated your TechPass account before proceeding to onboard your Internet Device to SEED. - >- If your SEED onboarding email has expired, create a [service request with TechPass](https://go.gov.sg/seed-techpass-support) to receive the SEED onboarding invitation email again. For more information, see [SEED FAQs](https://docs.developer.tech.gov.sg/docs/security-suite-for-engineering-endpoint-devices/faqs/seed-faq-general). +1. Open the **registration link** in your email. +2. Fill in the form with the following details: + - Username + - First name and last name + - Mobile number + - Department + - *(Offshore only)* Reporting officer name, email, and company address +--- +## Step 3: Sign in using your initial password -## Step 2: Sign in using your initial password - -1. Go to the required Docs portal environment and click **Login**. - - - [Docs portal - staging environment](https://stg.docs.developer.tech.gov.sg/) - - [Docs portal - production environment](https://docs.developer.tech.gov.sg/) -2. Enter your TechPass username and click **Next**. - +1. Go to the required Docs portal environment and click **Login**: + - [Docs portal](https://docs.developer.tech.gov.sg/) +2. Enter your TechPass username and click **Next**. ![vendor-sign-in-1](assets/support/Vendor_email.png) -3. Enter the initial password and click **Sign in**. - +3. Enter the initial password and click **Sign in**. ![vendor-initial-pwd](assets/support/vendor-initial-password.png) -4. Click **Next** to configure MFA for your TechPass account. - +4. Click **Next** to configure MFA. ![proceed-to-mfa-setup](assets/support/more-info-required.png ':size=500') +--- +## Step 4: Configure multi-factor authentication (MFA) +Follow the same MFA setup process as described for public officers. + - Install Microsoft Authenticator + - Scan the QR code + - Confirm number matching -## Step 3: Configure Multi-Factor Authentication (MFA) for TechPass account - -?> This section guides you to configure Microsoft Authenticator as your MFA. We recommend Microsoft Authenticator for the following reasons:
- It supports **Number Matching** to protect you from MFA Fatigue attacks and increases the security of your account.
- Microsoft constantly improves its MFA security policies to protect its users. - - - 1. Install Microsoft Authenticator on your mobile phone. - - 2. Click **Next** on your computer. - - ![vendor-mfa-1](assets/support/vendor-mfa-1-new.png) - - 3. On your mobile phone, open Microsoft **Authenticator** and select **+ Add account** > **Work or School account**. - 4. Select **Scan a QR code**. - 5. Go back to your computer and click **Next**. - - ![vendor-mfa-2](assets/support/vendor-mfa-2-new.png) - - 6. Scan the QR code on your computer screen and click **Next**. Your TechPass account gets activated and linked to the Authenticator app. - - ![vendor-scan-qr-code](assets/support/vendor-mfa-3-new.png) - - A number is shown on your browser. - - ![number-mfa](assets/images/onboarding/po-non-se/number-mfa.png) - - 7. On the Authenticator app, enter the number shown, and select **Yes** to authenticate your sign-in. - - ![vendor-confirmed-mfa](assets/support/vendor-mfa-5-new.png) - - 8. On your computer, click **Next**. - 9. Choose the country code, enter your phone number and click **Next**. - - ![vendor-mfa-6](assets/support/vendor-mfa-6-new.png) - - 10. Enter the six-digit code sent to your mobile phone through text message and click **Next**. - - ![vendor-mfa-7](assets/support/vendor-mfa-7-new.png) - - 11. Your mobile phone is registered successfully to this account. Click **Next**. - - ![vendor-mfa-8](assets/support/vendor-mfa-8-new.png) - - 12. When you see a success message, click **Done**. Now you are prompted to reset your initial password. +--- - ![vendor-mfa-9](assets/support/vendor-mfa-9-new.png) +## Step 5: Reset your initial password -## Step 4: Reset your initial password +1. Enter your **initial password**, create a **new password**, and re-enter it to confirm. + ![vendor-mfa-9](assets/support/vendor-update-initial-password.png) - 1. Enter your **initial password**, **new password** and retype the new password to confirm. +--- - 2. Click **Sign in** to proceed to accept the Terms of Use. +## Step 6: Accept the terms and conditions - ![vendor-mfa-9](assets/support/vendor-update-initial-password.png) +1. Read and accept the **privacy policy** and **terms of use**. +2. If SEED is provisioned, read and accept the **MDM AUP policy**. +--- -## Step 5: Accept the terms and conditions +## Notes for offshore users -1. Read the **Privacy Policy** and click **Accept**. -2. Read the **Terms of Use** and click **Accept**. You have successfully onboarded to TechPass. -3. If you had requested for SEED provisioning and is successfully provisioned to you, read the **MDM AUP Policy** and click **Accept**. +- Activate your TechPass account within **30 days** of receiving the onboarding email. +- If your SEED onboarding email expires, submit a [service request](https://go.gov.sg/seed-techpass-support) to receive a new one. - ?>- Upon accepting the terms and conditions, you are successfully onboarded to TechPass.
- If you had requested for SEED to be provisioned, you may proceed to onboard your Internet Device to SEED.
- Before you onboard your Internet Device to SEED, see[Prerequisites for onboarding your device to SEED](https://docs.developer.tech.gov.sg/docs/security-suite-for-engineering-endpoint-devices/#/prerequisites-for-onboarding). +--- -### Next step +## Next step -- [Verify TechPass login](log-in-with-techpass#log-in-to-a-service-using-your-techpass-account) +- [Verify TechPass login](log-in-with-techpass#log-in-to-a-service-using-your-techpass-account) +- Proceed with SEED onboarding if applicable. diff --git a/docs/invite-user.md b/docs/invite-user.md index ae5e03f..cbabbf9 100644 --- a/docs/invite-user.md +++ b/docs/invite-user.md @@ -28,20 +28,30 @@ You need the following to invite user via the TechPass Portal: 4. Enter the user's email address to display the appropriate onboarding form based on whether the email address is associated with an integrated identity provider (e.g. WoG, MoE) account. 5. For integrated identity provider accounts, provide the Mobile Number and indicate whether SEED is required (only applicable for WoG accounts). + ![invite_user_po](assets/images/invite_user_po.png) 6. For non-integrated identity provider accounts, provide the following information: - - Username - - First Name - - Last Name - - Mobile Number - - Department - - whether SEED is required - -!> **Note**: Email, username and mobile number must be unique. + - *Sponsoring Agency (the agency that the user is attached to) + - *Business Operation (*onshore/offshore*) + - *Offshore Development Centre (ODC) - only applicable to *offshore* users; if the user does not belong to any of the listed ODCs, select *Others* & fill in the Offshore Company Name. + - Whether SEED is required (For *offshore* users, SEED is mandatory and will be automatically indicated as 'Yes') + + **not applicable to Public Officers with non-WOG email domains listed in Q3 of the [onboarding flow chart](/onboard-to-techpass)* -![invite_user_vendor](assets/images/invite_user_vendor.png) + ![invite_vendor_v2](assets/images/invite_vendor_v2.gif) 7. Fill in the required information and click **Submit**. -> The invited user will receive an onboarding invitation email and if it's a non-integrated identity provider account, they will also receive the initial password by SMS. +> **Upon successful invitation:** + > - for integrated identity provider account: + > - the **user account has been created** + > - the invited user will receive an onboarding invitation email + > + > + > - for non-integrated identity provider account: + > - the **user account has not yet been created**; the invited user will receive a registration link via email to complete the [registration](/get-invited-and-onboard-to-techpass?id=step-2-complete-the-registration) + > - the **registration** must be completed within 5 days, after which the link will expire, requiring a new invitation to be sent. + > - the user account will be created upon successful registration + > - you will be notified via email whether the user successfully completes the registration or fails to register within the allotted time. + > - if you need to correct some of the invitation details after it has been sent, you may do so by sending a new invitation (the new invitation will override the old one), provided the user has not completed their registration; if the user has already completed the registration, you will need to raise a [service request](https://go.gov.sg/seed-techpass-support) for us to update the details on your behalf. \ No newline at end of file