Skip to main content
Integrating Suite with Okta

A step-by-step guide to integrating Okta with Suite

Updated over 6 months ago

Overview

This article describes integrating Okta with Suite. By the end of the article, your team members will be able to authenticate against Okta to log in to Suite.

Creating a Suite application within Okta

Step 1: Sign Into the Okta Admin Portal

Step 2: Navigate to the Applications Page

Step 3: Click "Create App Integration"

Step 4: Select "SAML 2.0" as the Sign-in method

Step 5: Type in the "App name" and as an option, add the Suite logo to the app in Okta.

Step 6: Locate the "Single sign-on URL" and the "Audience URI" provided by a Suite Team Member - You'll need these in the next step.

Step 7: Match your SAML Settings to the image below OR reference the corresponding table:

Field

Value

Single sign-on URL

Copy and Paste the Single sign-on URL here

Audience URI

Copy and Paste the Audience URI here

Default RelayState

Leave this field blank

Name ID format

"Unspecified"

Application username

"Email"

Update application username

"Create and update"

Step 8: Map the following attributes to the corresponding value. Pay close attention as this is case-sensitive.

Name ( ⚠️ case sensitive ⚠️ )

Value

email

user.email

firstName

user.firstName

lastName

user.lastName

Step 9: Navigate to the Suite Application within Okta and click on the "Sign On" Tab

Step 10: Copy the "Metadata URL" and keep it handy, you'll need it in Step 12

Step 11: Pick a team ID for your account

When your team members sign in using SSO on Suite they'll need to provide a team ID.

This ID can not include whitespace and cannot start or end with an underscore.

💡 We recommend keeping this simple and readable. For example, if your company's name was Flower Productions, you could choose "flowerproductions".

Step 12: Email or Slack a Suite team member the "Metadata URL" from Step 10 as well as your chosen team ID.

A Suite administrator will complete the integration and notify you as soon as it is ready!

Still have a question?

Click the chat icon in the corner of your screen to send us a message!

Did this answer your question?