Integrate Kandji with Conditional Access

In this topic, you will find general instructions on how to integrate Kandji 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 Kandji.

  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 Kandji for the new application configuration but you can use any name you like.

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

Open your Kandji SAML SSO settings

In this section, you will access your Kandji administrative interface and find the settings for custom SAML single sign-on (SSO).

  1. In another tab of your browser, open your Kandji web interface by accessing the following URL: https://your_tenant.kandji.io/, substituting your_tenant with your Kandji tenant name.

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

  2. In the left-hand side menu, click on the Settings option.

  3. In the Settings pane, click on the Access tab.

  4. In the Access tab, scroll down to the Authentication section, and then click on the Add button.

  5. In the Add SSO Connection pane, click on the Custom SAML tile, and then click on the Next button.

  6. In the Custom SAML pane, click on the Show Advanced Details link.

  7. In the Name field, enter a name for the identity provider. This name will appear on the login button.

    In this example, we used the name Conditional Access but you can use any name that will be best for your users, for example, your organization name.

Copy configuration values from the Portnox tab to the Kandji tab

In this section, you will copy the values displayed by Portnox Cloud and paste them in the relevant fields in the Kandji custom SAML SSO setup section.

  1. In the Portnox tab, in the Service details section, click on the  ⧉  icon next to the Sign-In URL / SSO URL field to copy the value.

  2. In the Kandji tab, click on the empty field next to the Sign-In URL label and paste the value copied from Portnox Cloud.

  3. In the Portnox tab, in the Certificates > Signing certificates section, click on the  ⋮  icon next to the Active certificate and select the Download certificate option to download the certificate to the local drive.

  4. In the Kandji tab, click on the Drop here or click to upload tile in the Signing Certificate Upload section, and upload the downloaded certificate file.

Copy configuration values from the Kandji tab to the Portnox tab

In this section, you will copy the values displayed in your Kandji custom SAML SSO setup section, and paste them in the relevant fields in Portnox Cloud.

  1. In the Kandji tab, in the Identity Provider Configuration Information section, copy the value of the Entity ID field using your operating system’s copy to clipboard shortcut.

  2. 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 value copied from Kandji.

  3. In the Kandji tab, in the Identity Provider Configuration Information section, copy the value of the Assertion Consumer Service URL field using your operating system’s copy to clipboard shortcut.

  4. 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 value copied from Kandji.

Finalize the configuration

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

  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 Kandji tab.
    1. Set the value of the Sign Request field to No and set the value of the Protocol Binding field to HTTP-POST.

    2. Click on the Save button in the bottom-right corner.

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