Joomla OAuth Client Integration with Azure AD B2C Single Sign-On (SSO)

Get in Touch

Integration of Azure AD B2C Single Sign-on (Azure Active Directory B2C SSO) with Joomla using OAuth 2.0 Protocol. The miniOrange Joomla OAuth / OpenID Connect Single Sign-on (SSO) plugin makes it simple to set up Azure AD B2C (Microsoft Azure) SSO into Joomla and enable secure login into Joomla. As a result, users can log in to Joomla and access the site by authenticating with their Azure AD B2C OAuth Provider credentials.

Visit our Joomla OAuth Client Plugin page to learn more about the features and Pricing plans we offer for the Joomla OAuth Single Sign-on (OAuth & OpenID connect) plugin.

Pre-requisites : Download And Installation

Setup Azure AD B2C as OAuth Provider with Joomla OAuth Client

1. Download and Setup Joomla OAuth Client

• Download the zip file for the miniOrange OAuth Client plugin for Joomla from the given link.
• Login into your Joomla site’s administrator console.
• From left toggle menu, click on System, then under Install section click on Extension.
• Upload the downloaded zip file to install the Joomla OAuth Client plugin.
• Installation of plugin successful. Now click on Start Using miniOrange OAuth Client plugin.
• Under Configure OAuth tab. Select Azure AD B2C as an OAuth Provider.

• Now copy the Callback / Redirect URL which is needed while configuring Azure AD B2C as OAuth Server.

2. Setup Azure AD B2C as OAuth Provider

• Sign in to Azure portal.
• Go to Home and in the Azure services, select Azure AD B2C.

• Please make sure you are in the Azure AD B2C directory with an active subscription and if not, you can switch to the correct directory.

• In the Essentials tab, you will find the Azure B2C domain name, keep it handy, you will need it later for configuring the Azure B2C tenant name under Joomla as an OAuth client.
  
  

  What is Tenant Name?
  You will need to copy the highlighted domain name portion only in order to configure the tenant name in the Joomla OAuth Client plugin.
  Eg. If your domain name is 'exampledomain.onmicrosoft.com', then your tenant name will be 'exampledomain'.



• Now, click on App registrations and then click on the New registration option to create a new Azure B2C application.

• Configure the following options to create a new application:
• Enter a name for your application under the Name text field.
• In supported account types, select 3rd option ‘Accounts in any identity provider or organizational directory (for authenticating users with user flows)’
• In the Redirect URI section, select the Web application and enter the Callback URL from the miniOrange OAuth Client plugin (Configure OAuth tab) and save it under the Redirect URL textbox.
• Click on the Register button to create your application.

• After successful application creation, you will be redirected to the newly created application’s overview page. If not, you can go to the app registrations and search the name of your application and you will find your application in the list.

• Copy your Application ID and keep it handy, you will need it later for configuring the Client ID under Joomla as an OAuth Client plugin.

• Now, click on Certificates and secrets and then click on New client secret to generate a client secret. Enter a description and click on the Add button.

• Copy the secret value from certificates & secrets page and keep it handy, you will need it later for configuring the Client Secret under Joomla as an OAuth Client plugin.

2.1. Add Users in your B2C application

• In home page, go to the Users tab in the left corner

• Click on New user in the users page

• Select Create Azure AD B2C user. Then, scroll down and click on Email from sign in method and set your password and click create to save the user details to perform test configuration.

2.2. How to create & add Azure B2C Policy

• Go to User Flows tab and then click on New user flow.

• Select a User flow type Sign up and Sign in then click on Create button.

• Fill all the information e.g. Name, Identity providers, etc. then click on Create button.

• Copy the Policy name this value whenever you need to enter Azure B2C Policy in miniOrange OAuth Client plugin.

2.3. Add user claims to your application

• Go to user flows under policies in the left corner. Select the configured policy.

• Select Application claims in settings

• Select the desired attributes to be displayed on the test configuration and save it.

3. Integrating Joomla with Azure AD B2C

• Go back to your Joomla Dashboard. Then go to Components, then miniOrange OAuth Client and click on Configure OAuth tab.
• Paste the Client ID, Client Secret and Tenant,Policy. click on Save Settings. Once Settings are saved then click on Test Configuration.

3.1. Scope and Endpoint

• Please refer the below table for configuring the scope & endpoints for Azure AD B2C in the plugin.

Scope:	openid
Authorize Endpoint:	https://<domain-name >.b2clogin.com/<domain-name>.onmicrosoft.com/<policy-name>/oauth2/v2.0/authorize
Access Token Endpoint:	https://<domain-name>.b2clogin.com/<domain-name>.onmicrosoft.com/<policy-name>/oauth2/v2.0/token
Get User Info Endpoint:	https://graph.microsoft.com/v1.0/me
Custom redirect URL after logout: [optional]	https://<domain-name>.b2clogin.com/<domain-name>.onmicrosoft.com/<policy-name>/oauth2/v2.0/logout?post_logout_redirect_uri=<your url>
Set Client Credentials	In Both (In Header and In Body)

4. User Attribute Mapping

• User Attribute Mapping is mandatory for enabling users to successfully login into Joomla. We will be setting up user profile attributes for Joomla using below settings.
• Click on Test Configuration button, you will see all the values returned by your OAuth Provider to Joomla in a table.

• Now go to do Attribute Mapping tab. Here you can map all the Attribute Mapping details in the given fields below.

5. Role/Group Mapping

• Go to the Role Mapping tab. Here you can Enable Role Mapping and select default groups for new users.
• Based on your provider application, you can allocate the Joomla role to your provider roles.

6. Login Settings

• Now you can use Login / SSO URL to perform SSO.

• Now logout and go to your Joomla site's pages where you have added this link. You will see a login link where you placed that button. Click on this button to perform SSO.
• Go to the Login/Logout Settings tab. Here, you can configure user login/logout behavior for your Joomla application.

• Congratulations, you have successfully configured the miniOrange OAuth Client plugin with your Okta OAuth Provider.
• Click on the Upgrade Plans tab to check out our complete list of features and various licensing plans. OR you can click here to check features and licensing plans.
• If you want to purchase any of the paid version of the plugin, you have to register/login with us in Account Setup tab. OR you can register/login Here .
• In case, you are facing some issue or have any question in mind, you can reach out to us by sending us your query through the Support button in the plugin or by sending us a mail at joomlasupport@xecurify.com.

In this guide, you have successfully configured Joomla Azure AD B2C Single Sign-On (SSO) by configuring Azure AD B2C as OAuth Provider and Joomla as OAuth Client using our Joomla OAuth Client plugin.This solution ensures that you are ready to roll out secure access to your Joomla site using Azure AD B2C login credentials within minutes.

Joomla Azure Integrator

Additional Resources

• What is OAuth 2.0?
• Frequently Asked Questions (FAQs)
• How to configure OAuth / OpenID Connect SSO with Salesforce
• How to configure OAuth / OpenID Connect SSO with AWS Cognito
• How to configure OAuth / OpenID Connect SSO with Discord
• How to configure OAuth / OpenID Connect SSO with Facebook
• How to configure OAuth / OpenID Connect SSO with Google Apps
• How to configure OAuth / OpenID Connect SSO with Instagram
• How to configure OAuth / OpenID Connect SSO with Keycloak

Mail us on joomlasupport@xecurify.com for quick guidance(via email/meeting) on your requirement and our team will help you to select the best suitable solution/plan as per your requirement.