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.
-
Add a SAML app
Section titled “Add a SAML app”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.
-
Enter the audience
Section titled “Enter the audience”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 - SP entity ID:
-
Enter the ACS URL
Section titled “Enter the ACS URL”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}
- ACS URL:
-
Send the email address as the name ID
Section titled “Send the email address as the name ID”On the SSO or Parameters tab, make sure the name ID is the user’s email address.
Fixes:
saml_nameid_missing -
Check the signing settings
Section titled “Check the signing settings”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 -
Add the attributes
Section titled “Add the attributes”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 -
Give people access
Section titled “Give people access”Assign the app to the users or roles who should sign in with single sign-on.
Fixes:
saml_idp_status_error -
Share the identity provider metadata
Section titled “Share the identity provider metadata”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.
-
Test the connection
Section titled “Test the connection”Run a test sign-in in this setup, signing in as a user who has access to the app.
Optional: add the standby ACS URL
Section titled “Optional: add the standby ACS URL”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.
Sources
Section titled “Sources”- Dev Overview of SAML (OneLogin Developers), read on 2026-10-11
- Create a SCIM test app (OneLogin Developers), read on 2026-10-11