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

Overview

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

Download Plugin Pricing Plans

Pre-requisites: Single Sign On - SSO Login Application

To configure SSO into Shopify with WSO2 as IDP (SAML), you will need to install the miniOrange Shopify Single Sign On - SSO Login Application on your store.

Configuration Steps

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

Step 1: Configure Shopify as SP in WSO2

• Let's first register in WSO2 Identity Server (IS).
• Download and start WSO2 using wso2server.bat run command.
• Enter Username and Password as admin. Click on Sign in.

• From the Left Navigation Menu Click on ADD under Service Provider Tab.

• Add Service Provider name according to your preference and add description if necessary.
• Click on Register.

• Under Claims configuration select https://wso2.org/claims/emailaddress from Subject Claim URI dropdown.
• Add following URIs in Service Provider Claim Dialect: https://wso2.org/oidc/claim & https://wso2.org/claims.

• Click on Inbound Authentication Configuration.
• Select SAML2 Web SSO Configuration from the dropdown. Click on Configure.

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

• Click on the Add Identity Provider button to add your IDP.

• Select SAML protocol.

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

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

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

• Enter Application Callback URL, Audience, Recipient and other settings using SP entity ID and ACS URL copied from the Shopify WSO2 SSO application.
• Enter the values in manual configuration as shown in below screen.

• Uncheck the Enable Response Signing, Enable Signature Validation in Authentication Requests and Logout Requests and Enable Single Logout.
• Click on Register at the very bottom of the page.

• On successful registration, you can see the below screen.

• Now go in list in Service Provider tab. Click on Edit against your configure app.
• Click on Edit SAML2 Web SSO Configuration.

• Click on Download IDP Metadata option at the bottom the page. You will need this metadata in Step 2.

• To add users in WSO2 : Click on ADD under Users and Roles in the Left Navigation Menu. Then Click on Add New User.

• Enter Username and Password. Click on finish.

• Hence the user is successfully added in WSO2.

You have successfully completed WSO2 side configuration.

Step 2: Configure WSO2 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 identity providers (IDPs), select WSO2.

• 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, or simply paste the metadata by selecting upload method as Metadata Text, click on Import.

• Click on Save.

Step 3: 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 WSO2 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 4: 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 Save.

Step 5: 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

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

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

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

• Click on the Customer Accounts link as shown in the below image.

• Select the Customer accounts option recommended by Shopify & look for the Identity Provider option, if not present please reach out to shopifysupport@xecurify.com.

• If the identity provider is present, click on Manage.

• Click on Connect to Provider button.

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

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

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

Hence your configuration of WSO2 as IDP in Shopify is successfully completed.

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.