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 Settings >> API >> Store-level API Accounts.



• Click Create API Account and choose the token type as V2/V3 API Token.
• Add a suitable name for your API account.

  Note: In BigCommerce, the API Path is the base URL that your application or integration uses to connect to your store’s data through BigCommerce APIs. The Store Hash is a unique identifier automatically generated by BigCommerce for each store. It appears in the API Path.

• Copy the highlighted Store Hash from the API Path.



• Enable the Customers option as Modify and Customers Login option as login. Keep rest of the settings as it is.
• 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 the Choose Application section, open the dropdown list of All Apps and select JWT.



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



• Enter the following values in the respective fields.



• Enter the Client ID, Client secret and Access token which we have downloaded from step 1 during API creation in BigCommerce Console.

  Display Name [Required]	BigCommerce (According to your choice)
  Redirect-URL [Required]	Refer to the Note section below to get the Redirect URL.
  Client ID	Copy from the downloaded file in Step 1
  Client Secret	Copy from the downloaded file in Step 1
  Access Token	Copy from the downloaded file in Step 1
  Description	According to your choice

  Note: Your Redirect URL should be: <Storefront URL>/login/token/
  For Example: https://xyz.bigcommerce.com/login/token/
  

  To find your Storefront URL: Go to Channels >> Storefronts. Copy the URL listed for your store.

  
  
  


• Now next move to Advanced tab.




Subject	E-Mail Address.
Signature Algorithm	HS256
Logout URL	Copy the storefront URL as mentioned above and append /login.php?action=logout

• Click Next to go to the Login Options tab.




Primary Identity Provider	The identity source against which user will be authenticated
Force Authentication	Enable if you want user to authenticate even if the user has a session
Enable User Mapping	Enable if you are sending the logged-in user from this app in the response

• Click on Next and proceed to the Attributes tab.

For Microsoft Entra ID as an external IDP:

• To map the attributes between the external IDP and BigCommerce application, navigate to Attributes tab. Click on the + Add Attribute button.
• You need to map the attributes received from the IDP by selecting the External IDP option.
• The first three attributes will be hard-coded values

  Attribute Name	Attribute Type	Attribute Value
  store_hash	Custom Attribute Value	Refer to Step 1 above.
  redirect_to	Custom Attribute Value	Endpoint where you wish to redirect the user to after sso. [Homepage or account page e.g. /account.php]
  operation	Custom Profile Attribute	customer_login
  first_name	External Idp Attribute	first_name
  last_name	External Idp Attribute	last_name
  email	External Idp Attribute	email




• Click on the Next button.
• Navigate to Policies tab.
• Click on Assign Group button.



• On the Assign Group section.
• Choose the DEFAULT group.
• Click on the Next button.



• Assign the policies to the group. Here, you can choose the primary authentication method for users. From the dropdown under First Factor, select Password.
• Click on Save.

3. Syncing Address, Form, and Custom Attribute Fields to BigCommerce (Optional)

To synchronize address, custom attributes, and form fields from the Identity Provider (IDP) to BigCommerce, the following details must be configured:

Address Fields

To successfully sync customer address information, the following attributes are required:

• first_name
• last_name
• address1
• city
• country_code

• miniOrange as IDP
• ExternaI Identity Provider

In the below diagram, we are using miniOrange as the IDP.

• Before syncing these fields to BigCommerce, you must first create the corresponding attributes in the miniOrange user profile. These attributes will then be mapped and synced to BigCommerce.



• Then we need to configure the attribute mapping in the application.

  Attribute Name	Attribute Type	Value
  addresses.first_name	First Name	-
  addresses.last_name	Last Name	-
  addresses.address1	Custom Profile Attribute	address1
  addresses.city	Custom Profile Attribute	city
  addresses.state_or_province	Custom Profile Attribute	state/province
  addresses.country_code	Custom Profile Attribute	country
  addresses.postal_code	Custom Profile Attribute	postal_code





Note: When sending the country value, always use the country code (e.g., US, IN). If you pass the full country name such as “United States”, the value will not be updated — only country codes are supported for correct mapping.

While syncing address fields, ensure that the city, state, and country values you provide are valid options supported by BigCommerce and exist in their respective dropdown lists.



