OAuth Single Sign-On (SSO) For Shopify Using Google as Identity Provider
miniOrange allows Google Apps to act as an IDP (Identity Provider), which allows users to Single Sign-On (SSO) into Shopify using Google Apps 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 Google Apps as IdP (Identity Provider) and Shopify store as SP (Service Provider).
Pre-requisite : Single Sign On - SSO Application
To configure SSO into Shopify with Google Apps 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 Single Sign-On in Shopify Store Using Google apps
Step 1: Step to get the Redirect URI for OAuth Server
- 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 Configure SSO and click on Add Identity provider button.
- You can find the OAuth Callback URL/ Redirect URI in the OAuth 2.0 section. Keep the OAuth callback URL handy as you will need it later.
2. Configure Shopify as Service Provider (SP) in Google Apps
- Go to https://console.developers.google.com/ and sign up/login.
- Click on Select Project to create a new Google Apps Project, then click on NEW PROJECT. (refer to image below)
- Enter your Project name under the Project Name field an click on Create
- Now, again click on Select a Project (highlighted in the image below) and select the newly created Project by clicking on the project name that you entered in the previous step.
- Go to Navigation MenuAPIs & ServicesCredentials.
- Click on Create Credentials button and then select OAuth Client ID from the options provided.
- In case you are facing some warning saying that in order to create an OAuth Client ID, you must set a product name on consent screen (as shown in below image). Click on the Configure consent screen button.
- Choose how you want to configure and register your app and click on create button.
- Enter the required details such as App Name, User Support Email. and click on Save and Continue button.
- Scroll down and click on SAVE AND CONTINUE.
- Now for configuring scopes, click on Add or Remove the Scopes button.
- Now, Select the Scopes to allow your project to access specific types of private user data from their Google Account and click on Update button.
- Add test users for your application. Only test users will be able to access the app.
- Click on SAVE AND CONTINUE button.
- Check all the details in the Summary section.
- Click on BACK TO DASHBOARD button.
- Click on Create Credentials button and then select OAuth Client ID from the options provided.
- Go to the Credentials tab and click on Create Credentials button. Select Web Application from dropdown list to create new application. Enter the name you want for your Client ID under the name field and enter the Redirect/Callback URI which is copied from Shopify store under the Authorized redirect URIs field.
- Click on the CREATE button to save your configurations.
- Copy your Client ID and Client Secret and save it on your Shopify SSO App Configuration.
- You have successfully completed your Google App OAuth Server side configurations.
3. Configure Google Apps as OAuth 2.0 Provider in Shopify.
- 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 Configure SSO and click on Add Identity provider button.
- Go to OAuth 2.0 tab and select the IDP name as a Google Apps from the dropdown.
- Enter the following values.
| IdP Name | Google Apps |
| IdP Display Name | Choose appropriate Name |
| Client ID | From step 2 |
| Client secret | From step 2 |
| Scope | email profile |
4. User Attribute Mapping
You can map attributes coming from your Identity Provider into your Shopify store customer profile.
- Navigate to Single Sign On - SSO Application from Admin Dashboard.
- Scroll down to Attribute Mapping Section.
- Enter the Fristname and Lastname attributes values by reffering the below table.
- Save your configurations.
| Firstname | firstName |
| Lastname | lastName |
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 your configuration of Google Apps as IDP in Shopify is sucesssfully completed.
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!
