Integrate SOTI ONE with Conditional Access

In this topic, you will find general instructions on how to integrate SOTI ONE with Portnox™ Conditional Access for Applications.

Create a Portnox Cloud application configuration

In this step, you will create a configuration in Portnox Cloud that will contain all the information necessary to integrate with SOTI ONE.

  1. In a new tab of your browser, open your Portnox Cloud account by accessing the following URL: https://clear.portnox.com/

    From now on, we will call this tab the Portnox tab.

  2. In the Cloud portal top menu, click on the Applications option.

  3. On the Applications screen, click on the Add application button, and select the Add new SAML application option.

  4. Optional: If you have more than one SAML identity provider configured, select the identity provider in the Select an identity provider to use for this application section.
  5. In the Application details section, enter an Application name and optionally a Description.

    In this example, we used the name SOTI for the new application configuration but you can use any name you like.

  6. Keep this browser tab open. You will need it later.

Create a directory/IdP in SOTI ONE

In this section, you will create a directory in SOTI ONE for SAML integration with an identity provider (IdP).

  1. In another tab of your browser, log in to your SOTI ONE tenant by accessing the following URL: https://your_tenant.identity.soti.net/, substituting your_tenant with your SOTI ONE tenant name.

    From now on, we will call this tab the SOTI tab.

  2. In your SOTI ONE dashboard, click on the  ≡  icon in the top-left corner, and then select the Directories/IdP option from the menu.

  3. In the Directories pane, click on the NEW DIRECTORY button and select the IdP Connection option.

  4. In the CREATE CONNECTION window, click on the SAML Based IdP option.

  5. In the CONFIGURE IDP window:
    1. In the Name field, enter the name for this directory.

      In this example, we used the name Portnox Conditional Access, but you can use any name you like.

    2. In the Domain section, click on the Select From Existing field and select your company domain.

      Note: All users with email addresses in this domain will be logged in using Conditional Access and will be managed using the identity provider’s directory, not the primary SOTI ONE user directory. We recommend to have at least one administrative service user account with a different domain to be able to log in to SOTI ONE in case of problems with the configuration.
    3. In the User Attributes section, enter the name of the attributes as configured in your identity provider.

      These attributes will be used by SOTI ONE to create user accounts on the basis of the attributes/claims sent by your configured identity provider. Every identity provider has different default values. For example, in Entra ID, the default claims for a new SAML application are http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname, and http://schemas.microsoft.com/ws/2008/06/identity/claims/groups, but in Google Workspace, the only default value is NameID and you need to create custom attributes for a new SAML app.

    4. Click on the Downloads button and select the Identity Metadata option.

      You will need this metadata file later to copy the configuration values to the Portnox tab.

Export metadata from the Portnox tab and upload it in the SOTI tab

In this section, you will export the metadata from Portnox Cloud into a file and import that file with SOTI ONE.

  1. In the Portnox tab, in the SAML metadata section, click on the Download metadata XML file link to download the XML file and save it to your local drive.

  2. In the SOTI tab, click on the Import button in the IdP Metadata File section, and then upload the XML file downloaded from Portnox Cloud.

Copy the configuration values from the metadata file to the Portnox tab

In this section, you will copy the configuration values stored in the downloaded metadata file and paste them in the relevant fields in Portnox Cloud.

  1. Open the SOTI ONE metadata file downloaded earlier (SOTIIdentityMetadata.xml) in a browser.

    For example, in Windows, simply double click on the downloaded file.

  2. In the metadata content, find the <md:EntityDescriptor> element and its entityID attribute, and then copy its value (without the quotes) using your operating system’s copy shortcut.

  3. In the Portnox tab, in the Application properties section, click on the empty field under the Entity ID / Service Provider Entity URL heading and paste the copied value.

  4. In the metadata content, find the <md:AssertionConsumerService> element with the Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" attribute. Copy the value of its Location attribute (without the quotes).

  5. In the Portnox tab, in the Application properties section, click on the empty field under the Assertion Consumer Service (ACS) URL / Reply URL heading and paste the copied value.

Finalize the configuration

In this section, you will finalize the configuration in Portnox Cloud and SOTI ONE.

  1. Finalize the configuration in the Portnox tab.
    1. Optional: In the POLICY ASSIGNMENTS section, change the setting to Application-based and then select an access control policy and a risk assessment policy if you want to control access to this application without using groups.
    2. Scroll all the way down to the end of the page, and then click on the Save button.

  2. Finalize the configuration in the SOTI tab.
    1. Click on the Create button to create the directory in SOTI.

    2. In your SOTI ONE dashboard, click on the  ≡  icon in the top-left corner, and then select the Users option from the menu.

    3. In the Directory selector, select the directory/IdP that you created earlier in SOTI ONE.

    4. In the top-right corner, click on the NEW USER GROUP button.

    5. In the ADD IDP USER GROUP window, click on the  +  icon, enter the group NAME, optionally activate the IDENTITY ACCOUNT ADMINISTRATOR switch (if applicable), and click on the ADD button.
      Note: If you use the user.groups claim in Entra ID, in the NAME field, enter the group’s Object ID, not the human-readable Entra ID Name.

      Note: All users from your selected domain who are assigned to this group in your identity provider will be authorized to use SOTI ONE. You may want to create at least two groups, one with administrative access and the other for regular users.

Result: You have configured SOTI ONE to be accessible using Portnox Conditional Access for Applications.