Contents

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

How can we authenticate users into Shopify using PingOne as Identity Provider?

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

Pre-requisite : Single Sign On - SSO Application

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

Shopify Single Sign-On (SSO)

By miniOrange

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

Get this application

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

1. Configure Shopify as SP in PingOne

PINGONE as IDP -SAML Single Sign-On(SSO) for Shopify - add application

On your Dashboard menu, click on Connections section.

In the Connections menu, Click on Application and to create an application click on the + icon beside its name.

Provide appropriate Application Name and choose the Application Type as SAML. Click on Save button.

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

Shopify SSO - single sign on application

Click on the Add identity Provider button to add your IDP.

Select SAML protocol.

From the list of identity providers (IDPs), select PingOne as your identity provider.

Click on the Get Metadata to get the service provider (Shopify) metadata.

For SP-Initiated SSO, note down the required details to configure SSO in PingOne.

Shopify SSO - Shopify SP-intiated Metadata

Navigate to Import from URL tab, and paste the copied metadata URL in import URL section. Click on Import.

Click on Save.
Now go to configuration tab and click on Download Metadata button to download IDP metadata. Keep it handy as it will be used in furthur steps.

Navigate to Attribute Mappings tab and map the attributes as shown in below table.

saml_subject	Email Address
NameID	Email Address

Save your Application and on the Application Dashboard and enable the “User Access” button next to your application name.

You have successfully completed PingOne side configuration.

2. Configure PingOne as Identity Provider (IDP) in Shopify

Navigate back to the miniOrange Single Sign On-SSO application and click on Add identity Provider button.
Select SAML protocol.

From the list of identity providers (IDPs), select PingOne.

Enter the identity provider (IDP) display name.
Click on the Import IDP Metadata button.

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

Click on Save.

3. Test Connection

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

On entering valid PingOne credentials you will see a pop-up window which as shown in below screen.

PingOne Single Sign On SSO SucessTestConnection

Click on the Fetch Attributes to fetch IDP attribute.

4. Attribute Mapping

Click on the + Attribute Mapping button to map attributes between Shopify and PingOne.

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.
Navigate to the application home page. Click More actions against the configured IDP, and click on Make Default to set your IDP as default.

5. Testing 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 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 you have successfully configured Shopify Single Sign-On (SSO) using PingOne as IDP and Shopify as SP 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 PingOne login credentials within minutes.

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.

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.