How to Set Up Okta OAuth SSO in Shopify using Okta as an Identity Provider?

miniOrange allows Okta (OAuth) to act as an Identity Provider (IdP), enabling secure and seamless Single Sign-On (SSO) into your Shopify Storefront using Okta credentials. With OAuth 2.0–based authentication, users can log in once via Okta and gain instant access to your Shopify store without needing to manage separate credentials.

Our solution supports both New Shopify Customer Accounts and Classic (Legacy) Customer Accounts, making it compatible with all Shopify storefront configurations.

Whether you run a Shopify Plus or non-Plus store, or require advanced B2B Store and B2B Login functionality, the miniOrange Shopify Okta SSO integration delivers a flexible, secure, and scalable authentication solution for businesses of all sizes.

Install Application 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 Okta OAuth SSO in Shopify configuration

Step by Step guide for Configuring Okta as IDP (OAuth) for SSO into Shopify

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

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

Step 2: Configuring Shopify as a Service Provider (SP) in Okta (OAuth)

• First of all, go to Admin dashboard and log into your Okta account.
• Go to the Okta Admin panel. Go to Applications -> Applications.

• You will get the following screen. Click on Create App Integration button.

• Select sign in method as the OIDC - OpenID Connect option and select Application type as web application, click on Next button.

• You will be redirected to the app details page. Enter App integration name and Sign-in redirect URIs. you will get that from miniOrange Shopify Single Sign-On (SSO) application under the Callback URL field from Step 1.

• Scroll down and you will see the Assignments section. Choose a controlled access option and uncheck the Enable immediate access with Federation Broker Mode option. Click on Save button.

• Now you will get the Client credentials and okta domain. Copy these credentials in miniOrange Shopify Single Sign-On (SSO) application on corresponding fields.

Step 2.1: Assign an App integration to a user

• Go to Applications tab and Click on your application.

• Select the Assignments tab.

• Click Assign and select Assign to People.
• If you want to assign the application to multiple users at the same time then select Assign to Groups [If an app is assigned to a group then, the app will be assigned to all the people in that group]

• Click Assign next to a user name.

• Click Save and Go Back.

• Click Done.

Step 2.2: Profile Attributes for the ID Token

• In your Okta admin dashboard, navigate to Security -> API.

• Select your SSO application and click on the edit icon.

• Go to claims tab and select the ID token option.

• Click on Add claim button.

• Give a Name to your claim/attribute and Select ID Token from the token type dropdown. Now, enter the value user.$attribute in the Value field based on the attribute you want to receive. Keep other settings as default and click on Create button.

• Follow the similar steps for all the attributes you want to see. You will have a list similar to the below one.

You have completed Okta side configuration.

Step 3: Configure Okta (OAuth) as Identity Provider (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 Okta.

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

Step 4: Test Connections

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

• On entering valid Okta 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 Okta.

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

You’ve completed the Shopify Okta integration using the OAuth protocol, with Okta as the IdP and Shopify as the SP. This setup enables seamless Single Sign-On (SSO) into Shopify using Okta credentials, giving users one-click access without multiple logins while enhancing security. By leveraging OAuth-based authentication, store owners can simplify operations and deliver a trusted, consistent login experience for customers, employees, partners, and B2B users.

• Support for All Shopify Customer Accounts The Shopify Okta OAuth SSO solution works well with both New Customer Accounts and Classic Shopify accounts. This ensures full compatibility with the storefront.
• Compatible with Shopify Plus and Non-Plus Stores You can enable OAuth-based Okta SSO for both Shopify Plus and non-Plus merchants. The authentication setup is simple and secure.
• Secure Access for Private and Swag Stores You can restrict storefront access by allowing only users authenticated through Okta to log in. This keeps private, internal, or swag stores safe from unauthorized visitors.
• B2B and Wholesale Storefront Login Provide secure Okta OAuth login for B2B Shopify stores, wholesale portals, partners, and customers. This ensures controlled access for business users.
• OAuth Token-Based Authentication Use OAuth 2.0 token-based authentication to provide faster, modern, and highly secure login experiences for Shopify storefront users.
• Multi-Platform and Multi-IDP SSO Support Ensure consistent Shopify Okta OAuth SSO across web storefronts and Shopify mobile apps. You can also support multiple identity providers if needed.
• User Attribute and Profile Mapping Automatically map Okta user attributes to Shopify customer profiles, including customer tags and metafields, during the OAuth SSO process.
• Single Logout and Extended Login Sessions Enhance security with a centralized single logout while allowing configurable extended OAuth-based sessions for a better user experience.