Autenticación de terceros

Authentication de Cloud Scale te permite implementar un servicio de autenticación de terceros de tu preferencia para tu aplicación Catalyst. La autorización y validación del usuario final es gestionada por el servicio de terceros, y los datos se pasan a Catalyst.

Para implementar la autenticación de terceros en tu aplicación Android, debes realizar los pasos que se describen a continuación.

1. Configurar el servicio de autenticación de terceros

Antes de asociar una autenticación de terceros con tu aplicación Catalyst, debes asegurarte de haber completado primero la gestión de la lógica de terceros en el servicio externo. Puedes configurar la autenticación con cualquier servicio de terceros de tu elección.

2. Configurar el tipo de autenticación de terceros en Catalyst

Ahora debes configurar la autenticación de terceros que configuraste en Catalyst navegando al componente Authentication en Cloud Scale en la consola de Catalyst. Los pasos se explican en la página de ayuda Configurar autenticación de terceros en Catalyst.

Este proceso involucra los siguientes pasos que debes realizar:

i. Generar un token de servidor personalizado:

Cuando un usuario es redirigido desde un servicio de terceros después de ser autenticado, sus credenciales deben pasarse a una función de autenticación que necesitarás codificar en Java, Node.js o Python. Esta función generará un token del lado del servidor de Catalyst jwtToken o customToken que luego se pasará al lado del cliente (aplicación Android). La consola de Catalyst proporciona scripts predefinidos para generar el customToken. Puedes incorporar este script en la función del lado del servidor que escribas, para devolver el customToken.

ii. Omitir la configuración del lado del cliente:

Puedes omitir la configuración del lado del cliente en la consola por ahora, ya que incorporaremos el token de servidor personalizado en la lógica del cliente al final para completar el proceso de inicio de sesión.

iii. Configurar ajustes adicionales y finalizar la configuración:

Configura la validación personalizada de usuarios o los dominios autorizados como parte de la lista blanca y finaliza la configuración.

Catalyst mostrará una confirmación de que se ha habilitado un servicio de autenticación de terceros y que la autenticación de tu aplicación está siendo gestionada por este.

3. Reimportar el archivo de configuración en tu proyecto Android

Después de habilitar la autenticación de terceros para tu aplicación Android desde la consola de Catalyst, necesitarás descargar e importar el archivo de propiedades app_configuration_development o app_configuration_production en tu proyecto Android nuevamente, según el entorno de tu aplicación. Esto se debe a que este archivo ahora incluirá dos propiedades adicionales: JWTClientID y JWTClientSecret. Estas propiedades deberán pasarse en el siguiente paso, después de reinicializar el SDK.

Para volver a descargar el archivo de configuración:

1. Ve a Settings, luego a Developer Tools en la consola de Catalyst de tu proyecto. Encontrarás tu paquete Android existente en la sección Mobile SDK. Abre el paquete.

2. Haz clic en la pestaña del entorno requerido en la ventana emergente, luego haz clic en Download para descargar el archivo de configuración.

Ahora puedes reimportar este archivo de configuración descargado siguiendo los pasos mencionados aquí.

4. Reinicializar el SDK

Ahora debes reinicializar el SDK para incluir las propiedades recién descargadas en tu código. La reinicialización del SDK también se puede hacer de dos maneras, similar a inicializar el SDK por primera vez: especificando el entorno del proyecto, y sin especificar el entorno donde el entorno de producción se considera el predeterminado. Sin embargo, esto incluirá métodos adicionales del SDK para confirmar la autenticación de terceros.

Método 1: Especificando el entorno

Puedes reinicializar el SDK como se muestra a continuación. Puedes pasar los valores del Environment como DEVELOPMENT o PRODUCTION según el entorno en el que opera la aplicación. El isCustomLogin indica un valor booleano que se establece para la presencia de una autenticación de terceros.

Estos se pasan al método init() a través de la clase ZCatalystApp como se muestra a continuación:

fun init(
context: Context, 
environment: ZCatalystSDKConfigs.Environment, 
isCustomLogin: Boolean = false
): ZCatalystApp

A continuación se muestra un fragmento de código de ejemplo para esta operación:

ZCatalystApp.init(
context, 
ZCatalystSDKConfigs.Environment.{DEVELOPMENT},  
true
)

Método 2: Sin especificar el entorno

Si no se especifica el Environment en la inicialización del SDK, se considerará como PRODUCTION por defecto. Este método también te permite reinicializar el SDK especificando las propiedades JWTClientID y JWTClientSecret obtenidas del archivo de configuración recién descargado a través de ZCatalystSDKConfigsBuilder.

Esto se puede hacer de la siguiente manera:

fun init(context: Context, sdkConfigs: ZCatalystSDKConfigs, isCustomLogin: Boolean = false): ZCatalystApp

A continuación se muestra un fragmento de código de ejemplo:

val sdkConfigs = ZCatalystSDKConfigs.Builder(
          apiBaseURL: 'https://api.catalyst.zoho.com',
          clientID: '100****************************FX', //ID de cliente JWT
          clientSecret: '19ed***************************2s', //Secreto de cliente JWT
          redirectURL: '*****',
          oauthScopes: 'ZOHOCATALYST.tables.rows.ALL, ZOHOCATALYST.tables.columns.ALL',
          portalID: '10******79',
          projectID: 28*******90
  ).setAccountsPortalBaseURL('https://accounts.zohoportal.com')
     .setUserAgent("ZCatalyst Sample App")
     .setRequestHeaders('PORTAL_ID', '*********')
     .build();
ZCatalystApp.init(context, sdkConfigs, true)

5. Codificar la lógica de inicio de sesión del usuario para la autenticación de terceros

Ahora puedes completar la configuración gestionando la lógica de inicio de sesión de la autenticación de terceros en tu aplicación Android. Debes pasar el customToken o jwtToken generado en el paso 2 al método handleCustomLogin() como se muestra a continuación:

fun handleCustomLogin(jwtToken :String, success: () -> Unit, failure: (ZCatalystException) -> Unit)

A continuación se muestra un fragmento de código de ejemplo:

ZCatalystApp.getInstance().handleCustomLogin("123xxxxxxxx", {
    println("Login successfully.")
}, {
    println("Login failed.")
})