SAML Single Sign-On (SSO) For Shopify Using miniOrange as Identity Provider

miniOrange acts as an Identity Provider (IdP), allowing users to perform Single Sign-On (SSO) into Shopify, using their miniOrange credentials. This setup ensures that your customers, employees, or B2B partners can log in to your Shopify store securely without needing separate credentials.

The solution supports both new Shopify Customer Accounts and classic/legacy accounts, works with Shopify Plus and non-Plus stores, and is ideal for B2B, wholesale, and multi-store business scenarios. With miniOrange as your central IdP, you gain enterprise-grade authentication, MFA, adaptive access policies, and centralized identity management for your Shopify storefront.

Install App Pricing Plans

Pre-requisites: App Installation

• Log in to your Shopify Admin.
• Go to Apps → Shopify App Store
• Search for miniOrange Single Sign-On – SSO
• Click Install to add the app to your store
• Open the app from Apps to start miniOrange SAML SSO configuration

Step by Step guide for Single Sign-On in Shopify Store Using miniOrange

Step 1: Get Service Provider metadata from Shopify

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

• From the list of identity providers (IDPs), select miniOrange as your identity provider.

• Click on the Get metadata button, as shown on the screen below, to get the service provider metadata.

• Navigate to SP Initiated Metadata section and copy the SP Initiated Metadata URL. Keep it handly as it will be used in furthur steps.

Step 2: Configuring Shopify as Service Provider (SP) in miniOrange

• Go to miniOrange Admin console https://login.xecurify.com/moas/login and login with your miniOrange credentials.
• From the left menu, under the Configure section click on the Apps >> Add Application.

• In the search apps textbox, type Custom SAML App. Click on the Custom SAML App application.

• Click on Import SP metdata.

• Provide appropriate App Name and paste the metadata URL copied from Step 1. Click on Import.

• Click on Save.

• Now Click on Select >> Metadata tab of currently configured application to get the identity provider (IDP) metadata.

Identity Provider (IDP) Metadata:

• If you are setting miniOrange as the IDP, go to the Metadata tab, select miniOrange as IDP, and copy the Metadata URL as shown in the image below.
• If you are using an external source as the IDP, select the External Source as IDP tab and copy the Metadata URL.
• Keep this URL handy, as it will be required in further steps.

You have completed miniOrange side configuration.

Step 3: Configure miniOrange as Identity Provider (IDP) in miniOrange.

• Navigate back to the miniOrange Single Sign On-SSO application and click on Add identity Provider button.

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

• Select SAML protocol.

• From the list of identity providers (IDPs), select miniOrange.

• Click on the Import IDP Metadata button.

• Select the upload method as Metadata Link. Paste the copied XML file link from Step 2 and Click on Import.

• Add the appropriate identity provider (IDP) Name and click on Save.

Step 4: Test Connection

• After saving the identity provider 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 miniOrange 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 5: Attribute Mapping

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

• Map the attributes by referring to the table below:

• Click on Next.

Step 6: 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

Note: If you’re using a password-protected store or working on a Shopify development store, click here to set up the storefront digest cookie so SSO can work on your store.

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

Allow Only SSO Users to Complete Checkout - Restrict Others

This feature allows only users who log in via Single Sign-On (SSO) to complete the checkout process. Other users will be blocked from proceeding with checkout.

• Navigate to Settings.



• Open the Checkout section.



• Scroll downwards, in the checkout rules section, click on Add rule.



• Click on SSO Checkout Validation.



• Deselect the "Allow all customers to complete checkout" option, and click on Save.



• Now, you can Turn on the checkout rule.



• If you attempt to checkout without performing SSO, an error will appear as shown below.

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

• Navigate back to the SSO application, and click on the Connect Store tab.
• Copy the Discovery Endpoint URL Client ID, Client Secret, Additional Scopes and Post-Logout Redirect URI Parameter and keep them handy.

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

• Select the Customer Accounts option as recommended by Shopify. Next, look for the Authentication option and click on Manage.
• If you do not find the option, please reach out to shopifysupport@xecurify.com for assistance.

• Click on the Manage Providers button.

• Click on Connect to Provider button.

• Add the Identity Provider name and from the Provider dropdown, select Custom or other.

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

Provide Login Using Username & Password

If you want to provide login using username & password along with your login with IDP option for your B2B store, then click here

Provide Login Using Email OTP

If you want to provide login using Email OTP along with your login with IDP option for your B2B store, then click here

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

In this guide, you have configured miniOrange as the Identity Provider (IdP) and Shopify as the Service Provider (SP) using the miniOrange Shopify Single Sign-On (SSO) Login App. With this setup, your users can now enjoy Single Sign-On (SSO) into Shopify using miniOrange credentials, ensuring a secure, seamless, and scalable authentication experience across your Shopify ecosystem.