ADFS Single Sign On (SSO) for Joomla miniOrange provides a ready to use solution for Joomla. This solution ensures that you are ready to roll out secure access to your Joomla site using ADFS within minutes.
Step 1: Configuring ADFS as IdP
In ADFS, click on Add Relying Party Trust . Then click on Start .
In Select Data Source: Select Enter data about the relying party manually. Click Next .
In Specify Display name: Enter Display name . Click Next.
In Choose Profile : Select AD FS profile. Click Next.
In Configure Certificate: If you’re using a free plugin, skip this step and click Next. If you’re using a premium plugin, upload the certificate downloaded from the plugin. Click Next.
In Configure URL: Check Enable Support for the SAML 2.0 Web SSO Protocol and enter the ACS URL from the plugin in Relying Party SAML 2.0 SSO Service URL field. Click Next.
Configure Identifiers: Enter the SP-Entity ID/Issuer URL from the plugin in Relying Party Trust Identifier field. Click Add. Click Next
In Configure Multi-factor Authentication: Select I do not want to configure multi factor authentication settings for this relying party trust. Click Next.
In Choose Issuance Authorization Rules, select Permit all users to access this relying party. Click Next.
In Ready to Add Trusts, select click Next.
Check Open the Edit Claim Rules dialog and click close. Click Add rule and then select Send LDAP Attributes as Claims . Enter the following:
Claim rule name
Enter claim rule name(Any). For example: Attributes
Outgoing Claim Type
If you are sending Multiple Attributes to your SP, then make sure that
Outgoing Claim Type should be Unique.
Click on Finish button.
Step 2: Configuring Joomla as SP
In miniOrange SAML plugin, go to Service Provider Setup tab. There are two ways to configure the plugin:
By Uploading ADFS Metadata File :
Click on Upload IDP Metadata.
Upload metadata file and click on Upload.
By Uploading 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
Add a button on your site login page with the following URL:
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.
Step 3: Attribute Mapping (It is Optional to fill this). This is Premium feature.
Attributes are user details that are stored in your Identity Provider.
Attribute Mapping helps you to get user attributes from your IdP and map them to Joomla user attributes like firstname, lastname etc.
While auto registering the users in your Joomla site these attributes will automatically get mapped to your Joomla user details.
In miniOrange SAML plugin, go to Attribute Mapping tab and fill in all the fields.
Name of the username attribute from IdP (Keep NameID by default)
Name of the email attribute from IdP (Keep NameID by default)
Name of the Role attribute from IdP
You can check the Test Configuration Results under Identity Provider Settings tab to get a better idea of which values to map here.
Step 4: Group/Role Mapping (It is Optional to fill this). This is Premium feature.
Joomla uses a concept of Roles, designed to give the site owner the ability to control what users can and cannot do within the site.
Role mapping helps you to assign specific roles to users of a certain group in your IdP.
While auto registering, the users are assigned roles based on the group they are mapped to.
Step 5: SSO Login Settings.
Go to Login Settings tab. There are multiple features availabe in this tab like Auto redirect the user to Identity Provider and Enable Backed Login for Super Users.To use these features, click on the respective checkboxes.
You have successfully Installed and Configured plugin