Azure AD Single Sign-On SSO Magento Setup Guide with OAuth/OpenID Connect | Magento OAuth

Azure AD Single Sign-On SSO Magento Setup Guide with OAuth/OpenID Connect | Magento OAuth


Integration of Azure AD Login (Azure Active Directory OAuth Single Sign-On) with Magento using OAuth 2.0 Protocol. The Magento OAuth / OpenID Connect Single Sign-On (SSO) extension makes it easy to use OAuth2 to set up Azure AD Login on Magento (Azure AD Single Sign on).

The extension can be set up using other Social Media sources, as well as custom OAuth and OIDC providers. It contains a lot of Single Sign-On (SSO) features, like Attribute Mapping for user profiles, Role Mapping, and so on. In this guide, we'll go over how to set up SSO between Magento and Azure AD. At the end of this article, users should be able to log into Magento using Azure AD. Click here to read more about the Magento OAuth Single Sign-On (OAuth & OpenID Connect Client) extensions extra features.

The Magento OAuth & OpenID Connect Single Sign-On (SSO) extension makes it possible to log into Magento securely using Azure AD as an OAuth and OpenID Connect provider. You can also use alternative OAuth providers, such as Azure B2C, Office 365, and other custom providers, to configure the plugin. Advanced Single Sign-On features such as user profile Attribute Mapping, Role Mapping, and so on are supported. We'll go over how to set up SSO between Magento and Azure AD in this article. Users should be able to log in to Magento through Azure AD by the end of this guide.

Click here to know more about other features we provide in Magento OAuth Single Sign-On ( OAuth & OpenID Connect Client ) extension

Pre-requisites : Download And Installation

Installation using Composer:
  • Purchase the miniOrange OAuth / OpenID Connect Single Sign On extension from magento marketplace.
  • Go to My profile -> My Purchases
  • Please ensure you are using correct access keys (My Profile - Access Keys)
  • Paste the access keys in your auth.json file inside your project
  • Use the below command to add the extension to your project.
    "composer require {module_name}:{version}"
  • You can see the module name and list of versions in the selector below the extension module name.
  • Run the following commands on command prompt to enable the extension.
  • php bin/magento setup:di:compile
    php bin/magento setup:upgrade

Manual Installation:
  • Download the miniOrange OAuth OpenID Connect Single Sign-On extension.
  • Unzip all contents of the zip inside the MiniOrange/OAuth directory.
  • {Root Directory of Magento} app code MiniOrange OAuth
  • Run the following commands on command prompt to enable the extension.
  • php bin/magento setup:di:compile
    php bin/magento setup:upgrade

Magento OAuth OpenID Connect SSO extension allows login (Single Sign-On) into Magento with your Azure AD, Azure B2C, AWS Cognito, WSO2, Okta, LinkedIn, Google, Facebook, Slack, Discord or other custom OAuth 2.0 providers [24/7 SUPPORT]

 Tested with 2.4.5

Steps to configure Azure AD OAuth & OpenID Single Sign-On (SSO) Login into Magento

1. Setup Azure Active Directory as OAuth Provider

Follow the steps below to configure Azure AD as OAuth Provider

