Okta Configuration Guide (Okta Custom Application)

Supported Features

  • This configuration method allows for custom mappings in Okta to the MyInterskill custom information fields.
  • Single Sign-On (OpenID Connect) initiated via Okta.
  • Connect existing users to their Okta accounts, or create new users on initial Okta authentication.
  • Users that have active Okta authentication sessions, will bypass the MyInterskill LMS login screen, be automatically authenticated and will be directed to the home page of the MyInterskill LMS.

Prerequisites

You must already have a MyInterskill company account with Okta single sign-on enabled (currently only available with an Enterprise License).

Configuration Steps

  1. In your Okta admin area, navigate to the Applications page and click Create App Integration.
  2. In the Create a new app integration dialog, select OIDC – OpenID Connect as the Sign-in method, then select Web Application as the application type, and click Next.
  3. On the New Web App Integration page, give the app a name (for example, MyInterskill LMS) and add a logo. You can use this logo.
  4. Under Assignments, set the Controlled access as you desire.
  5. Leave the other fields as they are for now, and click Save.
  6. You should now see your new Okta application settings. If you named the Application MyInterskill LMS, this is what you should see at the top of the screen. For example:
  1. On the General tab, note the values of Client ID and Client secret (click the eye button to toggle the visibility).
  2. Note the URL of your Okta account (this should look something like https://companyname.okta.com. Do not include the ‘-admin’ suffix).
  3. Decide how you’ll match your Okta users to your existing MyInterskill users. The options are:
    • Okta email to LMS email
    • Okta email to LMS login ID
    • Okta subject ID to LMS login ID
  4. In your MyInterskill account, go to Help > Contact a Learning Consultant and click on the email address of your learning consultant.
  5. Email your learning consultant with the following details:
    • Subject: Request for Okta Integration
    • Your company name
    • Client ID (from step 7)
    • Client secret (from step 7)
    • Your Okta URL (from step 8)
    • Your desired method for matching users (from step 9)
  6. Your learning consultant will provide you with the following details to complete the integration.
    • Sign-in redirect URI
    • Initiate login URI
  7. In Okta, return to the Applications page, click on the MyInterskill LMS application (or your new application if you used a different name) and navigate to the General tab.
  8. In the General Settings section, click the Edit button to the right.
  9. Under the Login section, fill the relevant fields with the information you received from your learning consultant. For example:
  1. Remove any domains from the Sign-out redirect URIs section.
  2. Save your settings, and test your integration.

Troubleshooting and Tips

There are a number of reasons why a user’s login attempt may fail. However for security purposes, the reason will not be known to the user. If a user is unable to login, submit a support case and provide them with the user’s details so we can help you troubleshoot.