Drupal Rocket Chat SSO | Login to Rocket Chat using Drupal as IDP

Drupal Rocket Chat SSO | Login to Rocket Chat using Drupal as IDP


Drupal Rocket.Chat SSO Integration will allow you to configure Single Sign On ( SSO ) login between your Drupal site and Rocket Chat. Rocket Chat SSO integration with your Drupal site will help your users to login into Rocket Chat using their Drupal credentials.

This SSO setup will also help you to manage your users in one single place. The Drupal SAML IDP - SAML 2.0 Identity Provider Single Sign-On SSO module is compatible with Drupal 7, Drupal 8 as well as Drupal 9. Here we will go through a step-by-step guide to configure SAML IDP SSO login between Rocket Chat as SP ( Service Provider ) and Drupal as IDP ( Identity Provider ).

If you have any doubts or queries, you can contact us at drupalsupport@xecurify.com. We will help you to configure the module. If you want, we can also schedule an online meeting to help you configure the Drupal SAML IDP module.


Pre-requisite: Download and Installation 


  • For Window:
    composer require drupal/miniorange_saml_idp
  • For Linux:
    composer require 'drupal/miniorange_saml_idp'
  • Navigate to Extend menu on your Drupal admin console and search for miniOrange SAML Identity Provider using the search box.
  • Enable the module by checking the checkbox and click on install button.
  • Configure the module at
    {BaseURL}/admin/config/people/miniorange_saml_idp/idp_setup
  • Download the module:
    drush dl miniorange_saml_idp
  • Install the module:
    drush en miniorange_saml_idp
  • Clear the cache:
     drush cr
  • Configure the module at
    {BaseURL}/admin/config/people/miniorange_saml_idp/idp_setup
  • Navigate to Extend menu on your Drupal admin console and click on Install new module button.
  • Install the Drupal SAML IDP 2.0 Single Sign On (SSO) - SAML Identity Provider module either by downloading the zip or from the URL of the package (tar/zip).
  • Click on Enable newly added modules.
  • Enable this module by checking the checkbox and click on install button.
  • Configure the module at
    {BaseURL}/admin/config/people/miniorange_saml_idp/idp_setup

1. Configure Drupal site as Identity Provider

  • Navigate to the Service Provider Setup tab of the miniOrange SAML Identity Provider module on your Drupal site. There are two way to configure your Identity Provider ( Drupal as SAML Idp ):
    • A. By Uploading SP metadata:
    • Click on UPLOAD SP METADATA link.
    • You can either Upload Metadata File and click on Upload button or use a Upload Metadata URL and click on Fetch Metadata.
    • drupal saml idp service provider setup
      B. Manual Configuration:
    • Navigate to Service Provider Setup tab of the miniOrange Drupal SAML IDP module.
    • Provide the required settings (i.e. Service Provider Name, SP Entity ID or Issuer, ACS (Assertion Consumer Service) URL, X.509 Certificate (Optional)) as provided by your Service Provider Rocket Chat ( Rocket Chat as SP ).
    • Service Provider Name RocketChat
      SP Entity ID or Issuer https://<your-rocketchat-url>/_saml/metadata/<name-of-your-app>
      ACS URL https://<your-rocketchat-url>/_saml/validate/<name-of-your-app>
      NameID Format urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
      Assertion Signed Check to sign the SAML Assertion.
      drupal saml idp - upload metadata manually

    2. Configure Rocket Chat as Service Provider

    • Open a new browser tab or window, Log in to your RocketChat account as Account Admin.
    • Click on the left corner. Select Administration.
    • drupal saml idp home view rocketchat as sp
    • Search for SAML under Administration tab.
    • Enter the information into the corresponding fields.
    • Custom Provider <name-of-your-app>
      Custom Entry Point Enter the SAML Login URL copied from step 2.
      IDP SLO Redirect URL Enter the SAML Logout URL copied from step 2.
      Custom Issuer https://<your-rocketchat-url>/_saml/metadata/<name-of-your-app>
      Public Cert Contents (a) Open the Public Cert Contents dropdown
      (b)Open the downloaded (in step 2) certificate in notepad. Copy and paste the content here.
      Signature Validation Type Validate Either Signature
      User Data Field Map Open the User Data Field Map dropdown and enter the following attributes:
      {"username":"username", "email":"email", "name": "cn"}

      Note: Custom Provider = <name of your app> e.g. my-app

      drupal saml idp setting rocketchat as sp
    • Once this is done, click on Enable and Save Changes.

    24*7 Active Support

    If you face any issues or if you have any questions, please feel free to reach out to us at drupalsupport@xecurify.com. In case you want some additional features to be included in the module, please get in touch with us, and we can get that custom-made for you. Also, If you want, we can also schedule an online meeting to help you configure the Drupal SAML IDP SSO Login module.

    Free Trial

    If you would like to test out the module to ensure your business use case is fulfilled, we do provide a 7-day trial. Please drop us an email at drupalsupport@xecurify.com requesting a trial. You can create an account with us using this link.

    Additional Resources

    Our Other modules

Hello there!

Need Help? We are right here!

support
Contact miniOrange Support
success

Thanks for your inquiry.

If you dont hear from us within 24 hours, please feel free to send a follow up email to info@xecurify.com