Saltar al contenido

Aplicación de aprovisionamiento de usuarios en Jitterbit App Builder

Introducción

En esta página se muestra cómo crear una aplicación de aprovisionamiento de usuarios que los usuarios finales puedan usar para aprovisionar acceso de aplicaciones de manera semiautomatizada, sin necesidad de acceder al IDE. Este es un enfoque alternativo para gestionar el acceso de usuarios cuando no se dispone de un proveedor de identidad (como Okta o Azure).

El proceso implica crear proveedores de seguridad, configurar realms, preparar el modelo de datos, crear una secuencia de reglas de negocio para manejar la lógica y crear una interfaz de usuario simple para que los usuarios finales disparen el proceso.

Estas instrucciones utilizan el ejemplo de proporcionar acceso a los empleados de una empresa. Las instrucciones se dividen en cinco pasos:

Preparación

Para empezar, crea una aplicación dedicada para aprovisionar usuarios. La que se utiliza en este tutorial se llama simplemente User Provisioning App y comienza con las siguientes tablas:

Tabla Columnas
Employee EmployeeID (ID único, PK), FullName (Cadena), Email (Cadena), EmployeeNo (Cadena)
Department DepartmentID (ID único, PK), Name (Cadena)
Parameter ParameterID (ID único, PK)

Se añaden columnas adicionales a estas tablas durante los pasos siguientes.

Paso 1: Configuración inicial

Primero, necesitas un proveedor de seguridad para manejar el aprovisionamiento y un lugar para almacenar sus detalles de configuración.

Crear un proveedor de seguridad

Para crear un proveedor de seguridad, sigue estos pasos:

  1. Selecciona IDE > Security Providers.

  2. Haz clic en + Security Provider.

  3. Configura el proveedor con estos ajustes:

    • Name: User Provisioning

      Nota

      No confundir con la aplicación de aprovisionamiento en sí, que se llama User Provisioning App.

    • Type: User Provisioning

    • Enabled: Marcado.

    • User Provisioning: Marcado.

  4. Haz clic en Save.

  5. Copia y guarda la clave Identifier del nuevo proveedor para el siguiente paso.

Parametrizar la configuración

Para almacenar el ID del proveedor y una contraseña predeterminada en la tabla Parameter de tu aplicación, sigue estos pasos:

  1. Ejecuta tu aplicación de aprovisionamiento de usuarios y luego ve a la pestaña Tables del App Workbench.

  2. En Tables, encuentra la tabla Parameter y haz clic en su icono Open record.

  3. Añade las siguientes dos columnas:

    • MyProviderID (Tipo: ID único)

    • DefaultPassword (Tipo: Cadena)

  4. Ve a la pestaña Pages del App Workbench.

  5. En Pages, encuentra la página Parameter y haz clic en su icono .

  6. Añade nuevos controles (tipo de control Text) a la página para las columnas MyProviderID y DefaultPassword.

  7. Ejecuta la aplicación y selecciona Configuration > Parameters. Se abre la ventana emergente Parameters.

  8. Haz clic en Edit.

  9. Pega el identificador del proveedor de seguridad (copiado anteriormente) en el campo MyProviderID.

  10. Ingresa una contraseña predeterminada segura en el campo DefaultPassword. Esta es la contraseña que se asigna a los nuevos usuarios.

  11. Haz clic en Save y cierra la ventana emergente Parameter.

Paso 2: Configurar el control de acceso

