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

Overview

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

Pre-requisite: Shopify Single Sign-On - SSO Application

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

If you're using Shopify's new customer accounts, make sure to activate the New Customer Account SSO feature in our Shopify SSO application.

• Go to the Advanced Settings section and turn on the New Customer Account SSO feature. To enable the extension, click the 'clicking here' link, as shown in the screenshot below.

• You'll be taken to the Theme Customization page, where you can confirm that the New Customer Account SSO widget has been added. Activate the widget and click on Save.

Configuration Steps

Setup guide for Configuring PingFederate as IDP for SSO into Shopify

Step 1: Get Service Provider Metadata from Shopify

• Go to your Shopify store, 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 SAML protocol.

• Now choose PingFederate from the list of IDPs.

• Click on the Get metadata button, as shown on the screen below, to get the service provider metadata.

• SP - INITIATED SSO
• IDP - INITIATED SSO

• Navigate to the SP Initiated Metadata section and copy down the SP Initiated metadata URL.

• Navigate to IDP Initiated Metadata section and copy down the IDP Initiated metadata URL.

Step 2: Configure Shopify as SP in PingFederate

• Login to your PingFederate User Admin dashboard.
• Click on the Identity Provider in the left navigation menu.
• Under SP CONNECTION, click on Create New button.

• Select the Browser SSO Profiles connection template on the Connection Type tab and click Next.

• Select Browser SSO on the Connection Options tab and click Next.

• Select URL as the method for importing metadata and paste the SP Metdata URL that you get from Step 1. Click Next.

• Review the information on the Metadata Summary tab and click Next.
• In the General Info tab ensure that the Service Provider’s Entity ID, Connection Name, and Base URL fields pre-populate based on the metadata. Click Next.
• Navigate to the Browser SSO tab and click on the Configure Browser SSO. You will be redirected to Browser SSO Setup wizard.
• Select the IDP-Initiated SSO and SP-Initiated SSO options on the SAML Profiles tab and click Next.



• Enter your desired assertion validity time on the Assertion Lifetime tab and click Next. By default, it is configured 5 minutes for both.
• Navigate to the Assertion Creation and click on the Configure Assertion Creation. You will be redirected to the assertion creation setup wizard.
• In the Identity Mapping tab select STANDARD and click Next.
• Select a Subject Name Format for the SAML_SUBJECT on the Attribute Contract tab and click Next.
• Click Map New Adapter Instance on the Authentication Source Mapping.



• Select an Adapter Instance and click Next. The adapter must include the user’s email address.



• Select the Use only the adapter contract values in the SAML assertion option on the Mapping Method tab and click Next.
• Select your adapter instance as the Source and the email as the Value on the Attribute Contract Fulfillment tab and click Next.



• (Optional): Select any authorization conditions you would like on the Issuance Criteria tab and click Next.
• Click Done on the Summary.
• Click Next on the Authentication Source Mapping tab.
• Click Done on the Summary tab.
• Click Next on the Assertion Creation.

• Navigate to the Protocol Settings tab of the Browser SSO wizard and click on the Configure Protocol settings.
• Select POST for Binding and specify the single sign-on Endpoint URL in the Endpoint URL field on the Assertion Consumer Service URL. Click Next.
• Select POST on the Allowable SAML Bindings tab and click Next.
• Select your desired signature policies for assertions on the Signature Policy tab and click Next.

• Select your desired encryption policy for assertions on the Encryption Policy tab and click Next.
• Click Done on the Protocol Settings Summary tab.
• Click Done on the Browser SSO Summary.

• Navigate to the Credentials and click on the Configure Credentials. You will be redirected to the Credentials setup wizard.
• Select the Signing Certificate to use with the Single Sign-On service and select Include the certificate in the signature element in the Digital Signature Settings tab. Click Done.



• Click Done on the Summary.
• Click Next on the Credentials.

• Select Active for the Connection Status on the Activation & Summary tab and click Save.
• Now, navigate to the PingFederate User Admin dashboard.
• Click Manage All under SP Connections.
• Click Export Metadata for the desired service provider connection.
• Click Export on the Export & Summary tab and click Done.

You have successfully configured PingFederate as SAML IdP (Identity Provider) for achieving PingFederate SSO login into your Shopify Store.

Step 3: Configure PingFederate as IDP in Shopify

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

• Select SAML protocol.

• From the list of IDPs, select PingFederate.

• Click on the Import IDP Metadata button.

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

• Add the appropriate IDP Name and click on Save.

You have completed the Shopify side configuration to set up SSO between PingFederate and Shopify.

Step 4: Test Connection

• 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 PingFederate account credentials you will see a pop-up window as 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 PingFederate.

• 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

• Click on Save.

• Navigate to the application home page. Go to More actions against the IDP you have configured and click on the Make Default button to make the IDP default.

Step 6: 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.

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

• Otherwise, you’ll be redirected to the login page of the IDP you configured in the previous step. Log in with your IDP account credentials.
• You’ll be successfully logged in to your Shopify store.

In this Guide, you have configured PingFederate Single Sign-On (SSO) by configuring PingFederate as an Identity Provider and Shopify as an Service Provider using our Shopify Single Sign-On - SSO Login App. This solution ensures that you are ready to roll out secure access to your Shopify Store using PingFederate login credentials within minutes.

Additional Resources

• Shopify Security Solutions
• Shopify Single Sign-On (SSO)
• Shopify Content restriction
• Shopify Subscription

Get in Touch

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.