• Home
• App Integrations
• Single Sign-On Integrations
• BigCommerce Single Sign-On

BigCommerce SSO with Azure AD

---

BigCommerce + Azure AD solution by miniOrange allows a seamless Single Sign-On solution for BigCommerce. Since BigCommerce doesn’t support SSO via Azure, miniOrange provides an interface to generate JWT token and log users into BigCommerce using their Azure AD credentials without migrating the users from their existing directory.

Prerequisites

• Log into miniOrange Admin Console.
• Click on Customization in the left menu of the dashboard.
• In Basic Settings, set your company domain in Organization Name textfield.
• Click Save. Once that is set, the branded login URL would be of the format https://<company_domain>.xecurify.com/moas/login

Follow the Step-by-Step Guide given below for BigCommerce Single Sign-On (SSO)

1. Create BigCommerce API

• Log in to BigCommerce Admin Panel.
• Go to the Advanced Settings from the menu and select API Accounts.
• Click on Create API Account and choose Create V2/V3 API Token option from the menu shown.



• Add a suitable name for your API account.
• API Path will be used as the store_hash value when we configre BigCommerce in miniOrange which will require in step2.



• Enable the Customers option as Modify and Customers Login option as login.
• Click on Save.



• Download the API credentials file. It contains the API token, Client ID and Client Secret.

2. Configure BigCommerce in miniOrange

• Login into miniOrange Admin Console.
• Go to Apps Click on Add Application button.



• In Choose Application Type click on Create App button in JWT application type.



• In the next step, search for BigCommerce application from the list and click on it.



• Enter the following values in the respective fields.
1. Custom Application Name [Required] : BigCommerce (According to your choice)
2. Description : According to your choice
3. Redirect-URL [Required] : Storefront URL, e.g. https://{{my-store}}.mybigcommerce.com/login/token/
4. Logout-URL : https://{{my-store}}.mybigcommerce.com
5. Force Authentication : Enable if you want user to authenticate even if the user has a session
6. Primary IDP : The identity source against which user will be authenticated
7. User Mapping : Enable if you are sending the logged-in user from this app in the response



1. Group Name : Default
2. Policy Name : Add policy name according to your Preference
3. Login Method : Password



• Click on Save.
• For Attribute Mapping, navigate to Select >> Edit next to your configured application.



• For Azure AD as an external IDP:
  • Enter the Client Id, App Secret and Access Token (which we have downloaded from step 1 during API creation in BigCommerce Console).
  • For Signature Algorithm, select HS-256 from the dropdown menu.
  • Set Subject to E-Mail Address.
  
  
  
  • You need to map the following attributes coming in from the idp by choosing the external IDP option.
  
  
  
  • Click on Save.
  • Now, You can access BigCommerce Account Using IDP credentials through the Single-sign-on URL as shown in image above.

3. Setting up on Azure AD

3.a. Configuring miniOrange as Service Provider (SP) in Azure AD

• Log in to Azure AD Portal.
• Select Azure Active Directory ⇒ Enterprise Applications.



• Click on New Application.




• Click on Create your own application section and enter the name for your app and click on Create button.



• Click on Single sign-on from the application's left-hand navigation menu. The next screen presents the options for configuring single sign-on. Click on SAML.



• Go to miniOrange Dashboard in the left navigation menu. Click on Add External IdP.



• Now click on the Click here link to get miniorange metadata as shown in Screen below.



• Here you will see 2 options, if you are going to initiate SSO from the Application copy the metadata details related to miniOrange from the SP - Initiated SSO section otherwise go for the metadata details from the IDP - Initiated section.



• For Basic SAML configuration you need to get the Entity ID, ACS URL, and the Single Logout URL from miniOrange.



• Enter the values in basic SAML configuration as shown in below screen

Identifier (Entity ID)	Entity ID or Issuer copied from the miniOrange metadata section mentioned in the previous step.
Reply URL (Assertion Consumer Service URL)	ACS URL copied from the miniOrange metadata section mentioned in the previous step.
Logout URL	Single Logout URL copied from the miniOrange metadata section mentioned in the previous step.



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




• Download Federation Metadata xml, and copy the Logout URL as well. This will be used while configuring the Azure AD as IDP in Step 3.b.

3.b. User/Group Assignment

• Assign users and groups to your SAML application.
• As a security control, Azure AD will not issue a token allowing a user to sign in to the application unless Azure AD has granted access to the user. Users may be granted access directly, or through group membership.
• Click on Users and groups from the applications left-hand navigation menu. The next screen presents the options for assigning the users/groups to the application.



• After clicking on Add user, Select Users and groups in the Add Assignment screen.
• The next screen presents the option for selecting user or invite an external user. Select the appropriate user and click on the Select button.



• Here, you can also assign a role to this user under Select Role section. Finally, click on Assign button to assign that user or group to the SAML application.

3.c. Configure Azure AD as Identity Provider (IDP) in miniOrange

• Go to miniOrange Admin Console.
• From the left navigation bar select Identity Provider
• Click on Add Identity Provider button.




• Select SAML. Click on Import IDP metadata.



• Choose appropriate IDP name. Browse for the file downloaded in step 1.a.
• Click on Import.



• As shown below the, IDP Entity ID, SAML SSO Login URL and x.509 Certificate will be auto filled via the imported metadata file. You can also enter the Logout URL copied from Azure AD in the Single Logout URL field.



• Few other optional features that can be enabled are listed below:

Domain Mapping	Enable to redirect domain specific user to a specific IDP
Show IdP to Users	Enable this option if you wish to show this IDP as a button on the login page. Eg : Login with Azure AD.
Send Configured Attributes	Enable this option if you wish to send user attributes from the IDP to BigCommerce while SSO.

• To map the attributes, click on + next to Attributes Mapping and enter the following attributes.

first_name	http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
email	http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
last_name	http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

• Click on Save.
• Navigate back to View Identity Providers page.
• Click on select against the configured IDP and select Make Default.

3.d. Test IDP Connection

• Go to Identity Providers tab.
• Click on Select>>Test Connection option against the Identity Provider you configured.






• On entering valid Azure Ad credentials you will see a pop-up window which as shown in below screen.



• Hence your configuration of Azure AD as IDP in miniOrange is successfully completed.

4. Test SSO Configuration

• On accessing the Single sign-On URL, you will be asked for Azure AD credentials.



• On entering the valid credentials, you will be successfully logged into BigCommerce.

5. Configure SLO in BigCommerce

• Download the script to initiate SLO in BigCommerce.
• Navigate to Storefront >> Script Manager.
• Click on create a script and add the script file which you have downloaded earlier in the footer of the page.



• Enable settings as given in the image below:



• A text box will be opened where you can add the downloaded script.

Frequently Asked Questions

External References

• What is Customer Identity and Access Management (CIAM)?
• Know about Social Login Solution
• Read more about "What is JWT" & how does it work?
• Know how to configure 2FA for Bigcommerce
• Configure Azure B2C SSO into Multiple Apps