Add a SAML Configuration

Required User Role: Administrator

You can manually enter the details for your SAML configuration or you can upload a metadata.xml file that you download from your identity provider (IdP).

Tip: To enable automatic user provisioning, see Enable Automatic Account Provisioning.
Note: Once SAML is configured for a user, they must log in normally one time before they can access the Sign in via SSO link on the Tenable Vulnerability Management login page.

Before you begin:

  • Follow the steps described in your IdP's documentation to set up a SAML application for Tenable Vulnerability Management on your IdP account. Your IdP requires an entity ID and a reply URL for Tenable Vulnerability Management to set up the SAML application. The entity ID for Tenable Vulnerability Management is TENABLE_IO_placeholder. The reply URL for Tenable Vulnerability Management is https://cloud.tenable.com/SAML/login/placeholder.com.

  • In your IdP account, download your metadata.xml file.

Note: Tenable does not currently support a SP-Initiated SAML flow. Because it must be initiated from the Identity Provider side, navigating directly to https://cloud.tenable.com does not allow SSO. Additionally, all users must have an account configured in Tenable Vulnerability Management that matches their SSO login.

To add a new SAML configuration:

  1. In the upper-left corner, click the Menu button.

    The left navigation plane appears.

  2. In the left navigation plane, click Settings.

    The Settings page appears.

  3. Click the SAML tile.

    The SAML page appears.

  4. In the action bar, click Create.

    The SAML Settings page appears.

  5. Do one of the following:

    1. In the first drop-down box, select Import XML.

      Note: Import XML is selected by default.

    2. Under Import, click Add File.

      A file manager window appears.

    3. Select the metadata.xml file.

      The metadata.xml file is uploaded.

    1. In the first drop-down box, select Manual Entry.

      A SAML configuration form appears.

    2. Configure the settings described in the following table:

      Settings Description
      Type Specifies the type of identity provider you are using. MSSP supports SAML 2.0 (for example, Okta, OneLogin, etc.).
      This option is read-only.
      Description A description for the SAML configuration.
      IdP Entity ID

      The unique entity ID that your IdP provides.

      Note: If you want to configure multiple IdPs for a user account, create a new configuration for each identity provider with separate identity provider URLs, entity IDs, and signing certificates.
      IdP URL The SAML URL for your IdP.
      Certificate

      Your IdP security certificate or certificates.

      Note: Security certificates are found in a metadata.xml file that your identity provider provides. You can copy the content of the file and paste it in the Certificate box.
      SAML Enabled

      A toggle that indicates whether the SAML configuration is enabled or disabled.

      By default, the Enable setting is set to Enabled.

      User Auto Provisioning Enabled

      A toggle that indicates whether automatic user account creation is enabled or disabled.

  6. Click Save.

    MSSP saves your SAML configuration.

What to do next:

  • Download the metadata.xml from Tenable Vulnerability ManagementMSSP using the Download SP Metadata option in the SAML Configurations table.

  • Upload this file to the SAML application you created for Tenable Vulnerability ManagementMSSP with your SAML provider.