Skip to main content
Configuring MS Azure SAML 2.0 SSO for Virtual Office Configuration Manager
8x8 Support Knowledge Base

Configuring MS Azure SAML 2.0 SSO for Virtual Office Configuration Manager

Microsoft Azure administrators will need to configure their Azure AD account for 8x8 SSO before completing changes in Virtual Office (VO) Configuration Manager.

Adding 8x8 Virtual Office from the Gallery

To configure the integration of 8x8 Virtual Office into Azure AD, you need to add 8x8 Virtual Office from the gallery to your list of managed SaaS apps.

1. In the Azure Portal, on the left navigation panel, click Azure Active Directory icon.

AZ portal image 1.png

2. Navigate to Enterprise applications. Then go to All applications.

AZ portal image 2.png

3. To add new application, click New Application button on the top of dialog.

AZ portal image 3.png

4. In the search box, type 8x8 Virtual Office.

AZ portal image 4.png

5. In the results panel, select 8x8 Virtual Office, and then click Add button to add the application.

AZ portal image 5.png

Configuring Azure AD for Single Sign-On

In this section, you enable Azure AD single sign-on in the Azure portal and configure single sign-on in your 8x8 Virtual Office Configuration Manager.

1. In the Azure portal, on the 8x8 Virtual Office application integration page, click Single sign-on.

AZ portal image 6.png

2. On the Single sign-on dialog, select Mode as SAML-based Sign-on to enable single sign-on

AZ portal image 7.png

3. In the 8x8 Virtual Office Domain and URLs section, add https://sso.8x8.com/saml2 to the Identifier and Reply URL fields.

Azure_SSO_Identifier_Reply_URLs.jpg

4. On the SAML Signing Certificate section, click Certificate (Raw) and then save the certificate file on your computer.

AZ portal image 9.png

5. Click Save button.

AZ portal image 10.png

6. On the 8x8 Virtual Office Configuration section, click Configure 8x8 Virtual Office to open Configure sign-on window. Copy the Sign-Out URL, SAML Entity ID and SAML Single Sign-on Service URL from the Quick Reference section.

AZ portal image 11.png

7. Sign-on to your 8x8 Virtual Office Portal as an Administrator

8. Select Virtual Office Config Mgr on the Application Panel.

AZ_portal_image_12.png

9. Select Identity Management under Virtual Office section.

AZ_portal_image_13.png

10. In Identity Managment select Add new SAML provider.

AZ_portal_image_14.png

11. Under Provider Name field type in provider name ie: MS Azure or Azure.

AZ_portal_image_15.png

12. Under Login options make selection Both 8x8 username and Single Sign On, Only Single Sign On or Only 8x8

AZ_portal_image_16.png

Note: Before uploading a certificate and saving it, be sure to convert raw certificates from DER/Binary to standard PEM format!

To convert a certificate to PEM format, you can use the SSL Converter tool at https://www.sslshopper.com/ssl-converter.html

  • Click Browse to upload your raw certificate
  • Type of Current Certificate should be DER/Binary
  • Type to Convert to must be Standard PEM
  • Click Convert Certificate.

AZ_portal_image_18.png

 

13. Copy SAML SSO URL, Single Sign Out Service URL and Issuer URL from Azure AD to the IDP Login URL, IDP Logout URL and IDP Issuer URL/URN fields.

14. Click Upload certificate link to upload certificate file that you downloaded from Azure AD as raw certificate. Once certificate is uploaded click Save.

AZ_portal_image_17.png

Assigning the Azure AD test user

In this section, you enable a user to use Azure Single Sign-On by granting access to 8x8 Virtual Office

AZ portal image 20.png

To assign the user to 8x8 Virtual Office, perform the following steps:

1. In the Azure portal, open the applications view, and then navigate to the directory view and go to Enterprise applications then click All applications.

AZ portal image 21.png

2. In the applications list, select 8x8 Virtual Office.

AZ portal image 22.png

3. In the menu on the left, click Users and groups.

AZ portal image 23.png

4. Click Add button, then select Users and groups on Add Assignment dialog.

AZ portal image 24.png

5. In the Users and groups dialog, select the user in the Users list.

6. Click Select button on Users and groups dialog.

7. Click Assign button on Add Assignment dialog.

Assigning the 8x8 User Federation ID field with the Azure AD userid

1. Log into the 8x8 Configuration Manager portal with the administrator credentials.

2. Click the Users icon under the General section of Configuration Manager.

AZ_portal_image_25.png

3. Select Edit next to the user you would like to assign the Azure AD user profile to.

AZ_portal_image_26.png

4. Navigate to Advanced settings section and click on down arrow to expand it.

AZ_portal_image_27.png

5. Finally, navigate to Single Sign-On (SSO) section and under Federation ID add the Azure AD Userid.

6. Click Save at bottom of page.

AZ_portal_image_28.png

 

  • Was this article helpful?