Azure B2C WordPress Login | WordPress Azure B2C SAML Single Sign-On (SSO)

Overview

Azure B2C WordPress Single Sign On (SSO) login with our WordPress SAML Single Sign-On (SSO) module. WordPress Azure B2C SSO allows your users to login to your WordPress and access the site by authenticating with their Azure B2C Identity Provider (IDP) credentials. You can also configure plugin using different IDPs such as Azure B2C / Azure AD, Office 365, and other custom providers. Our WordPress Azure AD B2C SSO solution will make WordPress (WP) SAML 2.0 compliant Service Provider (SP), establishing trust between the WordPress (WP) site and Azure B2C to securely authenticate and login users to the WordPress (WP) site.

It also provides Seamless support for advanced Windows SSO features like Attribute & Group Mapping, Populate Employee information from Azure B2C / Azure AD to WordPress (WP), Intranet SSO / Internet SSO, Mapping the profile picture from Azure B2C / Azure AD to your WordPress (WP) avatar, etc.

Here, we will go through a guide to configure SAML Single Sign-On SSO for WordPress Azure B2C login by considering Azure B2C as IDP (Identity Provider) and WordPress as SP (Service Provider). Our WordPress Azure AD B2C SSO solution provides Unlimited user authentications from Azure B2C. You can visit our WordPress SSO plugin to know more about the other features we provide.

Pre-requisites : Download And Installation

• To configure Azure B2C as SAML IDP with WordPress, you will need to install the miniOrange WP SAML SP SSO plugin.

Configuration Steps

Step 1. Setup Azure B2C as IdP (Identity Provider)

Follow the steps below to configure Azure B2C as an Identity Provider:

Configure Azure B2C as IdP

• In the WordPress (WP) SAML SP SSO plugin, navigate to Service Provider Metadata tab. Here, you can find the SP metadata such as SP Entity ID and ACS ( AssertionConsumerService ) URL which are required to configure Azure B2C as the Identity Provider.

Step 2. Register Azure B2C Applications

Register the Identity Experience Framework application

• Login into Azure B2C Portal.
• From the Azure AD B2C tenant, select App registrations, and then select New registration.

• For Name, enter IdentityExperienceFramework.
• Under Supported account types, select Accounts in this organizational directory only.

• Under Redirect URI, select Web, and then enter https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com, where your-tenant-name is your Azure AD B2C tenant domain name.

• Under Permissions, select the Grant admin consent to openid and offline_access permissions check box.
• Select Register.

• Record the Application (client) ID for use in a later step.

Register the Identity Experience Framework application

• In left navbar, under Manage section, select Expose an API.
• Select Add a scope, then select Save and continue to accept the default application ID URI.

• Enter the following values to create a scope that allows custom policy execution in your Azure AD B2C tenant:
• Scope name: user_impersonation
• Admin consent display name: Access IdentityExperienceFramework
• Admin consent description: Allow the application to access IdentityExperienceFramework on behalf of the signed-in user.

• Select Add scope.

Register the ProxyIdentityExperienceFramework application

• Select App registrations, and then select New registration.
• For Name, enter ProxyIdentityExperienceFramework.
• Under Supported account types, select Accounts in this organizational directory only.

• Under Redirect URI, use the drop-down to select Public client/native (mobile & desktop).
• For Redirect URI, enter myapp://auth.
• Under Permissions, select the Grant admin consent to openid and offline_access permissions check box.
• Select Register.

• Record the Application (client) ID for use in a later step.

Next, specify that the application should be treated as a public client

• In left navbar, under Manage section, select Authentication.
• Under Advanced settings section, enable Allow public client flows (select Yes).
• Click on the Save button.

Now, grant permissions to the API scope you exposed earlier in the IdentityExperienceFramework registration

• In the left navbar, under Manage section, select API permissions.
• Under Configured permissions, select Add a permission.

• Select the My APIs tab, then select the IdentityExperienceFramework application.

