Contents

nopCommerce SAML Single Sign-On (SSO) with Azure AD as IDP

nopCommerce SAML Single Sign-On (SSO) plugin gives the ability to enable SAML Single Sign-On for your nopCommerce applications. Using Single Sign-On you can use only one password to access your nopCommerce application and services. Our plugin is compatible with all the SAML compliant identity providers. Here we will go through a step-by-step guide to configure Single Sign-On (SSO) between nopCommerce and Microsoft Entra ID (formerly Azure AD) considering Azure AD as IdP. To know more about the features we provide for nopCommerce SSO, click here.

VIDEO GUIDE - Setup nopCommerce Single Sign-On with Microsoft Entra ID: [Link]

Pre-requisites : Download And Installation

Download from nopCommerce Dashboard

To download the plugin zip, login as admin into your nopCommerce store. In the admin dashboard, go to Configuration Tab > All Plugins and Themes or search for All Plugins and Themes in the Admin search bar.
Search for the SAML Single Sign-On (SSO) - miniOrange plugin and click the Download button to get the zip.

nopCommerce Single Sign-On (SSO) - install plugin

From nopCommerce marketplace

You can download the plugin zip file from nopCommerce store - nopCommerce SAML Single Sign-On (SSO)
To install the plugin, login as admin into your nopCommerce website. In the admin dashboard, go to Configuration Tab >> Local plugins.
On the top right corner of the page select the Upload plugin or theme button to upload the downloaded plugin zip. Follow the instructions further to install the plugin.

Steps to configure nopCommerce Single Sign-On (SSO) using Azure AD as Identity Provider

1. Configure Azure AD as IDP

You need to send your SP metadata to identity provider, Microsoft Entra ID (formerly Azure AD). For SP metadata, use the SP metadata URL or download the SP metadata as a .xml file and upload it at your IdP end. You can find both these options under the Service Provider Metadata tab.

nopcommerce Single Sign On (SSO) service provider spmetadata

Alternatively, you can manually add the SP Entity ID and ACS URL from Service Provider metadata tab in the plugin to your IdP configurations.

nopcommerce Single Sign On (SSO) service provider sptable

Azure AD setup through Enterprise Applications
Azure AD setup through App Registrations

Log in to Azure AD Portal
Select Azure Active Directory.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Enterprise registrations

Select Enterprise Application.

Click on New Application.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - New Application

Click on Create your own Application.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Add Non-Gallery Application

Enter the name for your app, then select Non-gallery application section and click on Create button.

Click on Setup Single sign-on .

Select the SAML tab.

After clicking on Edit, enter the SP Entity ID for Identifier and the ACS URL for Reply URL from Service Provider Metadata tab of the plugin.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Select SAML authentication SSO

By default, the following Attributes will be sent in the SAML response. You can view or edit the claims sent in the SAML response to the application under the Attributes tab.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Configure SAML 2.0

Copy the App Federation Metadata Url to get the Endpoints required for configuring your Service Provider.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Setup SAML 2.0

Assign users and groups to your SAML application

Navigate to Users and groups tab and click on Add user/group.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - assign groups and users

Click on Users to assign the required user and then click on select.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - add users

You can also assign a role to your application under Select Role section.
You have successfully configured Microsoft Entra ID (formerly Azure AD) as SAML IdP ( Identity Provider) for achieving Azure AD SSO login into your nopCommerce application.

2. Configure nopCommerce as SP (SSO Plugin)

Note: After installation of the plugin, we need to setup the trust between your nopCommerce application and your Azure AD account. SAML metadata is shared with Microsoft Entra ID (formerly Azure AD) so they can update their inbuilt configuration to support Single Sign-On.

2.1: Share SP SAML metadata with Azure AD

Click on Add New IDP to configure nopCommerce Single Sign-On (SSO) using Microsoft Entra ID (formerly Azure AD) as IDP.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Add new IDP

Under Service Provider Metadata tab, you can either copy-paste the metadata URL on your IDP side or download the SP metadata as an XML file. Additionally, you have the choice to manually copy and paste Base URL, SP Entity ID, and ACS URL.
Share SAML metadata with Azure AD.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - nopCommerce SP metadata

2.2: Import Azure AD SAML metadata

Under Identity Provider Settings tab, select Azure AD as your preferred identity provider.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Choose identity provider

There are two methods for configuring nopCommerce as service provider:

To upload IDP's metadata, you can either provide the metadata URL or upload XML file.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Upload IDP metadata

Alternatively, under the Identity Provider Settings tab, you can manually fill in the mandatory fields like IDP Name, IDP Entity ID and Single Sign-On URL and hit Save.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - IDP Configuration

3. Testing SAML SSO

Before testing, please ensure the following:

The nopCommerce (SP) SAML metadata has been exported to Azure AD (IDP).
Importing the Azure AD (IDP) SAML metadata in nopCommerce (SP).
Click here if you haven't already configured MFA on Azure AD. You can also disable MFA for Microsoft Entra ID (formerly Azure AD) by clicking here.

Hover on Select Action and click on the Test Configuration button to verify if you have configured the plugin correctly.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Click on Test Configuration

Click the Test Configuration button to verify if you have configured the plugin correctly.
On successful configuration, you will get Attribute Name and Attribute Values in Test Configuration window.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Test Configuration Result

4. Attribute Mapping

After successful test configuration, click on Edit Configuration and navigate to Attribute Mapping section.
On the right side, you can see the IDP response table, map attribute names provided by your IDP with your store attributes, under Attribute/Role Mapping tab.
Click on Save button.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Attribute Mapping

5. Enabling SSO in your nopCommerce store

Enable SSO for your nopCommerce store by dragging the slider as shown below.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Enable SSO

Under the Redirection & SSO link tab, use the URL labeled as Your Store SSO Link in your store to initiate the SSO.

nopCommerce Single Sign-On (SSO) using Azure AD (Microsoft Entra ID) as IDP - Store SSO Link

Additional Resources

Need Help?

Not able to find your identity provider? Mail us on nopcommercesupport@xecurify.com and we'll help you set up SSO with your IDP and 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.