Skip to main content

Setup SAML 2.0 with Okta

This guide walks you through configuring SAML 2.0 single sign-on (SSO) between Okta and Anzenna, enabling secure authentication across both platforms.

Prerequisites​

  • Admin access to your Okta dashboard
  • Admin access to your Anzenna account
  • Your organization's Anzenna Domain ID

Overview​

The setup process involves:

  1. Retrieving your Anzenna Domain ID
  2. Creating a SAML app integration in Okta
  3. Configuring attribute mappings

  4. Connecting Okta to Anzenna with the metadata URL

Step-by-Step Instructions​

Step 1: Get Your Anzenna Domain ID​

  1. Navigate to Settings > Access > SAML

  2. Toggle Enable SAML and locate the Domain ID

  3. Copy this Domain ID - you'll need it for the Okta configuration

Anzenna Domain ID Location
tip

Keep this Domain ID handy in a text editor. You'll use it multiple times in the Okta configuration URLs.

Step 2: Configure Okta​

Create the App Integration​

  1. Open your Okta dashboard in a new browser tab

  2. Click the hamburger menu icon (☰)

  3. Select Applications from the navigation menu

  4. Click Create App Integration

Create App Integration in Okta

  1. Select SAML 2.0 as your authentication protocol

Select SAML 2.0

Configure General Settings​

  1. Enter "Anzenna" as the app name

  2. (Optional) Upload an app logo

Configure SAML Settings​

Configure the following URL fields by replacing <domain-id> with your actual Domain ID:

FieldValue
Single sign-on URLhttps://app.anzenna.ai/auth/saml/<domain-id>/acs
Audience URI (SP Entity ID)https://app.anzenna.ai/auth/saml/<domain-id>/metadata
Default RelayStatehttps://app.anzenna.ai
SAML URL Configuration
Important

Make sure to replace <domain-id> with your actual Domain ID from Step 1. The URLs will not work with the placeholder text.

Add Attribute Statements​

Add the following three attribute statements to map user information:

NameValue

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname

user.firstName

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

user.lastName

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

user.email
Attribute Statements Configuration

These mappings ensure that user profile information (first name, last name, and email) is passed from Okta to Anzenna during authentication.

Complete Okta Setup​

  1. (Optional) Select the appropriate feedback option for Okta

  2. Click Finish to complete the Okta configuration

Step 3: Connect Okta to Anzenna​

Get the Metadata URL from Okta​

  1. In your newly created Okta app, navigate to the Sign On tab

  2. Scroll down to find the Metadata URL

  3. Copy the Metadata URL - it should look like:

https://your-org.okta.com/app/...metadata
Okta Metadata URL

Configure SAML in Anzenna​

  1. Navigate to Settings > Access > SAML

  2. Select Okta as the identity provider

  3. Paste the IDP Metadata URL from Okta

Anzenna SAML Configuration

Step 4: Test Your SAML Setup​

  1. Log out of Anzenna completely

  2. Sign in again at

    app.anzenna.ai/u/signin

    using Enterprise SSO

Anzenna Login Page with SAML
Testing

For the first test, try logging in with a user account that exists in both Okta and Anzenna to verify the connection is working properly.

Need help? Contact

Anzenna Support

for assistance.