Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/_sidebar.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**
Expand Down
Binary file added docs/assets/images/invite_vendor_v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
161 changes: 61 additions & 100 deletions docs/get-invited-and-onboard-to-techpass.md
Original file line number Diff line number Diff line change
@@ -1,139 +1,100 @@
# Get invited and onboard to TechPass
# Get invited and onboard to TechPass (vendors and offshore users)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if Vendors and offshore users is appropriate cuz:

  • offshore users are also vendors
  • some of the public officers that belongs to particular email domain (see screenshot) should be onboarded to this flow as well, so it's not exclusive to vendors
    Screenshot 2024-12-18 at 8 45 02 AM
  • some of the vendors who are using 'gov.sg' email should be not be onboarded via this flow, but should be using the other flow (same as PO)


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. <br>- For more information, see [**TechBiz documentation**](https://docs.developer.tech.gov.sg/docs/techbiz-documentation/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this no longer applicable?

?> For offshore users, SEED provisioning is **mandatory** unless you belong to an offshore development centre (ODC).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SEED is required for all offshore users, regardless whether they are ODC or not. but is it abit weird that we mention this here or we put it below in Step 1: Request for TechPass account where we mention they can request for TechPass account and SEED provisioning


---

## 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).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I find it weird that it's a prerequisite that user have to first receive the onboarding email, but down below we ask them to Request for a TechPass account first.


- 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.<br>- If you do not see the TechPass onboarding email in your inbox, please check your Junk Email, Deleted Items or Archive folder.<br>- 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SEED is optional for onshore users

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mobile phone and project name is not needed.
Actually I think can retain this Contact your project manager or the reporting officer to request for the provisioning of TechPass and SEED, which is optional. (seed is optional for onshore users, mandatory for offshore)

?> For offshore users not in an ODC, provide:
- Offshore reporting officer’s name and email
- Offshore company address
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These info are filled in by the user themselves during registration


!> 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**.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think can move the Failure to register within **5 days** invalidates the link, and you must request a new invitation. to here


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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

username is not required, it's auto-generated

- First name and last name
- Mobile number
- Department
- *(Offshore only)* Reporting officer name, email, and company address
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For offshore users, we classify into odc & non-odc users, only offshore non-odc users need to provide this info. ODC stands for 'Offshore Development Centre'


---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we still need the further instruction what happens after they have successfully registered (the one u removed from line 33 onwards). i.e. They'll receive email containing their username, password etc


## 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/)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should be stg url

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

where is this described at?

- 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:<br>- It supports **Number Matching** to protect you from MFA Fatigue attacks and increases the security of your account.<br>- 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.
Copy link
Contributor

@yqyeoh yqyeoh Dec 18, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why are these 2 notes applicable to offshore users only?


?>- Upon accepting the terms and conditions, you are successfully onboarded to TechPass.<br>- If you had requested for SEED to be provisioned, you may proceed to onboard your Internet Device to SEED.<br>- 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe can put a link



30 changes: 20 additions & 10 deletions docs/invite-user.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.