Skip to main content
Configuring Okta SAML 2.0 SSO for Virtual Office Configuration Manager
8x8 Support

Configuring Okta SAML 2.0 SSO for Virtual Office Configuration Manager

Objective

To configure Okta SAML 2.0 SSO for Virtual Office Configuration Manager.

Applies To

  • Configuration Manager
  • Okta
  • SSO

Procedure

This is a basic configuration walkthrough for Okta and the 8x8 Virtual Office Configuration Manager, to provide Okta SAML SSO login for 8x8 Virtual Office users.

Note: If your 8x8 Virtual Office account is on the Account Manager platform, see Configuring Okta SAML 2.0 SSO for Virtual Office 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 Virtual Office (VO) Configuration Manager.

  1. Open the Okta Admin portal.
  2. Click the Applications menu and select Applications.
  3. Click Add Application.
  4. Search for 8x8 Inc and click Add.
  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.
  2. Click the Assignments tab.
  3. Click the Assign drop-down and select Assign to People.
  4. Click Assign for each individual user you are providing access to 8x8 Virtual Office.
  5. Click Done.

Obtain Your Okta SAML SSO Configuration Info

Follow these steps to gather information for required changes in VO Configuration Manager.

  1. If needed, first click the Applications menu to see your installed applications, then click 8x8 Inc to open that application.
  2. Click the Sign On tab.
  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.

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 VO Configuration Manager 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.

Configure Okta Access

  1. Log in to VO Configuration Manager and navigate to Home > Virtual Office > Identity Management.
  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 Virtual Office Desktop.