OAuth Single Sign-On (SSO) For Shopify Using Microsoft Entra ID (Azure AD) as an Identity Provider

Overview

miniOrange allows Microsoft Entra ID (OAuth) to act as an IDP (Identity Provider), which allows users to Single Sign-On (SSO) into Shopify using Microsoft Entra ID (Azure AD) Credentials. Our application is compatible with all the SAML / OAuth-compliant Identity Providers. We will go through a step-by-step guide to configure Single Sign-On (SSO) into Shopify using Microsoft Entra ID (Azure AD) as IdP (OAuth) (Identity Provider) and Shopify store as SP (Service Provider).

Download Application Pricing Plans

Pre-requisite: Shopify Single Sign-On - SSO Application

To configure SSO into Shopify with Microsoft Entra ID (Azure AD) (OAuth) as IDP, you will need to install the miniOrange Shopify Single Sign On - SSO Login application on your store.

Configuration Steps

Setup guide for Configuring Microsoft Entra ID (Azure AD) as IDP (OAuth) for SSO into Shopify

Step 1: Get the Callback URL from the Shopify SSO App

• Go to your Shopify store and navigate to the App section and click on Single Sign On - SSO login application.

• Click on the Add Identity Provider button to add your IDP.

• Select OAuth 2.0 protocol.

• Now choose Microsoft Entra ID (Azure AD) from the list of IDPs.

• Copy the OAuth Callback URL and keep it handy as it will be used in further steps.

Step 2: Configuring Shopify as a Service Provider (SP) in (Microsoft Entra ID) Azure AD

• Sign in to (Microsoft Entra ID) Azure AD portal.
• Go to Home and in the Azure services, select Azure AD.

• Now, click on App Registrations and then click on the New Registration option to create a new (Microsoft Entra ID) Azure AD application.

• Configure the following options to create a new application.
• Enter a name for your application under the Name text field.
• In supported account types, select 3rd option ‘Accounts in any identity provider or organizational directory (for authenticating users with user flows)’.
• In the Redirect URI section, select the Platform type as Web and paste the callback URL copied from Step 1.
• Click on the Register button to create your application.

• After successful application creation, you will be redirected to the newly created application’s overview page. If not, you can go to the app registrations and search the name of your application and you will find your application in the list.
• Copy your Application ID and save it under your Client ID textbox in your Shopify Single Sign-On (SSO) Login application.

• Then click on Certificates and Secrets and then click on New client secret to generate a client secret. Enter a description and click on the Add button.
• Copy the secret value from the certificates & secrets page and store it as a Client secret in your Shopify Single Sign-On (SSO) Login application.

• Go to Application >> Select the application and go to the API Permissions tab.

• Click on the Add permission button, and then Microsoft Graph API -> Delegated Permissions select openid, Profile scope, and click on the Add Permissions button.

• Click on the Grant admin consent for Demo button.
• Go to the Manifest tab and find groupMembershipClaims change its value to "All" and click on the save button.

Step 3: Endpoints

• Navigate to the Overview section >> Endpoints.

• To get the User Info Endpoint, Copy your Tenant ID as Shown in the below image. For Azure AD single-tenant environment append the tenant id in the url https://login.windows.net/tenant-id/openid/userinfo.

You have completed Microsoft Entra ID (Azure AD) side configuration.

Step 4: Configure Azure AD (Microsoft Entra ID) as Identity Provider (IDP) in Shopify

• Navigate back to the miniOrange Single Sign On-SSO application.

• Click on the Add Identity Provider button to add your IDP.

• Select OAuth 2.0 protocol.

• From the list of IDPs, select Entra ID (Azure AD).

• Now, fill in the required details like Client ID, Client Secret, Endpoints, and Scope.
• Please refer to the below table for configuring the values.

• Click on Save.

You have configured Entra ID (Azure AD) as an identity provider (IDP) in Shopify.

Step 5: Test Connections

• After saving the IDP configuration, you will be redirected to the Test Connection step.
  Please perform Test Connection before mapping or fetching attributes, test connection ensures that your IDP configuration is correct.
• Click on the Test Connection button.

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

• Click on the Fetch Attributes button to fetch the IDP attribute.

Step 6: Attribute Mapping

• Click on the + Attribute Mapping button to map attributes between Shopify and Entra ID.

• Map the attributes by referring to the table below:

• Click on Next.

Step 7: Enable & Test SSO Configurations

Select Shopify Store Type:

• Non-Plus Store
• Plus Store

SSO Configuration in Non-Plus Shopify Stores

Choose the type of account you have enabled on your Shopify Store:

• Customer Accounts
• Legacy Customer Accounts

• Go to the application dashboard, enable the customer accounts extension as shown in the below image.

• Enable the New Customer Accounts extension and click on Save.

• Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.

Testing Single Sign-On (SSO) for your Shopify store

• Go to your Shopify Store.(https://<your-shopify-storedomain>)
• Click on the User login icon.

• You’ll be redirected to the login page of the identity provider (IDP) you configured in the previous step. Log in with your IDP account credentials.
• Next, enter the six-digit OTP that will be sent to your registered email address. (This is a one-time process)

• You’ll be successfully logged in to your Shopify store.

• Go to the application dashboard, you will see a warning box to add the login button extension on the Account page, click on the login widget extension link as shown in the below image to enable it.

• Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.

• If you want to configure SSO into Shopify using multiple IDPs, then select your IDP from the list provided here, and setup SSO using that IDP.
• Enable the IDP login toggle option for enabling SSO into Shopify using multiple IDPs.

Testing Single Sign-On (SSO) for your Shopify store

• Go to your Shopify Store login page.(https://<your-shopify-storedomain>/account/login)
• Click on the login button you customized earlier.

• You'll be redirected to the identity provider (IDP) login page. Now log in with your existing account credentials.

• After login, if you encounter an "invalid or missing reCAPTCHA token" error, accompanied by a "Something went wrong" message, refer to this FAQ to resolve the error.

SSO Configuration in Plus Shopify Stores

Choose the type of account you have enabled on your Shopify Store:

• Customer Accounts
• Legacy Customer Accounts

• Go back to the SSO application, and navigate to Connect Store tab. Copy the Client ID, Client Secret, Post-Logout Redirect URL and Discovery Endpoint URL and keep them handy.

• Click on the Customer Accounts link as shown in the below image.

• Select the Customer accounts option recommended by Shopify & look for the Identity Provider option, if not present please reach out to shopifysupport@xecurify.com.

• If the identity provider is present, click on Manage.

• Click on Connect to Provider button.

• Add the Identity Provider name and fill in the details such as Discovery endpoint URL, Client ID, Client secret, Additional Scopes, Post-logout redirect URI parameter that you copied from above step. Click on Save.

• Once the Identity Provider has been added, do the Test Connection.

• After verifying the flow make the identity provider as Active.

• Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.

Testing Single Sign-On (SSO) for your Shopify store

• Go to your Shopify Store.(https://<your-shopify-storedomain>)
• Click on the User login icon.

• You’ll be redirected to the login page of the identity provider (IDP) you configured in the previous step. Log in with your IDP account credentials.

• You’ll be successfully logged in to your Shopify store.

• Now, click on the Setup Guide button and follow the steps mentioned to get multipass token.

• Enable the Multipass Token option. Refer to this Faq to get the Multipass token value and paste it in the below field.

• Click on Save.

• Go to the application dashboard, you will see a warning box to add the login button extension on the Account page, click on the login widget extension link as shown in the below image to enable it.

• Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.

• If you want to configure SSO into Shopify using multiple IDPs, then select your IDP from the list provided here, and setup SSO using that IDP.
• Enable the IDP login toggle option for enabling SSO into Shopify using multiple IDPs.

Testing Single Sign-On (SSO) for your Shopify store

• Go to your Shopify Store login page.(https://<your-shopify-storedomain>/account/login)
• Click on the login button you customized earlier.

• You'll be redirected to the identity provider (IDP) login page. Now log in with your existing account credentials.

• If you encounter an "invalid or missing reCAPTCHA token" error, accompanied by a "Something went wrong" message, refer to this FAQ to resolve the error.

• You’ll be successfully logged in to your Shopify store.

Hence you have successfully configured Shopify Single Sign-On (SSO) using Google as IDP and Shopify as SP using miniOrange Single Sign-On (SSO) login application. This solution ensures that you are ready to roll out secure access to your Shopify store using Google login credentials within minutes.

Additional Resources

• Shopify Security Solutions
• Shopify Single Sign-On (SSO)
• Shopify Content restriction
• Shopify Subscription

Get in Touch

Please reach out to us at shopifysupport@xecurify.com, and our team will assist you with setting up the Shopify SSO application. Our team will help you to select the best suitable solution/plan as per your requirement.