Con el proveedor creado, ahora puedes configurar los grupos de usuarios y realms que rigen el acceso. Para hacerlo, sigue estos pasos:

  1. Selecciona IDE > User Management.

  2. Selecciona la pestaña Groups.

  3. Haz clic en + Group. Se abre la ventana emergente Group.

  4. Establece los siguientes valores:

  5. Nombre: Demo General User

    • Descripción: Permisos de usuario general para la aplicación de demostración.

  6. Haz clic en Guardar, luego cierra la ventana emergente Group.

  7. En Groups, haz clic en Manage Privileges para el grupo nuevo.

  8. En Privileges, haz clic en Create. Se abre la ventana emergente Privilege.

  9. Establece los siguientes valores:

    • Type: Selecciona Application.

    • Application: Abre el menú y selecciona la aplicación a la que accederán los usuarios finales.

    Nota

    La aplicación que debes seleccionar aquí es aquella en la que inician sesión los usuarios finales. Puede o no ser la aplicación de aprovisionamiento en sí. En este tutorial, se creó una aplicación de aprovisionamiento dedicada para administrar el acceso a una o más aplicaciones, por lo que debes seleccionar la aplicación de destino aquí, no la aplicación de aprovisionamiento.

  10. Haz clic en Guardar, luego cierra el panel Privileges/Roles.

  11. En Roles, asigna los roles apropiados para los usuarios generales.

  12. Selecciona la pestaña Realms.

  13. Haz clic en + Realm.

  14. Ingresa Demo Realm como nombre, luego haz clic en el icono .

  15. En la pestaña Applications, haz clic en Select para la aplicación a la que accederán los usuarios finales.

  16. Selecciona la pestaña Groups, luego haz clic en Select para el grupo Demo General User que acabas de crear.

  17. Selecciona la pestaña Providers, luego haz clic en Select para el proveedor de seguridad User Provisioning creado anteriormente.

Paso 3: Prepara el modelo de datos

Ahora debes actualizar tus tablas Department y Employee para almacenar información de seguridad y estado de aprovisionamiento.

Sigue estos pasos:

  1. Con tu aplicación ejecutándose, ve a la pestaña Data Sources del App Workbench.

  2. Haz clic en + Source.

  3. Selecciona Link to existing source, luego haz clic en Next.

  4. Busca y selecciona App Builder (Sealed) (Default), luego haz clic en Link 1 Source y Done. Esto te da acceso a los objetos de datos públicos necesarios para el aprovisionamiento.

  5. Ve a la pestaña Tables del App Workbench.

  6. En Tables, busca la tabla Department, luego haz clic en su icono Open record.

  7. Agrega una columna nueva llamada MyGroupID (Type: Unique ID).

  8. Ve a la pestaña Pages del App Workbench, luego abre tu página Department para editarla.

  9. Agrega el control MyGroupID a tu página. Establece su Control Type en List, luego haz clic en Next.

  10. En la página siguiente, establece estos valores, luego haz clic en Next:

    • Source: Realm_Group

    • Key (Column): GroupId (PK)

    • Title (Column): Name

  11. Haz clic en Finish.

  12. Ve a la pestaña Pages del App Workbench, luego abre tu página Department para editarla.

  13. Selecciona la pestaña Update Methods.

  14. Asegúrate de que la opción Edit Method sea Standard.

  15. Ejecuta la aplicación, navega a la página Departments y asigna el grupo Demo General User a uno de tus departamentos.

Actualiza la tabla Employee

Sigue estos pasos:

  1. Ve a la pestaña Tables del App Workbench.

  2. En Tables, busca la tabla Employee, luego haz clic en su icono Open record.

  3. Agrega las siguientes columnas:

    • MyUserID (Type: Unique ID): Almacena el ID de App Builder del usuario después de su creación.

    • ProvisionedOn (Type: DateTime): Una marca de tiempo de cuándo ocurrió el aprovisionamiento.

    • ProvisionedBy (Type: String, length: 150): El nombre del usuario que realizó el aprovisionamiento.

Paso 4: Construye la lógica de aprovisionamiento

El núcleo de la aplicación es un evento de nivel de tabla en la tabla Employee que orquesta una secuencia de reglas. Estas reglas se ejecutan una tras otra usando controladores de éxito.

Regla 1: Crear el usuario

