Search Results :

×
Sign Up Contact Us

Contents

How to set up Single Sign-On (SSO) in Shopify with Keycloak as IDP (SAML)?

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

Shopify Keycloak SSO - download plugin button Download Plugin Shopify Keycloak SSO - plugin pricing button Shopify Keycloak SSO - plugin pricing button Pricing Plans

Configure [OAuth] SSO into Shopify using Keycloak as IdP

To set up Single Sign-On (SSO) with Shopify via the OAuth protocol using Keycloak as an identity provider (IdP), follow the steps outlined here.

To configure SSO into Shopify with Keycloak as IDP (SAML), you will need to install the miniOrange Shopify Single Sign On - SSO Login Application on your store.


Youtube-color Created with Sketch.

Check out our video, to know more about how Single-Sign-On works in Shopify.

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

  • Log in to the Keycloak Admin Panel.
  • Click on Clients from the left menu and then click on Create button to create a new client/application.
Okta Admin Dashboard - Shopify Keycloak SSO Okta Admin Dashboard - Shopify Keycloak SSO

  • For the above SAML configuration, you need to get the Entity ID and ACS URL from Shopify.
  • Now go to your Shopify store, navigate to the App section and click on Single Sign On - SSO login application.

Shopify Store SSO App login - Shopify Keycloak SSO

  • Click on the Add Identity Provider button to add your IDP.
Add IDP - Shopify Keycloak SSO

  • Select SAML protocol.
SAML - Shopify Keycloak SSO

  • Now choose Keycloak from the list of IDPs.
Okta IDP - Shopify Keycloak SSO

  • Click on the Get metadata button, as shown on the screen below, to get the service provider metadata.
Get Metadata - Shopify Keycloak SSO

  • Navigate to the SP Initiated Metadata section and copy down the ACS URL and Entity ID or Issuer.
SP Initiated Metadata - Shopify Keycloak SSO

  • Enter the values provided by Shopify as follows:
Client ID EntityID / Issuer
Client SAML Endpoint ACS URL
SP Initiated Metadata - Shopify Keycloak SSO

  • Enter the values provided by Shopify as follows:
  • Provide the configurations values from Shopify over here:
Name Provide the name as your choice
Client Protocol SAML
Sign Assertion On
Encrypt Assertion Off
Client Signature Required Off
Name ID Format Username
Valid Redirect URIs ACS URL
SP Initiated Metadata - Shopify Keycloak SSO SP Initiated Metadata - Shopify Keycloak SSO

  • Now in Fine Grain SAML Endpoint Configuration enter values as follows.
Assertion Consumer Service POST Binding URL ACS URL
Logout Service Redirect Binding URL Single Sign-Out URL
SP Initiated Metadata - Shopify Keycloak SSO

  • Click on the Save button.
  • For IDP metadata, Go to Realms in left panel and click on SAML 2.0 Identity Provider Metadata.
SP Initiated Metadata - Shopify Keycloak SSO

You have completed the Okta side configuration.

  • Navigate back to the miniOrange Single Sign On-SSO application and click on the Add Identity Provider button.
miniorange SSO - Shopify Keycloak SSO

  • Select SAML protocol.
SAML - Shopify Keycloak SSO

  • From the list of IDPs, select Keycloak.
Okta - Shopify Keycloak SSO

  • Click on the Import IDP Metadata button.
Import IDP metadata - Shopify Keycloak SSO

  • Select the upload method as Metadata Link. Paste the copied XML file link from Step 1 and Click on Import.
Metadata Link - Shopify Keycloak SSO

  • Add the appropriate IDP Name and click on Save.
Save Configuration - Shopify Keycloak SSO

You have completed Shopify side configuration.


  • 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.
Test Connection - Shopify Keycloak SSO

  • On entering valid Keycloak credentials you will see a pop-up window which is shown in the below screen.
Connection Succesfull - Shopify Keycloak SSO

  • Click on the Fetch Attributes button to fetch the IDP attribute.
Fetch Attributes - Shopify Keycloak SSO

  • Click on the + Attribute Mapping button to map attributes between Shopify and Okta.
Attribute Mapping - Shopify Keycloak SSO

  • Map the attributes by referring to 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
Map Attributes - Shopify Keycloak SSO

  • Click on Save.

Select Shopify Store Type:

SSO Configuration in Non-Plus Shopify Stores

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

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.
Shopify ADFS SSO Login - Enable Customer

  • Enable the New Customer Accounts extension and click on Save.
Shopify ADFS SSO Login - Enable /wp-content/uploads/2025/05/shopify-sso-paste-multipass-token.webps

  • Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.
Shopify ADFS SSO Login - Make app default

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

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

  • 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)
Shopify miniOrange SSO - 6 Digit OTP customer accounts

  • 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.
Shopify ADFS SSO Login - Make app default

  • Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.
Shopify ADFS SSO Login - Make app default

  • 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.
