Logging into Drupal using the Identity Server¶

Drupal is an open source content management software distributed under the terms of the GNU General Public License (GPL). This topic provides instructions on how to log into Drupal using your MWARE IAM credentials. In this tutorial, Drupal acts as the service provider and MWARE IAM acts as the identity provider.

Let's get started!

Configure SimpleSAMLphp as a service provider¶

1. Navigate to the Web directory on a terminal window and run the following command to create a symlink to the vendor/simplesamlphp/simplesamlphp/www folder.

   ln -s https://iam-docs.m-ware.eu/en/6.1.0/vendor/simplesamlphp/simplesamlphp/www simplesaml

   2. Create an .htaccess file inside the simplesaml symlink folder and add the following configurations.

   RewriteCond %{REQUEST_URI} !/core/[^/]*\.php$
   RewriteCond %{REQUEST_URI} !/core/modules/system/tests/https?.php
   RewriteCond %{REQUEST_URI} !/core/modules/statistics/statistics.php$
   RewriteCond %{REQUEST_URI} !/simplesaml/[^/]*\.php$
   RewriteCond %{REQUEST_URI} !/simplesaml/admin/[^/]*\.php$
   RewriteCond %{REQUEST_URI} !/simplesaml/[^/]*\.php/sanitycheck/[^/]*\.php$
   RewriteCond %{REQUEST_URI} !/simplesaml/[^/]*\.php/saml/[^/]*\.php$
   RewriteCond %{REQUEST_URI} !/simplesaml/[^/]*\.php/saml/sp/[^/]*\.php/default-sp$
   RewriteRule "^(.+/.*|autoload)\.php($|/)" - [F]\

   3. Make the following changes to the <PROJECT_NAME>/vendor/simplephp/simplephp/config/config.php file.

   Info

   If you are unable to find the config folder, create an empty folder and copy all the files from config-templates directory.

   • store.type: sql
   • store.sql.dsn: mysql:host=localhost;dbname=db_name (change the host & db_name according to your values)
   • store.sql.username: enter the Drupal database user_name
   • store.sql.password: enter the Drupal database password
   • auth.adminpassword: Change admin password of the simplesaml setup
   • enable.saml20-idp: true
   • technicalcontact_name: enter the name of thet echnical person who is running this installation.(optional)
   • technicalcontact_email: enter the email of the technical person who is running this installation.(optional)
   • Add this line to the end of the config.php file

   $config['baseurlpath'] = 'http://'. $_SERVER[‘HTTP_HOST’].'/simplesaml/';

   Note!

   Configure your server to support virtual hosts and point the document root to <PATH_TO_PROJECT>/www. Click here to see how to configure virtual hosts in the Apache server.

2. Update the config/authsources.php file of the service provider by providing the following details under default-sp.

   Field	Value	Description
   EntityID	SimpleSAML	Entity ID of the service provider that MWARE IAM is expecting in Human readable format. This field can be NULL/unset, in which case an entity ID is generated based on the metadata URL.
   idp	https://localhost:9443/samlsso	Entity ID of the IdP.

3. Copy IdP metadata to the metadata/saml20-idp-remote.php file of the Service Provider. MWARE IAM’s cert fingerprint should be set as the certFingerprint and tenant domain should be set as Idp tenant domain.

    $metadata['https://localhost:9443/samlsso'] = array(
      'name' => array(
          'en' => 'MWARE IAM',
          'no' => 'MWARE IAM',
      ),
      'description' => 'Login with MWARE IAM SAML2 IdP.',
      'SingleSignOnService'  => 'https://localhost:9443/samlsso?tenantDomain=carbon.super',
      'SingleLogoutService'  => 'https://localhost:9443/samlsso?tenantDomain=carbon.super',
      'certFingerprint'  => '57ff38d97664c792ff8801171f04191ded88778d'
   );

Configure MWARE IAM as the identity provider¶

1. Click on Identity Providers > Resident and then expand SAML2 Web SSO Configuration.

2. Use https://localhost:9443/samlsso as the Identity Provider Entity Id and click Update to save the configuration.

3. Click Service Providers > Add and enter a unique name as the Service Provider name (e.g., "Drupal_SP").

4. Expand Inbound Authentication Configuration and then expand SAML2 Web SSO Configuration.

5. Enter the value you configured as the Entity ID in the the config/authsources.php file as the Issuer.

6. Enter http://$host/simplesaml/module.php/saml/sp/metadata.php/default-sp as the Assertion Consumer URL.

7. Enable Enable IdP Initiated SSO.

8. Enable Attribute Profile and Include Attributes in the Response Always.

9. Click Register to save the details.

10. Expand Claim Configuration. Select Define Custom Claim Dialect and add the following Claim URI.

    • Service Provider Claim: Mail Local Claim:https://wso2.com/claims/emailaddress Requested Claim: Yes

    • Service Provider Claim: fname Local Claim:https://wso2.org/claims/givenname Requested Claim: Yes

11. Click Update to save.

Try SAML 2.0 authentication¶

1. On a browser window, navigate to: http://'. $_SERVER[‘HTTP_HOST’] .’/simplesaml/.

2. Click Authentication > Test configured authentication sources.

3. Click default-sp. You will be redirected to the MWARE IAM authentication page.

4. Login as the newly created user and you will see the User attributes, SAML Subject and Auth Data.

Configure Drupal¶

1. Go to the Drupal Home page and login as admin.

2. Click on the Extend tab and install the following modules.

   • SimpleSAMLphp Authentication

   • External Authentication

3. Click Configuration > People > SimpleSAMLphpAuthSettings.

4. Enable Activate authentication via SimpleSAMLphp.

5. Enable User provisioning > Register users to create or register users using this module.

6. Click Save configuration.

7. Click on the User info and syncing tab.

8. Enter Mail as the SimpleSAMLphp attribute to be used as a unique identifier for the user.

9. Enter fname as the SimpleSAMLphp attribute to be used as a username for the user.

10. Enter Mail as the SimpleSAMLphp attribute to be used as an email address for the user.

11. Click Save configuration.

Try it out¶

1. Create a user in MWARE IAM. Edit the user profile and update the First name and email address fields.

2. Login to Drupal as the admin user and create a user with the same email address.

3. Logout of Drupal. You will be redirected to the Drupal Login page.

4. Click Federated login You will be directed to the WSO2 Login Page.

5. Provide user credentials of the user you created in step 2 and click Continue.

6. Enable Select All.

7. Click continue You will be redirected to the Drupal home page.

8. Click edit . The user profile attributes configured in MWARE IAM will be populated in the Personal details section of your account.