nopCommerce SAML Single Sign-On Setup Guides

Step 1: Download and install NopCommerce SAML Plugin

A) 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.

B) From NopCommerce marketplace

• You can download the plugin zip file from NopCommerce store - SAML Single Sign-On (SSO) - miniOrange - NopCommerce
• 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.

Step 2: Configure nopCommerce SAML Single Sign-On Plugin

Note: After installation of the plugin, we need to setup the trust between your nopCommerce application and your desired identity or partner provider.
SAML metadata is shared with partner providers so they can update their inbuilt configuration to support Single Sign-On.

Step 2.1: Share SP SAML metadata with partner provider

• Click on Add New IDP to configure nopCommerce Single Sign-On (SSO) with your preferred 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 your partner provider.

Step 2.2: Import partner's SAML metadata

• Under Identity Provider Settings tab, choose your preferred IDP from the list of identity providers listed below.

• 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.

Step 3: Testing SAML SSO

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

• On successful configuration, you will get the Attribute Name and Attribute Values in the test configuration window shown below.

Step 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.

Step 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.