- Print
- DarkLight
SSO Configuration with Okta
Before getting started in Okta, complete the following steps in Unleash to ensure you have access to the information you need:
Navigate to the Admin Center in Unleash and click on the Sign-In page.
Under SSO, click Configure.
Select SAML as the authentication method.
Choose Okta as your identity provider.
Once you've completed these steps, open your Okta account and follow the instructions below.
Step 1: Creating an App
Go to the Applications section of your Okta admin console and click Create App Integration.
Select SAML 2.0 and click Next.
Step 2: General Settings
Name your app, Unleash IT, and upload the provided logo below.
Mark your app as Do not display application icon to users and Do not display application icon in Okta Mobile App.
Step 3: SAML Settings
Copy the Single Sign-On URL from the Okta SAML configuration page in Unleash and paste it into the Single Sign-On URL field on the Okta setup page.
Fill in the Audience URI to be unleash-tech .
Fill in the Default RelayState to be initiator=Idp&returnUrl=https://app.unleash.so/signin .
Under Attribute Statements, fill in the following attributes mapping:
Please note that the user.id may not be in the dropdown but you can fill it manually.
firstName | user.firstName |
lastName | user.lastName |
user.email | |
userId | user.id |
Step 4: Finish
On the last page of the app creation wizard, mark your app as an internal app.
After the app is created, copy the Identity Provider Metadata URL and paste it into the corresponding field in the Okta SAML configuration page in Unleash.
SCIM Configuration with Okta
Set up a SAML app in Okta.
Under the General tab, click on Enable SCIM provisioning.
Under the Provisioning tab, navigate to Settings -> Integration and fill in the following fields:
SCIM connector base URL
Enter the following URL: https://okta-scim.unleash.so
Supported provisioning actions
Please select the following checkboxes:
Push new users
Push Profile Updates
Push Groups
Authentication Mode
Enter the following field: HTTP Header
Configure Authorization
#Enter the token generated by your Unleash representative
Under the Provisioning tab, navigate to Settings -> To App and edit and enable the following options:
Under the Assignments tab, assign groups for provisioning.
Under Push Groups, click on the Push Groups button. Then, add the group by either name or rule to initiate push provisioning.
If you require further assistance, feel free to contact your Unleash point of contact or email us at support@unleash.so.