• Under Permission, select the user_impersonation scope that you defined earlier.
• Select Add permissions. As directed, wait a few minutes before proceeding to the next step.

• Select Grant admin consent for (your tenant name).

• Select your currently signed-in administrator account, or sign in with an account in your Azure AD B2C tenant that's been assigned at least the Cloud application administrator role.
• Select Yes.
• Select Refresh, and then verify that "Granted for ..." appears under Status for the scopes - offline_access, openid and user_impersonation. It might take a few minutes for the permissions to propagate.

Register the WordPress Application

• Select App registrations, and then select New registration.
• Enter a Name for the application such as: WordPress.
• Under Supported account types, select Accounts in any organizational directory or any identity provider. For authenticating users with Azure AD B2C.

• Under Redirect URI, select Web, and then enter the ACS URL from the Service Provider Metadata tab of the miniOrange SAML plugin.
• Select Register.

• Under Manage, click on Expose an API.
• Click on Set for the Application ID URI and then click on Save, accepting the default value.

• Once saved, copy the Application ID URI and navigate to the Service Provider Metadata tab of the plugin.

• Paste the copied value under the SP Entity ID / Issuer field provided in this tab.
• Click on Save.

Step 3. Generate SSO Policies

• From our Azure B2C portal, navigate to the Overview section of your B2C tenant and record your tenant name.

• Enter your Azure B2C tenant name below, along with the application ID for IdentityExperienceFramework and
  ProxyIdentityExperienceFramework apps as registered in the above steps.

Azure B2C tenant Name:
IdentityExperienceFramework app ID:
ProxyIdentityExperienceFramework app ID:
Select additional attributes	User Type Job Title Department Usage Location Street Address State or Province Country or Region City ZIP or Postal Code Office Phone Mobile Phone physicalDeliveryOfficeName Age Group Consent Provided for Minor Legal Age Group Classification createdDateTime netId

• Click on the Generate Azure B2C Policies button to download the SSO policies.
• Extract the downloaded zip file. It contains the policy files and certificate (.pfx), which you will require in the following steps.

Step 4. Setup Certificates

Upload the Certificate

• Sign in to the Azure portal and browse to your Azure AD B2C tenant.

• Under Policies, select Identity Experience Framework and then Policy keys.

• Select Add, and then select Options > Upload
• Enter the Name as SamlIdpCert. The prefix B2C_1A_ is automatically added to the name of your key.

• Using the upload file control, upload your certificate that was generated in the above steps along with the SSO policies (tenantname-cert.pfx).
• Enter the certificate's password as your tenant name and click on Create. For example, if your tenant name is xyzb2c.onmicrosoft.com, enter the password as xyzb2c
• You should be able to see a new policy key with the name B2C_1A_SamlIdpCert.

Create the signing key

• On the overview page of your Azure AD B2C tenant, under Policies, select Identity Experience Framework.
• Select Policy Keys and then select Add.
• For Options, choose Generate.
• In Name, enter TokenSigningKeyContainer.
• For Key type, select RSA.
• For Key usage, select Signature.

• Select Create.

Create the encryption key

• On the overview page of your Azure AD B2C tenant, under Policies, select Identity Experience Framework.
• Select Policy Keys and then select Add.
• For Options, choose Generate.
• In Name, enter TokenEncryptionKeyContainer.
• For Key type, select RSA.
• For Key usage, select Encryption.

• Select Create.

Step 5. Upload the Policies

• Select the Identity Experience Framework menu item in your B2C tenant in the Azure portal.

• Select Upload custom policy.

• As per the following order, upload the policy files downloaded in the above steps:
• TrustFrameworkBase.xml
• TrustFrameworkExtensions.xml
• SignUpOrSignin.xml
• ProfileEdit.xml
• PasswordReset.xml
• SignUpOrSigninSAML.xml
• As you upload the files, Azure adds the prefix B2C_1A_ to each.