Shopify ADFS SSO Login - Make app default

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.
SSO Login into Store - Shopify miniOrange SSO

  • 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.
Shopify miniOrange SSO - Something went wrong error

SSO Configuration in Plus Shopify Stores

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

  • 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.
Shopify ADFS SSO Login - Copy Client ID and Secret

  • Click on the Customer Accounts link as shown in the below image.
Shopify ADFS SSO Login - Click on Customer Accounts

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

  • If the identity provider is present, click on Manage.
Shopify ADFS SSO Login - Click Manage

  • Click on Connect to Provider button.
Shopify ADFS SSO Login - Connect to identity provider

  • 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.
Shopify ADFS SSO Login - Add identity provider name

Shopify ADFS SSO Login - Add metadata

  • Once the Identity Provider has been added, do the Test Connection.
Shopify ADFS SSO Login - Test Connections

  • After verifying the flow make the identity provider as Active.
Shopify ADFS SSO Login - Make identity provider active

  • Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.
Shopify ADFS SSO Login - Make app default

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

  • Go to your Shopify Store.(https://<your-shopify-storedomain>)
  • Click on the User login icon.
SSO Login into Store - Shopify miniOrange SSO
  • 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.
Shopify ADFS SSO Login - 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.
Shopify ADFS SSO Login - Enable multipass token

  • 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.
Shopify ADFS SSO Login - Make app default

  • Navigate to the application home page and enable the IDP Login toggle option against the IDP you have configured.
Shopify ADFS SSO Login - Make app default

  • 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.
Shopify ADFS SSO Login - Make app default

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.
SSO Login into Store - Shopify miniOrange SSO

  • 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.
Shopify miniOrange SSO - Something went wrong error

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

Hence your configuration of Keycloak as IDP in Shopify is successfully completed.


Follow the steps outlined here to configure SSO in Shopify with your preferred IDP.

Redirection to any other site might be blocked in the browser. Please follow the steps given here to resolve the issue.

Follow the steps outlined here to redirect your customer to collections/cart or any other page.

You must upgrade to the SSO application’s Enterprise plan to enable the Auto-Redirect to the IDP feature. Follow the steps outlined here to enable this feature.

More FAQs ➔

Yes, you can sync Keycloak user details with Shopify customer profiles during first-time login using the miniOrange SSO application.

Here’s how to sync Keycloak user details with Shopify via SSO app:

  • Set up Keycloak as Identity Provider: In the SSO application, select SAML protocol and configure Keycloak as IdP with its metadata.
  • Configure Attribute Mapping: Map Keycloak attributes like email, name, phone, etc., to corresponding Shopify customer fields.
  • Enable profile updates on SSO: Under post login configurations, enable the toggle to update customer profile after a user performs SSO.

This ensures that customer data from Keycloak is synced into Shopify without any hassles.

You can redirect all login attempts to Keycloak using the Auto-Redirect to IdP feature in the miniOrange SSO app.

Here’s how to configure it:

  • Set Up Keycloak as Identity Provider: In the miniOrange SSO application, configure Keycloak as the identity provider (IdP) using its SAML metadata or OAuth endpoints.
  • Enable Auto-Redirect to IdP: Navigate to global configurations and enable the Auto Redirect To IDP feature under Store Access Settings. Choose whether you want to enable this feature on the “Complete Store” or only on the "Login Page".

This ensures a seamless login experience where all login attempts on your Shopify store are redirected to Keycloak.

Yes, it is possible to redirect users to specific pages or sections of my Shopify store after SSO login from Keycloak.

Here’s how to configure redirection of users to specific pages via SSO app:

  • Configure Keycloak as Identity Provider: In the SSO application, select the desired SSO protocol and configure Keycloak as IdP with its metadata.
  • Configure Shopify as Service Provider: Set up Shopify as a Service Provider (SP) and import the Keycloak IdP metadata. Enable SSO login for customers, allowing them to log in using their Keycloak credentials.
  • Custom Redirection: Under post login configurations, enter the endpoint where you want to redirect users after login. For example, /cart, /account

Yes, you can use Keycloak as Identity Provider (IdP) to enable Single Sign-On (SSO) across multiple Shopify stores.

Here’s how to configure SSO to let employees log in to multiple Shopify stores:

  • Install Shopify SSO application: On each Shopify store, install the Shopify SSO application from the app store.
  • Configure Keycloak as IdP: In Keycloak, create a client with either SAML or OIDC protocol for each Shopify store.
  • Configure SSO App in Shopify: Enter Keycloak IdP details (SAML metadata or OIDC endpoints) in each store’s SSO application.
  • Use Same Realm and User Store in Keycloak: Ensures all employees use the same credentials across all stores.

This setup ensures that employees can seamlessly access multiple Shopify stores using a single set of Keycloak credentials, improving both security and user convenience.


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.

ADFS_sso ×
Hello there!

Need Help? We are right here!

support