OAuth Single Sign-On (SSO) For Shopify Using FusionAuth as IDP
Setting up Single Sign-On (SSO) between FusionAuth and Shopify can streamline the
authentication process for your users. SSO allows users to log in to multiple services using a single set of
credentials. This guide outlines the steps to set up SSO between FusionAuth and Shopify, enhancing user
convenience and security while navigating your applications.
miniOrange allows FusionAuth to act as an IDP (Identity Provider), which allows users to Single Sign-On
(SSO) into Shopify using FusionAuth Credentials. Our application is compatible with all the SAML /
OAuth-compliant Identity Providers.
Pre-requisite: Single Sign On - SSO Login Application
To configure SSO into Shopify with FusionAuth 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 store (both plus and Non-plus).
Step by Step guide for Configuring FusionAuth as IDP for SSO into Shopify
1. Get the OAuth Callback URL from the Shopify SSO application
- 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 in the OAuth 2.0 section.
- Keep this value handy as it will be used in the next step.
2. Configure Shopify as SP in FusionAuth
- Log in to your FusionAuth account.
- Navigate to the Applications" tab on the FusionAuth dashboard and then click the Green plus button to add a new application.
- You must give your application a name on the Application Creation page. This is done so that your application can be distinguished in the dashboard. Provide an appropriate name for your application.
- Now select the OAuth tab. The default settings should be fine; the only thing you need to change is the Authorised redirect URLs section. Paste the OAuth Callback URL you copied in Step 1.
- Please keep in mind that FusionAuth will only provide login functionality by default, and you will have to manually create new users via the admin panel. This is useful if you're creating an internal site and don't want users to register. However, if you're creating a store, you'll probably want users to be able to create an account, so let's enable that. Enable self-service registration by clicking the Registration tab. The default settings should be adequate.
- Click the blue Save button in the upper-right corner of the page.
- You will now be shown a list of your applications. Click the Green looking glass icon next to the newly created application.
- Copy the Client ID and Client Secret from the Details window.
- You have completed FusionAuth side configurations.
3. Configure FusionAuth as IDP in Shopify
- Again navigate to the App section of the Shopify store and click on 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.
- Select OAuth 2.0 and refer below table to fill in the required details like Client ID, Client Secret, Endpoints, and Scope.
-
Enter the following values and make sure you change <your-fusionauth-instance-url> to the value of
your FusionAuth instance URL:
App Name Custom Provider App Display Name FusionAuth OAuth Authorize Endpoint https://<your-fusionauth-instance-url>/oauth2/authorize OAuth Access Token Endpoint https://<your-fusionauth-instance-url>/oauth2/token OAuth Get User Info Endpoint https://<your-fusionauth-instance-url>/oauth2/userinfo Client ID from step 2 Client secret from step 2 Scope openid - You have completed Shopify side configuration.
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 FusionAuth credentials you will see a pop-up window which is shown in the below screen.
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 FusionAuth sign-in page.
- You can sign in with an existing account or create a new one here. To create a fresh account, simply click Create an account and you'll be taken to the registration form.
- Enter your email address and password, then click the Register button. After creating a new account, go to the Customers page in your Shopify admin dashboard to ensure that the new user has been added.
- You’ll be successfully logged in to your Shopify store.
In this Guide, you have successfully configured FusionAuth Single Sign-On (SSO) by configuring FusionAuth as an OAuth Provider and Shopify as an OAuth Client using our Shopify Single Sign-On - SSO Login App. This solution ensures that you are ready to roll out secure access to your Shopify Store using FusionAuth 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 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 the 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 at shopifysupport@xecurify.com.
Need Help? We are right here!
