Okta SSO Setup Guide

Learn how to integrate Okta single sign-on (SSO) for your Trainual account logins.



Trainual connects with Okta so your team can sign in once, stay secure, and get straight to work without juggling yet another username and password. 



πŸ‘‰ Before you start:

  • SSO integrations are only available under select Trainual subscriptions. If needed, reach out to our support team directly to see if your plan qualifies. πŸ“§
  • You will need an Admin+ permission level in Trainual and an administrative access level in your Okta platform to set up this integration. 
  • You must add users to your Trainual account for them to actively use SSO.

Overview

SSO logins make accessing Trainual simple and secure. With SSO integrations...

  • πŸ›‘οΈ Your company's knowledge has an extra layer of protection.
  • πŸ”‘ Sign-ins are quick and hassle-free for everyone.
  • πŸ§‘β€πŸ’» You can expect fewer password reset headaches (IT will thank you.)
  • πŸ™Œ Password fatigue is lessened.

Integration setups may seem intimidating, but everything here is broken down step by step so you can feel confident no matter your technical skill level.


Okta web setup:

Use this five-step Okta guide to begin setting up this SSO for your Trainual account.


πŸ”Ή Step 1
β†’ Connect Trainual as a new application from your Okta dashboard.

  1. Log in to your Okta "Admin Console."
  2. Expand the "Applications" option from the left-hand navigation menu.

  3. Open "Applications."

  4. Hit the β€œCreate App Integration” button. 

  5. Take the following actions in the "Create a new app integration" window:

    • Select β€œOIDC - OpenID Connect” as the sign-on method.

    • Choose β€œNative Application” as the application type.

  6. Click theβ€œNext” button to proceed. 


πŸ”Ή Step 2 β†’ Configure your app intergration's general settings.

  1. Input β€œTrainual” (or something identifiable) as your "App integration name."

  2. Select the following grant types:
    • "Authorization Code."
    • "Refresh Token." βœ…


πŸ”Ή Step 3
 β†’ Configure your app intergration's sign-in and sign-out redirect URIs

  1. Add the following redirect scheme into the "Sign-in redirect URIs" line:
    • com.trainual.okta:/callback
  2. Add the following redirect scheme into the "Sign-out redirect URIs" line:
    • com.trainual.okta:/

πŸ“ Please note: If your Trainual account uses a custom domain, be sure to add that additional redirect under "Sign-in redirect URIs."

Example: https://app.YOURCUSTOMDOMAIN.com/users/auth/oktaoauth/callback

πŸ”Ή Step 4 β†’ Decide who gets access under assignments

  1. Choose who can access the app under "Controlled access":
    • "Allow everyone in your organization to access."
      • If this option is selected, also check the "Enable immediate access: Enable immediate access with Federation Broker Mode" setting. 
    • "Limit access to selected groups."


πŸ”Ή Step 5 β†’ Save and finalize the Okta steps for your newly added app. 

  1. Click the "Save" button.
  2. Stay on your app’s "Client Credentialsredirect page and open Trainual in a new browser tab (this information is needed for the Trainual set up steps.)

πŸ‘· Trouble? If setup fails, restart all steps and verify your client secret is correct.

 


Trainual Okta web setup:

Next, you'll need to connect the Okta integration inside Trainual.

  1. Expand the "Marketplaces" options from the left-hand navigation menu.
  2. Select "Integrations."
  3. Search for and open β€œOkta.”
  4. Click the "Connect for web” button.
  5. Copy over the client ID, client secret, and Okta domain from your open Okta tab and paste them into the matching fields in Trainual.


  6. *Optional: Customize your "Sign in" button text. 
  7. Hit the β€œConnect” button to integrate.

πŸ“ Please note: You’ll know that Okta has been successfully connected when you see this green confirmation on the Okta Trainual integration page.


Trainual Okta mobile setup:

Want to enable Okta SSO on mobile too? Here’s how to connect that in Trainual.

  1. Expand the "Marketplaces" options from the left-hand navigation menu.
  2. Select "Integrations."
  3. Search for and open β€œOkta.”
  4. Click the "Connect for mobile” button.
  5. Copy over the client ID and issuer URI from your open Okta tab and paste them into the matching fields in Trainual.



  6. Hit the β€œConnect” button to integrate.


πŸ“ Please note: To find your Okta issuer URI for the instructions above, simply...

  1. Log in to your Okta "Admin Console."
  2. Expand the "Security" option from the left-hand navigation menu.

  3. Open "API."

  4. Copy your "Issuer URI" from the "Authorization Servers" tab.




Test your Okta web SSO:

Use these steps to log into Trainual with Okta web for the first time.

  1. Sign out of your Trainual web app and stay on the login page.

  2. Look for and click on the β€œSign in with Okta” button.

  3. Authenticate your Okta credentials for your first use to sign back in.

πŸ“ Please note: If you don’t see the Okta icon, clear your browser history and refresh the page. Once completed, you’ll be signed in with Okta on future visits.


Test your Okta mobile SSO:

Use these steps to log into Trainual with Okta mobile for the first time.

  1. Sign out of your Trainual mobile app and stay on the login page.
  2. Use your email on the first sign-in page.
  3. Look for and click on the β€œSign in with Okta” button.
  4. Authenticate your Okta credentials for your first use to sign back in.
πŸ“  Please note: If you don’t see the Okta icon, make sure you have the latest version of the Trainual app. Once completed, you'll be signed in with Okta on future visits.


Add more users to Okta:

Don’t forget to add new teammates to Okta so they can sign in with SSO too.

  1. Log in to your Okta "Admin Console."
  2. Expand the "People" option from the left-hand navigation menu.

  3. Open the "Add person" tab. 

  4. Complete the following fields in the pop-up window
    • Select "User" for the user type. 

    • Enter your user's...

      • First name.

      • Last name.

      • Username (this is the user's email address.)

    • Choose any groups (skip this if you haven’t added groups in Okta).

    • Select "Set by user" for the password.

    • Check the "Send user activation email now" box.

  5. Click "Save" or "Save and Add Another" to apply your changes.



πŸ“ Please note: Users will receive a welcome email from Okta that looks like this...


πŸ“§ The welcome email from Okta includes:

  1. A link to activate Okta.

  2. The user's email address (which will also be their username).

  3. Your organization's direct Trainual sign-in page.

πŸ” Okta activation links expire in 7 days, so make sure passwords are set ASAP.


Enforce SSO login:

Optionally, you can require SSO only sign-ins for your Trainual account.

  1. Expand the "Account" options from the left-hand navigation menu.
  2. Select "Settings."
  3. Locate and toggle on the "Require all users to login with single sign on (SSO)" setting from the "General" tab. 

  4. Hit the "Save" button to apply the account change.


FAQs:


How can I submit my feedback and ideas about features?
If you'd like to share your thoughts about Okta SSO or think of something else you'd like to see added in the future, send us your feature requests and ideas.



Learn more about integrations: 

  • Connect your current HRIS or payroll system for quick teammate info syncing.
  • Easily connect your Trainual account to thousands of other apps with Zapier.
  • Capture knowledge and build training content from Slack.