Contents

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

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

Pre-requisite: Single Sign On - SSO Login Application

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

Shopify Single Sign-On (SSO)

By miniOrange

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

Get this application

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

1. Configure Shopify as SP in Okta

Login into your Okta Admin Dashboard.
In the Okta Developer site, navigate to the Applications tab and select Applications.

Configure Okta as IDP -SAML Single Sign-On(SSO) for WordPress - Okta SSO Login - add_application

Click on the Create App Integration button to create a new app.

Configure Okta as IDP -SAML Single Sign-On(SSO) for WordPress - Okta SSO Login - SAML 2.0 Configure

Select SAML 2.0 as the Sign-On method and Click on the Next button.

In the General Settings tab, enter the App Name and click on the Next button.

Configure Okta as IDP -SAML Single Sign-On(SSO) for WordPress - Okta SSO Login - SAML_SETTINGS

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 the App section and click on Single Sign On - SSO login application.
Click on the Setup IDP button in the left 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 the Screen below.

For SP - INITIATED SSO
For IDP - INITIATED SSO

For the SP - INITIATED SSO section Select Show Metadata Details.

Shopify Okta SSO - Shopify Okta Login - SP initiated SSO

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

Single Sign-On URL	ACS URL
Audience URI (SP Entity ID)	Entity ID or Issuer

Configure Okta as IDP -SAML Single Sign-On(SSO) for WordPress - Okta SSO Login - Enter SP metadata in Okta

Configure Group Attribute Statements (Optional) and click on theNext button.

Configure Okta as IDP -SAML Single Sign-On(SSO) for WordPress - Okta SSO Login - Add_Attributes

Select Okta Configuration type & click on finish.
Now navigate to the application you created and click on the Assignments Tab in Okta.

Configure Okta as IDP -SAML Single Sign-On(SSO) for WordPress - Okta SSO Login - Assign_groups

Click on the Assign button to Assign People and Assign Groups.

Once you Assign the user, click on the Done button.

You have completed the Okta side configuration.

2. Configure Okta as IDP in Shopify

Again navigate to the App section of the Shopify store and click on Single Sign On - SSO Login application.

shopify app section - single sign on application

Click on the Setup IDP button in the top left corder of the navigation bar.

Single Sign-On (SSO)for Shopify (Plus and Non Plus), Configure IDP for enabling Single Sign-On (SSO)

From the left navigation bar select Configure SSO and click on Add Identity Provider.

Okta Single Sign On SSO add identity provider

Select SAML and click on Import IDP metadata.

Navigate to the Sign On tab in Okta and then navigate to the SAML Signing Certificate section.
Click on the Action dropdown for the Active certificate and then click on the View IdP Metadata option to get the IdP Metadata which will be required for configuring your Service Provider.

Copy the XML file URL and navigate back to the miniOrange Single Sign-On - SSO Login application dashboard.
Add the appropriate IDP Name and paste the copied XML file link in the IDP metadata section.
Click on Import and then click on Save.

You have completed the Shopify side configuration.

3. Set Default Relay State in Okta (Only in IDP Initiated SSO Configuration)

Go to the Configure SSO tab.
Click on Select >> Show SSO Link option against the Identity Provider you configured.

Copy the SSO URL Link.

Now go to the application you configured in Okta. Navigate to the Sign On tab and click on Edit.

Paste the copied SSO URL Link in the Default Relay State section.

Click on Save.

4. Test Connection

Note: The test connection will not work for IDP-initiated SSO, so skip this step.

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

5. Testing SSO

Testing SSO into Shopify using your Okta credentials.

For SP - INITIATED SSO
For IDP - INITIATED SSO

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 your configuration of Okta as IDP in Shopify is sucessfully completed.

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.

After performing SSO, I want my customers to redirect to the collections or discount offer page.

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

How do I enable the SSO application’s auto redirect to IDP feature on my Shopify store?

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.