Adding Zendesk to Your PingOne for Enterprise Dock
Add the Zendesk application to your PingOne for Enterprise dock from the application catalog.
Steps
-
In the PingOne for Enterprise admin console, go to Applications → Application Catalog.
-
Optional: In the Search field, search for the application.
-
Click the Zendesk application line to expand it, and then click Setup.
-
On the SSO Instructions tab, click Download to download the PingOne for Enterprise signing certificate.
-
In the Zendesk admin console, click the Zendesk Products icon, then click Admin Center.
-
Click the Security icon, then click the Single sign-on tab.
-
Click Configure.
-
In the single sign-on (SSO) configuration form, enter the following information.
Field Action SAML SSO URL (Required)
https://sso.connect.pingidentity.com/sso/idp/SSO.saml2?idpid=<your IdP ID value>Certificate fingerprint (Required)
Enter the certificate fingerprint for your signing certificate.
To obtain the certificate fingerprint, in PingOne for Enterprise, go to Setup → Certificates, and expand the line for your signing certificate. PingOne for Enterprise displays both the SHA1 Fingerprint and SHA256 Fingerprint values.
Remote logout URL (Optional)
https://sso.connect.pingidentity.com/sso/terminatesession?page=https://<URL to redirect users to>IP Ranges (Optional)
Enter a range of IP addresses to restrict SSO to those locations. Users requesting sign on from outside those locations will be redirected to the Zendesk sign-on page.
Leave this field blank to allow SSO from any location.
-
Click Enabled
-
Click Save.
Next steps
In PingOne for Enterprise, click Continue to Next Step.
Zendesk Connection Configuration
Steps
-
Import the metadata for Zendesk:
Choose from:
-
Click Select File to upload the metadata file.
-
Click Or use URL to enter the URL of the metadata.
-
-
In the ACS URL and Entity ID fields, replace the ${accountname} variables with the your Zendesk account name.
-
In the Target Resource field, enter a URL to redirect the user to after IdP-initiated single sign-on (SSO).
-
In the Single Logout Endpoint field, enter a URL for PingOne for Enterprise to send single logout (SLO) requests to.
-
In the Single Logout Response Endpoint field, enter a URL for PingOne for Enterprise to send SLO responses to.
-
To add a Primary Verification Certificate, click Browse to locate and upload a local certificate file used to verify SLO requests and responses coming from Zendesk.
-
To add a Secondary Verification Certificate, click Browse to locate and upload a local certificate used to verify SLO requests and responses if the primary certificate fails.
-
Select the Force Re-authentication check box to require your identity bridge to re-authenticate users with an active SSO session.
-
Select Pass-Thru RequestedAuthnContext to IdP if you want PingOne for Enterprise to pass the
RequestedAuthnContextrequest to the IdP for your account.This option is available only if you upload a primary verification certificate.
-
Select the Encrypt Assertion check box to encrypt outgoing SAML assertions.
-
On the Signing line:
Choose from:
-
Click Sign Assertion to have PingOne for Enterprise sign outgoing SAML assertions. This is the default option.
-
Click Sign Response to have PingOne for Enterprise sign responses to incoming SAML assertions.
-
-
In the Signing Algorithm list, select an algorithm with which to sign SAML assertions.
-
Select the Use Custom URL check box to enter a customer URL to launch Zendesk from the dock.
Next steps
Click Continue to Next Step.
Zendesk Attribute Mapping
About this task
PingOne for Enterprise will automatically populate required SAML attributes.
For Zendesk, the required attribute is SAML_SUBJECT.
Steps
-
To add an additional optional attribute, click Add new attribute.
-
In the Application Attribute field, enter the attribute name as it appears in the application.
-
In the Identity Bridge Attribute or Literal Value field, choose one of the following:
Choose from:
-
To map to the application attribute: Enter or select a directory attribute.
-
To assign to the application attribute: Select As Literal, then enter a literal value.
-
-
To create advanced attribute mappings, click Advanced.
For more information, see Create advanced attribute mappings.
Next steps
Click Continue to Next Step.
Zendesk Customization
Steps
-
To change the application icon, click Select image and upload a local image file.
The image file must be:
-
PNG, GIF, or JPG format
-
312 x 52 pixels maximum
-
2 MB maximum file size
Images are scaled to 64 x 64 pixels for display.
-
-
To change the name of the application displayed on the dock, in the Name field, enter a new name.
-
To change the description of the application, in the Description field, enter the new description text.
-
To change the category to which the application is assigned on the dock, in the Category list, select a category.
For information about creating custom application categories, see Creating a custom application category.
Next steps
Click Continue to Next Step.
Zendesk Group Access
About this task
The Group Access tab shows every user group that you have created.
For more information about creating user groups, see Add user groups.
Steps
-
To add a group’s access to the application, on the line for that group, click Add.
-
To remove a group’s access, on the line for that group, click Remove.
-
When you’re finished assigning groups, click Continue to Next Step.
Next steps
On the Review Setup tab, review your configuration, and click Finish to add the application to your PingOne for Enterprise dock.