OAuth Shopify Single Sign-On (SSO) using F5 as Identity Provider
Configure Single Sign On (SSO) login into Shopify store using F5 as an Identity provider (IDP). miniOrange allows F5 to act as an IDP (Identity Provider), which allows users to Single Sign-On (SSO) into Shopify store using F5 credentials. This document will guide you through the easy step-by-step process of configuring SSO login into Shopify store with F5 using OAuth protocol. This solution ensures that you are ready to roll out secure access to your Shopify store using F5 within minutes
Pre-requisite : Single Sign On - SSO Login Application
To configure SSO into Shopify with F5 as IDP, you will need to install the miniOrange Shopify Single Sign On - SSO Login Application on your 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 F5
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 SP in F5 OAuth Provider
- Go to developer console page of F5.
- Navigate to Access > Federation > OAuth Authorization Server > Client Application
- Enter the basic details required for configuring app.
- Enter Redirect URI/ OAuth Callback URI which is copied from Shopify store.
- Click on Finished button.
- Copy your Client ID and Client Secret and keep these values handy as you will need them later.
You have successfully completed your F5 OAuth Server side configurations.
3. Configure F5 as Identity 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 App name as a Custom Provider from the dropdown.
- Now, fill in the required details like Client ID, Client Secret, Endpoints, and Scope.
- Please refer to the below table for configuring the values.
- Click on the Save button.
| App Name | Custom Provider |
| App Display Name | Display name of your choice |
| OAuth Authorize Endpoint | https://f5-oauth2/v1/authorize |
| OAuth Access Token Endpoint | https://f5-oauth2/v1/token |
| OAuth Get User Info Endpoint | https://f5-oauth2/v1/userinfo |
| Client ID | From step 2 |
| Client secret | From step 2 |
| Scope | contacts email |
You have successfully completed your Shopify side configurations.
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 F5 you configured in previous step. Log in with your F5 account credentials.
- You’ll be successfully logged in to your Shopify store.
Hence your configuration of F5 as IDP in Shopify is successfully 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.
How do I enable the SSO application’s auto redirect to IDP feature on my Shopify store?
You must upgrade to the SSO application’s Enterprise plan to enable the Auto-Redirect to the IDP feature. Follow the steps outlined here to enable this feature.
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!
