OAuth Single Sign-On (SSO) For Shopify Using Azure AD as Identity Provider
miniOrange allows (Microsoft Entra ID) Azure AD (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 (Identity Provider) and Shopify store as SP (Service Provider).
Pre-requisite: Single Sign-On - SSO Login Application
To configure SSO with (Microsoft Entra ID) Azure AD as IDP, you will need to install the miniOrange Single Sign On - SSO Login Application on your Shopify store:
miniOrange Provides Secure Single Sign-On (SSO) access to your Shopify applications(both plus and Non-plus Stores).
Step by Step guide for Configuring (Microsoft Entra ID) Azure AD as IDP for SSO into Shopify
Step 1: Step to get the Redirect URI from Shopify
- Navigate to the miniOrange Single Sign On-SSO application and click on Add identity Provider button.
- Select OAuth protocol.
- From the list of identity providers (IDPs), select Azure AD (Microsoft Entra ID) .
- Note down the Callback URL which will be required while configuring SSO.
- Click on Save.
Step 2: Setup (Microsoft Entra ID) Azure AD as OAuth Provider
- 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.
You have completed the (Microsoft Entra ID) Azure AD side configurations.
Step 3: Endpoints
- Navigate to the Overview section >> Endpoints.
Step 4: Configure Azure AD (Microsoft Entra ID) as an Identity provider (IDP) in Shopify
- Navigate back to the miniOrange Single Sign On-SSO application and click on Add identity Provider button.
- Select OAuth protocol.
- From the list of identity providers (IDPs), select Azure AD (Microsoft Entra ID).
- Enter the identity provider (IDP) display name.
- Now, fill in the required details like Endpoints, Client ID, Client Secret, and Scope.
- Click on Save.
| App Name | Azure AD B2C |
| App Display Name | Choose the appropriate Name |
| OAuth Authorize Endpoint | from Step 3 |
| OAuth Access Token Endpoint | from Step 3 |
| Client ID | from Step 2 |
| Client secret | from Step 2 |
| Scope | openid |
5. Test Connection
- After saving the IDP configuration, you will be redirected to Test Connection step.
- Perform test connection before mapping or fetching attributes, test connection ensures that your IDP configuration is correct.
- Click on Test Connection.
- On entering valid Azure AD (Microsoft Entra ID) credentials you will see a pop-up window which as shown in below screen.
- Click on the Fetch Attributes to fetch IDP attribute.
6. Attribute Mapping
- Click on the + Attribute Mapping button to map attributes between Shopify and Azure AD (Microsoft Entra ID).
- Map the attributes by referring the table below:
- Click on Save.
- Navigate to the application home page. Click More actions against the configured IDP, and click on Make Default to set your IDP as default.
| Attribute Name in Shopify | Choose the attribute from the list of predefined attributes |
| Attribute Type | IDP Attribute |
| Attribute Value | Select the attribute value you have fetched from your IDP |
7. Testing 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 login page of the IDP you configured in previous step. Log in with your IDP account credentials.
- You’ll be successfully logged in to your Shopify store.
In this Guide, you have successfully configured (Microsoft Entra ID) Azure AD (OAuth) Single Sign-On (SSO) by
configuring (Microsoft Entra ID) Azure AD as OAuth Provider and Shopify as OAuth Client using our
Shopify Single Sign-On - SSO Login App. This solution ensures that you are ready to roll out secure access to
your Shopify Store using (Microsoft Entra ID) Azure AD login credentials within minutes.
Troubleshooting
invalid_request
This may be because your primary domain would be different from your Shopify domain. To check your primary domain and make SSO work, follow the steps given here.
shopify_plan_expired
This issue arises when either the trial period of your Development plan is expired. Or if your plan is not auto-renewed from the Shopify end. Contact us at shopifysupport@xecurify.com to resolve the plan upgrade issue and get smooth functioning of the SSO – Single Sign On Application.
invalid_attributes_received
As email is a required entity in Shopify for account creation as well as login operation, Single Sign On is not successful in this case. To resolve this error, please follow given here.
encountered_an_error
When I am performing SSO, I am getting ‘Please verify if Shopify App is installed’ error. To resolve this error, please follow given here.
If your error or query is not listed here, click here to see others.
Frequently Asked Questions (FAQs)
I have followed the steps to set IdP but where can I check SSO?
Follow the steps outlined here. to configure SSO in Shopify with your preferred IDP.
I installed the Shopify SSO application. I clicked on the “SETUP IDP” option but nothing opened up.
Redirection to any other site might be blocked in the browser. Please follow the steps given here to resolve the issue.
When I try to perform SSO, I get redirected to the “Incorrect App Configuration” page and then after subsequent attempts, I get redirected to https://store.xecurify.com/moas/login page.
You might be trying to perform SSO in the different tab of the same browser where you have
opened
our Single Sign-On – SSO Application or accessed the configuration portal of our application. In
this case, SSO will be restricted due to security reasons.
Try to perform Single Sign On in a new incognito/private window or in a
different
browser in order to make SSO work.
After performing SSO, I want my customers to redirect to the collections or discount offer page.
Follow the steps outlined here. to redirect your customer to collections/cart or any other page.
Choose your preferred Identity Provider and start setting up SSO for Shopify right away
Additional Resources
If you are looking for anything that you cannot find, please drop us an email at shopifysupport@xecurify.com
Need Help? We are right here!
