Hello there!

Need Help? We are right here!

miniOrange Email Support

Thanks for your Enquiry.

If you don't hear from us within 24 hours, please feel free to send a follow-up email to info@xecurify.com

Search Results:


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.

BigCommerce Single Sign-On (SSO)

Video Setup Guide


  • 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
  • 2FA Two-Factor authentication for BigCommerce : setting up branding

Connect with External Source of Users

miniOrange provides user authentication from various external sources, which can be Directories (like ADFS, Microsoft Active Directory, Azure AD, OpenLDAP, Google, AWS Cognito etc), Identity Providers (like Shibboleth, Ping, Okta, OneLogin, KeyCloak), Databases (like MySQL, Maria DB, PostgreSQL) and many more.

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.
  • BigCommerce Single Sign-On (SSO): API account

  • 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.
  • BigCommerce Single Sign-On (SSO): API Path

  • Enable the Customers option as Modify and Customers Login option as login.
  • Click on Save.
  • BigCommerce Single Sign-On (SSO): API Configuration

  • Download the API credentials file. It contains the API token, Client ID and Client Secret.
  • BigCommerce Single Sign-On (SSO): API Credential Download

2. Configure BigCommerce in miniOrange

  • Login into miniOrange Admin Console.
  • Go to Apps Click on Add Application button.
  • BigCommerce Single Sign-On (SSO) add app

  • In Choose Application Type click on Create App button in JWT application type.
  • BigCommerce Single Sign-On (SSO) choose JWT as app type

  • In the next step, search for BigCommerce application from the list and click on it.
  • BigCommerce Single Sign-On (SSO): Select BigCommerce Application

  • 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
    BigCommerce Single Sign-On (SSO): add jwt app

    1. Group Name : Default
    2. Policy Name : Add policy name according to your Preference
    3. Login Method : Password
    BigCommerce Single Sign-On (SSO): add jwt app

  • Click on Save.
  • For Attribute Mapping, navigate to Select >> Edit next to your configured application.
  • BigCommerce Single Sign-On (SSO): add jwt app

  • 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.
    • BigCommerce Single Sign-On (SSO): configure Client ID and Client Secret

    • You need to map the following attributes coming in from the idp by choosing the external IDP option.
    • Attribute Mapping

    • 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 DirectoryEnterprise Applications.
  • BigCommerce Azure AD: azure ad sso Enterprise Applications

  • Click on New Application.

  • BigCommerce Azure AD: azure ad sso New Application

  • Click on Create your own application section and enter the name for your app and click on Create button.
  • BigCommerce Azure AD: azure ad sso Non-gallery application

  • 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.
  • BigCommerce Azure AD: azure ad sso Single sign-on

  • Go to miniOrange Dashboard in the left navigation menu. Click on Add External IdP.
  • BigCommerce Azure AD: azure ad add external IDP

  • Now click on the Click here link to get miniorange metadata as shown in Screen below.
  • BigCommerce Azure AD: azure ad get miniorange metadata

  • 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.
  • BigCommerce Azure AD: azure ad SPintiatedMetadata

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

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

  • BigCommerce Azure AD: azure ad sso 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.
  • dowload Azure ad metadata

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.
  • BigCommerce Azure AD: azure ad sso-13

  • 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.
  • BigCommerce Azure AD: azure ad sso selecting user or invite an external user

  • 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.
  • BigCommerce Azure AD: azure ad sso 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.

  • BigCommerce Azure AD SSO: azure ad Identity Provider

  • Select SAML. Click on Import IDP metadata.
  • BigCommerce Azure AD SSO: azure ad Import IDP metadata

  • Choose appropriate IDP name. Browse for the file downloaded in step 1.a.
  • Click on Import.
  • BigCommerce Azure AD SSO: azure ad 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.
  • BigCommerce Azure AD SSO: SAML SSO Login URL and x.509 Certificate

  • 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.
  • BigCommerce - 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.
  • BigCommerce Azure AD SSO: azure AD IDP Test Connection

    BigCommerce Azure AD SSO: azure AD login

  • On entering valid Azure Ad credentials you will see a pop-up window which as shown in below screen.
  • BigCommerce Azure AD SSO: Success Test Connection AZure AD IDP

  • 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.
  • BigCommerce Azure AD SSO: azure AD login

  • On entering the valid credentials, you will be successfully logged into BigCommerce.
  • BigCommerce Single Sign-On (SSO): BigCommerce Login

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.
  • BigCommerce Single Sign-On (SSO): create script

  • Enable settings as given in the image below:
  • BigCommerce Single Sign-On (SSO): enable settings

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

Frequently Asked Questions

Yes, our scripts are completely customizable and you can restrict page access based on memberships, groups, company . domain or any other custom attribute of your choice.

We handle this by adding the no script tags in our script file, this enables redirection of your users to a customizable page with instructions to enable javascript.

External References

Want To Schedule A Demo?

Request a Demo

Our Other Identity & Access Management Products