Search Results :

×

Shopify Single Sign-On (SSO) using JWT Protocol

What is JWT (JSON Web Token)?

JWT, or JSON Web Token, is an open standard used to share information between two parties securely — a client and a server. In most cases, it’s an encoded JSON containing a set of claims and a signature. The client will have to authenticate once with the server with the credentials. The server verifies the credentials and delivers a JSON Web Token to the client (JWT). The client may use this JSON Web Token (JWT) to authenticate itself to the server for avoiding the need to submit credentials such as username and password again.

This solution allows you to setup Single Sign-On (SSO) into Shopify store and authenticate via JWT from your client application. When you use single sign-on (SSO) with JWT authentication, a user's identity is verified when they sign in to the client application. The user can then access Shopify store without having to enter any additional sign-in credentials. Only users who have completed Shopify JWT Single Sign-On and authenticated by the client application have access to Shopify store.

jwt token authentication shopify SSO

Whenever a user logs in to your client application, their details are taken from the application userbase by the JWT issuer for creating a JWT token having three parts header, payload, and signature. This JWT token is then appended in the Shopify SSO link and when the user clicks on the SSO link, there will be a signature validation process and if the signature is validated, the user is authentic and will be granted access to the Shopify store; otherwise, the access will be denied.

To configure Shopify JWT Single Sign-On into your store, 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 Single Sign-On in Shopify Store Using JWT Token

  • Go to your Shopify store and navigate to the App section and click on Single Sign On - SSO login application.
JWT Shopify SSO  - Shopify JWT SSO - Navigate to Shopify SSO Application

  • Click on the Add identity Provider button to add your IDP.
JWT Shopify SSO  - Shopify JWT SSO - Add identity Provider

  • Select JWT protocol.
JWT Shopify SSO  - Shopify JWT SSO - Select JWT Protocol

  • Fill out the below fields by referring the below table:
JWT Shopify SSO  - Shopify JWT SSO - Fill out the below fields

IDP Display Name Enter appropriate IDP name (It will be used in SSO link)
JWT Login URL Authentication endpoint of company on which the user will get authenticated and get redirected to miniOrange JWT SSO link
User Identifier Enter user identitfier as "email"
JWT Signing Algorithm

RSA256 / HS256 / Token Introspection

  • Click on Save.
  • Go to your configured application and locate the 'Application Key' field, which will act as the IdpIdentifier, shown in the image below:
JWT Shopify SSO  - Shopify JWT SSO - locate the Application Key field

  • Append the data in the below URL format.
Customer ID miniOrange will provide customer ID. Please contact shopifysupport@xecurify.com for the same.
IdpIdentifier JWT Identifier in above image
JWT token Provided by the organization using SSO services. The JWT token needs to have these three mandatory parameters in the payload:

iat - The time when this token was issued.
exp - This indicates the Shopify access token expiration.
user_identifier - attribute in which you are passing email address
Store-domain The primary domain of your Shopify store

URL Format:

    https://store.xecurify.com/moas/broker/login/jwt/callback/{customerId}/{idpIdentifier}/{jwtToken}?relay=https://store.xecurify.com/moas/broker/login/shopify/<store-domain>/account

  • After substituting the values click on the Single Sign-On (SSO) link. You will be redirected and logged-in to the Shopify store.
JWT Shopify SSO  - Shopify JWT SSO - logged-in to Shopify Store

  • Click on the + Attribute Mapping button to map attributes.
JWT Shopify SSO  - Shopify JWT SSO - click on + Attribute Mapping

  • Map the attributes by refering the table below:
JWT Shopify SSO  - Shopify JWT SSO - Map the attributes

Attribute Name in Shopify Choose the attribute from the list of predefined attributes
Attribute Type IDP Attribute
Attribute Value Enter the attribute value that you are passing from JWT token
  • 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:

  • 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 you have successfully configured Shopify JWT Single Sign On (SSO) using miniorange Single Sign-On (SSO) login application. This solution ensures that you are ready to roll out secure access to your store using Shopify JWT within minutes.

More FAQs ➔

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.


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