Zendesk cloud application
You must be signed in as a super administrator for this task.
Using Security Assertion Markup Language (SAML), your users can use their Google Cloud credentials to sign in to enterprise-cloud applications.
Set up SSO via SAML for Zendesk
Here's how to set up Single Sign-On (SSO) via SAML for the Zendesk® application.Step 1: Set up Zendesk as a SAML 2.0 service provider (SP)
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.
- Click the Download button to download the Google IdP metadata and the X.509 Certificate.
- In a new browser tab, log into your Zendesk application as an administrator.
- Select the Admin icon, then select Security from the Settings category.
- Select the Admins & Agents or End-users tab.
- Select the SAML option.
- Copy the Google SSO Login URL from the Zendesk cloud application and paste it into the SAML SSO URL field.
- Filling in the Logout URL field is optional. You can leave it empty.
- Generate the SHA-256 fingerprint from the Google X.509 certificate you downloaded in Step 3.
- Click Save and proceed to the next section to set up Google as a SAML identity provider (IdP).
- In a new browser tab, sign in to your Admin console as a super administrator.
- Click Apps > SAML apps.
- Select the Add a service/App to your domain link or click the plus (+) icon in the bottom corner.
The Enable SSO for SAML Application window opens.
- Select the Zendesk item from the list. The values on the Google IDP Information page automatically populate.
- There are two ways to collect the service provider Setup information:
You can copy the Entity ID and the Single Sign-On URL field values and download the X.509 Certificate, paste them into the appropriate service provider Setup fields, and then click Next
You can download the IDP metadata, upload it into the appropriate service provider Setup fields, and then come back to the admin console and click Next.
- In the Basic application information window, the Application name and Description values automatically populate. You can edit them.
- (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.
- Click Next.
- In the Service Provider Details section, enter the following URLs into the Entity ID, ACS URL, and Start URL fields:
ACS URL: https://your-domain-name.zendesk.com/access/saml
Entity ID: https://your-domain-name.zendesk.com
Start URL: https://your-domain-name.zendesk.com
- 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.
- 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 Zendesk SAML application.
- Click Next.
- Click Add new mapping and map the attribute value "Email" to Basic Information > Primary Email
- In the drop-down list, select the Category and User attribute to map the attribute from the Google profile.
- Click Finish.
- Sign in to your Admin console.
- Go to Apps > SAML apps.
- Select Zendesk.
At the top of the gray box, click More and 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.
- Ensure that your Zendesk user account email IDs match those in your Google domain.
- Close all browser windows.
- Open https://your-domain-name.zendesk.com and attempt to sign in.
You should be automatically redirected to the Google sign-in page.
- Enter your sign-in credentials.
- After your sign-in credentials are authenticated you're automatically redirected back to Zendesk.