Configurar autenticação de aplicativo no Jitterbit App Builder

O App Builder suporta Application Authentication como um tipo de provedor de segurança. O Application Authentication permite que os desenvolvedores criem seus próprios formulários de login. Os desenvolvedores podem autenticar clientes usando uma abordagem adequada ao aplicativo.

Talvez você queira configurar a Autenticação de Aplicativo se, por exemplo, quiser que seu aplicativo:

Manter suas próprias contas de usuário
Validar credenciais com externo
Verifique um número de telefone enviando uma senha de uso único (OTP) por mensagem de texto
Permitir que os clientes efetuem login de forma semi-anônima

Nota

Veja o Aplicativo anônimo artigo para obter informações sobre como configurar o acesso de Usuário Anônimo a aplicativos.

Requisitos de autenticação do aplicativo

As seguintes informações precisam ser configuradas em cada ambiente em que o aplicativo reside (por exemplo, desenvolvimento, controle de qualidade, produção) para que a autenticação do aplicativo funcione corretamente:

Página de login configurada como um aplicativo separado
Grupo de Provedores de Segurança de Autenticação de Aplicativos
Conta(s) de usuário genérica(s)
Grupos com funções atribuídas
App Builder Realm configurado para aplicativo

Além dos requisitos acima, dentro do próprio aplicativo você precisará configurar:

Regra de autenticação
Tabela de Sessão com Campos de Login
Opcional: Validação de senha
Tabela de usuários em nível de aplicativo
App Builder como uma fonte de dados adicionada ao aplicativo e vinculada à sua fonte de dados primária

Login personalizado

A página de Login deve ser configurada como um Aplicativo autônomo dentro do seu ambiente de aplicativo e construída a partir da mesma fonte de dados do seu Aplicativo principal. Ela será usada apenas para fins de autenticação e, portanto, precisa de acesso aos dados de credencial do Usuário.

Esta página de Login é totalmente personalizável. Há algumas informações necessárias nesta página (listadas abaixo) e você pode desejar adicionar informações adicionais conforme necessário para os requisitos específicos do seu aplicativo.

Nota

Se o usuário anônimo tiver acesso à página inicial padrão de um aplicativo (configurada nas configurações do aplicativo), ele carregará automaticamente essa página em vez da página de login padrão do App Builder (/auth/login).

Painel projetado para ser executado a partir da Sessão
A página inteira deve ser acessível pelo Usuário anônimo
No mínimo, a página requer um campo Nome de usuário (editável)
Opcionalmente, você pode incluir um campo Senha (pode ter a Validação de senha configurada)
Botão que permite ao usuário disparar a Regra de autenticação criada para Autenticação de aplicativo. Por exemplo: Login.

Nota

Este botão não deve vincular a nenhuma página. Ele deve executar apenas o evento Authenticate, que então carregará automaticamente a página do App Builder definida como 'Default Page' nas configurações do Security Provider.
Opcional: link Esqueceu a senha, link Inscreva-se

Provedor de segurança de autenticação de aplicativos

O Application Authentication Security Provider precisa ser configurado para o aplicativo.

Para configurar o provedor de segurança de autenticação do aplicativo

Navegue até o IDE
Selecione Provedores de segurança
Clique em + Autenticação do Usuário no painel Autenticação do Usuário e Nomeie o Provedor de Segurança. Geralmente, ele é nomeado após o aplicativo para o qual está sendo provisionado. Por exemplo: ApplicationManager.
- Tipo = Autenticação do aplicativo
- Prioridade = gerado automaticamente pelo App Builder
- Enabled = deve ser habilitado para ser usado. Deixe essa configuração desligada (desabilitada) até que todas as informações necessárias sejam configuradas e você esteja pronto para testar a Autenticação do Aplicativo.
- Identifier = gerado automaticamente pelo App Builder. Se você estiver parametrizando essas informações, é isso que deve estar na tabela Parameter como Provider ID.
- Na seção Autenticação, selecione Mostrar no formulário de login.
- Para Default Page, selecione a Page que você quer que um Usuário vá em seu Aplicativo após autenticar na Login Page. Se você não vir a Page que você quer na lista inicialmente, navegue de volta para seu Aplicativo e torne a Page Shared e volte para selecioná-la.
- Provisionamento não é recomendado para ser preenchido
Clique em + Propriedade em Propriedades. Selecione LoginPath como Parâmetro e, para o próprio Valor, navegue até a página de login de Autenticação do aplicativo e selecione a URL após o Nome de Domínio.
- Certifique-se de incluir a barra inicial com as informações que você copiou da URL. Por exemplo: /app/Application%20Manager%20LogIn/LogIn%3F%24activepanel%3DA?$activepanel
Salve o registro

Contas de usuário genéricas

Para usar a Autenticação de Aplicativo, você precisa de pelo menos uma Conta de Usuário criada para essa finalidade. Você pode querer ter mais de uma Conta de Usuário, dependendo dos requisitos do seu aplicativo. Crie um(s) Usuário(s) do App Builder e nomeie-os de acordo com o nível que você quer que eles vejam no aplicativo após a autenticação. Por exemplo: ApplicationManagerUser, ApplicationManagerDeveloper, ApplicationManagerAdministrator.

