Ir para o conteúdo

Aplicativo de provisionamento de usuários no Jitterbit App Builder

Introdução

Esta página mostra como criar um aplicativo de provisionamento de usuários que os usuários finais podem usar para provisionar o acesso ao aplicativo de forma semiautomática, sem precisar de acesso ao IDE. Essa é uma abordagem alternativa para gerenciar o acesso do usuário quando um provedor de identidade (como Okta ou Azure) não está disponível.

O processo envolve criar provedores de segurança, configurar realms, preparar o modelo de dados, criar uma sequência de regras de negócio para lidar com a lógica e criar uma interface de usuário simples para os usuários finais acionarem o processo.

Essas instruções usam o exemplo de fornecer aos funcionários de uma empresa acesso. As instruções estão divididas em cinco etapas:

Preparação

Para começar, crie um aplicativo dedicado para provisionar usuários. O usado neste tutorial é chamado simplesmente de User Provisioning App e começa com as seguintes tabelas:

Tabela Colunas
Employee EmployeeID (ID exclusivo, PK), FullName (String), Email (String), EmployeeNo (String)
Department DepartmentID (ID exclusivo, PK), Name (String)
Parameter ParameterID (ID exclusivo, PK)

Colunas adicionais são adicionadas a essas tabelas durante as etapas abaixo.

Etapa 1: Configuração inicial

Primeiro, é necessário um provedor de segurança para lidar com o provisionamento e um local para armazenar seus detalhes de configuração.

Criar um provedor de segurança

Para criar um provedor de segurança, siga estas etapas:

  1. Selecione IDE > Security Providers.

  2. Clique em + Security Provider.

  3. Configure o provedor com essas configurações:

    • Name: User Provisioning

      Nota

      Não confundir com o aplicativo de provisionamento em si, que é chamado de User Provisioning App.

    • Type: User Provisioning

    • Enabled: Marcado.

    • User Provisioning: Marcado.

  4. Clique em Save.

  5. Copie e salve a chave Identifier do novo provedor para a próxima etapa.

Parametrizar a configuração

Para armazenar a ID do provedor e uma senha padrão na tabela Parameter do seu aplicativo, siga estas etapas:

  1. Execute seu aplicativo de provisionamento de usuários e vá para a guia Tables do App Workbench.

  2. Em Tables, localize a tabela Parameter e clique em seu ícone Open record.

  3. Adicione as duas colunas a seguir:

    • MyProviderID (Type: Unique ID)

    • DefaultPassword (Type: String)

  4. Vá para a guia Pages do App Workbench.

  5. Em Pages, localize a página Parameter e clique em seu ícone .

  6. Adicione novos controles (tipo de controle Text) à página para as colunas MyProviderID e DefaultPassword.

  7. Execute o aplicativo e selecione Configuration > Parameters. O popup Parameters é aberto.

  8. Clique em Edit.

  9. Cole o identificador do provedor de segurança (copiado anteriormente) no campo MyProviderID.

  10. Digite uma senha padrão segura no campo DefaultPassword. Essa é a senha atribuída aos novos usuários.

  11. Clique em Save e feche o popup Parameter.

Etapa 2: Configurar controle de acesso

Com o provedor criado, configure agora os grupos de usuários e realms que controlam o acesso. Para fazer isso, siga estas etapas:

  1. Selecione IDE > User Management.

  2. Selecione a guia Groups.

  3. Clique em + Group. O popup Group é aberto.

  4. Defina os seguintes valores:

  5. Name: Demo General User

    • Description: Permissões de usuário geral para o aplicativo de demonstração.
  6. Clique em Save, depois feche o popup Group.

  7. Em Groups, clique em Manage Privileges para o novo grupo.

  8. Em Privileges, clique em Create. O popup Privilege abre.

  9. Defina os seguintes valores:

    • Type: Selecione Application.

    • Application: Abra o menu e selecione o aplicativo que os usuários finais acessarão.

    Nota

    O aplicativo que você deve selecionar aqui é aquele no qual os usuários finais farão login. Pode ou não ser o próprio aplicativo de provisionamento. Neste tutorial, um aplicativo de provisionamento dedicado foi criado para gerenciar o acesso a um ou mais aplicativos, portanto você deve selecionar o aplicativo de destino aqui, não o aplicativo de provisionamento.

  10. Clique em Save, depois feche o painel Privileges/Roles.

  11. Em Roles, conceda as funções apropriadas para usuários gerais.

  12. Selecione a aba Realms.

  13. Clique em + Realm.

  14. Digite Demo Realm como o nome, depois clique no ícone .

  15. Na aba Applications, clique em Select para o aplicativo que os usuários finais acessarão.

  16. Selecione a aba Groups, depois clique em Select para o grupo Demo General User recém-criado.

  17. Selecione a aba Providers, depois clique em Select para o provedor de segurança User Provisioning criado anteriormente.