miniorange img Configure Azure AD as OAuth Provider
  • Sign in to Azure portal.
  • Select Azure Active Directory.
  • Azure AD Single Sign-on (SSO) - Login
  • In the left-hand navigation pane, click the App registrations service, and click New registration.
  • Azure AD Single Sign-on (SSO) - App-Registration
  • Enter the Name of your application.
  • Azure AD Single Sign-on (SSO) enter app name
  • Select the supported account types checkbox.
  • Magento Azure AD Single Sign-on select supported account
  • Select the platform as Web.
  • Magento Azure AD Single Sign-on (SSO) - select platform
  • Copy Callback URL from the miniOrange OAuth Client plugin (Configure OAuth tab) and save it under the Redirect URL textbox.
  • Magento2 OAuth/OpenID/OIDC Azure AD Single Sign-On Configure call back url Magento2 OAuth/OpenID/OIDC Azure AD Single Sign-On paste call back url
  • Make sure the "Grant admin consent to openid and offline_access permissions" option is enabled. When finished, click Register.
  • Magento OAuth SSO Azure AD Single Sign-on (SSO) Register
  • Azure AD assigns a unique Application ID to your application. The Application ID is your Client ID and the Directory ID is your Tenant ID, keep these values handy as you will need them to configure the miniOrange OAuth Client plugin.
  • Magento SSO OAuth 2.0 Azure AD Single Sign-on (SSO) applications details
  • Copy the Application (Client) ID and paste it as Client ID in miniOrange OAuth Client plugin.
  • Magento SSO OAuth 2.0 Azure AD Single Sign-on (SSO) applications details
  • Now, Go to Certificates and Secrets from the left navigaton pane and click on New Client Secret. Enter description and expiration time and click on ADD option.
  • Magento OAuth Azure AD Single Sign-on (SSO) secret-Key OAuth/OpenID/OIDC
  • Copy the secret key "value" and paste it as Client Secret under the miniOrange Magento OAuth Client Plugin.
  • Magento SSO Azure AD Single Sign-on (SSO) secret key value
  • Navigate to API Permission tab from the left pane and click on Add a permission option.
  • Magento SSO Azure AD Single Sign-on (SSO) API Permission
  • Click on Microsoft Graph.
  • Microsoft graph Magento SSO Azure AD Single Sign-on (SSO)
  • Select Delegated Permission option.
  • Magento SSO Azure AD Single Sign-on (SSO) Delegated permissions
  • Enable permissions for Email, OpenID, and Profile and click on Add permission button.
  • Magento SSO Azure AD Single Sign-on (SSO) enable API Permission

2. Configuring Magento 2 as OAuth Client

  • After successfully configuring OAuth Provider, go to OAuth Provider tab and configure OAuth Provider Name, Client ID, Client Secret, Scope and provided endpoints.

    Please refer below Endpoints to configure the OAuth client


    Scope: openid email profile
    Authorize Endpoint: https://login.microsoftonline.com/[tenant-id]/oauth2/v2.0/authorize
    Access Token Endpoint: https://login.microsoftonline.com/[tenant-id]/oauth2/v2.0/token
    Get User Info Endpoint: https://graph.microsoft.com/oidc/userinfo
  • Click on the Save button to save the settings.
  • Click on the Test Configuration button.
  • Magento 2 OAuth credentials Azure AD SSO OAuth
  • You will see all the values returned by your OAuth Provider to Magento in a table. If you don't see value for First Name, Last Name, Email or Username, make the required settings in your OAuth Provider to return this information.
  • The miniOrange Premium Plugin also provides you the the feature to auto redirect your user to the IdP Login Page.
  • Magento 2 OAuth auto redirect to idp
  • Go to the Sign In Settings tab and check options to enable SSO on your Magento site.
  • Magento 2 OAuth enable SSO
  • You have successfully configured your Magento 2 as an OAuth Client. You will see the SSO button on your frontend. Click on the button and test the SSO.
  • Magento 2 OAuth SSO Azure AD SSO Azure AD magento SSO magento 2 OAuth client SSO Azure AD SSO

3: Attribute / Custom Mapping (Optional). *This is Premium feature.

  • You can map attributes in the Attribute Mapping tab. Only username and email are allowed to be mapped in free version of the plugin. However, in the premium version of the plugin, you can map various attributes coming from your OAuth Provider to the attributes present in your Magento site.
  • Magento 2 OAuth attribute mapping

4: Role Mapping (Optional). *This is Premium feature.

  • You can specify a default role in the free plugin that will be allocated to all non-admin users when they conduct SSO.
  • Go to Attribute/Role mapping tab and navigate to Role Mapping section.
  • Select the Default Role and click on the Save button.
  • Azure AD Magento SSO - Azure AD Single Sign-On(SSO) Login in Magento - role mapping

By configuring Azure AD as an OAuth Provider and Magento as an OAuth Client using our Magento OAuth Client plugin, you have successfully installed Magento Azure AD (Active Directory) Single Sign-On (SSO). Within minutes, you'll be able to provide safe access to your Magento site utilising Azure AD login credentials thanks to this solution.


Additional Resources


If you are looking for anything which you cannot find, please drop us an email on magentosupport@xecurify.com

Hello there!

Need Help? We are right here!

support
Contact miniOrange Support
success

Thanks for your inquiry.

If you dont hear from us within 24 hours, please feel free to send a follow up email to info@xecurify.com