Freshdesk SAML Single Sign-On (SSO) Integration with Drupal as IdP

This document explains how to configure Drupal as an Identity Provider (IdP) for the Freshdesk application using the miniOrange SAML IDP module. This will allow users to log in and access Freshdesk using Drupal credentials. The module is compatible with Drupal 7, Drupal 8, Drupal 9, and Drupal 10.

Obtain SAML IDP Metadata from Drupal:

• Once the module is installed, navigate to the Configuration tab from the top navigation bar and click on the miniOrange SAML IDP Configuration.

• Navigate to the IDP Metadata tab. Copy the Entity ID/Issuer, SAML Login URL, and X.509 Certificate. Keep it handy. (This is required in order to set up Freshdesk as a SAML SP)

Configure SAML SSO Application in Freshdesk:

• Login into your Freshdesk Admin Console as a System Admin.
• Navigate to the Admin → Account → Security

• Under Login settings, click on the Configure Freshworks SSO link.

• Select the Default Login Method.

• In the login methods, enable the Single Sign-On option and select SAML under the IdP of your choice option.

• Click on the Download Metadata link to download the metadata file of the Freshdesk. (This will require further configuring Drupal as IdP)

• Now enter the information copied earlier from Drupal and Click on the Configure SSO button
  • Entity ID provided by the IdP → IDP Entity ID/Issuer
  • SAML SSO URL → SAML Login URL
  • Security certificate → X.509 Certificate

Configuring Drupal as SAML Identity Provider (IdP):

• Go to the Drupal site. Navigate to the Service Provider Setup tab of the miniOrange SAML IDP module.
• Click on the Upload SP Metadata.

• Upload the metadata file downloaded from the Freshdesk.

• Now click on the Test link to verify your configuration. If your configurations are correct then you will get the homepage of the Freshdesk site in the test configuration window.

You have successfully configured the SAML SSO between Freshdesk as SAML SP and Drupal as SAML IDP.