Etapa 3: Prepare o modelo de dados

Agora você deve atualizar suas tabelas Department e Employee para armazenar informações de segurança e status de provisionamento.

Siga estas etapas:

  1. Com seu aplicativo em execução, acesse a aba Data Sources do App Workbench.

  2. Clique em + Source.

  3. Selecione Link to existing source, depois clique em Next.

  4. Encontre e selecione App Builder (Sealed) (Default), depois clique em Link 1 Source e Done. Isso dá acesso aos objetos de dados públicos necessários para o provisionamento.

  5. Acesse a aba Tables do App Workbench.

  6. Em Tables, encontre a tabela Department, depois clique em seu ícone Open record.

  7. Adicione uma nova coluna chamada MyGroupID (Type: Unique ID).

  8. Acesse a aba Pages do App Workbench, depois abra sua página Department para edição.

  9. Adicione o controle MyGroupID à sua página. Defina seu Control Type como List, depois clique em Next.

  10. Na próxima página, defina estes valores, depois clique em Next:

    • Source: Realm_Group

    • Key (Column): GroupId (PK)

    • Title (Column): Name

  11. Clique em Finish.

  12. Acesse a aba Pages do App Workbench, depois abra sua página Department para edição.

  13. Selecione a aba Update Methods.

  14. Certifique-se de que a configuração Edit Method é Standard.

  15. Execute o aplicativo, navegue para a página Departments, e atribua o grupo Demo General User a um de seus departamentos.

Atualizar a tabela Employee

Siga estas etapas:

  1. Acesse a aba Tables do App Workbench.

  2. Em Tables, encontre a tabela Employee, depois clique em seu ícone Open record.

  3. Adicione as seguintes colunas:

    • MyUserID (Type: Unique ID): Armazena a ID do App Builder do usuário após a criação.

    • ProvisionedOn (Type: DateTime): Um timestamp de quando o provisionamento ocorreu.

    • ProvisionedBy (Type: String, length: 150): O nome do usuário que realizou o provisionamento.

Etapa 4: Construa a lógica de provisionamento

O núcleo do aplicativo é um evento em nível de tabela na tabela Employee que orquestra uma sequência de regras. Essas regras são executadas uma após a outra usando success handlers.

Regra 1: Criar o usuário

Esta regra cria o registro do usuário, mas apenas se um ainda não existir. Siga estas etapas:

  1. Acesse a aba Tables do App Workbench.

  2. Em Tables, encontre a tabela Employee, depois clique em seu ícone Open record.

  3. Clique em Events. O popup Data Storage Events (Employee) abre.

  4. Clique em + Table Event.

  5. Em Event Information, defina o Name como Provision User e clique em Save.

  6. Em Actions, clique em + Rule & Register.

  7. Na página Rule Builder, defina os seguintes valores:

    • Name: Realm_User_Create (Insert Employee)

    • Purpose: XP CRUD

    • Action: Insert

    • Source Data Source: Selecione o app de provisionamento de usuário que você criou. Neste tutorial, é User Provisioning App.

    • Target Data Source: Vinyl (Sealed)

    • Options: Selecione Logic Layer.

    • Target: Realm_User_Create

  8. Clique em Create.

  9. Com a aba Tables selecionada, clique em + Table.

  10. Na aba Current Data Source, adicione a tabela Employee.

  11. Selecione a aba Where.

  12. Clique em + Where Clause.

  13. Em Left Expression, insira E.MyUserID.

  14. Abra o menu Operator e selecione IS NULL.

  15. Clique em Save e feche o popup Where.

  16. Selecione a aba Tables e escolha EmployeeID e quaisquer colunas adicionais que a regra necessite para sua ação (por exemplo, nome e endereço de e-mail do usuário provisionado).

  17. Selecione a aba Columns e defina os campos da seguinte forma:

    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, mas recomendado) Selecione a aba Results e clique em Validate.

  19. Acesse a aba Tables do App Workbench.

  20. Em Tables, localize a tabela Employee e clique no ícone Open record correspondente.

  21. Clique em Events. O popup Data Storage Events (Employee) é aberto.

  22. Clique no ícone Open record do evento Provision User.

  23. Em Actions, clique no ícone Open record da regra Realm_User_Create (Insert Employee).

  24. Em Bindings, clique em + Binding.

  25. Defina o seguinte binding:

    Source Column Rule Column
    EmployeeID EmployeeID
  26. Clique no ícone e feche o popup Action/Bindings/SQL.

Rule 2: Atualizar o registro de funcionário

