Huntress - SSO configuration

Huntress - SSO configuration

Idea
This documentation has been tested and approved by Kelvin Zero's team
Quote
This documentation provides a step-by-step guide to setting up Single Sign-On (SSO) for Huntress using MPAS. SSO simplifies user authentication by allowing access to multiple applications with a single set of credentials. This integration enhances security and improves user experience across your organization.
Warning
To set up Multi-Pass with Huntress, ensure you meet the following requirements:
- Huntress admin rights
- MPAS Admin rights
- Make sure that all users intended to use SSO in Huntress are registered in your IdP and have the necessary permissions to access Huntress.
Important: Custom elements in URLs (like realm names) are case sensitive. Make sure to match the exact casing from your environment.


Huntress - SSO configuration


Start SAML SSO Setup in Huntress

  1. Log in to your Huntress dashboard.
  2. In the top-right corner, click on the three horizontal lines (menu).
  3. Go to Settings.

  1. In the Single Sign-On section, click on Set up SAML SSO.

  1. A window will open asking for three fields to complete:
    1. SSO Service URL
    2. Entity ID URL
    3. Certificate
We will retrieve these values from Multi-Pass shortly.

Information Required from Huntress

Refer to Huntress's documentation (SAML SSO for the Huntress Portal). The values you will need for Multi-Pass are:

Configure Multi-Pass

  1. Go to Open Multi-Pass Deployment Dashboard and authenticate.
  2. Select your deployment.
  3. In the left-hand menu, click on Advanced Console.

  1. Once redirected, click on Clients.
You have two options:
  1. Import Client using the Huntress metadata file.
  2. Manually create the client (described below).

Create a New Client Manually

  1. Click on Create Client and fill in the following fields:
FieldValue
Client TypeSAML
Client IDhttps://huntress.io/sso/metadata
NameHuntress (or any name you prefer)
Descriptione.g., Huntress SSO Integration
Always display in UION


  1. Click Next and configure the next fields
FieldValue
Home URL
https://ca.auth.kzero.com/realms/<TENANT_NAME>/protocol/saml/clients/huntress
Valid Redirect URIshttps://huntress.io/sso/auth
Valid Post Logout Redirect URIs(Optional - not mandatory for Huntress)
IDP-Initiated SSO URL Namehuntress


  1. Click Save
  2. finalize the configuration, In the Settings tab under SAML Capabilities:
SettingValue
Name ID Formatemail
Force Name ID FormatON
  1. Under Signature and Encryption:
SettingValue
Sign AssertionsON
  1. Click Save and go on the Keys tab
  2. Ensure both options are set to OFF
  3. Go to the advanced tab 
FieldValue
Assertion Consumer Service POST Binding URLhttps://huntress.io/sso/auth
  1. Click Save

Retrieve the Certificate

  1. In the left-hand menu, click on Realm Settings.
  2. Go to the Keys tab.
  3. Locate the RS256 line.
  4. Click on Certificate and copy the full X.509 certificate (You will need this for Huntress.)

Finalize Setup in Huntress

Return to the Huntress configuration page and complete the fields:
FieldValue
SSO Service URLhttps://ca.auth.kzero.com/realms/<TENANT_NAME>/protocol/saml
Entity ID (URL)https://ca.auth.kzero.com/realms/<TENANT_NAME>
CertificatePaste the X.509 certificate between:
-----BEGIN CERTIFICATE-----
[certificate content]
-----END CERTIFICATE-----


  1. Click Save
Info
If you want to remove the 2FA please follow the documentation provided by Huntress here
    • Related Articles

    • HaloPSA - SSO configuration

      This documentation has been tested and approved by Kelvin Zero's team This documentation provides a step-by-step guide to setting up Single Sign-On (SSO) for HaloPSA using MPAS. SSO simplifies user authentication by allowing access to multiple ...
    • Auvik - SSO configuration

      This documentation has been tested and approved by Kelvin Zero's team This documentation provides a step-by-step guide to setting up Single Sign-On (SSO) for Auvik using MPAS. SSO simplifies user authentication by allowing access to multiple ...
    • Blumira - SSO Configuration

      This documentation has been tested and approved by Kelvin Zero's team This documentation provides a step-by-step guide to setting up Single Sign-On (SSO) for Blumira using MPAS. SSO simplifies user authentication by allowing access to multiple ...
    • Datadog - SSO configuration

      This documentation has been tested and approved by Kelvin Zero's team This documentation provides a step-by-step guide to setting up Single Sign-On (SSO) for Datadog using MPAS. SSO simplifies user authentication by allowing access to multiple ...
    • SAML SSO Integration Guide

      This guide provides an overview of how to configure SAML Single Sign-On (SSO) between Multi-Pass and a third-party Service Provider (SP). Multi-Pass acts as the Identity Provider (IdP) in this federation model. Multi-Pass is working on SCIM support ...