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 |
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!