Depois que o usuário do App Builder é criado pela Regra 1, esta regra escreve o ID do novo usuário no campo MyUserID da tabela Employee. Isso vincula o registro do funcionário à sua conta do App Builder para que regras subsequentes possam referenciar seu ID.

  1. Na página Event/Validations/Actions, em Actions, clique em + Rule & Register.

  2. Defina os seguintes valores:

    • Name: Employee (Update MyUserID to EmployeeID)

    • Purpose: CRUD

    • Action: Update

    • Target Layer: Data Layer

    • Target: Employee

  3. Clique em Create.

  4. Selecione a aba Columns.

  5. Clique em + Column.

  6. Na caixa Column or Expression, insira E.EmployeeID e defina os seguintes valores restantes:

    • Alias: MyUserID

    • Target: MyUserID

    • TargetType: Target

  7. Clique em Save e feche o popup Add Column.

  8. (Opcional, mas recomendado) Selecione a aba Results e clique em Validate.

  9. Clique em < Event para retornar à página Provision User (Event/Validations/Actions).

  10. Em Actions, clique em para deregistrar a regra adicionada e registrada (Employee (Update MyUserID to EmployeeID)) e clique em Proceed.

  11. Em Actions, clique no ícone Open record da ação Realm_User_Create (Insert Employee) restante. O popup Action/Bindings/SQL é aberto.

  12. Clique em Success. O popup Success Handlers abre.

  13. Clique em Create. O popup Action abre.

  14. Defina os seguintes valores:

    • Type: Rule

    • Rule: Selecione Employee (Update MyUserID to EmployeeID)

  15. Clique em Save.

  16. Em Bindings, clique em + Binding.

  17. Defina o seguinte binding:

    Source Column Rule Column
    EmployeeID EmployeeID
  18. Feche os popups para retornar à página Event/Validations/Actions para Provision User.

    Dica

    O número 1 ao lado do ícone indica a presença de um success handler para esta ação.

Rule 3: Definir a senha do usuário

Esta regra define a senha inicial do novo usuário usando o valor padrão armazenado na tabela Parameter.

  1. Acesse a guia Rules do App Workbench.

  2. Clique em + Rule.

  3. Defina os valores da seguinte forma:

    • Name: User_SetPassword (Update Default Password)

    • Purpose: Selecione XPCRUD

    • Action: Update

    • Source Data Source: Selecione o app de provisionamento de usuários que você criou. Neste tutorial, é User Provisioning App.

    • Target Data Source: Vinyl (Sealed)

    • Target Layer: Logic Layer

    • Target: User_SetPassword

  4. Clique em Create.

  5. Selecione a guia Tables.

  6. Na guia Current Data Source, clique em + Table e adicione as tabelas Employee e Parameter.

  7. Na tabela Employee, selecione as colunas EmployeeID e MyUserID.

  8. Na tabela Parameter, selecione a coluna DefaultPassword.

  9. Selecione a guia Columns e defina os campos da seguinte forma:

    Column or Expression Alias Target PK
    E.MyUserID UserID (PK)
    P.DefaultPassword Password
  10. (Opcional) Clique no ícone Open record da coluna E.MyUserID. No popup Column, confirme que o Target Type é Bind.

  11. (Opcional) Clique no ícone Open record da coluna P.DefaultPassword. No popup Column, confirme que o Target Type é Target.

  12. Selecione a guia Where e clique em + Where Clause.

  13. Em Left Expression, digite E.MyUserID.

  14. Abra o menu Operator e selecione IS NOT NULL.

  15. Clique em Save e feche o popup Where.

  16. Acesse a guia Rules do App Workbench.

  17. Em App Data Sources, selecione All Events.

  18. Em All Events, clique em Provision User na coluna Event.

  19. Para a entrada Provision User, clique em Rule Event Detail.

  20. Em Actions, clique no ícone Success handlers da regra Realm_User_Create (Insert Employee). O popup Success Handlers abre.

  21. Clique em Create. O popup Action abre.

  22. Defina os seguintes valores:

    • Type: Rule

    • Rule: Selecione User_SetPassword (Update Default Password)

  23. Clique em Save.

  24. Em Bindings, clique em + Binding.

  25. Defina o seguinte binding:

    Source Column Rule Column
    EmployeeID EmployeeID
  26. Feche os popups para retornar à página Event/Validations/Actions para Provision User.

  27. Atualize a página e observe que o número de success handlers da regra Realm_User_Create (Insert Employee) agora é 2.

Rule 4: Conceder acesso ao grupo

