Okta is a cloud identity management system that enables organizations to securely log their users into a variety of applications. Our integration allows Okta users to seamlessly create new accounts and log into Topic. The guide below will show you exactly how to set the integration up.
- OpenID Connect (OIDC) SSO
- JIT (Just In Time) Provisioning
For more information on the listed features, visit the Okta Glossary.
When using Okta with Topic, you will need to be on an enterprise plan within Topic. If you need to upgrade, please contact firstname.lastname@example.org.
Okta SSO Configuration Steps
Setting up Okta SSO with Topic is a two step process. First, you'll add the Topic Application to your Okta account. Then, you'll configure your Topic account to connect to Okta.
Warning Before Enabling SSO
Once setup is complete, team members will be immediately required to re-login to Topic using their Okta credentials. Their current work may be interrupted. We recommend notifying your team before proceeding further.
Part 1: Add Topic Application to Okta
Add Topic to your Okta account by clicking going to your Applications page and clicking Add Application.
Search for Topic in the Application Search field and click Add.
You'll be asked to provide an Application label (Topic) and configure whether the application should display to users or auto-submit with the browser plugin. Select your preference and click Next (these can be changed later).
Next, you'll see Step 2: Sign-On Options. Select OpenID Connect and click Done.
Once you click Done, the application will be added to your Okta org and is ready to be assigned to your team members. Click Assign to add the team members or groups who will be accessing Topic, including yourself!
Once you've added People, keep the Okta window open and move to Step 2.
Part 2: Configure Okta SSO in Topic
Open a new window and get ready to set up SSO in your Topic account. Log in to Topic and navigate to the Team Management Page under the settings.
You should see a form (shown below) to add your Okta Configuration Settings.
In the Configuration form, enter the following information:
Okta Application Client ID and Client Secret: This is located on the "Sign On" tab of the Topic Application in Okta.
Okta Organization URL
This can be found in your Okta dashboard and typically follows the format of https://companyname.okta.com. Learn more about Okta Org URLs here.
- Click "Update" and you're all good to go!
- Logout and go to the app.usetopic.com, and click "Sign in with Oktaoauth"
When prompted for authentication, enter your Okta credentials
Known Issues / Troubleshooting
If any errors occur, please email email@example.com and we will work with you to troubleshoot the issue.