SAML Single Sign On (SSO) into Drupal using ADFS as IDP

Drupal SAML ADFS SSO setup will allow your user to login to your Drupal site using their ADFS Credentials. Drupal SAML module gives the ability to enable SAML Single Sign-On for Drupal. This module is compatible with all SAML Identity Providers ( IDP ). We provide Drupal SAML SP 2.0 Single Sign on (SSO) - SAML Service Provider module which is compatible with Drupal 7, Drupal 8 as well as Drupal 9. Here we will go through a guide to configure SAML SSO between Drupal and ADFS Idp. By the end of this guide, users from your Identity Provider should be able to login into the Drupal site.

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 SP 2.0 Single Sign On (SSO) module.

Setup Video ADFS as IDP

You can refer to the steps to Configure ADFS with the Drupal SAML SSO from the Video or Documentation given below

Steps to configure Window ADFS Single Sign-On (SSO) Login into Drupal website

1. Configuring ADFS as Identity Provider

• Once you have installed the module, click on the Configuration tab in the top navigation panel of your Drupal site and select miniOrange SAML Login Configuration.

• Navigate to Service Provider Metadata tab in miniOrange SAML SP module. The SP metadata, such as the SP Entity ID / Issure, SP ACS URL (AssertionConsumerService) and X.509 Certificate, can be found here and are required to configure the Identity Provider.

 Configure ADFS as IdP

• In ADFS, click on Add Relying Party Trust .

• Click on Start .

• In Select Data Source, select the data source for adding a relying party trust.

Metadata URL

Metadata XML file

Manual Configuration

• Navigate to Service Provider Metadata tab from the module and copy the Metadata URL.
• Select Import data about the relying party published online or on the local network option and add the metadata URL in Federation metadata address.
• Click on Next.

• Navigate to Service Provider Metadata tab from the module and click on the Download XML metadata button to download the module metadata file.
• Select Import data about the relying party from a file option and upload the downloaded metadata file.
• Click on Next.

• Navigate to Service Provider Metadata tab of the module to get the endpoints to configure Service Provider manually.
• In Add Relying Party Trust Wizard select option Enter data about the relying party manually and click on Next.

 Specify Display Name

• Enter Display Name and Click Next.

 Configure Certificate (Premium feature)

• Download the certificate from Service Provider Metadata Tab.
• Upload the certificate and click on Next.

 Configure URL

• Select Enable support for the SAML 2.0 WebSSO protocol option and enter ACS URLfrom the module's Service Provider Metadata Tab.
• Click on Next.

 Configure Identifiers

• In the Relying party trust identifier, add the SP-EntityID / Issuer from the module's Service Provider Metadata tab.

 Choose Access Control Policy

• Select Permit everyone as an Access Control Policy and click on Next.

 Ready to Add Trust

• In Ready to Add Trust click on Next and then Close.

 Edit Claim Issuance Policy

• In the list of Relying Party Trust, select the application you created and click on Edit Claim Issuance Policy.

• In Issuance Transform Rule tab click on Add Rule button.

 Choose Rule Type

• Select Send LDAP Attributes as Claims and click on Next.

 Configure Claim Rule

• Add a Claim Rule Name and select the Attribute Store as required from the dropdown.
• Under Mapping of LDAP Attributes to outgoing claim types, Select LDAP Attribute as E-Mail-Addresses and Outgoing Claim Type as Name ID.

• Once you have configured the attributes, click on Finish.
• After configuring ADFS as IDP, you will need the Federation Metadata to configure your Service Provider.
• To get the ADFS Federation Metadata, you can use this URL
  https://< ADFS_Server_Name >/federationmetadata/2007-06/federationmetadata.xml
• You have successfully configured ADFS as SAML IdP (Identity Provider) for achieving ADFS Single Sign-On (SSO) Login

2. Windows SSO

 Steps to configure ADFS for Windows Authentication

• Open elevated Command Prompt on the ADFS Server and execute the following command on it:

setspn -a HTTP/##ADFS Server FQDN## ##Domain Service Account##

FQDN is Fully Qualified Domain Name (Example : adfs4.example.com)

Domain Service Account is the username of the account in AD.

Example : setspn -a HTTP/adfs.example.com username/domain

• Open AD FS Management Console and go to Authentication Policies section, edit the Global Authentication Policies. Check Windows Authentication in Intranet zone.

• Open Internet Explorer. Navigate to Security tab in Internet Options.
• Add the FQDN of AD FS to the list of sites in Local Intranet and restart the browser.
• Select Custom Level for the Security Zone. In the list of options, select Automatic Logon only in Intranet Zone.

• Open the powershell and execute following two commands to enable windows authentication in Chrome browser.

Set-AdfsProperties -WIASupportedUserAgents ((Get-ADFSProperties | Select -ExpandProperty WIASupportedUserAgents) + "Chrome")

Get-AdfsProperties | Select -ExpandProperty WIASupportedUserAgents

• You have configured ADFS for Windows Authentication. Now to add Relying Party for your Drupal you can follow these steps.

3. Configuring Drupal as Service Provider

• In Drupal SAML Module, go to Service Provider Setup tab. There are two ways to configure the Module:

 By Uploading ADFS Metadata File :

• Click on Upload IDP Metadata.
• Upload metadata file and click on Upload.

 By ADFS Metadata URL :

• Click on Upload IDP Metadata.
• Enter Metadata URL and click on Fetch Metadata.
• You can provide this metadata url https://<your_ADFS_domain>/federationmetadata/2007-06/federationmetadata.xml
• If you want Single logout then follow these steps:
• Navigate to Relying Party Trusts => Properties

• Navigate to Endpoints => Add SAML

• Select SAML Logout from Endpoint type dropdown.
• Enter ACS URL in Trusted URL textfield and SAML Logout URL in Response URL textfield then click on OK button.

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 SP 2.0 Single Sign On (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

• What is Single Sign-On (SSO)?
• What is SAML?
• Frequently Asked Questions (FAQs)

Our Other modules: