Skip to main content

Setup user authentication with Zoho Accounts

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.

info

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:

  1. Authress-Zoho OAuth configuration
  2. Zoho Accounts Client Registration
  3. 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.

Authress preconfigured Zoho connection

You will see there are the missing fields Client ID and Client Secret.

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

Zoho server-based application

  • Enter a Client Name as Authress, and set the Homepage URL to be your application main page.

App Registration type selection

  • Set the Authorized Redirect Redirect URIs to 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://auth.yourdomain.com and therefore the redirect URI is https://auth.yourdomain.com/login. And then click Register. This value is available in your new Authress Connection for Zoho in the Complete Setup section of the connection.

Complete Authress Setup

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:

Zoho server registration client ID

Then enable all the regions to use the same credentials in the Zoho client configuration:

Zoho server configuration settings

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 Test Connection:

Test Connection in Authress

When everything is configured correctly you'll see the test login success screen:

Correct Zoho configuration in Authress