Contents

Single Sign-On (SSO) with WSO2 for Magento OAuth | WSO2 SSO Login | Magento SSO

Magento OAuth/OpenID Connect Single Sign-On module gives the ability to enable OAuth/OpenID Single Sign-On for Magento. If you want users to log in to your Magento site using their WSO2 credentials, you can simply do it using our Magento OAuth/OpenID Connect Single Sign-On module. Once you configure the WSO2 with the Magento module, you can allow users to SSO to your Magento site using WSO2. It has powerful Single Sign-On (SSO) features like user profile attribute mapping and role mapping, among others. We'll go over how to set up Single Sign-On (SSO) for user authentication between Magento and WSO2 in this guide.

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

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 miniorange_inc/miniorange-oauth-sso"
```
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 zip from here.
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

OAuth / OpenID Connect Single Sign On – SSO (OAuth Client)

By miniOrange

(1)

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]

Get this plugin

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

1. Setup WSO2 as OAuth Provider

Follow the steps below to configure WSO2 as OAuth Provider

Configure WSO2 as OAuth Provider

Firstly, Register the Consumer App in WSO2 Identity Server. Download and start WSO2 Identity Server.

WSO2 Single Sign-On (SSO) with WSO2 login credentials Magento SSO : appregister-wso2 | Magento Wso2

Once logged in, Navigate to Main -> Service Provider and click on Add.

WSO2 Single Sign-On (SSO) with WSO2 login credentials Magento SSO : sp-Add

Enter the Service Provider Name and Description and click on Register button.

WSO2 Single Sign-On (SSO) with WSO2 login credentials Magento SSO : Enter-spname-description | Magento Wso2

Now go to the Service Provider->List and edit the Service Provider you have created.
Scroll down and select Inbound Authentication Configuration and then select OAuth/OpenID Connect Configuration and click on Configure button.

WSO2 Single Sign-On (SSO) with WSO2 login credentials Magento SSO :wso2 configure | Magento Wso2

Select the OAuth Version as 2.0 and enter the Redirect/Callback URL from the plugin in Callback URL field. Click on Add button.

WSO2 Single Sign-On (SSO) with WSO2 login credentials Magento SSO callbackURL | Magento Wso2

When the app has been added, Client ID and Client Secret are generated for the application. Configure the Magento OAuth SSO plugin with Client ID, Client Secret, Authentication and Access Token, Get User Info Endpoint of WSO2. Endpoints are provided at the bottom of this guide.

Magento SSO WSO2 Single Sign-On (SSO) with WSO2 login credentials :getclient-secret | Magento Wso2

Attribute Mapping: To get attributes from WSO2 you have to add following Claim URIs in your WSO2 application.
Go to Service Provider->Claim Configuration.
Select https://wso2.org/claims/emailaddress from Subject Claim URI dropdown.
Add following URIs in Service Provider Claim Dialect: https://wso2.org/oidc/claim & https://wso2.org/claims

WSO2 Magento SSO with WSO2 login credentials : claim-url

You have successfully completed your WSO2 Server side configurations.

WSO2 Identity Server as an OAuth Provider is successfully configured from the above step for achieving WSO2 Single Sign-On (SSO) with WSO2 login credentials into your Magento Site.

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. (You can copy these values in STEP 2 from the application dashboard.)

Please refer below Endpoints to configure the OAuth client

Scope:	openid
Authorize Endpoint:	https://<wso2-domain-name>/oauth2/auth
Access Token Endpoint:	https://<wso2-domain-name>/oauth2/token
Get User Info Endpoint:	https://<wso2-domain-name>/oauth2/userinfo

Click on the Save button to save the settings.
Click on the Test Configuration button.

Magento 2 OAuth credentials WSO2 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.

Go to the Sign In Settings tab and check options to enable SSO on your Magento site.

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.

WSO2 magento SSO magento 2 OAuth client SSO WSO2 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.

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.

WSO2 Magento SSO - WSO2 Single Sign-On(SSO) Login in Magento - role mapping

By configuring WSO2 as an OAuth Provider and Magento as an OAuth Client using our Magento OAuth Client plugin, you have successfully installed Magento WSO2 (Active Directory) Single Sign-On (SSO). Within minutes, you'll be able to provide safe access to your Magento site utilising WSO2 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