Skip to main content

Configure Okta OpenId Connect (OIDC)

Okta's OpenID Connect (OIDC) is an authentication protocol that sits on top of the OAuth 2.0 framework, strengthening the predictability and security of connections with third-party applications. You can configure Okta OIDC as your preferred authentication method in your Tonkean board, enabling Okta SSO as the sole sign-in method for your organization.

Tonkean currently supports service provider-initiated authentication (SSO) flow only.

Prerequisites

Set Okta as the Preferred Authentication

  1. In Tonkean, select your profile icon in the upper right.

    select_profile_icon.png
  2. Select the <Enterprise Name> Administration in the dropdown. The Enterprise Administration screen displays.

    enterprise_administration_select.png
  3. Locate the Preferred authentication method section and select No restrictions.

    ent_admin_no_restrictions_select.png
  4. Select Authenticate with, then select Okta from the dropdown. Okta authentication fields display.

    preferred_auth_auth_w_okta.png
  5. Enter the Okta environment URL for your organization, as well as the Client ID and Client Secret, all retrieved from your Okta application.

    preferred_auth_okta_fields.png
  6. Enter the email domains for your organization to route them directly to the authentication URL.

    secure_email_domains.png
  7. When finished, select Save. The Okta authentication fields close.

Sign in Using Okta SSO

After setting Okta as the preferred authentication method for your organization, all users at your organization must select the Okta SSO option on the Tonkean Sign In screen:

  1. Select Okta. The Login with Okta screen displays.

    sing_in_okta.png
  2. Enter the work email and select Login. Your email is validated and you are logged into Tonkean using Okta OIDC.

    email_login_okta.png

    Alternatively, you can select Manually enter the authentication domain to log in:

    sing_in_okta_domain.png

    Enter your Okta login credentials and sign in to Tonkean