> For the complete documentation index, see [llms.txt](https://ztrust.gitbook.io/ztrust-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ztrust.gitbook.io/ztrust-documentation/user-manual-ztrust-v4.1/4.-admin-manual/4.14-ztrust-authenticator/4.14.1-authenticator-setup.md).

# 4.14.1 Authenticator setup

Use this method if you’re registering your device for the first time via your organization's ZTrust SSO portal.

## Prerequisites:

* Initial device setup must be enabled by your organisation.
* The ZTrust Authenticator app must be installed on your mobile.
* Your device must have:
  * Camera access (for scanning QR code)
  * Internet access

### Add account to authenticator

1. Visit your application in the browser.
2. Click on the Register button to register yourself, if you're not registered.<br>

   <figure><img src="https://1778922777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3EUK5AUZv0UVaI5S0CTM%2Fuploads%2FKmuTcakzNnbrcg9jTURO%2Fimage.png?alt=media&amp;token=fafc9746-1824-48e2-a6f5-d7344d43332a" alt=""><figcaption><p>Fig 4.13.1.a: Login page</p></figcaption></figure>
3. Provide the required details to create an account.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdCJwKb3e_06bW6Boc8z5JBy-enQaijFdKb5TTvfn4UJc34dHF9xtOa01QYonT3twBVQgna2J2DC5_gAryQxQ48UUbl655Hyxtw3j13G2PVfuNV6SaYhANCoKVN5pc_Jez2fAfO2g?key=H1CBi0glPVUPOPXlkXmCEQ" alt=""><figcaption><p>Fig 4.13.1.b: Registration page</p></figcaption></figure>
4. After submitting the form successfully, you will be redirected to a page that display a QR Code.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdCJwKb3e_06bW6Boc8z5JBy-enQaijFdKb5TTvfn4UJc34dHF9xtOa01QYonT3twBVQgna2J2DC5_gAryQxQ48UUbl655Hyxtw3j13G2PVfuNV6SaYhANCoKVN5pc_Jez2fAfO2g?key=H1CBi0glPVUPOPXlkXmCEQ" alt=""><figcaption><p>Fig 4.13.1.c: QR Authenticator set up page</p></figcaption></figure>
5. Open the **ZTrust Authenticator** app on your mobile device. If it is not installed, first download and install it. Then tap the **"+" button** to begin setup.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcyFHWd1lMCRb4nTFZr3p3rTGLbvvAi6KUq51elva4JjVhyRZ6_QbcZ82q30nezeA7WlFF5tV_VMSoNDEMTdUPzIdf-WHmy7pUvHv7VnY22txft6JzzGBmtinrWhjV3omXxKZaTYQ?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.d: Initial page of Authenticator</p></figcaption></figure>
6. Scan the QR code displayed on the web browser. then ZTrust authenticator will generate an **onboarding code**.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeF2wlFykZ5eoctYlKSSDJnCMAH1kg7MVCTmMeASpAfPLT2PUzHq2ULTG60wO5hhlua1N2rlxGFDaF2h6nRdRVZMs0EU4EA1k7iOrpQSlJFUSy1ZDWTazYHeXyJIMxujGS8WxHllQ?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.e: Onboarding code page in authenticator</p></figcaption></figure>
7. &#x20;Enter the **onboarding code** into the designated field on the browser page, then click **Submit**.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNo9zUE11W9eAXzsGfCPLJIfVjf5__RIi-6Xcx-11AksjOSxZIKCrgcEws-tSTjepsAgf198qB6iRcQXn_Wu7e72kxD0o7iJKB--6bJXfS5As4-T1-bpKvWThbnu_kl20pVolR6Q?key=H1CBi0glPVUPOPXlkXmCEQ" alt=""><figcaption><p>Fig 4.13.1.f: Enter onboarding code in onboarding code field</p></figcaption></figure>
8. You are now successfully logged into the self-service portal of ZTrust.
9. On your mobile device, tap **OK**, confirm your password in the **ZTrust Authenticator** app, and complete the login process.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdUgegXxQnPtB-Kt6KUEjy-z7M-l7KbhNHWvBsBmgnW8XjvcZB-H7nzusV56wB8dUJ3AtkdWpjE-bmJJzpPNBXYmCAtaGhefGsupzTwp_WYTjuydQy9ruBvh2zE8GUU96-2TWsz4A?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.g: Login page of authenticator</p></figcaption></figure>
10. Your account will be successfully onboarded in the app.<br>

    <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeaOa1U0mN1eD7Fv68dB6EHs8gGik799lCnb_rkkRzwdZI1Lv3fmaxa4Tjg3zT_ptwxvRPt3FWgjqC7YIblgZTjO6BqSQP3SuX0noR3T4LGcTKCba60zteQ9SHPlb3qAKgeCPhb?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.h: Login seccess in authenticator</p></figcaption></figure>

### **Self-Service Portal Registration**

**Prerequisite:**

The user must already exist in **ZTrust SSO**.

To register their mobile device, the user should log in to the **ZTrust Self-Service Portal** with their username/email and password.

1. The user logs in to the Self-Service Portal.
2. The landing page is the **overview** page, which contains four sections:
   * **User Details Management**
   * **Device Management**
   * **Signing In**
   * **Applications**
3. From here, go to **Device Activity**.
   * If no mobile device is registered, you will see a **Set Up New** button.
   * Click on it to begin the mobile registration process.<br>

     <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdoh_CXaZNURyOIaIKwBkTQcg8REVdGJ77MiUNXlP5HRIiwgiTEOMbYliRyV_Tx7acqV1pG7QyMrTa6k_MnYMcGJnb80XSnaEXB-AtLTLOjZlt8akWCCEGw5VZSCVTnKJsUFaK2nQ?key=H1CBi0glPVUPOPXlkXmCEQ" alt=""><figcaption><p>Fig 4.13.1.i: Overview page of self service portal</p></figcaption></figure>
4. After clicking **Set Up New**, a popup will appear displaying a **QR code** along with clear instructions to complete the registration.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf4lVSzXajw05aCZMP7mTrkF_Il4lHeSufKQo17LuAKRKLybJVDcdZKGHLmVeFTNbuaDZR2r9gEC7Kuc6DHNWcrSETr8SWtzpiZuRNgGvZePmc8RduEq3KmKR0muEX8mBVAWoJ7QA?key=H1CBi0glPVUPOPXlkXmCEQ" alt=""><figcaption><p>Fig 4.13.1.j: Setup ZTrust authenticator from self service portal</p></figcaption></figure>
5. Open the **ZTrust Authenticator** app on your mobile device.
   * If the app is **not installed**, please download it from the **Google Play Store** or **Apple App Store** and open.
   * Tap the **“+” button** to add a new account.

     <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcyFHWd1lMCRb4nTFZr3p3rTGLbvvAi6KUq51elva4JjVhyRZ6_QbcZ82q30nezeA7WlFF5tV_VMSoNDEMTdUPzIdf-WHmy7pUvHv7VnY22txft6JzzGBmtinrWhjV3omXxKZaTYQ?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.k: Initial page of authenticator</p></figcaption></figure>
6. After tapping the **“+” button**, the app will open the scanner. Use it to **scan the QR code** displayed on the Self-Service Portal.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdgM2ZdLAJ5qQRJLufSS5qjAzLZmNcp15oz1wb3Z4iK0fskbgAo_SycnwW6plvlR_324jUTW0V_M_g9W-Z6hLq2H2cE0X8VwNKdt0oeG0F2HhsgS56c-5KUrOYehT6q_k0XgxTE?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.l: Scanner to scan QR</p></figcaption></figure>
7. After a successful scan, the user will be prompted to a page where they must **enter their username/email and password**.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdUgegXxQnPtB-Kt6KUEjy-z7M-l7KbhNHWvBsBmgnW8XjvcZB-H7nzusV56wB8dUJ3AtkdWpjE-bmJJzpPNBXYmCAtaGhefGsupzTwp_WYTjuydQy9ruBvh2zE8GUU96-2TWsz4A?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.m: Login page in authenticator</p></figcaption></figure>
8. After successful validation, the user will be logged in to their account.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeaOa1U0mN1eD7Fv68dB6EHs8gGik799lCnb_rkkRzwdZI1Lv3fmaxa4Tjg3zT_ptwxvRPt3FWgjqC7YIblgZTjO6BqSQP3SuX0noR3T4LGcTKCba60zteQ9SHPlb3qAKgeCPhb?key=H1CBi0glPVUPOPXlkXmCEQ" alt="" width="188"><figcaption><p>Fig 4.13.1.n: Login success</p></figcaption></figure>
