Skip to main content

 

 
8x8 Support

Configuring OneLogin SAML 2.0 SSO for Admin Console

Objective

Configuration of OneLogin and 8x8 Admin Console for SAML 2.0 SSO user login.

Important-Icon.png

At this time, OneLogin active user sync (SCIM) to 8x8 is not supported.  

Applies To

  • OneLogin identity management
  • 8x8 Admin Console
  • SAML 2.0 SSO

Procedure

You'll need to perform the following as an admin of both OneLogin and 8x8 Configuration Manager:

  • Add the 8x8 Application to OneLogin
  • Set Up Identity Management in 8x8 Admin Console
  • Configure a User in Admin Consoler for SSO Login
  • 8x8 Work for Desktop SSO Login Process

Add the 8x8 Application to OneLogin

To begin, you'll need to add the 8x8 application to your OneLogin configuration.

  1. From Applications in OneLogin, click Add App.

clipboard_ebe80e800e6c2cd8a29e5f524deb1bda5.png

  1. Find and click on the 8x8 (SAML 2.0, form-based auth).

clipboard_e5c20a9318b5f47f0acc8364c369a6ba0.png

  1. In App Listing > Configuration, you can change the Display Name for the app, if needed.

clipboard_ebb147e8e578eb2b2b9b64c610e516bc1.png

  1. Scroll down to the bottom of the same App Listing page and confirm that Connectors is set to SAML 2.0.

clipboard_ee889a528538e2dc96491113fd601f923.png

  1. Scroll back to the top and click Save.
  2. More options will be displayed for the 8x8 app after saving. Click SSO.

clipboard_ea71580893f086ef9b2bb5f1dcbcdd639.png

  1. Copy the URLs from the following fields (or return to this window later). You’ll need them later, during configuration of your 8x8 Configuration Manager account.
    • Issuer URL
    • SAML 2.0 Endpoint (HTTP)
    • SLO Endpoint (HTTP)
  2. Then click on View Details for your certificate, or right-click on the link and select Open link in a new tab.
    • If you already have your OneLogin certificate in PEM format, you can skip this part. Either way, you'll need your certificate file later.

clipboard_e4fac1628209247b62912702d7df94d17.png

  1. If needed, scroll down the Certificates page and select the appropriate PEM-formatted certificate, and click Download.
  2. Save your certificate for later upload to 8x8 Admin Console.

clipboard_e747e63132bd55b390b363af7b210e73c.png

Note-Icon.png

Next, you'll add the new 8x8 app to users, to allow them access to 8x8 applications that require authentication.

If this procedure is performed using some other method in OneLogin – such as bulk edit or Roles – you can ignore these next steps, and perform that operation instead.

  1. Click on Users. For single users, select a user and click the plus sign icon clipboard_e928df21922c0f253bd7f4d1fb6f0eb32.png.

clipboard_edf12639a15d6ca5a19b9474f43f44a76.png

  1. Select the 8x8 application you just added, above, and click Continue.

clipboard_ed7444393bd4a5873b77442c5e0238aa5.png

  1. Make a note of the NameID and click Save.
    • The user's NameID will need to be applied to the specific 8x8 user profile in 8x8 Admin Console, which is covered later in this article.

clipboard_e798ccc444f8483eeb084b8b2a45bc144.png

  1. You should now see the 8x8 application assigned to the user you’ve modified. Click Save User.
  2. Continue with the next steps below to make the required changes to your 8x8 Admin Console account.

clipboard_e3217323484fa3d7d3b325a2010249ae2.png

Set Up Identity Management in 8x8 Admin Console

Next, you'll configure your 8x8 account to allow the use of your OneLogin SSO service.

  1. From https://admin.8x8.com/, log into the 8x8 Admin Console.
  2. From Home, click on Identity Management.

clipboard_e191870799088279818a8447604ae322e.png

  1. Click the check box for Single Sign-On (SSO) to enable it.
    • Note that 8x8 supports only one ID management app per account.
  2. Un-check the 8x8 Username and Password check box only if you want to prevent users from authenticating with 8x8 Work credentials.
    • Doing this will allow only the SAML SSO identity provider credentials to be used.
    • Keep the 8x8 Username and Password check box checked if users should be allowed to use both authentication methods.
  3. Select Other SAML SSO Provider. The screen will expand with more configuration options.

clipboard_e12043d6ddd47c10458b7c00389420c07.png


Now you simply need to fill in the blanks with the information you collected earlier, and upload your OneLogin certificate.

  1. In SAML SSO Provider Information > SAML SSO Provider Name, enter a label you want for this SSO provider. 
  2. Match the 8x8 fields with the OneLogin URL information you collected earlier, and add the OneLogin URLs into the appropriate fields in SAML Settings.

