SAML Single Sign-On (SSO) Solution For Shopify Using Keycloak as IDP
miniOrange allows Keycloak to act as an IDP (Identity Provider), which allows users to Single Sign-On (SSO) into Shopify using Keycloak 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 Keycloak as IdP (Identity Provider) and Shopify store as SP (Service Provider).
Pre-requisite : Single Sign On - SSO Application
To configure SSO into Shopify using Keycloak as IDP, you will need to install the miniOrange Single Sign On - SSO Application on your Shopify store:
miniOrange Provides Secure Single Sign-On (SSO) access to your Shopify Store(both plus and Non plus Stores).
Step by Step guide to setup Single Sign-On in Shopify Store Using Keycloak as IDP
1. Configure Shopify as SP (Service Provider) in Keycloak:
- Log in to the Keycloak Admin Panel.
- Click on Clients from the left menu and then click on Create button to create a new client/application.
- For the above SAML configuration you need to get the Entity ID and ACS URLfrom miniOrange
- Now go to your Shopify store and click on Setup IDP button in the top left in navigation bar.
- Now click on the Click here link to get miniorange metadata as shown in Screen below.
- For SP - INITIATED SSO section Select Show Metadata Details or click on Download Metadata.
- Click on Select file and upload above downloaded metadata file.
- For manual configuration, enter the values provided by Shopify as follows:
- Click on Save for further configuration.
- Provide the configurations values from Shopify over here:
- Now in Fine Grain SAML Endpoint Configuration enter values as follows.
- Click on the Save button.
- For IDP metadata, Go to Realms in left panel and click on SAML 2.0 Identity Provider Metadata.
| Client Id | EntityID / Issuer |
| Endpoints | ACS URL |
| Name | Provide the name as your choice |
| Client Protocol | SAML |
| Sign Assertion | On |
| Encrypt Assertion | Off |
| Client Signature Required | Off |
| Name ID Format | Username |
| Valid Redirect URIs | ACS URL |
| Assertion Consumer Service POST Binding URL | ACS URL |
| Logout Service Redirect Binding URL | Single Sign-Out URL |
2. Configure Keycloak as IDP:
- Again, go to your Shopify store, click on the Apps tab and select the Single Sign On - SSO Login application.
- Click on the Setup IDP button in the top left in the navigation bar.
- From the left navigation bar select Identity Provider
- Select SAML. Click on Import IDP metadata.
- Choose appropriate IDP name. Browse for the file downloaded in step 1.
- Click on Import.
- As shown in the below screen the IDP Entity ID, SAML SSO Login URL and x.509 Certificate will be filled from the file imported.
- Click on Save.
3. Test Connection
- Go to Identity Providers tab.
- Click on Select >> Test Connection option against the Identity Provider you configured.
- On entering valid Keycloak credentials you will see a pop-up window which as shown in below screen.
- Hence your configuration of Keycloak as IDP in Shopify is sucesssfully completed.
4. 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.
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.
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!
