Configure single sign-on for an SAML (Generic) IdP Provider

Configure single sign-on (SSO) so that any user in your organization can automatically log in to Incident Response.

Before you begin

Role required: Administrator

Procedure

  1. Access your IdP Provider.
  2. Note the IdP Provider URL from your provider.
  3. Note the SSO Endpoint URL from your provider.
  4. Export the X.509 certificate.
  5. Logout.
  6. Log in to Incident Response.
  7. On the navigation pane, select Admin.
  8. On the Single Sign-on, OAuth Identity form, select Set up and manage SSO.
    Note: Only one authentication feature can be enabled at a time.
    Generic SSO configuration form
  9. Select Edit.
  10. Fill in the SSO fields with the information you noted from your provider.
    Field Description
    IdP Issuer URI/Entity ID Issuer URI of the Identity Provider. This value is usually the SAML Metadata EntityID of the IdP EntityDescriptor.
    IdP Login URL The binding-specific IDP Authentication Request Protocol endpoint that receives SAML AuthnRequest messages from Incident Response.
    IdP Logout URL [Hidden] Visible when Single Sign Out is enabled. This is the logout endpoint for IdP.
    IdP Signature Certificate
    The PEM encoded public key certificate of the Identity Provider used to verify SAML message and assertion signatures.
    Note: Wrap this field with ––-BEGIN CERTIFICATE----- and ––-END CERTIFICATE----- text.

    A certificate expiration date is generated after successfully adding the certificate. Placeholder alt text for cert-expiration-date

  11. Optional: To activate single sign out, select the Enable Single Sign Out toggle switch.
    When enabled it completes the user IdP logout. Otherwise, their logout is only from Incident Response.
  12. Select Save.
    Figure 1. Configured SSO form example
    Completed SSO configuration form
  13. Use the Test connection button to make sure your configuration works.

    Test connection creates a popup with your results.

    When the test succeeds, you can select Activate to enable SSO.

    If the test failed, follow the instructions in the popup and select Close to continue editing.

    Once you have successfully tested your configuration and activated, you're done. Your SSO configuration is enabled.
    Note: To disable the configuration, use the Enable Single Sign In toggle switch back to the off position.

    See Configure OAuth identity authentication for detailed information on configuring and managing OAuth authentication.

What to do next

See Sign in to Incident Response using Single Sign-on, OAuth, or multi-factor authentication