• Now, after completing SSO, go to your BigCommerce dashboard. From the sidebar, click on Customers.
• You will see the list of all customers. Search for the specific user and click on their name.
• Next, open the Customer Address Book section — this is where you will be able to view the customer’s address details.

For the Sign up form fields:

• In BigCommerce, the following form fields are available. We need to configure the corresponding attribute mappings in the application to ensure these fields are correctly synced to BigCommerce.



• Then we need to configure the attribute mapping in the application.

  Attribute Name	Attribute Type	Value
  addresses.first_name	First Name	-
  addresses.last_name	Last Name	-
  addresses.address1	Custom Profile Attribute	address1
  addresses.city	Custom Profile Attribute	city
  addresses.state_or_province	Custom Profile Attribute	state/province
  addresses.country_code	Custom Profile Attribute	country
  addresses.postal_code	Custom Profile Attribute	postal_code
  form_fields.name.0	Custom Attribute Value	Law School
  form_fields.value.0	Custom Attribute Value	XYZ
  form_fields.name.1	Custom Attribute Value	Bar Exam State
  form_fields.value.1	Custom Attribute Value	Arizona
  form_fields.name.2	Custom Attribute Value	Bar Exam Date
  form_fields.value.2	Custom Attribute Value	31-12-2025
  form_fields.name.3	Custom Attribute Value	Estimated Graduation Month
  form_fields.value.3	Custom Attribute Value	January
  form_fields.name.4	Custom Attribute Value	Estimated Graduation Year
  form_fields.value.4	Custom Attribute Value	2025




• After completing SSO, go to your BigCommerce dashboard.
• From the left sidebar, click on Customers.
• You will now see the list of all customers.
• Search for the specific user and click on their name.
• The customer profile will open — scroll down to the Customer Details section.
• Here, you will see the signup form fields, where you can view all the customer-submitted form-field details.

For the Attribute Fields

• In BigCommerce, the following attribute fields are available. We need to configure the corresponding attribute mappings in the application to ensure these fields are correctly synced to BigCommerce.



• Then we need to configure the attribute mapping in the application.

  Attribute Name	Attribute Type	Value
  color	Custom Profile Attribute	blue
  customer_address	Custom Profile Attribute	MG road
  customer_mobile	Custom Profile Attribute	+911234567890
  DOB	Custom Profile Attribute	2002-01-01
  attribute_string 01	Custom Profile Attribute	testing




• After completing SSO, go to your BigCommerce dashboard.
• From the left sidebar, click on Customers.
• You will now see the list of all customers.
• Search for the specific user and click on their name.
• The customer profile will open — scroll down to the Customer Details section.
• Here, you will see the attribute fields, where you can view all the customer-submitted form-field details.

NOTE: Update customer profile during sso

• Go to the BigCommerce application you have configured in miniOrange.
• Open the Advanced tab.
• Scroll to the bottom of the page.
• Enable the checkbox Update Customer Profile During SSO.

For ExternaI Identity Provider

• Before syncing these fields to BigCommerce, you must first create the corresponding attributes in your external IDP. These attributes will then be mapped and synced to BigCommerce.
• Then we need to configure the attribute mapping in the application.
• For Address field:

  Attribute Name	Attribute Type	Value
  addresses.first_name	External Idp Attribute	first_name
  addresses.last_name	External Idp Attribute	last_name
  addresses.address1	External Idp Attribute	street1
  addresses.city	External Idp Attribute	city
  addresses.state_or_province	External Idp Attribute	state
  addresses.country_code	External Idp Attribute	country
  addresses.postal_code	External Idp Attribute	zipcode





Note: When sending the country value, always use the country code (e.g., US, IN). If you pass the full country name such as “United States”, the value will not be updated — only country codes are supported for correct mapping.

While syncing address fields, ensure that the city, state, and country values you provide are valid options supported by BigCommerce and exist in their respective dropdown lists.



• Now, after completing SSO, go to your BigCommerce dashboard. From the sidebar, click on Customers.
• You will see the list of all customers. Search for the specific user and click on their name.
• Next, open the Customer Address Book section — this is where you will be able to view the customer’s address details.