Esta regra concede ao novo usuário acesso ao grupo do App Builder associado ao seu departamento, usando o valor MyGroupID definido na tabela Department.

  1. Acesse a guia Rules do App Workbench.

  2. Clique em + Rule.

  3. Defina os valores da seguinte forma:

    • Name: Realm_UserGroup (Cram Department)

    • Purpose: Selecione XPCRUD

    • Action: Cram

  4. Fonte de Dados de Origem: Selecione o app de provisionamento de usuário que você criou. Neste tutorial, é User Provisioning App.

  5. Fonte de Dados de Destino: Vinyl (Sealed)

  6. Camada de Destino: Logic Layer

  7. Destino: Realm_UserGroup

  8. Clique em Create.

  9. Selecione a aba Tables.

  10. Na aba Current Data Source, clique em + Table e adicione as tabelas Employee e Department.

    Dica

    O App Builder cria automaticamente uma relação de chave estrangeira entre as colunas DepartmentID das duas tabelas.

  11. Na tabela Employee, selecione as colunas EmployeeID e MyUserID.

  12. Na tabela Department, selecione a coluna MyGroupID.

  13. Selecione a aba Where e clique em + Where Clause.

  14. Em Left Expression, insira D.MyGroupID.

  15. Abra o menu Operator e selecione IS NOT NULL.

  16. Clique em Save e feche o popup Where.

  17. Clique em + Where Clause.

  18. Em Left Expression, insira E.MyUserID.

  19. Abra o menu Operator e selecione IS NOT NULL.

  20. Clique em Save e feche o popup Where.

  21. Selecione a aba Columns e configure os campos conforme a seguir (por exemplo):

    Column or Expression Alias Target PK
    E.EmployeeID
    E.MyUserID UserID (PK)
    D.MyGroupID GroupID (PK)
  22. Selecione More > Edge Case. O popup Edge Case Settings é aberto.

  23. Ative a opção Select Distinct e feche o popup.

  24. Acesse a aba Rules do App Workbench.

  25. Em App Data Sources, selecione All Events.

  26. Em All Events, clique em Provision User na coluna Event.

  27. Para a entrada Provision User, clique em Rule Event Detail.

  28. Em Actions, clique no ícone Open record para a regra Realm_User_Create (Insert Employee).

  29. Clique em Success. O popup Success Handlers é aberto.

  30. Clique em Create. O popup Action é aberto.

  31. Configure os seguintes valores:

    • Type: Rule

    • Rule: Selecione Realm_UserGroup (Cram Department)

  32. Clique em Save.

  33. Em Bindings, clique em + Binding.

  34. Configure a seguinte vinculação:

    Source Column Rule Column
    EmployeeID EmployeeID
  35. Feche os popups para retornar à página Event/Validations/Actions para Provision User.

Rule 5: Registre a ação de provisionamento

Esta regra registra quem acionou o provisionamento e quando, escrevendo o timestamp atual e o nome do usuário conectado nos campos ProvisionedOn e ProvisionedBy da tabela Employee.

  1. Acesse a aba Rules do App Workbench.

  2. Clique em + Rule.

  3. Configure os seguintes valores:

    • Name: Employee (Update ProvisionedOn/By)

    • Purpose: CRUD

    • Action: Update

    • Target Layer: Data Layer

    • Target: Employee

  4. Clique em Create.

  5. Selecione a aba Columns.

  6. Clique em + Column.

  7. Na caixa Column or Expression, insira now() e configure os seguintes valores restantes:

    • Target: ProvisionedOn

    • TargetType: Target

  8. Clique em Save e feche o popup Add Column.

  9. Clique em + Column.

  10. Na caixa Column or Expression, insira who() e configure os seguintes valores restantes:

    • Target: ProvisionedBy

    • TargetType: Target

  11. Clique em Save e feche o popup Add Column.

  12. (Opcional, mas recomendado) Selecione a aba Results e clique em Validate.

  13. Acesse a aba Rules do App Workbench.

  14. Em App Data Sources, selecione All Events.

  15. Em All Events, clique em Provision User na coluna Event.

  16. Para a entrada Provision User, clique em Rule Event Detail.

  17. Em Actions, clique no ícone Success handlers para a regra Realm_User_Create (Insert Employee). O popup Success Handlers é aberto.

  18. Clique em Create. O popup Action é aberto.

  19. Defina os seguintes valores:

    • Type: Rule

    • Rule: Selecione Employee (Update ProvisionedOn/By)

  20. Clique em Save.

  21. Em Bindings, clique em + Binding.

  22. Defina o seguinte binding:

    Source Column Rule Column
    EmployeeID EmployeeID
  23. Feche os popups para retornar à página Event/Validations/Actions para Provision User.

Etapa 5: Criar a interface do usuário

  1. Navegue até Pages e abra sua página Employee para edição.

  2. Adicione um novo controle Button com o rótulo Provision User.

  3. Nas propriedades do botão, navegue até a aba Events e selecione o evento Provision User.

  4. Para garantir que a interface seja atualizada corretamente, na aba Behavior, defina Refresh Scope como Row.

  5. Para ocultar o botão para usuários já provisionados, acesse a aba Visibility e adicione uma condição: ProvisionedOn IS NOT NULL.

Próximas etapas

A lógica de provisionamento principal agora está completa. Você pode aprimorar ainda mais este processo por meio de: