Configure admin SSO with a custom SAML provider

Configure admin SSO with a custom SAML provider

StatusGator supports Single Sign-On (SSO) for admin users using SAML 2.0. If your identity provider is not listed, select Other. 

Before you begin

• You must be on a plan that includes SSO
• You must have administrator access in your identity provider
• Users must already be invited to StatusGator

Step 1: Create a SAML application in your identity provider

Create a new SAML 2.0 application in your identity provider and enter the following service provider details:

Single sign-on URL

• https://app.statusgator.com/users/saml/auth

Audience URI (SP Entity ID)

• https://app.statusgator.com

Name ID format

• EmailAddress

Application username / Name ID value

• User email address

If your provider asks for a default relay state, leave it blank unless required.

Step 2: Configure attribute statements

Ensure the following attribute is included in the SAML assertion:

Required attribute

• email
  • Value: User’s email address
  • Must exactly match the invited email in StatusGator

Optional attributes

• first_name
• last_name

If the email value does not match an invited user, login will fail.

Step 3: Copy your identity provider values

After creating the SAML application, copy the following from your identity provider:

• Identity provider issuer (Entity ID)
• Identity provider single sign-on URL
• X.509 certificate

You will enter these values into StatusGator.

Step 4: Configure SSO in StatusGator

1. Log in as an admin
2. Go to Team management
3. Select Authentication options
4. Under Configure single sign-on, choose Other
5. Enter:

Identity provider issuer

Identity provider SSO URL

X.509 certificate

1. Click Save
2. Enable SSO
3. Click Save again

We recommend testing SSO before enforcing it for all users.