Esta regla crea el registro de usuario, pero solo si uno no existe ya. Sigue estos pasos:

  1. Ve a la pestaña Tables del App Workbench.

  2. En Tables, busca la tabla Employee, luego haz clic en su icono Open record.

  3. Haz clic en Events. Se abre la ventana emergente Data Storage Events (Employee).

  4. Haz clic en + Table Event.

  5. En Event Information, establece el Name como Provision User, luego haz clic en Save.

  6. En Actions, haz clic en + Rule & Register.

  7. En la página Rule Builder, establece los siguientes valores:

    • Name: Realm_User_Create (Insert Employee)

    • Purpose: XP CRUD

    • Action: Insert

    • Source Data Source: Selecciona la aplicación de aprovisionamiento de usuarios que has creado. En este tutorial, es User Provisioning App.

    • Target Data Source: Vinyl (Sealed)

    • Options: Selecciona Logic Layer.

    • Target: Realm_User_Create

  8. Haz clic en Create.

  9. Con la pestaña Tables seleccionada, haz clic en + Table.

  10. En la pestaña Current Data Source, agrega la tabla Employee.

  11. Selecciona la pestaña Where.

  12. Haz clic en + Where Clause.

  13. En Left Expression, ingresa E.MyUserID.

  14. Abre el menú Operator, luego selecciona IS NULL.

  15. Haz clic en Save, luego cierra la ventana emergente Where.

  16. Selecciona la pestaña Tables, luego selecciona EmployeeID y las columnas adicionales que necesita la regla para su acción (por ejemplo, el nombre y la dirección de correo electrónico del usuario aprovisionado).

  17. Selecciona la pestaña Columns y establece los campos como se indica a continuación:

    Column or Expression Alias Target PK
    E.EmployeeID UserId (PK)
    E.FullName FullName
    E.Email EmailAddress
    E.FullName DisplayName DisplayName
    E.EmployeeNo UserName UserName

  18. (Opcional, pero recomendado) Selecciona la pestaña Results y haz clic en Validate.

  19. Ve a la pestaña Tables del App Workbench.

  20. En Tables, busca la tabla Employee, luego haz clic en su icono Open record.

  21. Haz clic en Events. Se abre la ventana emergente Data Storage Events (Employee).

  22. Haz clic en el icono Open record del evento Provision User.

  23. En Actions, haz clic en el icono Open record de la regla Realm_User_Create (Insert Employee).

  24. En Bindings, haz clic en + Binding.

  25. Establece el siguiente vinculación:

    Source Column Rule Column
    EmployeeID EmployeeID

  26. Haz clic en el icono , luego cierra la ventana emergente Action/Bindings/SQL.

Rule 2: Actualiza el registro del empleado

Después de que el usuario de App Builder se crea mediante la Regla 1, esta regla escribe el ID del nuevo usuario nuevamente en el campo MyUserID de la tabla Employee. Esto vincula el registro del empleado a su cuenta de App Builder para que las reglas posteriores puedan hacer referencia a su ID.

  1. En la página Event/Validations/Actions, en Actions, haz clic en + Rule & Register.

  2. Establece los siguientes valores:

    • Name: Employee (Update MyUserID to EmployeeID)

    • Purpose: CRUD

    • Action: Update

    • Target Layer: Data Layer

    • Target: Employee

  3. Haz clic en Create.

  4. Selecciona la pestaña Columns.

  5. Haz clic en + Column.

  6. En el cuadro Column or Expression, ingresa E.EmployeeID, luego establece estos valores restantes:

    • Alias: MyUserID

    • Target: MyUserID

    • TargetType: Target

  7. Haz clic en Save, luego cierra la ventana emergente Add Column.

  8. (Opcional, pero recomendado) Selecciona la pestaña Results y haz clic en Validate.

  9. Haz clic en < Event para regresar a la página Provision User (Event/Validations/Actions).

  10. En Actions, haz clic en para desregistrar la regla que acabas de agregar y registrar (Employee (Update MyUserID to EmployeeID)), luego haz clic en Proceed.

  11. En Actions, haz clic en el icono Open record de la acción Realm_User_Create (Insert Employee) restante. Se abre la ventana emergente Action/Bindings/SQL.

  12. Haz clic en Success. Se abre la ventana emergente de Success Handlers.

  13. Haz clic en Create. Se abre la ventana emergente de Action.

  14. Establece los siguientes valores:

    • Type: Rule

    • Rule: Selecciona Employee (Update MyUserID to EmployeeID)

  15. Haz clic en Save.

  16. En Bindings, haz clic en + Binding.

  17. Establece el siguiente binding:

    Source Column Rule Column
    EmployeeID EmployeeID

  18. Cierra las ventanas emergentes para volver a la página Event/Validations/Actions de Provision User.

    Consejo

    El número 1 junto al icono indica la presencia de un success handler para esta acción.

Rule 3: Establecer la contraseña del usuario

