Configuring SAML for 8x8

This topic describes how to configure OneLogin to provide SSO for 8x8 using SAML. 

Setting Up SSO in OneLogin

1. Go to to Apps > Add Apps.
2. Search for 8x8 and select it.
   
   You can edit the Display Name.
3. Under Connectors select SAML2.0.
4. Click Save to display additional tabs.
5. Select the Parameters tab map 8x8 user attributes to OneLogin attributes.
1. Ensure that Credentials are Configured by admin.
2. Default mappings for SSO are as follows:
   NameID (Subject) -> Email
6. Select the SSO tab and copy the SAML Issuer URL and SAML2.0 Endpoint (HTTP) URL which you will provide to 8x8.
7. Click View Details to access your X.509 certificate information.
8. Select .PEM and then click Download to acquire your certificate file which you will also provide to 8x8.

Setting up SSO in 8x8

1. Log in to the 8x8 administrator dashboard.

2. Go to Accounts > Single Sign On > SAML Config to configure SAML SSO.

   1. In the Sign In URL field, enter your SAML HTTP Endpoint URL.

   2. In the Issuer URL field, enter your SAML Issuer URL. 

   3. Click Upload and select your X.509 certificate.pem file.

3.  Click Save.

OneLogin and 8x8 should now be connected through SAML.

Troubleshooting Email Mismatch

In some cases, the 8x8 admin email may not match the OneLogin admin email. This can be remedied by doing the following:

1. Go to Users > Account_Owner.
2. Select the Applications tab.
3. Select 8x8 to open the Edit Login pane.
4. Overwrite the default 8x8 login fields with the correct credentials.