8x8                                     OneLogin
IDP Login URL             >    SAML 2.0 Endpoint (HTTP)
IDP Issuer URL/URN   >    Issuer URL
IDP Logout URL           >    SLO Endpoint (HTTP)

  1. In Certificate in use, click on Click to attach a certificate file and choose the OneLogin certificate you downloaded earlier. The file name of the certificate will appear in the field.
    • Note that this field requires a file extension other than .pem. If needed, simply rename the pem file extension to .cert before you upload the file.

clipboard_e88cd7f84f85cd4dfa0911724d920dda0.png

  1. Finally, click Save at the bottom of the page. You should see a green confirmation banner for a few seconds at the top of the screen.

clipboard_ed1c6d8914ce0f0a31f90499dc369f9eb.png

  1. Continue with the next steps below to make the necessary changes to your 8x8 users in Configuration Manager.
Important-Icon.png

Important note: If after saving you find that you’ve made a mistake with the certificate, just un-check the Single Sign-On (SSO) check box and click Save to clear out the SSO information. Then follow the above process again with the correct information.

The URLs can be edited without clearing the entire SSO configuration.

Configure a User in 8x8 Admin Console for SSO Login

This is a very quick process for an 8x8 user's login configuration.

  1. In 8x8 Admin Console, click on Home > Users.

clipboard_e9806958086890451093700801748b269.png

  1. Search for the user you’re configuring, and click the pencil icon clipboard_e118c2606c558654c53225afb29f8287d.png to edit the user.

clipboard_eb34f508da0f21197aac401f90b9f06cb.png

  1. Scroll down to Single Sign-On (SSO) and add the user’s OneLogin NameID to the Federation ID field.
    • Note: This field only appears after an identity provider is configured in Identity Management.
  2. Click Save.

clipboard_e785dd955bc1229419d11cb3a07773164.png

  1. You should then see a green confirmation banner at the top of the screen for a few seconds.

clipboard_ec87eb42216dcdf2000cfd8e20189fdbe.png

Note-Icon.png

This completes the 8x8 Admin Console configuration of OneLogin.

Your configured user(s) should now be able to log into 8x8 applications such as Work for Desktop.

A brief example of the login process is shown, below.

8x8 Work for Desktop SSO Login Process

This login process may vary, depending on the OneLogin administrator’s configuration of that service.

  1. First, launch 8x8 Work for Desktop on your PC.

clipboard_e0c6c0f5768f1ec8b3f269422da301b6b.png

  1. Enter the OneLogin NameID of the assigned user into the 8x8 Username or Email field and click Continue.

clipboard_e290d06ae0a17b68df4e09b1239eea070.png

  1. Click Log in using SSO.

clipboard_e859e99a25c13f5db2f742d4df59d170f.png

  1. In the OneLogin Username field, enter the NameID of the assigned user.

clipboard_efec2d4828563b5143c6b8b0b6b6f5efc.png

  1. Enter the user’s OneLogin Password and click Continue.

clipboard_e1d820c6cedbe7f3b848fa853a5b21d0d.png

  1. This will complete the login to 8x8 Work for Desktop.

clipboard_ea2ac2a47c3d17fba08f9042c212335d4.png

Note-Icon.png

Other login options and login persistence may be available depending on the OneLogin administrator’s configuration of that service.

Login Issues

Invalid SAML Profile

If users receive the error Invalid SAML profile error: No valid certificate found when attempting to log in to an 8x8 app, the OneLogin certificate applied to the SSO setup in 8x8 Configuration Manager probably included a non-PEM certificate, or a certificate was simply not added.

clipboard_ef61d96e5f756912d25fb4e3aba1d5765.png

In this case, the SSO configuration must be deleted and re-applied with the correct certificate.

Or if the certificate was never added, simply add it to the 8x8 SSO configuration, and save the configuration again.

The OneLogin X.509 PEM certificate seems to work best with this service.

clipboard_e747e63132bd55b390b363af7b210e73c.png

We could not verify your SSO account

If users see this error when attempting to log in, the configuration in either OneLogin or 8x8 Admin Console could be incorrect, and should be reviewed and corrected as needed.

If the applications are correctly configured, then the 8x8 user profile in Admin Console is not configured correctly.

  • We could not verify your SSO account. Please contact your 8x8 administrator.

clipboard_eb636e8282137798bd37c25906228cc9b.png

To correct the user configuration issue, verify that the Admin Console user profile in Home > Users has the correct OneLogin NameID applied to the Single Sign-On > Federation ID field.

clipboard_e6c0d7dc2d0f3fef63b695bab80962991.png

  • Was this article helpful?