Okta
Configuring Okta for IdP-initiated login with Deque products
Not for use with personal data
This guide covers IdP-initiated login only. For SP-initiated login, follow the generic SAML setup and no provider-specific configuration is required.
Creating the Application
- In Okta, go to Applications > Create App Integration.
- Select SAML 2.0.
- Enter the application name (for example,
Deque Axe). - On the Configure SAML page, enter the values Deque provided:
- Single sign-on URL: The SSO URL from your Deque metadata
- Audience URI: The Entity ID value (the one ending in
/clients/<client name>, not the one ending in/endpoint)
- Click Next.
important
Use the Entity ID value ending in /clients/<client name> exactly as it appears in the metadata file. Do not shorten or edit it. The metadata file contains both an Entity ID ending at /endpoint and one ending at /clients/<client name> — use only the longer one.
Adding Attribute Statements
Attribute statements tell Okta which user properties to send to Deque. The first and last name attributes are optional but recommended — they are imported on first sign-in.
- On the SAML 2.0 application page, go to the Attributes tab.
- In the Attribute Statements section, select Show legacy configuration.
- Add the following three attributes:
| Name | Value |
|---|---|
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress |
user.email |
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname |
user.firstName |
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname |
user.lastName |
- Click Save.
Set Name ID format to EmailAddress.
Assigning Users
- In the application, go to the Assignments tab.
- Assign the users and groups who should have access to this application.
Sending Metadata to Deque
- In the application, go to the Sign On tab.
- Under SAML Signing Certificates, select your certificate.
- Download the metadata by selecting the Metadata details link. This opens an XML document.
- Copy the URL from your browser's address bar (the
metadataURL ending in.xml), or save the XML file and send it to helpdesk@deque.com.
Testing
- In your Okta user profile, go to My Applications.
- Select the Deque application you created.
- Confirm you are redirected to Deque and arrive in the product.
- Confirm your name and email address are correct on your Deque profile.
Your IdP-Initiated Start URL
After testing completes, send this URL to Deque:
- In the application, go to General > App Embed Link.
- Copy the URL.
