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:
-
Selecione IDE > Security Providers.
-
Clique em + Security Provider.
-
Configure o provedor com essas configurações:
-
Name:
User ProvisioningNota
Não confundir com o aplicativo de provisionamento em si, que é chamado de
User Provisioning App. -
Type: User Provisioning
-
Enabled: Marcado.
-
User Provisioning: Marcado.
-
-
Clique em Save.
-
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:
-
Execute seu aplicativo de provisionamento de usuários e vá para a guia Tables do App Workbench.
-
Em Tables, localize a tabela Parameter e clique em seu ícone Open record.
-
Adicione as duas colunas a seguir:
-
MyProviderID(Type: Unique ID) -
DefaultPassword(Type: String)
-
-
Vá para a guia Pages do App Workbench.
-
Em Pages, localize a página Parameter e clique em seu ícone .
-
Adicione novos controles (tipo de controle Text) à página para as colunas
MyProviderIDeDefaultPassword. -
Execute o aplicativo e selecione Configuration > Parameters. O popup Parameters é aberto.
-
Clique em Edit.
-
Cole o identificador do provedor de segurança (copiado anteriormente) no campo MyProviderID.
-
Digite uma senha padrão segura no campo DefaultPassword. Essa é a senha atribuída aos novos usuários.
-
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:
-
Selecione IDE > User Management.
-
Selecione a guia Groups.
-
Clique em + Group. O popup Group é aberto.
-
Defina os seguintes valores:
-
Name:
Demo General User- Description:
Permissões de usuário geral para o aplicativo de demonstração.
- Description:
-
Clique em Save, depois feche o popup Group.
-
Em Groups, clique em Manage Privileges para o novo grupo.
-
Em Privileges, clique em Create. O popup Privilege abre.
-
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.
-
-
Clique em Save, depois feche o painel Privileges/Roles.
-
Em Roles, conceda as funções apropriadas para usuários gerais.
-
Selecione a aba Realms.
-
Clique em + Realm.
-
Digite
Demo Realmcomo o nome, depois clique no ícone . -
Na aba Applications, clique em Select para o aplicativo que os usuários finais acessarão.
-
Selecione a aba Groups, depois clique em Select para o grupo
Demo General Userrecém-criado. -
Selecione a aba Providers, depois clique em Select para o provedor de segurança
User Provisioningcriado 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.
Vincular departamentos a grupos de segurança
Siga estas etapas:
-
Com seu aplicativo em execução, acesse a aba Data Sources do App Workbench.
-
Clique em + Source.
-
Selecione Link to existing source, depois clique em Next.
-
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.
-
Acesse a aba Tables do App Workbench.
-
Em Tables, encontre a tabela
Department, depois clique em seu ícone Open record. -
Adicione uma nova coluna chamada
MyGroupID(Type: Unique ID). -
Acesse a aba Pages do App Workbench, depois abra sua página
Departmentpara edição. -
Adicione o controle
MyGroupIDà sua página. Defina seu Control Type como List, depois clique em Next. -
Na próxima página, defina estes valores, depois clique em Next:
-
Source:
Realm_Group -
Key (Column):
GroupId (PK) -
Title (Column):
Name
-
-
Clique em Finish.
-
Acesse a aba Pages do App Workbench, depois abra sua página
Departmentpara edição. -
Selecione a aba Update Methods.
-
Certifique-se de que a configuração Edit Method é Standard.
-
Execute o aplicativo, navegue para a página Departments, e atribua o grupo
Demo General Usera um de seus departamentos.
Atualizar a tabela Employee
Siga estas etapas:
-
Acesse a aba Tables do App Workbench.
-
Em Tables, encontre a tabela
Employee, depois clique em seu ícone Open record. -
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:
-
Acesse a aba Tables do App Workbench.
-
Em Tables, encontre a tabela
Employee, depois clique em seu ícone Open record. -
Clique em Events. O popup Data Storage Events (Employee) abre.
-
Clique em + Table Event.
-
Em Event Information, defina o Name como
Provision Usere clique em Save. -
Em Actions, clique em + Rule & Register.
-
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
-
-
Clique em Create.
-
Com a aba Tables selecionada, clique em + Table.
-
Na aba Current Data Source, adicione a tabela
Employee. -
Selecione a aba Where.
-
Clique em + Where Clause.
-
Em Left Expression, insira
E.MyUserID. -
Abra o menu Operator e selecione IS NULL.
-
Clique em Save e feche o popup Where.
-
Selecione a aba Tables e escolha
EmployeeIDe quaisquer colunas adicionais que a regra necessite para sua ação (por exemplo, nome e endereço de e-mail do usuário provisionado). -
Selecione a aba Columns e defina os campos da seguinte forma:
Column or Expression Alias Target PK E.EmployeeIDUserId (PK)E.FullNameFullNameE.EmailEmailAddressE.FullNameDisplayNameDisplayNameE.EmployeeNoUserNameUserName -
(Opcional, mas recomendado) Selecione a aba Results e clique em Validate.
-
Acesse a aba Tables do App Workbench.
-
Em Tables, localize a tabela
Employeee clique no ícone Open record correspondente. -
Clique em Events. O popup Data Storage Events (Employee) é aberto.
-
Clique no ícone Open record do evento Provision User.
-
Em Actions, clique no ícone Open record da regra Realm_User_Create (Insert Employee).
-
Em Bindings, clique em + Binding.
-
Defina o seguinte binding:
Source Column Rule Column EmployeeIDEmployeeID -
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.
-
Na página Event/Validations/Actions, em Actions, clique em + Rule & Register.
-
Defina os seguintes valores:
-
Name:
Employee (Update MyUserID to EmployeeID) -
Purpose: CRUD
-
Action: Update
-
Target Layer: Data Layer
-
Target:
Employee
-
-
Clique em Create.
-
Selecione a aba Columns.
-
Clique em + Column.
-
Na caixa Column or Expression, insira
E.EmployeeIDe defina os seguintes valores restantes:-
Alias:
MyUserID -
Target:
MyUserID -
TargetType: Target
-
-
Clique em Save e feche o popup Add Column.
-
(Opcional, mas recomendado) Selecione a aba Results e clique em Validate.
-
Clique em < Event para retornar à página Provision User (Event/Validations/Actions).
-
Em Actions, clique em para deregistrar a regra adicionada e registrada (Employee (Update MyUserID to EmployeeID)) e clique em Proceed.
-
Em Actions, clique no ícone Open record da ação Realm_User_Create (Insert Employee) restante. O popup Action/Bindings/SQL é aberto.
-
Clique em Success. O popup Success Handlers abre.
-
Clique em Create. O popup Action abre.
-
Defina os seguintes valores:
-
Type: Rule
-
Rule: Selecione Employee (Update MyUserID to EmployeeID)
-
-
Clique em Save.
-
Em Bindings, clique em + Binding.
-
Defina o seguinte binding:
Source Column Rule Column EmployeeIDEmployeeID -
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.
-
Acesse a guia Rules do App Workbench.
-
Clique em + Rule.
-
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
-
-
Clique em Create.
-
Selecione a guia Tables.
-
Na guia Current Data Source, clique em + Table e adicione as tabelas
EmployeeeParameter. -
Na tabela Employee, selecione as colunas EmployeeID e MyUserID.
-
Na tabela Parameter, selecione a coluna DefaultPassword.
-
Selecione a guia Columns e defina os campos da seguinte forma:
Column or Expression Alias Target PK E.MyUserIDUserID (PK)P.DefaultPasswordPassword -
(Opcional) Clique no ícone Open record da coluna
E.MyUserID. No popup Column, confirme que o Target Type é Bind. -
(Opcional) Clique no ícone Open record da coluna
P.DefaultPassword. No popup Column, confirme que o Target Type é Target. -
Selecione a guia Where e clique em + Where Clause.
-
Em Left Expression, digite
E.MyUserID. -
Abra o menu Operator e selecione IS NOT NULL.
-
Clique em Save e feche o popup Where.
-
Acesse a guia Rules do App Workbench.
-
Em App Data Sources, selecione All Events.
-
Em All Events, clique em Provision User na coluna Event.
-
Para a entrada Provision User, clique em Rule Event Detail.
-
Em Actions, clique no ícone Success handlers da regra Realm_User_Create (Insert Employee). O popup Success Handlers abre.
-
Clique em Create. O popup Action abre.
-
Defina os seguintes valores:
-
Type: Rule
-
Rule: Selecione User_SetPassword (Update Default Password)
-
-
Clique em Save.
-
Em Bindings, clique em + Binding.
-
Defina o seguinte binding:
Source Column Rule Column EmployeeIDEmployeeID -
Feche os popups para retornar à página Event/Validations/Actions para Provision User.
-
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.
-
Acesse a guia Rules do App Workbench.
-
Clique em + Rule.
-
Defina os valores da seguinte forma:
-
Name:
Realm_UserGroup (Cram Department) -
Purpose: Selecione XPCRUD
-
Action: Cram
-
-
Fonte de Dados de Origem: Selecione o app de provisionamento de usuário que você criou. Neste tutorial, é
User Provisioning App. -
Fonte de Dados de Destino:
Vinyl (Sealed) -
Camada de Destino: Logic Layer
-
Destino:
Realm_UserGroup -
Clique em Create.
-
Selecione a aba Tables.
-
Na aba Current Data Source, clique em + Table e adicione as tabelas
EmployeeeDepartment.Dica
O App Builder cria automaticamente uma relação de chave estrangeira entre as colunas
DepartmentIDdas duas tabelas. -
Na tabela Employee, selecione as colunas EmployeeID e MyUserID.
-
Na tabela Department, selecione a coluna MyGroupID.
-
Selecione a aba Where e clique em + Where Clause.
-
Em Left Expression, insira
D.MyGroupID. -
Abra o menu Operator e selecione IS NOT NULL.
-
Clique em Save e feche o popup Where.
-
Clique em + Where Clause.
-
Em Left Expression, insira
E.MyUserID. -
Abra o menu Operator e selecione IS NOT NULL.
-
Clique em Save e feche o popup Where.
-
Selecione a aba Columns e configure os campos conforme a seguir (por exemplo):
Column or Expression Alias Target PK E.EmployeeIDE.MyUserIDUserID (PK)D.MyGroupIDGroupID (PK) -
Selecione More > Edge Case. O popup Edge Case Settings é aberto.
-
Ative a opção Select Distinct e feche o popup.
-
Acesse a aba Rules do App Workbench.
-
Em App Data Sources, selecione All Events.
-
Em All Events, clique em Provision User na coluna Event.
-
Para a entrada Provision User, clique em Rule Event Detail.
-
Em Actions, clique no ícone Open record para a regra Realm_User_Create (Insert Employee).
-
Clique em Success. O popup Success Handlers é aberto.
-
Clique em Create. O popup Action é aberto.
-
Configure os seguintes valores:
-
Type: Rule
-
Rule: Selecione Realm_UserGroup (Cram Department)
-
-
Clique em Save.
-
Em Bindings, clique em + Binding.
-
Configure a seguinte vinculação:
Source Column Rule Column EmployeeIDEmployeeID -
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.
-
Acesse a aba Rules do App Workbench.
-
Clique em + Rule.
-
Configure os seguintes valores:
-
Name:
Employee (Update ProvisionedOn/By) -
Purpose: CRUD
-
Action: Update
-
Target Layer: Data Layer
-
Target:
Employee
-
-
Clique em Create.
-
Selecione a aba Columns.
-
Clique em + Column.
-
Na caixa Column or Expression, insira
now()e configure os seguintes valores restantes:-
Target:
ProvisionedOn -
TargetType: Target
-
-
Clique em Save e feche o popup Add Column.
-
Clique em + Column.
-
Na caixa Column or Expression, insira
who()e configure os seguintes valores restantes:-
Target:
ProvisionedBy -
TargetType: Target
-
-
Clique em Save e feche o popup Add Column.
-
(Opcional, mas recomendado) Selecione a aba Results e clique em Validate.
-
Acesse a aba Rules do App Workbench.
-
Em App Data Sources, selecione All Events.
-
Em All Events, clique em Provision User na coluna Event.
-
Para a entrada Provision User, clique em Rule Event Detail.
-
Em Actions, clique no ícone Success handlers para a regra Realm_User_Create (Insert Employee). O popup Success Handlers é aberto.
-
Clique em Create. O popup Action é aberto.
-
Defina os seguintes valores:
-
Type: Rule
-
Rule: Selecione Employee (Update ProvisionedOn/By)
-
-
Clique em Save.
-
Em Bindings, clique em + Binding.
-
Defina o seguinte binding:
Source Column Rule Column EmployeeIDEmployeeID -
Feche os popups para retornar à página Event/Validations/Actions para Provision User.
Etapa 5: Criar a interface do usuário
-
Navegue até Pages e abra sua página
Employeepara edição. -
Adicione um novo controle Button com o rótulo
Provision User. -
Nas propriedades do botão, navegue até a aba Events e selecione o evento
Provision User. -
Para garantir que a interface seja atualizada corretamente, na aba Behavior, defina Refresh Scope como Row.
-
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:
-
Adicionar um evento de fluxo de trabalho para enviar aos novos usuários suas credenciais de login por email (consulte Email em Notifications).
-
Usar outros objetos de dados públicos para exigir uma alteração de senha no primeiro login (consulte User_LocalAuthentication public data object).
-
Expandir o conjunto de regras para lidar com o desprovisionamento de usuários (consulte Realm_UserGroup public data object).