Skip to main content

 

 
8x8 Support

Configuring Okta SAML 2.0 SSO for Admin Console

Objective

To configure Okta SAML 2.0 SSO for 8x8 Admin Console.

Applies To

  • Admin Console
  • Okta
  • SSO

Procedure

This is a basic configuration walkthrough for Okta and 8x8 Admin Console, to provide Okta SAML SSO login for 8x8 Work users.

Note-Icon.png

Note: If your 8x8 Work account is on the Account Manager platform, see Configuring Okta SAML 2.0 SSO for 8x8 Work Account Manager.

Add the 8x8 SAML Application in Okta

Okta administrators will need to configure their Okta account for 8x8 SSO before completing changes in 8x8 Admin Console.

  1. Open the Okta Admin portal.
  2. Click the Applications menu and select Applications.
  3. Click Add Application.
    Okta_CM_Add_Application1-350x223.jpg
  4. Search for 8x8 Inc and click Add.
    Okta_CM_Add_Application2a-350x172.jpg
  5. In General Settings, click Done.

Add Users to the 8x8 Inc Application

  1. If needed, click the Applications menu to see your installed applications, then click 8x8 Inc to open that application.
    Okta_CM_8x8_Application-400x216.jpg
  2. Click the Assignments tab.
  3. Click the Assign drop-down and select Assign to People.
    Okta_CM_Assignments1-300x258.jpg
  4. Click Assign for each individual user you are providing access to 8x8 Work.
    Okta_CM_Assignments2-400x163.jpg
  5. Click Done.

Obtain Your Okta SAML SSO Configuration Info

Follow these steps to gather information for required changes in 8x8 Admin Console.

  1. If needed, first click the Applications menu to see your installed applications, then click 8x8 Inc to open that application.
    Okta_CM_8x8_Application-450x243.jpg
  2. Click the Sign On tab.
    Okta_CM_Applications_SignOn1a-250x183.jpg
  3. Scroll down to Sign On Methods > SAML 2.0 and click View Setup Instructions. This will pop open a new browser tab with Okta's document How to Configure SAML 2.0 for 8x8 Inc.
    Okta_CM_Applications_SignOn1b-500x126.jpg
Note-Icon.png

Note: If the View Setup Instructions option does not appear in this view, switch your Okta from Developer Console to Classic UI mode at the top-left of the screen, and then follow these instructions again.

clipboard_ec458867de03bc1b3e165c5d273326053.png

  1. Scroll down to step Step 7 of Okta's configuration document.
  2. You'll need the information below to Configure Okta Access in Admin Console instead of Account Manager.
    • Copy and paste the Sign In URL into any text editor (or just keep your browser tab open for later). You'll use this information in the next section.
    • Copy and paste the Issuer URL as above.
    • Click the Identity Provider Certificate URL and save your okta.cert certificate file to a known location.Okta_CM_Config_Step7a.jpg

Configure Okta Access

  1. Log in to Admin Console and navigate to Home > 8x8 Work > Identity Management.
    Okta_CM_Identiy_Management-600x346.jpg
  2. In Authentication methods > Login options, select one of the two Single Sign On options:
    • Both 8x8 username and Single Sign On allows your 8x8 users to log in using either their 8x8 credentials or their Okta credentials.
    • Only Single Sign On forces your 8x8 user to log in to their 8x8 extension using only Okta credentials.
      Configuring Okta SSO in VO CM.jpg
  3. Under Okta SAML settings, do the following:
    • Paste the Okta Sign In URL you copied earlier into the Configuration Manager IDP Login URL area.
    • Paste the Okta Issuer URL you copied earlier into the Configuration Manager IDP Issuer URL area.
  4. Click the attachment field to upload a certificate, select the certificate file you downloaded earlier, and click Open.
    Copy the 8x8 URL and 8x8 API Token from Okta User Provisioning to your Okta application.
  5. Click Save. Okta users will now be able to use the Single Sign On option to log in to 8x8 8x8 Work Desktop.
  • Was this article helpful?