Configurar la autenticación de aplicaciones en Jitterbit App Builder

App Builder admite Autenticación de Aplicaciones como un tipo de proveedor de seguridad. La Autenticación de Aplicaciones permite a los desarrolladores crear sus propios formularios de inicio de sesión. Los desarrolladores pueden autenticar a los clientes utilizando un enfoque adecuado para la aplicación.

Es posible que desee configurar la Autenticación de Aplicaciones si, por ejemplo, desea que su aplicación:

• Mantenga sus propias cuentas de usuario
• Valide credenciales con un tercero
• Verifique un número de teléfono enviando un Código de Acceso Único (OTP)
• Permita que los clientes inicien sesión de manera semi-anónima

Requisitos de autenticación de aplicaciones

La siguiente información debe configurarse dentro de cada Entorno en el que reside la Aplicación (por ejemplo, Dev, QA, Producción) para que la Autenticación de Aplicaciones funcione correctamente:

• Página de inicio de sesión configurada como una aplicación separada
• Grupo de Proveedor de Seguridad de Autenticación de Aplicaciones
• Cuenta(s) de Usuario Genérica(s)
• Grupos con Roles asignados
• Reino de App Builder configurado para la Aplicación

Además de los requisitos anteriores, dentro de la Aplicación misma necesitará configurar:

• Regla de Autenticación
• Tabla de Sesiones con Campos de Inicio de Sesión
• Opcional: Validación de Contraseña
• Tabla de Usuario a Nivel de Aplicación
• App Builder como Fuente de Datos añadida a la Aplicación y Vinculada a su Fuente de Datos principal

Configurar la página de inicio de sesión como una aplicación separada

La página de inicio de sesión debe configurarse como una Aplicación independiente dentro de su entorno de aplicación y construirse a partir de la misma fuente de datos que su Aplicación principal. Solo se utilizará con fines de autenticación y, por lo tanto, necesita acceso a los datos de credenciales de Usuario.

Esta página de inicio de sesión es completamente personalizable. Hay información requerida en esta página (que se enumera a continuación) y puede desear agregar información adicional según las necesidades específicas de su aplicación.

Requisitos de la página de inicio de sesión

• Panel diseñado para funcionar con Sesión
• La página completa debe ser accesible por el Usuario Anónimo
• Como mínimo, la página requiere un campo de Nombre de Usuario (editable)
• Opcionalmente, se puede incluir un campo de Contraseña (puede tener validación de contraseña configurada)

• Botón que permite al Usuario activar la Regla de Autenticación construida para la Autenticación de la Aplicación. Por ejemplo: Iniciar sesión.

  Nota

  Este Botón no debe enlazar a ninguna Página. Solo debe ejecutar el Evento de Autenticación que luego cargará automáticamente la página del Constructor de Aplicaciones configurada como 'Página Predeterminada' en la configuración del Proveedor de Seguridad.

• Opcional: enlace de Olvidé mi Contraseña, enlace de Registrarse

Proveedor de seguridad de autenticación de la aplicación

El Proveedor de Seguridad de Autenticación de la Aplicación necesita ser configurado para la aplicación.

Para configurar el proveedor de seguridad de autenticación de la aplicación

1. Navega a la IDE
2. Selecciona Proveedores de Seguridad

3. Haz clic en + Autenticación de Usuario bajo el panel de Autenticación de Usuario, y Nombra el Proveedor de Seguridad. Generalmente se nombra según la aplicación para la que se está aprovisionando. Por ejemplo: ApplicationManager.

   • Tipo = Autenticación de Aplicación
   • Prioridad = autogenerada por el Constructor de Aplicaciones
   • Habilitado = debe estar habilitado para ser utilizado. Deja esta configuración desactivada (deshabilitada) hasta que toda la información requerida esté configurada y estés listo para probar la Autenticación de la Aplicación.
   • Identificador = autogenerado por el Constructor de Aplicaciones. Si estás parametrizando esta información, esto es lo que debería estar en la tabla de Parámetros como el ID del Proveedor.
   • En la sección de Autenticación, selecciona Mostrar en el Formulario de Inicio de Sesión.
   • Para Página Predeterminada, selecciona la Página a la que deseas que un Usuario acceda en tu Aplicación después de autenticarse desde la Página de Inicio de Sesión. Si no ves la Página que deseas de la lista inicialmente, navega de regreso a tu Aplicación y haz que la Página sea Compartida y vuelve a seleccionarla.
   • No se recomienda poblar Aprovisionamiento.

4. Haz clic en + Propiedad bajo Propiedades. Selecciona LoginPath como el Parámetro, y para el Valor en sí, navega a la página de inicio de sesión de autenticación de la aplicación y selecciona la URL después del Nombre de Dominio.

   • Asegúrate de incluir la barra inclinada inicial con la información que copiaste de la URL. Por ejemplo: /app/Application%20Manager%20LogIn/LogIn%3F%24activepanel%3DA?$activepanel

5. Guarda el registro

Cuentas de usuario genéricas

Para usar la Autenticación de Aplicaciones necesitas al menos una Cuenta de Usuario creada para este propósito, es posible que desees tener más de una Cuenta de Usuario dependiendo de los requisitos de tu aplicación. Crea un Usuario(s) de App Builder y nómbralos de acuerdo al nivel que deseas que vean dentro de la aplicación después de autenticarse. Por ejemplo: ApplicationManagerUser, ApplicationManagerDeveloper, ApplicationManagerAdministrator.

La Cuenta de Usuario es lo que App Builder utiliza para tomar el Usuario especificado y autenticarlo. Si requieres Grupos asignados a Usuarios que están autenticados a través de esta Cuenta de Usuario creada, deberías agregar el(los) Grupo(s) en esta etapa.

A continuación, crearás una Identidad para el(los) nuevo(s) Usuario(s). Aquí es donde seleccionas el grupo Proveedor que es el proveedor de Autenticación de Aplicaciones que creaste, el Usuario (el usuario real de App Builder y debe estar predeterminado), y un Nombre. El Nombre es el Nombre real de la Identidad que has creado. A menudo, el Nombre es el mismo que el Usuario. El Identificador no necesita ser definido.

Reino de App Builder configurado para la aplicación

• Un Reino debe ser configurado conteniendo tu aplicación y la aplicación de inicio de sesión
• Este Reino debe contener cualquier Grupo utilizado por los Usuarios de Autenticación de la Aplicación
• El Proveedor de Seguridad de Autenticación de Aplicaciones también será parte del Reino

Para más información sobre Reinos y cómo configurarlos, consulta el artículo Reinos.

Regla de autenticación

A continuación, configurarás una Regla de Autenticación que será utilizada por la Autenticación de Aplicaciones. Crea una Regla de Negocio CRUD XP que apunte a la vista de Autenticación desde la Fuente de Datos del Constructor de Aplicaciones. La Fuente de Datos de Origen debe ser la Fuente de Datos principal de las aplicaciones, y la Fuente de Datos de Destino será la Fuente de Datos del Constructor de Aplicaciones, la Acción será Insertar. Nombra esta Regla algo como Autenticar (Autenticación de Usuario).

Cuando vayas a diseñar la Regla CRUD en SQL de Negocios, necesitarás incluir la tabla de Usuarios (la tabla que almacena las credenciales de tu Usuario), la tabla de Sesiones, y dependiendo de cómo almacenes qué Usuario está iniciando sesión, puede que desees incluir una o más tablas adicionales, como Parámetro.

La unión interna en este escenario es sobre el Nombre de Usuario que deseas que utilicen, de modo que si el Nombre de Usuario es igual a algo en esa tabla, el Usuario podrá iniciar sesión en la aplicación. Si también se está configurando la Validación de Contraseña, estaría en el mismo Evento que esta Regla CRUD XP.

Las siguientes 4 Columnas son necesarias para configurar la Regla de Autenticación:

1. La Regla debe tener un GUID generado recientemente (newUUID()) configurado para apuntar a AuthenticateID
2. El ID del proveedor de seguridad de Autenticación de Aplicaciones, esto debe apuntar a ProviderId
3. La Regla necesita lo que estés pasando como el Nombre de Usuario de la aplicación. Esto es lo que etiqueta al Usuario para que el Constructor de Aplicaciones sepa quién es la persona que inició sesión. Esto es lo que se utiliza en la Auditoría en el Constructor de Aplicaciones. Se recomienda usar Correo Electrónico o Nombre de Usuario, y esta Columna debe apuntar a AppUserId.
4. Un Nombre de Usuario del Proveedor, este es el Usuario al que se le otorga acceso provisionado en la aplicación. Esto puede ser dinámico o codificado, pero es requerido y debe apuntar a Name.

Habilitar proveedor de seguridad

Por último, con toda la información descrita en este artículo configurada, deberías poder habilitar el Proveedor de Seguridad y probar para ver que la Autenticación de Aplicaciones ahora está funcionando para tu aplicación.

Configuración opcional para manejar usuarios no autenticados

Cuando un Usuario no Autenticado navega a una página donde la Autenticación de Aplicaciones está habilitada, puedes controlar a dónde los redirige App Builder. Si deseas que un Usuario sea redirigido a la página de inicio de sesión estándar, donde puede seleccionar un enlace para llegar a la página de inicio de sesión de la aplicación, no se requiere configuración adicional. Sin embargo, si deseas que un Usuario sea redirigido automáticamente a la página de inicio de sesión de la aplicación, se requieren 2 configuraciones adicionales:

1. Autenticación Predeterminada - Esto le indica a App Builder qué proveedor de seguridad deseas usar para autenticar usuarios dentro de una aplicación dada.
2. Redirigir en Desafío - Esto le indica a App Builder que omita el formulario de inicio de sesión al redirigir a los usuarios a tu proveedor de Autenticación de Aplicaciones.

Para configurar el proveedor de autenticación predeterminado

1. Inicia sesión en App Builder como un Usuario administrador
2. Haz clic en el botón IDE
3. Haz clic en el botón Proveedores de Seguridad
4. En el panel de Autenticación de Usuarios, haz clic en Más > Gestionar Aplicaciones
5. Haz clic en el ícono de Editar (Lápiz) para la aplicación
6. Establece Autenticación Predeterminada en el proveedor de Autenticación de Aplicaciones
7. Haz clic en el botón Guardar

Para configurar redirigir en desafío

1. Haz clic en el botón Atrás para regresar a la página de Proveedores de Seguridad
2. En el panel de Autenticación de Usuarios, haz clic en el ícono de Detalles (Chevron) para tu proveedor de Autenticación de Aplicaciones
3. Haz clic en el botón Editar
4. Marca la opción Redirigir en Desafío
5. Haz clic en el botón Guardar

Recursos

• Proveedor de seguridad - autenticación de aplicaciones
• URLs de desafío