Setting up Okta SSO
Maryjane Bates avatar
Written by Maryjane Bates
Updated over a week ago

Prerequisites

Before setting up Okta, you must sign-up for an Agora account via https://app.getagora.com/signup

Supported Features

  • SP initiated SSO

  • IDP initiated SSO

Setting up Okta with Agora

We recommend being logged into both Okta and your Agora account before you get started, as there will be a few values you’ll need to copy and paste between both platforms.

In Okta:

  1. Navigate to Applications and choose Applications from the dropdown

  2. In the Applications page, select Browse App Catalog

  3. Search for Agora and then click on it (there may be multiple results that come back for the Agora search term. Make sure you select the one with the right logo!

  4. Click the Add button.

You’ll now see a field for Company ID. Next, we’ll switch over to Agora to get the values we need to paste into the Company ID field.

In Agora:

  1. If you haven’t already, sign-up for an Agora account, or log-in

  2. Navigate to the Okta Settings page within Agora (Settings > Organization > Security > Okta SSO)

  3. Copy the Company ID from the top of the settings page in Agora, and paste it into the Company ID field in Okta

  4. In Okta, click Done

  5. In Okta, navigate to the Sign-On tab

  6. Copy both the Client ID and the Client Secret from Okta and paste it into the Okta SSO settings page in Agora.

  7. In Agora, type the URL of your Okta Sign-In portal in the Issuer URL. For example, if your domain is https://acme.okta.com, you would type https://acme.okta.com into the Issuer URL field.

  8. In Agora, click Save

Your Okta SSO integration for Agora should now be setup, with visual confirmation after Saving your settings.

Agora (Service Provider) Initiated SSO

In order to log in using Okta SSO directly from Agora:

  1. Visit https://app.getagora.com/login

  2. Click on the "Sign in with SSO" button

  3. Enter the email of the account you are trying to log in to, for example [email protected]

  4. Click "Sign in"

  5. You will then be redirected to Okta to sign in (if already signed in to Okta, this step may be transparent).

  6. You will then be redirected back to Okta and be signed in to your account

Notes

  • Okta SSO will be enforced after the first successful login using Okta. After you have successfully setup the integration you’ll want to log out of Agora and log back in via Okta

  • If any of the Okta configuration parameters are changed, you’ll need to log out and log back in using Okta to ensure Okta SSO is enforced

  • Once Okta SSO is setup and enforced via the first successful login, it will be the only way users will be allowed to sign-in to Agora

  • To give Agora access to additional users

    • In Okta:

      • Give the user access to the Agora tile via Okta

    • In Agora

      • Create the user in Agora by going to Settings > Organization > Users utilizing the same email they have setup for Okta.

      • During account creation select the permission group to determine the level of access the new user will have

    • Once accounts in both systems have been setup, they can login to Agora using only their Okta account.

  • Please contact Agora support via the chat bubble in the bottom-right corner of the platform if you run into any issues or errors

Did this answer your question?