Integrate Huntress with Conditional Access

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

  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 Huntress 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 Huntress SSO configuration page

In this section, you will access your Huntress single sign-on configuration page and set up SAML SSO.

  1. In another tab of your browser, open your Huntress dashboard by accessing the following URL: https://www.huntress.io/.

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

  2. Click on the  ≡  icon in the top-right corner, and then select the Settings option from the menu.

  3. In the settings pane, in the Single Sign-On section, click on the Setup SAML SSO button.

Copy configuration values from the Portnox tab to the Huntress tab

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

  1. In the Portnox tab, in the Service details section, click on the  ⧉  icon next to the Identity Provider Entity ID / Audience URI field to copy the value.

  2. In the Huntress tab, in the Setup SAML SSO window, click on the empty field below the Entity ID (URL) label and paste the value copied from Portnox Cloud.

  3. 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.

  4. In the Huntress tab, in the Setup SAML SSO window, click on the empty field below the SSO Service URL label and paste the value copied from Portnox Cloud.

  5. In the Portnox tab, in the Certificates > Signing certificates section, click on the  ⋮  icon next to the Active certificate and select the Copy certificate option to copy the certificate.

  6. In the Huntress tab, in the Setup SAML SSO window, click on the empty field below the Certificate label and paste the value copied from Portnox Cloud.

Enter configuration values in the Portnox tab

In this section, you will enter configuration values in the relevant fields in Portnox Cloud.

  1. In the Portnox tab, in the Application properties section, click on the empty field under the Entity ID / Service Provider Entity URL heading and enter the following value: https://huntress.io/sso/metadata.

  2. 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 enter the following value: https://huntress.io/sso/auth/.

Finalize the configuration

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

  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 Huntress tab.
    1. Click on the Save button.

      Your SSO configuration will be enabled but not verified.

    2. In a private/incognito browser window, log in to Huntress to test the SSO configuration.

      Your SSO configuration will now be verified.

    3. Optional: Click on the Edit button to edit the configuration and enforce SSO.

      By default, all Huntress users can log in using their Huntress credentials and MFA or using single sign-on. If you want to allow them to log in only using Conditional Access (recommended), you must activate the Enforce SSO for this Account switch and then click on the Save button.

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