Shopify Single Sign-On (SSO) using WSO2 as Identity Provider (IDP)
How can we Authentication users into Shopify using WSO2 as Identity Provider?
WSO2 Single Sign On (SSO) for Your Shopify store. 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 store using WSO2 as IdP (Identity Provider) and Shopify as SP (Service Provider).
Pre-requisite : Single Sign On - SSO Application
To configure SSO into Shopify with WSO2 as IDP, you will need to install the miniOrange Single Sign On - SSO Login Application on your Shopify store:
miniOrange Provides Secure Single Sign-On (SSO) access to your Shopify stores(both plus and Non plus Stores).
Step by Step guide for Configuring WSO2 as IDP for SSO into Shopify
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.
- Select SAML protocol.
- From the list of identity providers (IDPs), select WSO2.
- 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 WSO2.
- Enter Application Callback URL, Audience, Recipient and other settings using SP entity ID and ACS URL copied from the Shopify 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.
| Issuer | Entity ID or Issuer |
| Assertion Consumer URL | ACS URL |
You have successfully completed WSO2 side configuration.
2. Configure WSO2 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 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.
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 WSO2 credentials you will see a pop-up window which as shown in below screen.
- Click on the Fetch Attributes to fetch IDP attribute.
4. Attribute Mapping
- Click on the + Attribute Mapping button to map attributes between Shopify and WSO2.
- Map the attributes by referring the table below:
- 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.
| 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 |
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 WSO2 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 WSO2 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.
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.
Choose your preferred Identity Provider and start setting up SSO for Shopify right away
Additional Resources
If you are looking for anything which you cannot find, please drop us an email on shopifysupport@xecurify.com
Need Help? We are right here!
