Configurar autenticación para una aplicación sin conexión en Jitterbit App Builder
Introducción
La autenticación para una aplicación sin conexión requiere pasos de configuración tanto en la aplicación principal como en la aplicación sin conexión. Esta página describe estos pasos y cómo probarlos.
Aplicación principal
Cuando un usuario inicia sesión en una aplicación sin conexión, se autoriza y se le otorgan permisos a través de la aplicación principal asociada. Para permitir esto, debes configurar lo siguiente en la aplicación principal:
-
Un grupo de proveedor de seguridad. Esto permite que la aplicación sin conexión acceda a la aplicación principal a través del servidor de autorización.
-
Un cliente.
Grupo de proveedor de seguridad
Debes crear un grupo de proveedor de seguridad en tu entorno de desarrollo y luego propagarlo a tus entornos de control de calidad o producción usando el método habitual de gestión de paquetes de aplicaciones.
Para crear un grupo de proveedor de seguridad, sigue estos pasos:
-
Abre tu aplicación principal para editar.
-
Selecciona App Workbench del cajón de acciones o Workbench del menú de la aplicación, luego haz clic en Roles.
-
Haz clic en el botón Application Groups para abrir el diálogo Group y Roles.
-
Bajo Group, haz clic en el botón Create.
-
Ingresa un nombre (por ejemplo
Offline App Security Provider) y una descripción para el grupo, luego haz clic en el icono para guardarlo. -
Cierra el diálogo.
Consejo
Este grupo no proporciona permisos, sino que los proporciona la asociación del grupo con el proveedor de seguridad, que se realiza en la siguiente sección.
Proveedor de seguridad de autorización
El proveedor de seguridad de autorización habilita la autenticación OpenID para la aplicación sin conexión. Debe configurarse en cualquier entorno con el que la aplicación sin conexión pueda autenticarse.
Para configurar un proveedor de seguridad de autorización, sigue estos pasos:
-
Selecciona IDE > Security Providers.
-
En el panel Security Providers, haz clic en el icono al final de la fila Authorization Server para abrir el registro.
-
Bajo Provider, haz clic en el botón Edit, luego realiza los cambios necesarios.
-
Cuando el proveedor esté configurado, haz clic en Enabled para habilitarlo, luego haz clic en el botón Save.
-
Bajo Provider, selecciona More > Manage Groups.
-
En el diálogo Groups, haz clic en el botón Create.
-
En el diálogo Provider Group, establece los siguientes valores:
-
Name:
Offline App Security Provider -
Identifier:
Offline App Security Provider -
Group: Haz clic para abrir el menú, luego selecciona el grupo Offline App Security Provider.
-
-
Cierra el diálogo Provider Group, luego cierra el diálogo Groups.
Consejo
El identificador del grupo de seguridad (Offline App Security Provider en este ejemplo) se utiliza más adelante para configurar el proveedor de seguridad de la aplicación sin conexión.
Cliente
Para crear un cliente, sigue estos pasos:
-
Selecciona IDE > User Management.
-
Selecciona la pestaña Clients.
-
Haz clic en el botón + Client.
-
En el diálogo, establece valores para lo siguiente bajo Client:
-
Name:
Offline App Client -
Description: Ingresa una descripción.
-
-
Haz clic en el botón Save.
-
Bajo Redirects, haz clic en el botón + URL.
-
Ingresa lo siguiente en el campo, luego haz clic en el icono para guardarlo:
https://localhost:5001/signin-OpenID-
localhost: Esta es una cadena literal; no necesitas sustituir un nombre de host o una dirección IP. -
OpenID: Esta parte de la URL puede ser diferente pero debe coincidir exactamente con el nombre del proveedor de seguridad OpenID (configurado más adelante).
-
-
Bajo Client, selecciona More > Advanced.
-
En el diálogo Advanced Settings, haz clic para activar tanto Require PKCE como Public, después cierra el diálogo.
-
Copia o anota el Client ID para usarlo más adelante, después cierra el diálogo.
Aplicación sin conexión
Para configurar la aplicación sin conexión, debes hacer lo siguiente:
-
Crear grupos de usuarios.
-
Configurar un proveedor de seguridad OpenID.
-
Hacer una asociación de grupo para el proveedor de seguridad.
-
Configurar los orígenes de datos del conector de la aplicación.
Grupos de usuarios
Como en cualquier aplicación de App Builder, deberías crear grupos de usuarios para los diferentes tipos de usuarios que se espera que usen la aplicación, o al menos los siguientes:
-
Un grupo User, para usuarios generales de la aplicación.
-
Un grupo Administrator, para desarrolladores y administradores.
Proveedor de seguridad OpenID
Necesitas un proveedor de seguridad para probar la autenticación en instancias de desarrollo (fuera del dispositivo) de tu aplicación sin conexión. La información de este proveedor de seguridad se puede exportar como un archivo JSON y usarse para configurar automáticamente el proveedor en dispositivos móviles. El soporte de Jitterbit utiliza el archivo JSON al crear compilaciones de la aplicación sin conexión para tus dispositivos móviles.
Para configurar un proveedor de seguridad OpenID, sigue estos pasos:
-
Selecciona IDE > Security Providers.
-
Haz clic en el botón + Security Provider.
-
En Provider, establece los siguientes valores:
-
Settings
-
Name:
OpenIDImportante
Este valor debe coincidir exactamente con el sufijo de URL de redirección del cliente (establecido previamente) en la aplicación principal.
-
Type: Vinyl / OpenID Connect
-
Priority: (Predeterminado).
-
Enabled: Habilitado.
-
-
Tokens
- Owner: User (predeterminado).
-
Sign In
-
Redirect On Challenge: Deshabilitado (predeterminado).
-
Show On Login Form: Habilitado.
-
Default Page: En blanco (predeterminado).
-
Sign Out Page: En blanco (predeterminado).
-
-
Provisioning
-
User Provisioning: Habilitado.
-
Match Existing User: Habilitado.
-
Supplies Group Membership: Habilitado.
-
Name Format: En blanco (predeterminado).
-
Name Identifier Format: En blanco (predeterminado).
-
Identity Provider URL: En blanco (predeterminado).
-
-
-
Haz clic en el botón Save para guardar el proveedor.
-
En Endpoints, haz clic en el botón + Endpoint.
-
En el diálogo Endpoint, establece lo siguiente:
-
Endpoint Type: Haz clic para abrir el menú, después selecciona OpenID Connect Issuer.
-
URL: Ingresa la URL del servidor App Builder de la aplicación principal con la que se autentica la aplicación sin conexión.
-
-
Haz clic en el botón Save, después cierra el diálogo Endpoint.
-
En Credentials, haz clic en el botón + Credential.
-
En el diálogo Credential, establece lo siguiente:
-
Type: Haz clic para abrir el menú, después selecciona Client.
-
User Name: Ingresa el Client ID (anotado previamente).
-
-
Haz clic en el botón Save, después cierra el diálogo Credential.
-
En Properties, haz clic en el botón + Property.
-
En el diálogo Properties, establece lo siguiente:
-
Parameter: Haz clic para abrir el menú, después selecciona Scopes.
-
Value:
openid profile email phone api groups
-
-
Haz clic en el botón Save, después cierra el diálogo Properties.
Asociación de grupo
Se otorga acceso a la aplicación sin conexión a través del identificador de grupo del proveedor de seguridad OpenID configurado en la instancia de App Builder de la aplicación principal.
Para asociar el grupo con el proveedor, sigue estos pasos:
-
Selecciona IDE > Security Providers.
-
En el panel Security Providers, haz clic en el icono al final de la fila OpenID para abrir el registro.
-
En Provider, selecciona More > Manage Groups.
-
En el diálogo Groups, haz clic en el botón Create.
-
En el diálogo Provider Group, establece los siguientes valores:
-
Name: Ingresa un nombre de tu elección.
-
Identifier:
Offline App Security Provider -
Group: Haz clic para abrir el menú y luego selecciona el grupo Offline App Security Provider.
-
-
Haz clic en el botón Save y cierra los diálogos Provider Group y Groups.
Fuentes de datos del conector
Cualquier fuente de datos del conector de App Builder de la aplicación sin conexión que acceda a la aplicación principal debe usar el proveedor de seguridad OpenID recién creado.
Para todos estos conectores, haz lo siguiente:
-
Selecciona IDE > Data Servers.
-
En la tabla Data Servers, haz clic en el botón Details de la fuente de datos.
-
En el diálogo Server, asegúrate de que la URL sea tu instancia de App Builder de la aplicación principal y luego haz clic en el botón Edit.
-
Expande el grupo Security Settings.
-
Haz clic para abrir el menú Security Provider y luego selecciona OpenID (el proveedor de seguridad creado anteriormente).
-
Haz clic en el botón Save y cierra el diálogo Server.
Prueba
Cuando la configuración está completa, aparece un botón Sign in with OpenID en la pantalla de inicio de sesión de App Builder de la aplicación sin conexión.
El siguiente es un ejemplo de un patrón de prueba simple:
-
En la instancia de App Builder de la aplicación principal, crea un usuario local con una contraseña.
-
En la instancia de App Builder de la aplicación sin conexión, inicia sesión con este usuario.
-
Verifica el acceso a tu aplicación sin conexión y comprueba la funcionalidad de cualquier página que utilice conectores de App Builder.