You have successfully configured Azure B2C as SAML IdP (Identity Provider) for achieving WordPress Azure B2C Single Sign-On (SSO) Login, ensuring secure login into WordPress (WP) Site.

Step 6. Configure the Plugin

• Navigate to the Service Provider Setup tab of the plugin and click on the Upload IDP Metadata button.
• Provide any IDP Name. For example, AzureB2C
• Enter the Metadata URL as
  https://tenant-name.b2clogin.com/tenant-name.onmicrosoft.com/B2C_1A_signup_signin_saml/Samlp/metadata




Note: You will need to replace the tenant-name in above URl with Azure B2C tenant name.



• Click on the Fetch Metadata button.

Step 7. How to configure SAML Single Logout in Azure AD B2C?

• To access SLO users would first require the SLO URL which is provided in the Service Provider Metadata tab of the Plugin. (Premium Feature).

• Copy the SLO Url from the SAML Single Sign-On – SAML SSO Login Plugin.
• Navigate to Azure AD B2C portal, navigate to the App (connected to the WordPress (WP)).
• In the left panel and select the Manifest tab.

• Place the Single Logout URL in the manifest code by replacing the NULL value.

You have successfully configured Single Logout functionality with Azure B2C.

• Free
• Standard
• Premium

Step 8. Attribute Mapping

• In the free plugin, only NameID is supported for Email and Username attributes of the WordPress (WP) user.
• When a user performs SSO, the NameID value sent by the IDP will get mapped to the email and username of the WordPress (WP) user.

Step 8. Attribute Mapping

• Attribute Mapping feature allows you to map the user attributes sent by the IDP during SSO to the user attributes at WordPress (WP).
• In WordPress (WP) SAML plugin, go to Attribute/Role Mapping tab and fill up the following fields in Attribute Mapping section.

Note: If you click on Test Configuration button in Service Provider Setup tab and authenticate with your IDP, you can see a list of attributes sent by the IDP in the Attribute/Role mapping tab. This information can be used to provide the above mapping.

Step 8. Attribute Mapping

• Attribute Mapping feature allows you to map the user attributes sent by the IDP during SSO to the user attributes at WordPress (WP).
• In WordPress (WP) SAML plugin, go to Attribute/Role Mapping tab and fill up the following fields in Attribute Mapping section.

• Custom Attribute Mapping: This feature allows you to map any attribute sent by the IDP to the usermeta table of WordPress (WP).

Step 9. Role Mapping

• In the free plugin, you can choose a default role which will be assigned to all the non-admin users when they perform SSO.
• Go to Attribute/Role mapping tab and navigate to Role Mapping section.
• Select the Default Role and click on the Update button.

Step 9: Role Mapping

In the standard plugin, you can choose a default role which will be assigned to all the non-admin users when they perform SSO.

• Go to Attribute/Role mapping tab and navigate to Role Mapping section.
• Select the Default Role and click on the Save button.

Step 9. Role Mapping

This feature allows you to assign and manage roles of the users when they perform SSO. Along with the default WordPress (WP) roles, this is compatible with any custom roles as well.

• From the Attribute Mapping section of the plugin, provide a mapping for the field named Group/Role. This attribute will contain the role related information sent by the IDP and will be used for Role Mapping.
• Navigate to role mapping section and provide the mappings for the highlighted roles.



• For example, If you want a user whose Group/Role attribute value is wp-editor to be assigned as an Editor in WordPress (WP), just provide the mapping as wp-editor in the Editor field of Role Mapping section.

Step 10. SSO settings

• In the free plugin you can add a Single Sign-On button by enabling Add a Single Sign-On button on the WordPress (WP) Login Page toggle in Option 1.

• If your WordPress theme supports login widget, you can add a login widget to enable SP-Initiated SSO on your site.
• Navigate to Redirection and SSO links tab and follow the given steps given under Option 2: Use a Widget to add a login widget on your site.

