This article provides a quick start guide for adding Zoho Login to Authress, so that your users can use their Zoho Account Login to authenticate into your software.
If you are looking to enable admin login access into the Authress Management Portal using your corporate IdP see the Authress Management Portal SSO Configuration.
In this guide we’ll set up Zoho Accounts login. Setting up authentication requires the following parts:
- Authress-Zoho OAuth configuration
- Zoho Accounts Client Registration
- Testing the configuration
Prerequisite: Zoho Account
In order to enable your users to log in with their Zoho Account, you will first need a developer account. You can do that by Registering for a Zoho account.
Authress Connection configuration
The first step is enabling the Zoho preconfigured Authress connection in the Authress Management Portal.
You will see there are the missing fields
Client ID and
Zoho Client Registration
Now we can create a new Client Registration. This Client Registration is what your users will see when the choose to sign in with Zoho.
Navigate to the Zoho API Console and choose to create a new Server-based Application.
Or click here: Create Server-based application
- Enter a
Client Nameas Authress, and set the Homepage URL to be your application main page.
- Set the
Authorized Redirect Redirect URIsto be your Authress Custom Domain url. This is the domain you set up in your Authress account. We'll assume for this example it is
https://authress.company.comand therefore the redirect URI is
https://authress.company.com/login. And then click Register. This value is available in your new Authress Connection for Zoho in the
Complete Setupsection of the connection.
Zoho Service Client Configuration
Now that the App is created in Zoho we can copy the
Client ID and the
Client Secret from the console and store it in Authress:
Then enable all the regions to use the same credentials in the Zoho client configuration:
Validate the configuration
Now the setup is complete and you are ready to test connection. You can test the connection in the Authress Connection configuration by clicking
When everything is configured correctly you'll see the test login success screen: