Autenticación de terceros

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

Para implementar la autenticación de terceros en tu aplicación iOS, necesitarás realizar los pasos descritos a continuación.

1. Configurar el servicio de autenticación de terceros

Antes de asociar una autenticación de terceros con tu aplicación de Catalyst, debes asegurarte de haber completado primero el manejo 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 de configuración de 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 iOS). La consola de Catalyst proporciona scripts prediseñados 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 de usuario personalizada o los dominios autorizados como parte del Whitelisting 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 manejada por él.

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

Después de habilitar la autenticación de terceros para tu aplicación iOS desde la consola de Catalyst, necesitarás descargar e importar el archivo de propiedades AppConfigurationDevelopment.plist o AppConfigurationProduction.plist en tu proyecto iOS 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. Navega a Settings, luego a Developer Tools en tu consola de Catalyst de tu proyecto. Encontrarás tu paquete iOS 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. Reinicializar el SDK se puede hacer de manera similar a inicializar el SDK por primera vez. Sin embargo, ahora necesitarás especificar las propiedades JWTClientID y JWTClientSecret obtenidas del archivo de configuración recién descargado a través de ZCatalystAppConfiguration.

public func initSDK( window : UIWindow, environment : ZCatalystEnvironment, appConfiguration : ZCatalystAppConfiguration ) throws

Parámetros:

• window: El objeto window que despacha eventos a tus vistas
• appConfiguration: Un objeto que contiene todos los detalles de configuración para el funcionamiento del SDK.
• environment: El entorno de tu aplicación, ya sea .development o .production.

El environment aquí indica si la aplicación está operando en el entorno de Development o Production. De manera similar a incluir el archivo de configuración plist apropiado según el entorno en el proyecto de tu aplicación, debes reinicializar el SDK para el entorno apropiado.

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

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

public func handleCustomLogin( withJWT token : String, completion : @escaping ( Error? ) -> Void )