Saltar al contenido

Aplicación Portal de Registro de Jitterbit

Descripción general

Jitterbit proporciona la aplicación Portal de Registro a través de Jitterbit Marketplace. Creada con Jitterbit App Builder, es una interfaz de autoservicio de registro y autenticación basada en la autenticación de aplicación nativa de App Builder. Proporciona registro de cuenta, inicio de sesión y recuperación de contraseña, con autenticación de dos factores (2FA) mediante código de verificación por correo electrónico, políticas de contraseña y bloqueo configurables, y un panel administrativo para gestionar usuarios, plantillas de mensaje y configuraciones.

Se descarga la aplicación como un paquete de versión de App Builder (un archivo .LP) desde Marketplace e instalarlo en la propia instancia de App Builder, donde se puede configurar y ampliar para adaptarse al proceso.

Esta página describe cómo funciona la aplicación, sus características principales y modelo de datos, y cubre los requisitos previos, cómo descargar e instalar, cómo configurarla para el entorno, cómo se controla el acceso, las reglas comerciales que utiliza, y pasos comunes de solución de problemas.

Cómo funciona

Los visitantes anónimos llegan a tres puntos de entrada: registrar una nueva cuenta, iniciar sesión o recuperar una contraseña. El registro y la recuperación son asistentes guiados que utilizan un código de verificación por correo electrónico:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart TD V["Anonymous visitor"] --> R["Register"] V --> L["Log in"] V --> F["Forgot password"] R --> R1["Enter email and password;
policy and duplicate checks"] R1 --> R2["Verification code emailed"] R2 --> R3["Verify code"] R3 --> A["Account created,
identity assigned"] L --> L1["Lockout checks
by email and IP"] L1 --> L2["Validate credentials"] L2 --> S["Authenticated session"] F --> F1["Enter email;
recovery code emailed"] F1 --> F2["Verify code"] F2 --> F3["Set new password"] F3 --> L

Características principales

Al instalar y configurar Portal de Registro, se proporcionan las siguientes capacidades:

  • Registro de autoservicio: Un asistente de dos pasos recopila un correo electrónico y contraseña, aplica la política de contraseña configurada, confirma la contraseña y verifica una verificación de correo electrónico duplicado sin revelar si el correo electrónico ya existe.

  • Autenticación de dos factores: El registro y la recuperación de contraseña emiten un código de verificación con límite de tiempo por correo electrónico. Un código nuevo invalida cualquiera anterior.

  • Inicio de sesión con protección de bloqueo: El inicio de sesión valida las credenciales y aplica los umbrales de bloqueo por dirección de correo electrónico y dirección IP de origen.

  • Recuperación de contraseña: Un asistente de tres pasos identifica la cuenta, valida un código por correo electrónico y permite al usuario establecer una contraseña nueva compatible con la política.

  • Políticas configurables: Los administradores gestionan la complejidad de contraseña, umbrales de bloqueo y configuraciones de entorno desde paneles de política agrupados.

  • Mensajería personalizable: El contenido del correo electrónico, los mensajes en pantalla y el texto de términos de servicio se almacenan como registros de plantilla editable, permitiendo a los administradores cambiar la redacción sin alterar la lógica de la aplicación.

Modelo de datos

Portal de Registro utiliza tablas administradas de App Builder y aplica límites de datos según la sesión de usuario en lugar de restricciones de clave externa física. Cada tabla tiene un tipo de uso de datos, establecido por su Opción de instalación, que controla cómo se tratan sus datos cuando se instala la aplicación en un entorno nuevo.

Tabla Tipo de uso Propósito
User Usuario Registros de identidad de cuentas registradas automáticamente, incluyendo credenciales con hash, códigos de verificación, valores de vencimiento y asignación de grupo de identidad.
LoginAttempt Usuario Registro de seguridad de intentos de autenticación (correo electrónico, dirección IP, marca de tiempo y éxito), utilizado para auditoría y cálculos de bloqueo.
Session Usuario Estado de sesión por usuario, credenciales en caché y tokens de acceso, limitados a una única sesión del navegador.
Template Usuario HTML localizado para correos electrónicos, mensajes en pantalla y contenido de términos de servicio.
Parameter Compartido Configuración global: asignación de proveedor de seguridad, política de contraseña y umbrales de bloqueo de cuenta/IP.

Nota

Todas las tablas excepto Session se auditan.

Requisitos previos

Para usar Portal de Registro, se necesita lo siguiente:

  • Una licencia de Jitterbit Harmony con acceso a App Builder. Esto habilita la descarga de Marketplace; si la organización no tiene licencia para App Builder, la acción Descargar aplicación se reemplaza por una acción de solicitud Obtener aplicación (ver Descargar e instalar).

  • Una instancia de App Builder ejecutando App Builder 4.63, la versión para la que se genera el paquete actual. Cada paquete se instala solo en su versión exacta de App Builder; si tu instancia está en una versión diferente, contacta al soporte de Jitterbit para solicitar un paquete compatible.

  • Una base de datos PostgreSQL para tu instancia de App Builder.

  • Una ruta de correo saliente desde tu instancia de App Builder. La aplicación envía códigos de verificación y recuperación por correo electrónico; sin una configuración de correo funcional, esos códigos no se envían.

Descargar e instalar

Descargar la aplicación desde Marketplace

  1. Inicia sesión en el portal Harmony en https://login.jitterbit.com y abre Marketplace.

  2. Localiza la aplicación llamada Registration Portal. Puedes usar la barra de búsqueda o, en el panel Filtros bajo Tipo, selecciona App para mostrar solo aplicaciones.

  3. Haz clic en la tarjeta de la aplicación para abrir el panel Detalles. Revisa los Requisitos de la aplicación (la versión de App Builder y la base de datos que necesita).

  4. Haz clic en el enlace Ir a documentación de la aplicación para abrir esta documentación en una pestaña independiente y mantenla abierta como referencia.

  5. Realiza una de las siguientes acciones, según si tu organización tiene licencia para App Builder:

    • Descargar aplicación: Si tu organización tiene licencia para App Builder, haz clic en Descargar aplicación, ya sea en la tarjeta de la aplicación o en el panel Detalles. Tu navegador guarda el archivo .LP en su ubicación de descargas, y una notificación Aplicación de App Builder descargada correctamente confirma la descarga.

    • Obtener aplicación: Si tu organización no tiene licencia para App Builder, la acción se etiqueta como Obtener aplicación. El panel Detalles muestra un mensaje indicando que se requiere una licencia de App Builder, con un botón Enviar. Haz clic en Enviar para solicitar que un representante se comunique contigo sobre App Builder; una notificación Mensaje enviado correctamente lo confirma.

Instalar la aplicación en App Builder

Instala el archivo .LP descargado en tu instancia de App Builder:

  1. Inicia sesión en App Builder y ve al IDE.

  2. En Deploy, haz clic en Instalar versión.

  3. Haz clic en + Paquete, luego en Examinar y selecciona el archivo .LP que descargaste.

  4. Haz clic en Guardar. El panel Versión muestra la información del paquete, luego cierra el diálogo Paquete.

  5. Confirma que los detalles sean correctos, luego haz clic en Instalar.

Para obtener una vista previa del contenido de un paquete antes de instalarlo, haz clic en el botón Manifest.

Modificar la aplicación en un entorno de desarrollo

La fuente de datos de la aplicación se instala sellada. Si implementas la aplicación en un entorno de desarrollo e intentas modificarla, desella la fuente de datos para poder editar los objetos de la aplicación. Déjala sellada en QA y producción para preservar la equivalencia entre entornos. Consulta Sellar o dessellar una fuente de datos.

Configuración y ajustes

Después de instalar la aplicación en un nuevo entorno, completa los siguientes pasos para prepararla para usar:

  1. Asignar grupos de acceso. Agrega los usuarios que configurarán la aplicación al grupo Registration Portal Administrator, el cual otorga acceso a toda la configuración y administración. Agrega el usuario anónimo de App Builder al grupo Registration Portal Anonymous, el cual permite que visitantes no autenticados accedan a las páginas de registro, inicio de sesión y recuperación de contraseña. Consulta Seguridad y acceso.

  2. Establecer el proveedor de seguridad. En la configuración de Parameter, actualiza el valor de ProviderId para que coincida con tu host de autenticación del entorno. Para saber cómo crear este proveedor, consulta Crear el proveedor de seguridad de autenticación de aplicaciones.

  3. Establecer la identidad predeterminada. Establece el valor de DefaultIdentityName en un contexto de seguridad válido en tu entorno host. Las cuentas nuevas se aprovisionan contra esta identidad. Para configurar la cuenta de usuario genérica a la que se asigna, consulta Configurar una cuenta de usuario genérica; para saber cómo la identidad rige el acceso, consulta Seguridad y acceso.

  4. Revisar las políticas de seguridad. Verificar los umbrales de bloqueo, períodos de bloqueo y configuraciones de complejidad de contraseña en los paneles Lockout Policy, Password Policy y Environment Settings. La aplicación se instala con estos valores predeterminados:

    • Lockout Policy: IP Attempts 50, IP Duration 60 minutos, Email Attempts 10, y Email Duration 5 minutos.

    • Password Policy: Longitud mínima de 8 caracteres, que requiere al menos una letra mayúscula y un número.

  5. Personalizar plantillas. Editar los asuntos de correo electrónico, contenido del mensaje y copia de términos de servicio en los registros de Template.

Seguridad y acceso

Registration Portal utiliza la seguridad basada en roles de App Builder role-based security con dos grupos de acceso:

  • Registration Portal Anonymous: Otorga acceso a visitantes no autenticados a las páginas de registro, inicio de sesión y recuperación de contraseña. Asignar el usuario anónimo de App Builder a este grupo para que estos puntos de entrada públicos sean accesibles.

  • Registration Portal Administrator: Otorga acceso completo a la configuración y gestión de la aplicación, incluidas políticas, plantillas y la cuadrícula de usuarios. Asignar los usuarios que administran la aplicación a este grupo.

La aplicación aprovisiona cuentas utilizando un patrón semi-anónimo. Los usuarios nuevos reciben una identidad base definida por la configuración DefaultIdentityName en la tabla Parameter. Una vez que un usuario se autentica, esa identidad asignada rige lo que puede acceder. Los administradores pueden elevar o cambiar el acceso de un usuario desde la cuadrícula de gestión.

Los visitantes anónimos se limitan a los puntos de entrada de registro, inicio de sesión, recuperación de contraseña y la página de términos de servicio. La aplicación aplica varios controles de seguridad, implementados como reglas de negocio:

  • Bloqueo por dirección de correo electrónico y por dirección IP, utilizando umbrales configurados en Parameter.

  • Protección contra recolección de cuentas: Los fallos de inicio de sesión devuelven un mensaje genérico, y el registro y la recuperación devuelven comentarios genéricos, por lo que la aplicación no revela si existe una cuenta. Cuando alguien intenta registrarse con un correo electrónico que ya tiene una cuenta, el registrante ve la misma confirmación genérica, pero la aplicación envía un correo electrónico al titular de la cuenta existente sobre el intento de registro, para que pueda iniciar sesión en su cuenta o ignorar el mensaje si no fue él.

  • Expiración del código de verificación: Los códigos expiran después de una ventana configurada, e emitir un nuevo código invalida el anterior.

Reglas de negocio

La lógica de Registration Portal se implementa como reglas de negocio de App Builder. Los nombres de reglas siguen la convención Target (Purpose or Subtype) Descriptor de App Builder, por lo que la palabra inicial identifica la tabla sobre la que actúa la regla.

Reglas de inicio de sesión y bloqueo

Regla Propósito
LoginAttempt (Validation) Email Address Lockout Detiene el inicio de sesión cuando los intentos fallidos de correo electrónico superan el umbral configurado.
LoginAttempt (Validation) IP Address Lockout Detiene el inicio de sesión cuando los intentos fallidos desde la dirección IP superan el umbral configurado.
Session (Validation) Valid Email and Password Valida las credenciales y devuelve un mensaje de fallo genérico para evitar revelar detalles de la cuenta.

Las validaciones de bloqueo utilizan dos subconsultas auxiliares, Count Email Attempts y Count IP Attempts, que cuentan los intentos fallidos dentro de la ventana de umbral definida en Parameter.

Reglas de registro e identidad

Regla Propósito
User (Validation) Duplicate Email Verifica un correo electrónico existente durante el registro sin revelar si existe.
User (Update) Default Identity Name Asigna la identidad predeterminada a una cuenta nueva al registrarse.

Reglas de autenticación de dos factores

Regla Propósito
User (Validation) Email Verification Code Expired Determina si un código de verificación ha pasado su tiempo de expiración.
User (Update) Email Verification Code Emite un nuevo código de verificación e invalida cualquier código anterior.

Solución de problemas

Un usuario no puede acceder a su cuenta

  • Síntoma: Un usuario no puede iniciar sesión y recibe un mensaje de bloqueo, incluso con la contraseña correcta.

  • Posible causa: Los intentos de inicio de sesión fallidos para esa dirección de correo electrónico o dirección IP han superado el umbral de bloqueo configurado en Parameter.

  • Solución: Espera a que transcurra el período de bloqueo configurado, o solicita a un administrador que ajuste los umbrales en la configuración de Política de bloqueo.

El error de inicio de sesión no especifica qué salió mal

  • Síntoma: Un inicio de sesión fallido devuelve un mensaje genérico en lugar de indicar si el correo electrónico o la contraseña eran incorrectos.

  • Posible causa: Esto es lo esperado. Para evitar la recopilación de cuentas, la aplicación devuelve un error genérico en lugar de confirmar cuál fue el valor incorrecto.

  • Solución: No se requiere ninguna acción. Aconseja a los usuarios que confirmen tanto su correo electrónico como su contraseña.

Un código de verificación se rechaza como expirado

  • Síntoma: Un usuario ingresa un código de registro o recuperación y se rechaza como expirado.

  • Posible causa: El código pasó su ventana de expiración, o se emitió un código más reciente, que invalida el anterior.

  • Solución: Solicita un código nuevo y usa el más reciente.

Para obtener más ayuda, revisa tus registros de App Builder y comunícate con el equipo de soporte de Jitterbit.