SSO into the Shopify Store using Custom OAuth IDP | Shopify OAuth 2.0 SSO

Overview

Shopify Single Sign-On (SSO) Login application enables login into Shopify store using multiple identity providers (IdPs) using the OAuth protocol. Shopify OAuth 2.0 SSO supports advanced Single Sign-On (SSO) features like user profile attribute mapping, role mapping, and more. To learn about other features provided in our Shopify Single Sign-On application, click here.

Add Application Pricing Plans

Pre-requisites : Download And Installation

• To configure SSO into Shopify with a Custom OAuth IDP, you will need to install the Shopify Single Sign-On (SSO) Login Application on your Shopify store.

To proceed with Shopify OAuth 2.0 setup, follow the given steps to configure the Single Sign-On (SSO) application for your Shopify store users.

Configuration Steps

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 Custom IDP from the list of IDPs.

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

You have successfully obtained the Callback URL (Redirect URI) from Shopify.

Step 2: Configuring Shopify as SP in your OAuth IDP

• Go to the developer's console of your preferred OAuth Server.
• Create a new Application. Enter the basic details required for creating an application.
• Now, you will need to configure the Callback/ Redirect URL copied from Step 1
• Select proper scopes based on the OAuth Server. The Same scopes will be required to configure in the Shopify SSO Application during OAuth IDP configurations.
• Once, all the required details are entered. Please Save the configurations.
• After saving the configurations, your IDP will provide Client ID & Client Secret for your recently configured application. These details are also required while setting up the OAuth Server in Shopify Single Sign-On Application.

You have configured Shopify as SP in your OAuth IDP

Step 3: Configure OAuth 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 Custom IDP.

• 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 Next.
• We support all standard IDPs like AWS Cognito, Azure B2C, Salesforce, Google, Facebook, LinkedIn, Apple, Discord, etc.

You have now completed the configuration for Custom OAuth IDP into your Shopify SSO Application.

Step 4: Test Connection

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

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



• Else, you’ll be redirected to the login page of the IDP you configured in previous step. Log in with your IDP account credentials.

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

Step 5: Attribute Mapping

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

• Map the attributes by referring the table below:

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

• Click on Save.

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

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

Step 7: Restrict SSO based on the IDP Attributes

• You can control access to your Shopify Store by setting rules that allow or deny entry based on specific user attributes. For instance, you can restrict access to certain store sections for users with a particular tag or domain.
• Navigate to Apps section and then select the miniOrange Single Sign On – SSO application.

• Click on the Additional Settings option under the More Action tab.

• Enable the Restrict store access based on the IDP user profile attributes feature under the Store Access Restrictions tab.

• Click on the + Add Attribute to add an attribute as shown in the below image.

• If the attribute name from IDP matches the blocked attribute value, the user will be redirected to the blocked page after they SSO into the Shopify store.

• Click on Save.
• Example: If the blocked attribute name is “domain” and its value is “@gmail.com”, then all customers with a @gmail domain will be redirected to the blocked page after they perform SSO to the Shopify store.

Step 8: Store Access Exclusively for Logged-In Users

• "Protect Complete Store with SSO" grants exclusive access to your Shopify store, ensuring that only logged-in users can access it. Any non-logged-in user attempting to access any page of your Shopify store will be redirected to the password page.
• Note: For the following steps, ensure that you have enabled password protection on your Shopify store.
• To configure your complete store with the Shopify SSO app, you need to obtain a storefront_digest cookie.
• Go to your Shopify store. Right-click on the page and select the "Inspect" option.

• Now, navigate to the Application section and select the Cookies option from the left menu. Choose your store and search for storefront_digest. Copy the value associated with this cookie.

• Navigate to Apps section and then select the miniOrange Single Sign On – SSO application.

• Go to Global Configurations tab and then under Store Access Settings, enable the Complete Store Protection feature. Paste the storefront_digest cookie value in the Store Token field, as shown in the image below.

• Click on Save.
• Now, go to https://<your-store-domain>/password and click on Enter using Password in the top right corner.

• After that, click on the SSO Login widget to initiate the Single Sign-On process. For example; Let us name our widget "Login with SSO" as shown in the below image.

Hence you have successfully configured Shopify OAuth 2.0 Single Sign-On (SSO) using your Custom IDP and Shopify as Service Provider. 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 SAML IDP login credentials within minutes.

Additional Resources

• Shopify Security Solutions
• Shopify Single Sign-On (SSO)
• Shopify Content Restriction
• Shopify Order and SMS Notifications
• Two Factor Authentication (2FA) for Shopify

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 and will assist you to select the best suitable solution/plan as per your requirement to set up the Shopify OAuth 2.0 SSO.