A Conta de Usuário é o que o App Builder usa para pegar o Usuário especificado e autenticá-lo. Se você precisar de Grupos atribuídos a Usuários que são autenticados por meio desta Conta de Usuário criada, você deve adicionar o(s) Grupo(s) neste estágio.

Em seguida, você criará uma Identidade para o(s) novo(s) Usuário(s). É aqui que você seleciona o grupo Provedor, que é o provedor de Autenticação de Aplicativo que você criou, o Usuário (o usuário real do App Builder e deve ser o padrão) e um Nome. O Nome é o Nome real da Identidade que você criou. Frequentemente, o Nome é o mesmo que o Usuário. O Identificador não precisa ser definido.

Identidade

O domínio do App Builder foi configurado para o aplicativo

Um Realm deve ser configurado contendo seu aplicativo e o aplicativo Login app
Este Realm deve conter quaisquer Grupos usados pelos Usuários de Autenticação de Aplicativo
O Provedor de Segurança de Autenticação de Aplicativo também fará parte do Realm

Para mais informações sobre Realms e configurá-los, consulte Realms artigo.

Regra de autenticação

Em seguida, você configurará uma Regra de Autenticação a ser usada pela Autenticação de Aplicativo. Crie uma Regra de Negócios CRUD XP que tenha como alvo a exibição Autenticar da Fonte de Dados do App Builder. A Fonte de Dados de Origem deve ser a Fonte de Dados primária do aplicativo, e a Fonte de Dados de Destino será a Fonte de Dados do App Builder, a Ação será Inserir. Nomeie essa Regra com algo como Autenticar (Autenticação do Usuário).

Ao criar a regra CRUD no Business SQL, você precisará trazer a tabela Usuário (a tabela que armazena suas credenciais de Usuário), a tabela Sessão e, dependendo de como você armazena o que o Usuário está acessando, você pode querer trazer uma ou mais tabelas adicionais, como Parâmetro.

O Inner Join neste cenário está no Nome de Usuário que você quer que eles usem, de modo que se o Nome de Usuário for igual a algo naquela tabela, o Usuário poderá fazer login no aplicativo. Se a Validação de Senha também estiver sendo configurada, ela estaria no mesmo Evento que esta Regra CRUD XP.

As 4 colunas a seguir precisam ser configuradas para a regra de autenticação:

A regra deve ter um GUID recém-gerado (newUUID()) configurado para Target AuthenticateID
O ID do provedor de segurança de autenticação do aplicativo, que deve ter como alvo ProviderId
A regra precisa do que você está passando como o nome de usuário do aplicativo. É isso que marca o usuário para que o App Builder saiba quem é a pessoa que fez login. É isso que está sendo usado pela auditoria no App Builder. É recomendável usar Email ou nome de usuário, e esta coluna deve ter como alvo AppUserId.
Um Nome de Usuário do Provedor, este é o Usuário ao qual eles têm acesso provisionado no aplicativo. Isso pode ser dinâmico ou codificado, mas é obrigatório e deve ter como Alvo o Nome.

Habilitar provedor de segurança

Por fim, com todas as informações descritas neste artigo configuradas, você deve conseguir Habilitar o Provedor de Segurança e testar para ver se a Autenticação do Aplicativo agora está funcionando para seu aplicativo.

Configuração opcional para lidar com usuários não autenticados

Quando um Usuário não autenticado navega para uma página onde a Autenticação de aplicativo está habilitada, você pode controlar para onde o App Builder o redireciona. Se você quiser que um Usuário seja redirecionado para a página de login padrão, onde ele pode selecionar um link para chegar à página de login do aplicativo, nenhuma configuração adicional será necessária. Se, no entanto, você quiser que um Usuário seja redirecionado para a página de login do aplicativo automaticamente, há 2 configurações adicionais necessárias:

Autenticação padrão - Isso informa ao App Builder qual provedor de segurança você deseja usar para autenticar usuários em um determinado aplicativo.
Redirecionar no desafio - Isso informa ao App Builder para pular o formulário de login ao redirecionar usuários para seu provedor de autenticação de aplicativo.

Para configurar o provedor de autenticação padrão

Entre no App Builder como um usuário administrador
Clique no botão IDE
Clique no botão Provedores de segurança
No painel Autenticação do usuário, clique em Mais > Gerenciar aplicativos
Clique no ícone Editar (Lápis) para o aplicativo
Defina Autenticação Padrão para o provedor de Autenticação de Aplicativo
Clique no botão Salvar

Para configurar o redirecionamento no desafio

Clique no botão Voltar para retornar à página Provedores de Segurança
No painel Autenticação do Usuário, clique no ícone Detalhes (Chevron) para seu provedor de Autenticação de Aplicativo
Clique no botão Editar
Marque a opção Redirecionar em Desafio
Clique no botão Salvar

Recursos

Provedor de segurança - autenticação de aplicativo