Single Sign-On (SSO) For Shopify Using AWS Cognito as Userstore
Configure AWS Cognito as a Userstore for your Shopify Store. miniOrange provides a ready-to-use solution that ensures that you are ready to roll out secure access to the Shopify Store using AWS Cognito within minutes.
Pre-requisite: Single Sign On - SSO Application
To configure SSO into Shopify with AWS Cognito as Userstore, 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 the Single Sign-On in Shopify Store Using AWS Cognito as Userstore
Step 1: Step to get the Redirect URI for the 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 of 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. Configurations for AWS Cognito
- Sign in to AWS Amazon.
- Now enter “Cognito” in the search textbox & select Cognito from the dropdown.
- Go to “Manage your user pools”.
- Click on the “Create a user pool”.
- Add pool name and select “Review Defaults”.
- Click on the Edit icon as shown in the below image.
- Now, Enable the Email Address and Phone Number option and click on the Next step button.
- Click on “Add app client” & then click on Add an app client.
- Enter the App client name and Disable the Generate Client Secret option. Enable the Username Password-based authentication option,then Click on “Create app client”.
- Click on the Return to Pool Details to come back to your configuration.
- Click on the Create Pool button to save your settings and create a user pool.
- In the navigation bar present on the left side, click on the App Client Settings option under the App Integration menu.
- Go to the Cognito dashboard and select “Cognito User Pool”, and add the callback URL that you have copied from Pre-requisite.
- Add application home page URL has to Sign out URL.
- Also, select Authorization code grant as “Allowed OAuth Flows” & select email, OpenID, and Profile as “Allowed OAuth Scopes”.
- After selecting all the details click on the Save changes button.
- Go to “App client” and click on “Show details” to get a client ID. (Keep client ID handy as you will need it later.)
- Go to domain name and enter a domain name for your app. After adding the domain name you can check its availability by clicking on the “Check availability” button. After entering valid domain name click ”Save Changes” button.
- Complete domain name: The complete domain name that you need to enter in the miniOrange dashboard is {your domain name}.auth.{region name}.amazoncognito.com
- Add Users / Groups to Cognito App: Go to Users and groups and then click on Users. After this click on Create user.
- Fill in all required information and click on Create user.
- Click on Groups and then click on Create group.
- Fill all required information and click on the Create group.
- Go to Federated Identities and click on Create New Identity pool button.
- Enter the Identity pool name and enable Unauthenticated identities and Authentication flow settings, then click on the Create pool button.
- Click on the Allow button and You will get the Identity Pool Id.
A] Steps to Configure User Pool
B] Steps to Configure Identity Pool.
3. Configure Shopify as SP (Service Provider)
- 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 of the navigation bar.
- From the left navigation bar select User Store and Click on Add User Store button.
- Select AWS Cognito.
- Enter the following values.
- Now you can click on Save.
| AWS Cognito Identifier | Provider Name |
| AWS Cognito Region | Get Cognito region from user pool(eg.us-east-2) | User Pool ID | From step A | Client ID | From step A |
| Identity Pool ID | From step B |
4. Test Connection
- Go to the Configure SSO tab.
- Click on the Select >> Test Connection option against the Identity Provider you configured.
- On entering valid AWS Cognito credentials you will see a pop-up window which is shown in the below screen.
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 the 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!
