Contents

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

miniOrange allows Auth0 to act as an IDP (Identity Provider), which allows users to Single Sign-On (SSO) into Shopify using Auth0 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 Auth0 as IdP (Identity Provider) and Shopify store as SP (Service Provider).

Pre-requisite : Single Sign On - SSO Application

To configure SSO into Shopify with Auth0 as IDP, you will need to install the miniOrange Single Sign On - SSO Login Application on your Shopify store:

Shopify Single Sign-On (SSO)

By miniOrange

miniOrange Provides Secure Single Sign-On (SSO) access to your Shopify stores(both plus and Non plus Stores).

Get this application

Step by Step guide for Configuring Auth0 as IDP for SSO into Shopify

1. Configure miniOrange as SP in Auth0

Log in to Auth0 dashboard.
Click on Applications.
Click on Create Application.
A new window will pop-up. Enter a name for the application and select Regular Web App. Click on CREATE button.
Select the Addons tab.
Enable SAML2 option in the addons. It will open up a Configuration window.
For the above SAML configuration you need to get the Entity ID and ACS URL from Shopify
Now go to your Shopify store and navigate to App section and click on Single Sign On - SSO login application.
Click on Setup IDP button in the top left in navigation bar.
Click on Configure SSO >> Add Identity Provider.
Select SAML protocol. Now click on the Click here link to get miniOrange metadata as shown in Screen below.
For SP - INITIATED SSO section Select Show Metadata Details.

Enter the values in basic SAML configuration as shown in below screen.

Audience URL	SP Entity ID
Recipient	ACS URL
Callback URL	Single Logut URL

Enter Application Callback URL, Audience, Recipient and other settings using SP entity ID and ACS URL copied from your Shopify SSO app.
Scroll down and click on Save.
Go to the Usage tab and click on the Identity Provider Metadata download link. It will download the metadata XML file which you'll need for setting up the SAML plugin.

You have successfully completed Auth0 side configuration.

2. Configure Auth0 as Identity Provider (IDP) in miniOrange

Again navigate to the App section of Shopify store and click on Single Sign On - SSO Login application.
Click on Setup IDP button in the top left in navigation bar.
From the left navigation bar select Configure SSO and click on Add Identity Provider.
Select SAML and click on Import IDP metadata.
Enter IDP name and browse for the file downloaded in step 1. Click on Import.

If you don't have metadata file, you can also provide the details manually. You need to configure following endpoints:

IDP Entity ID	Entity ID of IDP
Single Login URL	Login Url from IDP
Single Logout URL	Logout Url from IDP
X.509 Certificate	The public key certificate of your Keycloak server.

Click on Save.

You have successfully completed Shopify side configuration.

3. Test Connection

Go to Configure SSO tab.
Click on Select >> Test Connection option against the Identity Provider you configured.
On entering valid Auth0 credentials you will see a pop-up window which as shown in below screen.

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

Hence you have successfully configured Shopify Single Sign-On (SSO) using Auth0 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 Auth0 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.