Google Workspace Single Sign-On via SAML

  • Updated

Using Security Assertion Markup Language (SAML), your users can use their Google Cloud credentials to sign into Dialpad.

As the Administrator, you'll need to configure a few things to make it work, including:

  1. Set up the selected application as a SAML service provider (SP).
  2. Set up Google Workspace as a SAML identity provider (IdP).
  3. Enter application-specific service provider details in Google Admin console.
  4. Turn on single sign-on (SSO) for the application.
  5. Verify that the SSO is working.

Let's take a closer look at the steps involved, starting with setting up Dialpad as a SAML 2.0 Service Provider.

Set up Dialpad as a SAML 2.0 Service Provider (SP)

  1. From the Admin console dashboard, go to Security > Set up single sign-on (SSO). To see Security, you might have to click More controls at the bottom. 

  2. Copy the SSO URL and the Entity ID (Issuer ID).

  3. Click the Download button to download the X.509 Certificate.

  4. Open a new incognito browser window.

  5. Go to https://dialpad.com/authentication/saml.

  6. Enter the IDP SSO URL and Entity ID in the appropriate fields.

  7. Paste the copied X.509 Certificate into the box.

    Note: Remove “BEGIN” and “END CERTIFICATE” from the copied X.509 certificate text.

  8. Click Save and proceed to the next section to set up Google Workspace as a SAML identity provider (IdP).

Screen_Shot_2018-12-03_at_6.58.19_AM.png

Set up Google Workspace as a SAML Identity Provider (IdP)

  1. From the Admin console dashboard, go to Apps > SAML Apps. To see Apps on the dashboard, you might have to click More controls at the bottom. 

  2. Select the Add a service/App to your domain link or click the plus (+) icon in the bottom corner.

  3. Select the Dialpad item from the list. The values on the Google IDP Information page automatically populate.

  4. In the Basic application information window, the Application name and Description values automatically populate. You can edit them.

  5. (Optional) Click Choose file next to the Upload Logo field to upload a PNG or GIF file to serve as an icon. The file size should be 256 pixels square.

  6. Click Next.

image__1_.png

image__8_.png

Add Dialpad specific Provider Details in Google Workspace Admin Console

  1. In the Service Provider Details section, enter the following URLs into the Entity ID, ACS URL, and Start URL fields:

            ACS URL: https://dialpad.com/saml/sso/google/your-domain.com
            Entity ID: https://dialpad.com/api/saml/metadata/google/your-domain.com
            Start URL: https://dialpad.com

  2. Leave Signed Response unchecked.

    When the Signed Response checkbox is unchecked, only the assertion is signed. When the Signed Response checkbox is checked, the entire response is signed.

  3. The default Name ID is the primary email. Multi-value input is not supported. You can change the Name ID mapping as per your requirement. Custom attributes of the user schema can also be used after creating them via Google Admin SDK APIs. The custom attributes for the user schema need to be created prior to setting up the Dialpad SAML application. 

  4. The NameID Format field should be Transient.

  5. Click Next.

  6. Under Attribute mapping, first select the Category as Basic Information from the drop-down list and then choose a User attribute to map the attribute from the Google Workspace profile. You must provide the "Primary Email" [Email], "First Name" [FirstName], and "Last Name" [LastName] attributes.

  7. Click Finish.

image__3_.png

image__4_.png

Turn on SSO for your Dialpad app

  1. From the Admin console dashboard, go to Apps > SAML Apps. To see Apps on the dashboard, you might have to click More controls at the bottom. 

  2. Select Dialpad.

  3. At the top of the gray box, click More Settingsand choose:

    • On for everyone to turn on the service for all users (click again to confirm).
    • Off to turn off the service for all users (click again to confirm).
    • On for some organizations to change the setting only for some users.

  4. For Dialpad, choose On for everyone. Ensure that your Dialpad user account email IDs match those in your Google Workspace domain.

image__9_.png

image__10_.png

Verify SSO is working between Google Workspace and Dialpad

  1. Open https://dialpad.com/saml/login/google/your-domain.com.
    You’ll be redirected to https://dialpad.com but you’ll still be logged out.

  2. Navigate to https://dialpad.com and you should be logged in.

  3. After your sign-in credentials are authenticated you will be automatically redirected back to Dialpad.