How to Configure SAML Authentication for Zscaler Internet Access

Item

Details

Prior Confirmation

  • Prior configuration in Zscaler is required.

  • You must create an account in Zscaler using the same email address as TrustLogin.
  • For the latest setup instructions, please check the manual provided by Zscaler.

Name ID

Email address

Custom attribute Note: For instructions on how to configure a custom attribute, see here

SP-side Configuration

Configured by the administrator

Request configuration from the SP

Provisioning

Provisioning via API supported (account management possible in TrustLogin)
SAML JIT provisioning supported (account management possible in TrustLogin; user deletion not supported)

None (accounts are created in each system)
Note: For setup instructions when provisioning is required, see here

Access Method

SP-Initiated SSO

IdP-Initiated SSO

Verified Operation by Device

PC - Browser

PC - Desktop App

iOS - Standard Browser (Safari)

iOS - TrustLogin Mobile App In-App Browser

iOS - Native App

Android - Standard Browser (Chrome)

Android - TrustLogin Mobile App In-App Browser

Android - Native App

TrustLogin Admin Page Settings

  1. Log in to TrustLogin, open the "Admin Page > App" menu, and click the "Register App" button in the upper right of the screen.
    01.png

  2. Search on the "Register Company App" screen and select "Zscaler Internet Access (SAML)".
    02.png

  3. Note down the "Identity Provider URL" under "Identity Provider Information", and download the certificate from "Get Certificate". Change the file extension of the downloaded certificate to ".pem".
    03.png

Now, switch to configuring the Zscaler side.
Do not click the "Register" button yet — open the Zscaler Internet Access service portal in a separate tab.

Zscaler Internet Access Settings

  1. Log in with an administrator account and open "Administration > Authentication > Authorization" from the left menu.
    05.png

  2. When the "Authorization" screen appears, configure each item as follows and save.
    User Repository Type Select "Internal DB"
    Authentication Frequency Select any value
    Authentication Type Select "SAML"
    Temporary Authentication Select "Disabled"

    06.png

  3. Select the "Administration > Identity Providers" tab and click "Add IdP".
    07.png

  4. When the Add IdP screen appears, configure each item as follows and click the "Save" button.
    Name Enter "TrustLogin"
    SAML Portal URL The Identity Provider URL you noted from TrustLogin
    Login Name Attribute Enter "NameID"
    Organization-Specific Entity ID Select "Enabled"
    IdP SAML Certificate Upload the certificate downloaded from TrustLogin
    Vendor Select "Others"
    Sign SAML Request OFF
    SP Metadata Download from "Download Metadata"
    Enable SAML Auto-Provisioning OFF

    08.png
    Image (2).png

  5. Click "Enable".
    ZIA3.png

  6. Open the metadata file obtained from Zscaler in a text editor, and add ":443" after "[domain].net" in the Location value "https://login.[domain].net/sfc_sso", then overwrite and save.
    (It is easier to find by searching for "Location".)

    After editing, save it as an XML file.
    ZIA.png

TrustLogin Admin Page Settings (Continued)

Return to the TrustLogin Admin Page again.

  1. From "Service Provider Settings" > "Select Metadata", upload the metadata that you downloaded from Zscaler and for which you edited the Location value.
    04.png

  2. Click the "Register" button to save.

TrustLogin User Settings

① When a user adds the app from My Page

  1. Click the "Add App" button on "My Page".
  2. On the "Register App" screen, select "Zscaler Internet Access (SAML)" and click the "Next" button in the upper right of the screen.
  3. If you want to change the "Display Name", enter it and click the "Register" button.

② When an administrator adds members

  1. Search for and click the "Zscaler Internet Access (SAML)" app in the "Admin Page > App" menu.
  2. Click "Add Member", select the user to add from the member list, and click the "Register" button to add them.

How to Configure SAML Authentication for Zscaler Internet Access

Item

Details

Prior Confirmation

  • Prior configuration in Zscaler is required.

  • You must create an account in Zscaler using the same email address as TrustLogin.
  • For the latest setup instructions, please check the manual provided by Zscaler.

Name ID

Email address

Custom attribute Note: For instructions on how to configure a custom attribute, see here

SP-side Configuration

Configured by the administrator

Request configuration from the SP

Provisioning

Provisioning via API supported (account management possible in TrustLogin)
SAML JIT provisioning supported (account management possible in TrustLogin; user deletion not supported)

None (accounts are created in each system)
Note: For setup instructions when provisioning is required, see here

Access Method

SP-Initiated SSO

IdP-Initiated SSO

Verified Operation by Device

PC - Browser

PC - Desktop App

iOS - Standard Browser (Safari)

iOS - TrustLogin Mobile App In-App Browser

iOS - Native App

Android - Standard Browser (Chrome)

Android - TrustLogin Mobile App In-App Browser

Android - Native App

TrustLogin Admin Page Settings

  1. Log in to TrustLogin, open the "Admin Page > App" menu, and click the "Register App" button in the upper right of the screen.
    01.png

  2. Search on the "Register Company App" screen and select "Zscaler Internet Access (SAML)".
    02.png

  3. Note down the "Identity Provider URL" under "Identity Provider Information", and download the certificate from "Get Certificate". Change the file extension of the downloaded certificate to ".pem".
    03.png

Now, switch to configuring the Zscaler side.
Do not click the "Register" button yet — open the Zscaler Internet Access service portal in a separate tab.

Zscaler Internet Access Settings

  1. Log in with an administrator account and open "Administration > Authentication > Authorization" from the left menu.
    05.png

  2. When the "Authorization" screen appears, configure each item as follows and save.
    User Repository Type Select "Internal DB"
    Authentication Frequency Select any value
    Authentication Type Select "SAML"
    Temporary Authentication Select "Disabled"

    06.png

  3. Select the "Administration > Identity Providers" tab and click "Add IdP".
    07.png

  4. When the Add IdP screen appears, configure each item as follows and click the "Save" button.
    Name Enter "TrustLogin"
    SAML Portal URL The Identity Provider URL you noted from TrustLogin
    Login Name Attribute Enter "NameID"
    Organization-Specific Entity ID Select "Enabled"
    IdP SAML Certificate Upload the certificate downloaded from TrustLogin
    Vendor Select "Others"
    Sign SAML Request OFF
    SP Metadata Download from "Download Metadata"
    Enable SAML Auto-Provisioning OFF

    08.png
    Image (2).png

  5. Click "Enable".
    ZIA3.png

  6. Open the metadata file obtained from Zscaler in a text editor, and add ":443" after "[domain].net" in the Location value "https://login.[domain].net/sfc_sso", then overwrite and save.
    (It is easier to find by searching for "Location".)

    After editing, save it as an XML file.
    ZIA.png

TrustLogin Admin Page Settings (Continued)

Return to the TrustLogin Admin Page again.

  1. From "Service Provider Settings" > "Select Metadata", upload the metadata that you downloaded from Zscaler and for which you edited the Location value.
    04.png

  2. Click the "Register" button to save.

TrustLogin User Settings

① When a user adds the app from My Page

  1. Click the "Add App" button on "My Page".
  2. On the "Register App" screen, select "Zscaler Internet Access (SAML)" and click the "Next" button in the upper right of the screen.
  3. If you want to change the "Display Name", enter it and click the "Register" button.

② When an administrator adds members

  1. Search for and click the "Zscaler Internet Access (SAML)" app in the "Admin Page > App" menu.
  2. Click "Add Member", select the user to add from the member list, and click the "Register" button to add them.