Guide for Zendesk Single Sign On (SSO) for Drupal 8

Step 1: Configure Single Sign On (SSO) Settings in Zendesk

  • Go to https://www.zendesk.com and Login to your Zendesk domain.
  • Click on the Settings icon in the left pane.
  • Then select Security in the Settings panel.
  • Choose the Single Sign On (SSO) option and select SAML.

    zendex_sso
  • Enter the following details:

    SAML SSO URL Enter SAML Login URL from the Service Provider Setup tab of the module.
    Remote logout URL Enter SAML logout URL from the Service Provider Setup tab of the module.
    Certificate Fingerprint Copy the Thumbprint of the certificate downloaded from the Service Provider Setup tab of the module. (To generate fingerprint follow the below mentioned steps)
    1. Open the certificate that was downloaded earlier.
    2. Copy all the content of the certificate and past it in any online X.509 Certificate Fingerprint generator.
    3. Copy the Thumbprint generated and past it in the Certificate Fingerprint field.

  • Click the Save to save the Single Sign-On (SSO) SAML settings.
  • Copy Assertion Consumer Service(ACS) URL and keep it handy you will need it at the time of module configuration (Highlighted in the below image)

    zendex_sso

Step 2: Configure miniOrange SAML 2.0 IdP in Drupal 8

  • Click here and scroll down to Download the miniOrange SAML IDP SSO module.

    zendex_sso
  • Login into your Drupal 8 instance using your admin account.
  • Click on the Extend option from top menu bar and click on Install new modules link.

    zendex_sso
  • Upload the downloaded module as a .zip file. Then click on Install.

    zendex_sso
  • After successful installation, click on Enable newly added modules and enable the module. Then click Install button.

    zendex_sso zendex_sso
  • Configure the module:
    1. Click on Configuration option from top menu bar.
    2. Click on Drupal SAML IDP Configuration to use module.

      zendex_sso
    3. Go to Service Provider tab and provide details of Service Provider. (Details received from your service provider). Then click on Save Configuration.

      Service Provider Name Give any appropriate name to your Service Provider
      ACS URL Enter ACS URL copied from Zendesk (Service Provider) Eg. https://<your domain>.zendesk.com/access/saml
      SP Entity Id or Issuer https://<your domain>.zendesk.com/
      Relay State https://<your domain>.zendesk.com/
      Response Signed checked

    4. Go to IDP METADATA tab and provide following (Drupal 8 IDP) details to the Service Provider or you can give metadata link to your Service Provider.

    5. Go to Attribute Mapping tab and choose Drupal Email Address NameID Attribute value and then click on Save.

      zendex_sso

    You have now successfully configured Drupal 8 as your IdP! Still, if you are facing any difficulty please mail us on info@miniorange.com.