Esta regla establece la contraseña inicial del nuevo usuario utilizando el valor predeterminado almacenado en la tabla Parameter.

  1. Ve a la pestaña Rules de App Workbench.

  2. Haz clic en + Rule.

  3. Establece los valores de la siguiente manera:

    • Name: User_SetPassword (Update Default Password)

    • Purpose: Selecciona XPCRUD

    • Action: Update

    • Source Data Source: Selecciona la aplicación de aprovisionamiento de usuarios que has creado. En este tutorial, es User Provisioning App.

    • Target Data Source: Vinyl (Sealed)

    • Target Layer: Logic Layer

    • Target: User_SetPassword

  4. Haz clic en Create.

  5. Selecciona la pestaña Tables.

  6. En la pestaña Current Data Source, haz clic en + Table y añade las tablas Employee y Parameter.

  7. En la tabla Employee, selecciona las columnas EmployeeID y MyUserID.

  8. En la tabla Parameter, selecciona la columna DefaultPassword.

  9. Selecciona la pestaña Columns y establece los campos de la siguiente manera:

    Column or Expression Alias Target PK
    E.MyUserID UserID (PK)
    P.DefaultPassword Password

  10. (Opcional) Haz clic en el icono Open record de la columna E.MyUserID. En la ventana emergente Column, confirma que Target Type es Bind.

  11. (Opcional) Haz clic en el icono Open record de la columna P.DefaultPassword. En la ventana emergente Column, confirma que Target Type es Target.

  12. Selecciona la pestaña Where y haz clic en + Where Clause.

  13. En Left Expression, ingresa E.MyUserID.

  14. Abre el menú Operator y selecciona IS NOT NULL.

  15. Haz clic en Save y cierra la ventana emergente Where.

  16. Ve a la pestaña Rules de App Workbench.

  17. En App Data Sources, selecciona All Events.

  18. En All Events, haz clic en Provision User en la columna Event.

  19. Para la entrada Provision User, haz clic en Rule Event Detail.

  20. En Actions, haz clic en el icono Success handlers de la regla Realm_User_Create (Insert Employee). Se abre la ventana emergente de Success Handlers.

  21. Haz clic en Create. Se abre la ventana emergente de Action.

  22. Establece los siguientes valores:

    • Type: Rule

    • Rule: Selecciona User_SetPassword (Update Default Password)

  23. Haz clic en Save.

  24. En Bindings, haz clic en + Binding.

  25. Establece el siguiente binding:

    Source Column Rule Column
    EmployeeID EmployeeID

  26. Cierra las ventanas emergentes para volver a la página Event/Validations/Actions de Provision User.

  27. Actualiza la página y observa que el número de success handlers de la regla Realm_User_Create (Insert Employee) es ahora 2.

Rule 4: Otorgar acceso a grupos

Esta regla otorga al nuevo usuario acceso al grupo de App Builder asociado con su departamento, utilizando el valor MyGroupID establecido en la tabla Department.

  1. Ve a la pestaña Rules de App Workbench.

  2. Haz clic en + Rule.

  3. Establece los valores de la siguiente manera:

    • Name: Realm_UserGroup (Cram Department)

    • Purpose: Selecciona XPCRUD

    • Action: Cram

  4. Fuente de Datos de Origen: Selecciona la aplicación de aprovisionamiento de usuarios que creaste. En este tutorial, es User Provisioning App.

  5. Fuente de Datos de Destino: Vinyl (Sealed)

  6. Capa de Destino: Logic Layer

  7. Destino: Realm_UserGroup

  8. Haz clic en Create.

  9. Selecciona la pestaña Tables.

  10. En la pestaña Current Data Source, haz clic en + Table y luego agrega las tablas Employee y Department.

    Consejo

    App Builder crea automáticamente una relación de clave externa entre las columnas DepartmentID de las dos tablas.

  11. En la tabla Employee, selecciona las columnas EmployeeID y MyUserID.

  12. En la tabla Department, selecciona la columna MyGroupID.

  13. Selecciona la pestaña Where y luego haz clic en + Where Clause.

  14. En Left Expression, ingresa D.MyGroupID.

  15. Abre el menú Operator y luego selecciona IS NOT NULL.

  16. Haz clic en Save y luego cierra la ventana emergente Where.

  17. Haz clic en + Where Clause.

  18. En Left Expression, ingresa E.MyUserID.

  19. Abre el menú Operator y luego selecciona IS NOT NULL.

  20. Haz clic en Save y luego cierra la ventana emergente Where.

  21. Selecciona la pestaña Columns y configura los campos de la siguiente manera (por ejemplo):

    Column or Expression Alias Target PK
    E.EmployeeID
    E.MyUserID UserID (PK)
    D.MyGroupID GroupID (PK)

  22. Selecciona More > Edge Case. Se abre la ventana emergente Edge Case Settings.

  23. Habilita la opción Select Distinct y luego cierra la ventana emergente.

  24. Ve a la pestaña Rules del App Workbench.

  25. En App Data Sources, selecciona All Events.

  26. En All Events, haz clic en Provision User en la columna Event.

  27. Para la entrada Provision User, haz clic en Rule Event Detail.

  28. En Actions, haz clic en el icono Open record para la regla Realm_User_Create (Insert Employee).

  29. Haz clic en Success. Se abre la ventana emergente Success Handlers.

  30. Haz clic en Create. Se abre la ventana emergente Action.

  31. Establece los siguientes valores:

    • Type: Rule

    • Rule: Selecciona Realm_UserGroup (Cram Department)

  32. Haz clic en Save.

  33. En Bindings, haz clic en + Binding.

  34. Establece el siguiente enlace:

    Source Column Rule Column
    EmployeeID EmployeeID

  35. Cierra las ventanas emergentes para volver a la página Event/Validations/Actions para Provision User.

