Set up Azure SSO
Updated
Who can do this: Super Admins
Connect OnRamp to Microsoft Azure with SAML. Once you're done, your team signs in to OnRamp with their Azure accounts.
This feature is available when it's turned on for your organization. If you don't see it, contact your OnRamp team.
Before you begin
You need admin rights in Azure to create and set up an application there.
Each person who signs in needs an OnRamp account with the same email address as their Azure account.
An organization uses one SSO provider at a time. Turning on Enforce SAML SSO turns off Enforce Google SSO.
Get OnRamp's SAML values
Go to Settings > Single sign-on. It's in the Organization group.
In the SAML SSO section, turn on Enforce SAML SSO.
Copy the Assertion Consumer Service URL and the SAML Entity ID. You'll enter these in Azure.
If no provider is set up yet, the page shows No SSO provider is configured yet.
Create the OnRamp app in Azure
In the Azure portal, create an enterprise application for OnRamp that uses SAML single sign-on. Microsoft's Azure documentation has the current steps.
In the app's SAML settings, enter the OnRamp SAML Entity ID as the identifier and the Assertion Consumer Service URL as the reply URL.
Save the app, then copy its app federation metadata URL.
Finish setup in OnRamp
Back on the Single sign-on page, make sure SAML (Metadata) (Recommended) is selected.
Paste the Azure metadata URL into SAML Metadata URL.
In the bar that shows You have unsaved changes, select Save changes.
When it works, a notification reads SSO configuration saved. If you leave the page before saving, OnRamp asks Leave without saving? so you can save or stay.
To enter the values yourself instead of using a metadata URL, select SAML (Manual). Then fill in Identity Provider HTTP POST URL and x.509 Certificate. Identity Provider Logout URL (optional) is optional.
Optional: Let customer users sign in through Azure
To have customer users sign in through Azure too, turn on Enable SSO for customer users in the SAML SSO section, then save. To learn about the other sign-in options for customer users, see How customers authenticate and access the portal.
Optional: Create users automatically with SCIM
After you save the SSO connection, the page shows SCIM provisioning. Copy the SCIM base URL into Azure, then select Generate token and paste the token into Azure too. Azure can then create OnRamp users for you.
OnRamp shows the token only once, so copy it right away. If you select Replace token, Azure stops creating users until you paste the new token into it.
If someone can't sign in
Check that their OnRamp email address matches their Azure email address. Without a matching account, OnRamp can't sign them in.
Check that the SAML Metadata URL was copied in full from Azure.