Okta

How to Configure SAML 2.0 for RingCentral

    Contents


    Supported Features

    The Okta/RingCentral SAML integration currently supports the following features:

    For more information on the listed features, visit the Okta Glossary.


    Configuration Steps

    1. Login to RingCentral as as administrator.

    2. Navigate to Tools > Single Sign-on:

      ringcentral_new_1.png

    3. In the Set up SSO by yourself section, click Edit:

      ringcentral_new_a.png

    4. Use the link below to download and save your IdP Metadata file:

      Sign into the Okta Admin dashboard to generate this value.

    5. In the Upload IdP Metadata section, select Upload with file from the dropdown menu, then click Browse to locate and update the metadata file you just saved (step 4):

      ringcentralc.png

    6. In the Attribute Mapping section, select Custom from the Map Email Attribute to dropdown menu, then enter email in the field that appears:

      ringcentral_new_b.png

    7. Click Save:

      ringcentralf.png

    8. In the Set up SSO by yourself section, click Download to obtain your SP metadata:

      ringcentral_new_c.png

    9. Open the SP metadata file you just downloaded in a text editor and take note of the entityID and Location values,

      ringcentralj.png

    10. In Okta, select the Sign On tab for the RingCentral app, then click Edit:

      • Default Relay State: Enter: https://service.ringcentral.com/mobile/ssoLogin.

      • Audience Restriction: Copy the entityID value from the metadata file (step 11) into this field.

      • ASC URL: Copy the Location value from the metadata file (step 11) into this field.

      • Click Save:

      ringcentralh.png

    11. Go back to Single Sign-on (SSO) in RingCentral, then follow the steps below:

      • Check Enable SSO Service.

      • Manage Your Login: Select your login type.

      • Click Save:

      ringcentral_new_d.png

    12. Done!


    Notes

    The following SAML attributes are supported:

    SP-initiated SSO

    1. Go to https://service.ringcentral.com/login/startupSSOLogin.html.

    2. Enter your email address.
    3. Click Submit.
    4. ringcentrali.png