Rule 5: Registra la acción de aprovisionamiento

Esta regla registra quién activó el aprovisionamiento y cuándo, al escribir la marca de tiempo actual y el nombre del usuario conectado en los campos ProvisionedOn y ProvisionedBy de la tabla Employee.

  1. Ve a la pestaña Rules del App Workbench.

  2. Haz clic en + Rule.

  3. Establece los siguientes valores:

    • Name: Employee (Update ProvisionedOn/By)

    • Purpose: CRUD

    • Action: Update

    • Target Layer: Data Layer

    • Target: Employee

  4. Haz clic en Create.

  5. Selecciona la pestaña Columns.

  6. Haz clic en + Column.

  7. En el cuadro Column or Expression, ingresa now() y luego establece estos valores restantes:

    • Target: ProvisionedOn

    • TargetType: Target

  8. Haz clic en Save y luego cierra la ventana emergente Add Column.

  9. Haz clic en + Column.

  10. En el cuadro Column or Expression, ingresa who() y luego establece estos valores restantes:

    • Target: ProvisionedBy

    • TargetType: Target

  11. Haz clic en Save y luego cierra la ventana emergente Add Column.

  12. (Opcional, pero recomendado) Selecciona la pestaña Results y luego haz clic en Validate.

  13. Ve a la pestaña Rules del App Workbench.

  14. En App Data Sources, selecciona All Events.

  15. En All Events, haz clic en Provision User en la columna Event.

  16. Para la entrada Provision User, haz clic en Rule Event Detail.

  17. En Actions, haz clic en el icono Success handlers de la regla Realm_User_Create (Insert Employee). Se abre la ventana emergente Success Handlers.

  18. Haz clic en Create. Se abre la ventana emergente Action.

  19. Establece los siguientes valores:

    • Type: Rule

    • Rule: Selecciona Employee (Update ProvisionedOn/By)

  20. Haz clic en Save.

  21. En Bindings, haz clic en + Binding.

  22. Establece el siguiente binding:

    Source Column Rule Column
    EmployeeID EmployeeID

  23. Cierra las ventanas emergentes para regresar a la página Event/Validations/Actions de Provision User.

Paso 5: Crear la interfaz de usuario

  1. Navega a Pages y abre tu página Employee para editarla.

  2. Agrega un nuevo control Button con la etiqueta Provision User.

  3. En las propiedades del botón, navega a la pestaña Events y selecciona el evento Provision User.

  4. Para asegurar que la interfaz se actualice correctamente, en la pestaña Behavior, establece Refresh Scope en Row.

  5. Para ocultar el botón para usuarios ya aprovisionados, ve a la pestaña Visibility y agrega una condición: ProvisionedOn IS NOT NULL.

Próximos pasos

La lógica de aprovisionamiento principal ya está completa. Puedes mejorar este proceso aún más mediante: