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 WordPress
considering WordPress as IdP. To know more about the features we provide for
nopCommerce SSO, click
here.
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.
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 WordPress as
Identity Provider.
1. Configure WordPress as IDP
-
You need to send your SP metadata to identity provider, WordPress. 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.
-
Alternatively, you can manually add the SP Entity ID and ACS URL from
Service Provider metadata tab in the plugin to your IdP
configurations.
- Navigate to the WordPress site.
-
Install and activate the
SAML & WSFED IDP ( SSO using WordPress Users )
plugin on your WordPress site which is acting as Identity Provider.
-
Go to the WordPress IDP plugin, navigate to the
Service Provider tab.
-
Enter the values corresponding to the information from the Service Provider.
Refer to the table below.
|
Service Provider Name
|
Name of your Service Provider. |
| SP Entity ID or Issuer |
Copy and paste the SP-EntityID from the Service
Provider
|
| ACS URL |
Copy and paste the ACS URL from the Service
Provider.
|
| NameID Format |
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
|
| Assertion Signed |
Checked |
-
Click on the Save button to save your configurations.
-
Go to the IDP Metadata tab. Here you can find information
for configuring the Service Provider.
-
You can also download the metadata XML file, by clicking on the
download link.
You have successfully configured WordPress as identity provider.
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 WordPress account. SAML metadata
is shared with WordPress so they can update their inbuilt configuration to
support Single Sign-On.
2.1: Share SP SAML metadata with WordPress
-
Click on Add New IDP to configure nopCommerce Single Sign-On (SSO)
using WordPress as 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 WordPress.
2.2: Import WordPress SAML metadata
-
Under Identity Provider Settings tab, select WordPress as your
preferred 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.
-
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.
3. Testing SAML SSO
- Before testing, please ensure the following:
-
The nopCommerce (SP) SAML metadata has been exported to WordPress (IDP).
- Importing the WordPress (IDP) SAML metadata in nopCommerce (SP).
-
Hover on Select Action and click on the
Test Configuration button to verify if you have configured the plugin
correctly.
-
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.
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.
5. Enabling SSO in your nopCommerce store
-
Enable SSO for your nopCommerce store by dragging the slider as shown below.
-
Under the Redirection & SSO link tab, use the URL labeled as
Your Store SSO Link in your store to initiate the SSO.
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.
