Skip to content
Dashboard
Theme
Theme

OneLogin SAML single sign-on

Set up SAML single sign-on with OneLogin

View Markdown

Add a SAML app in OneLogin, paste the values from this setup, give your users access and share the app’s metadata with us.

The values in braces, such as {sp_entity_id}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

  1. In the OneLogin admin portal, go to Applications > Add App, search for the custom SAML connector, select it, enter a display name and select Save.

  2. On the app’s Configuration tab, paste {sp_entity_id} into the audience (entity ID) field.

    Paste into OneLogin:

    • SP entity ID: {sp_entity_id}

    Fixes: saml_audience_mismatch

  3. Paste {acs_url} into the recipient field and the ACS (consumer) URL field. If there is an ACS URL validator field, paste the same URL there too. Select Save.

    Paste into OneLogin:

    • ACS URL: {acs_url}

    Fixes: saml_destination_mismatch, saml_response_malformed

  4. On the SSO or Parameters tab, make sure the name ID is the user’s email address.

    Fixes: saml_nameid_missing

  5. On the SSO tab, sign the assertion (or both the assertion and the response) and use SHA-256.

    Fixes: saml_signature_missing, saml_signature_algorithm_weak

  6. On the Parameters tab, add email, firstName and lastName parameters mapped to the user’s email, first name and last name, and select Include in SAML assertion for each.

    Fixes: saml_email_missing

  7. Assign the app to the users or roles who should sign in with single sign-on.

    Fixes: saml_idp_status_error

  8. Download the app’s SAML metadata (or the issuer URL and X.509 certificate) and add it to this setup. Do this again whenever the certificate changes.

    Fixes: saml_signature_invalid, saml_issuer_mismatch

  9. Run a test sign-in in this setup, signing in as a user who has access to the app.

If our main network ever has an outage, sign-ins can continue through a standby address, but only if OneLogin accepts it. If the app lets you add more than one ACS URL, add {standby_acs_url} as the second one and keep {acs_url} as the default. If it allows only one, skip this step. Then confirm in this setup that you added it.

Paste into OneLogin:

  • Standby ACS URL: {standby_acs_url}
  • ACS URL: {acs_url}

This step is optional. See standby route behavior for what the standby address does during an outage.