Step 10: SSO Settings

In the Standard plugin you can enable SP-initiated SSO using the following options.

• Auto-Redirection from site: If this option is enabled, any unauthenticated user trying to access your site will get redirected to the IDP login page and after successful authentication, they will be redirected back to the same page on your site which they were trying to access.

Steps:

• Go to Redirection and SSO Links tab of the plugin and navigate to Option 1: Auto-Redirection from site.
• Enable Redirect to IdP if user not logged in [PROTECT COMPLETE SITE] option.




• Auto-Redirection from WordPress (WP) Login: If this option is enabled, any unauthenticated user trying to access the default WordPress (WP) login page will get redirected to the IDP login page for authentication. After successful authentication, they will be redirected back to the WordPress (WP) site.

Steps:

• Go to Redirection and SSO Links tab of the plugin and navigate to Option 2: Auto- Redirection from WordPress (WP) Login.
• Enable Redirect to IdP from WordPress Login Page option.





Note: Please enable the Backdoor login and note down the backdoor URL. This will allow you to access the WordPress (WP) login page in case you get locked out of the IDP.



• SSO Links: You can add SSO links anywhere on your site using the Shortcode and Widget provided in Redirection and SSO Links tab > Option 3: SSO Links section of the plugin

Step 10. SSO settings

In the Premium plugin you can enable SP-initiated SSO using the following options.

• Auto-Redirection from site: If this option is enabled, any unauthenticated user trying to access your site will get redirected to the IDP login page and after successful authentication they will be redirected back to the same page on your site which they were trying to access.

Steps:

• Go to Redirection and SSO Links tab of the plugin and navigate to Option 1 : Auto-Redirection from site.
• Enable Redirect to IdP if user not logged in [PROTECT COMPLETE SITE] option.



• Auto-Redirection from WordPress (WP) Login: If this option is enabled, any unauthenticated user trying to access the default WordPress (WP) login page will get redirected to the IDP login page for authentication. After successful authentication, they will be redirected back to the WordPress (WP) site.

Steps:

• Go to Redirection and SSO Links tab of the plugin and navigate to Option 2: Auto-Redirection from WordPress (WP) Login
• Enable Redirect to IdP from WordPress Login Page option.





Note: Please enable the Backdoor login and note down the backdoor URL. This will allow you to access the WordPress (WP) login page in case you get locked out of the IDP login.



• Login Button: You can add a customized login button anywhere on your site or WordPress (WP) login page by navigating to Option 3: Login Button section of Redirection and SSO Links tab.

• SSO Links: You can add SSO links anywhere on your site using the Shortcode and Widget provided in Option 4: SSO Links section of Redirection and SSO Links tab.

In this Guide, you have successfully configured WordPress Azure B2C SSO [SAML] (Azure B2C WordPress SSO / Azure B2C WordPress Login), choosing Azure B2C as IDP and WordPress (WP) as SP. WordPress (WP) SAML Single Sign On – SSO solution ensures that you are ready to roll out secure access / Login int WordPress (WP) site using Azure B2C login credentials. Our solution WordPress Azure B2C SSO supports all kinds of SSO use cases such as WordPress Azure Active directory SSO, WordPress Office 365 SSO, WordPress Azure AD SSO.

Related Articles

• What is Single Sign-On (SSO) Login?
• WordPress (WP) + Azure / Office 365 Active Directory integrations
• Azure B2C SAML SSO
• Azure B2C SSO
• WordPress SSO - Azure | miniOrange Integration
• Azure Multitenant Single Sign-On (SSO) login in WordPress (WP)
• Setup Azure B2C as SAML Identity Provider (IdP)
• How to Configure Attribute Mapping in WordPress SAML SP Multiple IDP Plugin ?
• How to Configure Role Mapping in WordPress SAML SP Multiple IDP Plugin ?
• Frequently Asked Questions (FAQs)