For the Sign up form fields:

• In BigCommerce, the following form fields are available. We need to configure the corresponding attribute mappings in the application to ensure these fields are correctly synced to BigCommerce.




Attribute Name	Attribute Type	Value
form_fields.name.0	Custom Attribute Value	Law School
form_fields.value.0	External Idp Attribute	law_school
form_fields.name.1	Custom Attribute Value	Bar Exam State
form_fields.value.1	External Idp Attribute	bar_exam_state
form_fields.name.2	Custom Attribute Value	Bar Exam Date
form_fields.value.2	External Idp Attribute	bar_exam_date
form_fields.name.3	Custom Attribute Value	Estimated Graduation Month
form_fields.value.3	External Idp Attribute	month
form_fields.name.4	Custom Attribute Value	Estimated Graduation Year
form_fields.value.4	External Idp Attribute	year




• After completing SSO, go to your BigCommerce dashboard.
• From the left sidebar, click on Customers.
• You will now see the list of all customers.
• Search for the specific user and click on their name.
• The customer profile will open — scroll down to the Customer Details section.
• Here, you will see the signup form fields, where you can view all the customer-submitted form-field details.




For Custom Attribute Fields

• In BigCommerce, the following attribute fields are available. We need to configure the corresponding attribute mappings in the application to ensure these fields are correctly synced to BigCommerce.



• Then we need to configure the attribute mapping in the application.

  Attribute Name	Attribute Type	Value
  color	External Idp Attribute	color
  customer_address	External Idp Attribute	address
  customer_mobile	External Idp Attribute	mobile_number
  DOB	External Idp Attribute	birth_date
  attribute_string 01	External Idp Attribute	string




• After completing SSO, go to your BigCommerce dashboard.
• From the left sidebar, click on Customers.
• You will now see the list of all customers.
• Search for the specific user and click on their name.
• The customer profile will open — scroll down to the Customer Details section.
• Here, you will see the attribute fields, where you can view all the customer-submitted form-field details.




NOTE: Update customer profile during sso

• Go to the BigCommerce application you have configured in miniOrange.
• Open the Advanced tab.
• Scroll to the bottom of the page.
• Enable the checkbox Update Customer Profile During SSO.

4. Setting up on Microsoft Entra ID

4.a. Configuring miniOrange as Service Provider (SP) in Microsoft Entra ID

• Log in to Microsoft Entra ID Portal.
• Select Microsoft Entra ID (Azure Active Directory) >> Enterprise apps.
• 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. Go to Add Identity Source >> and click Setup.



• In Choose Identity Provider, select SAML from the dropdown.



• Then, search for Entra ID and click on it.



• 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 Microsoft Entra ID as IDP in Step 3.c.

4.b. User/Group Assignment

• Assign users and groups to your SAML application.
• As a security control, Microsoft Entra ID will not issue a token allowing a user to sign in to the application unless Microsoft Entra ID has granted access to the user.
• Users may be granted access directly or through group membership.
• Click on Users and groups from the application's 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.

4.c. Configure Microsoft Entra ID as Identity Provider (IDP) in miniOrange

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



• Then, search for Entra ID and click on it.



• Click on Import IDP Metadata.



• Choose an appropriate IDP name. Browse for the file downloaded in step 3.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 Microsoft Entra ID 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. E.g., Login with Microsoft Entra ID.
  Send Configured Attributes	Enable this option if you wish to send user attributes from the IDP to BigCommerce while SSO.

• Now Save the application.
• To map the attributes, click on your configured Identity Providers, then click on the three dots (⋮) under Actions, and select Attribute Mapping.






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 External Identity Providers page.
• Click on select against the configured IDP and select Make Default.

4.d. Test IDP Connection

• Go to Identity Providers tab.
• Search for your app, click the three dots in the Actions menu, and select Test Connection against the Identity Provider (IDP) you configured.



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



• Hence, your configuration of Microsoft Entra ID as IDP in miniOrange is successfully completed.

5. Test SSO Configuration

• On accessing the Single sign-On URL, you will be asked for Microsoft Entra ID credentials.



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

6. 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 Header 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
• Microsoft Entra ID Provisioning and Deprovisioning Configuration