Browser Considerations

If you are using the Embedded Authentication type for your Catalyst application, then you need to implement the sign in process in the following manner:

await zcAuth.signIn(‘ELEMENT_ID’, {
redirectUrl:’/login’,
});

If you are using the Hosted Authentication type for your Catalyst application, then you need to implement the sign in process in the following manner:

await zcAuth.hostedSignIn(‘Redirect_Url’); //Replace with your required URL

Cloud Scale’s Authentication component allows you to implement a third-party authentication service of your preference for your Catalyst application. The authorization and validation of the end-user is handled by the third-party service, and the data is passed on to Catalyst.

Before you associate a third-party authentication with your Catalyst application, you must ensure that you have first completed handling the third-party logic in the external service. You can configure the authentication with any third-party of your choice.

Next, you set up the third-party authentication that you configured in Catalyst by navigating to the Authentication component in Cloud Scale in the Catalyst console. The steps are explained in Set Up Third-party Authentication in Catalyst help page.

This process involves the following steps that you must perform:

Generate a Custom Server Token

First, we generate a custom server token. When a user is re-directed from a third-party service after being authenticated, their credentials must be passed to an authentication function that you will need to code in Java, Node.js, or Python. This function will generate a Catalyst server-side token JSON Web Token token (JWT) which will then be passed to the client.

Authenticate User Using JWT

The below SDK will use the generated JWT or custom token to authenticate the end-user. You must incorporate this code into your web client logic, to enable third-party authentication.

This is a sample code that uses a JWT to authenticate the user is given below.

await zcAuth.signInWithJwt(getCustomTokenCallbacb);
function getCustomTokenCallback(){
  return fetch("{domain}/server/{function_name}/execute") //function url to get the generated custom token
    .then(resp => resp.json()
      .then(resp => {
        return new Promise((resolve, reject) => {
          resolve({
            client_id:"********",
            scopes:"ZOHOCATALYST.tables.rows.ALL,ZOHOCATALYST.cache.READ",
            jwt_token:"*********"
          });
        });
      })
    );
}

Configure Addional Settings

Finally, you can onfigure Customer User Validation or Authorized Domains as a part of Whitelisting and finish the set up. Catalyst will display a confirmation that a third-party authentication service has been enabled and your application’s authentication is being handled by it.