Rocket.Chat SAML Single Sign-On (SSO) Integration with Drupal as IdP

Overview

This guide will help you integrate Drupal as a SAML 2.0 Identity Provider (IdP) and Rocket.Chat as a Service Provider(SP) using the miniOrange SAML IDP module. This integration enables centralized user management and permission control, allowing users to access multiple applications with a single set of credentials. This module is compatible with Drupal 7, Drupal 8, Drupal 9, Drupal 10, and Drupal 11.

Download Schedule a Meeting

Configuration Steps

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 SAML Login URL, and X.509 Certificate. Keep it handy. (This is required in order to set up Rocket.Chat as a SAML SP)

Configure Rocket.Chat as Service Provider

• Open a new browser tab or window, Log in to your RocketChat account as Account Admin.
• Click on Administration from the left corner and navigate to Workspace.

• Scrolldown and click on the Settings and search for SAML. Click on the Open button in the SAML card.

• Now, enter the previously copied SAML Login URL and X.509 Certificate from Drupal in the corresponding textfield as per below table:

Custom Provider	<name-of-your-app>
Custom Entry Point	Enter the SAML Login URL copied from step 2.
Custom Issuer	https://<your-rocketchat-url>/_saml/metadata/<name-of-your-app>



Note: Copy the Custom Issuer url, it is Service Provider metadata url and required to configure Drupal as Identity Provider.

• Scrooldown and enter previously copied X.509 Certificate from Drupal into the Public Cert Contents textfield.
• Select Validate Response Signature from the Signature Validation Type dropdown.
• Click on the Save button.

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.

• Paste the copied Custom Issuer (Metadata URL) url into the Add from a URL textfield and click on Fetch Metadata button.

• Scrolldown and click on the Save Configuration button.

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

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

Related Articles

Explore the advanced features offered by the module with full-featured trial. You can initiate the trial request using Request 7-day trial button of the module or reach out to us at drupalsupport@xecurify.com for one-on-one assistance from Drupal expert.

• Setup Multiple Applications (Service Provider) with Drupal
• Share additional User Attribute/Roles to the Service Provider
• Dynamic Relay State (The URL to which users are redirected after successful authentication)
• IDP initiated SSO

24/7 Support

The Drupal developers at miniOrange offer quick and active support for your queries. We can assist you from choosing the best solution for your use case to deploying and maintaining the solution.

 Contact us

Case Studies

miniOrange has successfully catered to the use cases of 400+ trusted customers with its highly flexible/customizable Drupal solutions.

 Read more

Other Solutions

Feel free to explore other Drupal solutions that we offer the popular solutions used by our trusted customers include 2FA, User Provisioning, Website Security.

 Know More