Ir para o conteúdo

Provedor de segurança de autenticação de aplicativos no Jitterbit App Builder

Visão geral

Esta página detalha como configurar o provedor de segurança Application Authentication, um dos métodos de autenticação de usuários suportados pelo App Builder (consulte Métodos de autenticação de usuários para uma visão geral de todos eles). Com a Application Authentication, você cria uma página de login personalizada usando as ferramentas do App Builder, e o App Builder gerencia o fluxo de redirecionamento: quando um usuário não autenticado tenta acessar uma página protegida, o App Builder o redireciona para sua página de login e, após uma autenticação bem-sucedida, o retorna para a página que ele originalmente solicitou.

Diferentemente da autenticação local e SSO, este método não fornece recursos de gerenciamento de usuários integrados e, portanto, requer uma configuração consideravelmente mais complexa. O desenvolvedor é responsável por construir todos os aspectos do fluxo de autenticação, desde a validação de credenciais até o provisionamento de usuários e atribuição de grupos. Para detalhes sobre o que isso envolve, consulte a seção Fluxo de autenticação. Um passo a passo detalhado de um cenário hipotético é fornecido na seção Guia de configuração passo a passo.

Casos de uso

Application Authentication é o melhor método de autenticação de usuários quando:

  • Você precisa validar credenciais em uma fonte de dados de sua escolha, em vez da tabela de usuários do App Builder.

  • Seu aplicativo requer integração com uma API de autenticação de terceiros.

  • Você precisa de um fluxo MFA personalizado, como verificar um número de telefone com uma senha única (OTP).

  • Você deseja permitir que os usuários façam login de forma semi-anônima.

Fluxo de autenticação

Application Authentication coloca o desenvolvedor em controle total do processo de login. O App Builder gerencia o redirecionamento de usuários para sua página de login personalizada e de volta após uma autenticação bem-sucedida, mas toda a lógica intermediária deve ser projetada e construída pelo desenvolvedor. Portanto, é essencial compreender este fluxo com precisão: isso determina quais componentes você precisa construir e como eles se encaixam.

O desenvolvedor é responsável pela implementação dos seguintes aspectos:

  • Validação de credenciais de usuário em uma fonte de dados.

  • Implementação de MFA ou fatores de autenticação secundários, se necessário.

  • Criação e provisionamento de contas de usuário.

  • Atribuição de usuários a grupos e configuração de permissões.

  • Construção de fluxos de redefinição de senha e recuperação de conta.

  • Aplicação de políticas de senha.

Quando um usuário tenta fazer login, ocorre a seguinte sequência de eventos:

  1. Solicitação inicial: Um usuário não autenticado tenta acessar um "deep link" para uma página dentro de seu aplicativo que requer login. O link pode até conter parâmetros de URL.

    URL de exemplo
    https://<your-domain>/app/MyApp/MyProtectedPage?orderId=123
    
  2. Desafio de autenticação: O App Builder determina que o usuário não está conectado e que a página requer autenticação. Ele inicia um "desafio".

  3. Redirecionamento para página de login: O App Builder redireciona o usuário para a página de login personalizada definida na propriedade LoginPath do seu provedor de segurança Application Authentication.

    Importante

    Para que isso aconteça automaticamente, você deve fazer o seguinte:

    • Defina este provedor de segurança como o provedor de Default Authentication para seu aplicativo. (Isso substitui qualquer padrão em todo o sistema que possa estar definido em IDE > Security Providers > Configuration > Default Authentication.)

    • Ative a opção Redirect On Challenge.

  4. Usuário faz login: O usuário insere suas credenciais na página de login personalizada e envia o formulário.

  5. Regra de autenticação é executada: Sua regra de autenticação personalizada é executada, verifica as credenciais e registra o usuário no App Builder.

  6. Redirecionamento para página original: Após um login bem-sucedido, o App Builder redireciona automaticamente o usuário de volta para a página que ele originalmente tentou acessar, incluindo todos os parâmetros de URL originais.

Visão geral de configuração

Para configurar a Autenticação de Aplicativo, é necessário definir vários componentes no ambiente e dentro do aplicativo.

Configuração do ambiente

O seguinte deve ser configurado em cada ambiente (por exemplo, Dev, QA e Production):

  • Aplicativo de página de login: Um aplicativo App Builder separado e independente que funciona como formulário de login.

  • Provedor de segurança de autenticação de aplicativo: O provedor de segurança que define o comportamento de login personalizado.

  • Contas de usuário genéricas: Uma ou mais contas de usuário no App Builder para as quais os usuários autenticados são mapeados.

Configuração do aplicativo

É necessário configurar estes itens no aplicativo principal:

  • Regra de autenticação: Uma regra de negócio que contém a lógica para verificar as credenciais do usuário.

  • (Opcional) Tabelas de suporte: Tabelas para gerenciar sessões de usuário, senhas e dados de usuário específicos do aplicativo.

Guia de configuração passo a passo

As etapas a seguir orientam na configuração completa da Autenticação de Aplicativo. Para tornar as instruções mais concretas, cada etapa inclui um exemplo baseado em um cenário simples: um portal de clientes que valida credenciais de usuário contra uma fonte de dados externa (chamada Customers) contendo endereços de email e hashes de senha. Todos os clientes autenticados são mapeados para uma única conta de usuário App Builder genérica. A implementação diferirá nos detalhes, mas a estrutura e sequência das etapas serão as mesmas.

1. Criar o aplicativo de página de login

A página de login é um aplicativo App Builder independente cujo único propósito é coletar e enviar credenciais de usuário. Deve ser um aplicativo separado do aplicativo principal para que usuários não autenticados possam acessá-lo antes de fazer login.

Para criar o aplicativo, siga as etapas em Criar um novo aplicativo. Após o aplicativo existir, configure sua página de login com os seguintes requisitos:

  • A página deve ser acessível ao grupo Usuário Anônimo. Isso é necessário porque usuários não autenticados devem conseguir acessar a página de login antes de fazer login. Sem isso, o redirecionamento de desafio falhará.

  • A página deve conter um painel que funciona com base em uma tabela usada para capturar as credenciais inseridas no formulário. A tabela Session é a escolha recomendada, pois armazena valores de formulário para a sessão atual sem persistir. Como alternativa, é possível usar uma tabela personalizada (por exemplo, uma tabela LoginAttempt definida no modo Add, para que cada tentativa de login insira um novo registro). A regra de autenticação lê as credenciais da tabela escolhida.

  • A página precisa de um ou mais campos editáveis para capturar credenciais de usuário (como Email, Nome de Usuário ou Número de Telefone).

  • (Opcional) Um campo Senha com validação de senha configurada.

  • Um botão Login que aciona a regra de autenticação. Este botão não deve estar vinculado a nenhuma página; seu único propósito é executar a regra.

  • (Opcional) Links para fluxos de Esqueci minha senha ou Cadastro, se o aplicativo exigir.

Por exemplo, o aplicativo de login poderia ser nomeado Customer Login contendo uma única página chamada Sign In, que teria dois campos de credencial baseados na tabela Session: um campo Email e um campo Password com validação de senha configurada. Um botão Sign In ativa a regra de autenticação.

2. Criar o provedor de segurança de Autenticação de Aplicativo

Para criar o provedor de segurança de Autenticação de Aplicativo, siga estas etapas:

  1. Selecione IDE > Provedores de Segurança.

  2. Clique em + Provedor de Segurança.

  3. Na página Provedor, defina o seguinte:

    • Nome: Um nome para o provedor (por exemplo, CustomerPortalAuth).

    • Tipo: Selecione Autenticação de Aplicativo.

    • Habilitado: Deixe desabilitado até que toda a configuração seja concluída.

  4. Mostrar no Formulário de Login: Marque esta caixa.

  5. Página Padrão: Selecione a página de destino padrão que um usuário deve ver após fazer login, se não tiver tentado originalmente acessar uma página de deep link específica. A página deve estar marcada como Pública em suas configurações de Caso Extremo.

  6. Página de Logout: Selecione a página para a qual os usuários são redirecionados após fazer logout. Se você quiser que os usuários retornem à sua página de login personalizada após fazer logout, selecione essa página aqui. A página selecionada deve estar marcada como Pública em suas configurações de Caso Extremo.

  7. Clique em Salvar.

  8. Em Propriedades, clique em + Propriedade.

  9. Na janela Propriedades, defina os valores da seguinte forma:

    • Parâmetro: Selecione LoginPath.

    • Valor: Digite o caminho relativo à raiz para seu app de página de login. O caminho deve ser codificado em URL e começar com /.

      Exemplo
      /app/Customer%20Login/Sign%20In
      
  10. Salve as propriedades e feche a janela.

3. Configurar uma conta de usuário genérica

O App Builder oferece duas abordagens principais para lidar com contas de usuário com Autenticação de Aplicativo:

  1. Mapeamento para uma conta de usuário genérica: Isso envolve criar uma ou mais contas de usuário pré-existentes no App Builder às quais os usuários externos autenticados são mapeados. Isso é particularmente útil para cenários como acesso semi-anônimo (por exemplo, usando um número de telefone e OTP), onde todos os usuários externos podem compartilhar uma conta com privilégios baixos.

  2. Provisionamento dinâmico de usuários: Essa abordagem mais avançada envolve criar contas de usuário individuais no App Builder dinamicamente durante o processo de login.

Esta seção se concentra na primeira abordagem: mapeamento para uma conta de usuário genérica. Para fazer isso, siga estas etapas:

  1. Selecione IDE > Gerenciamento de Usuários e crie uma nova conta de usuário (por exemplo, PortalUser). Esta é a conta que fornece as permissões dentro do app.

  2. Atribua o usuário aos Grupos que concedem as funções necessárias para seu aplicativo.

  3. Em Identidades, clique em + Identidade para criar uma identidade para este usuário com as seguintes configurações:

    • Nome: Digite o valor que seu aplicativo usará para identificar a pessoa, como seu nome de usuário ou endereço de email. Isso deve ser único para cada usuário. O App Builder usará isso para encontrar a conta de usuário correta, a menos que você também forneça um valor para Identificador.

    • Identificador (opcional, mas recomendado): Digite um ID permanente e único para este usuário. Esta é a forma mais confiável para o App Builder reconhecer um usuário, mesmo que seu endereço de email ou nome de usuário mude. Se você fornecer isso, o App Builder sempre o usa primeiro para encontrar o usuário.

Por exemplo, no cenário do portal de clientes, a conta de usuário genérica é chamada PortalUser e seu Nome de identidade está definido como portal.user@example.com. Todos os clientes que se autenticam com sucesso são mapeados para esta conta.

4. Criar a regra de autenticação

Você precisa de uma regra de negócio para lidar com a lógica de autenticação real. Para configurar uma, siga estas etapas:

  1. Crie uma Regra de Negócio CRUD XP que execute uma ação de Inserção.

  2. Defina a Fonte de Dados de Destino como Vinyl e o Destino como o objeto de dados público Authenticate.

  3. No SQL da regra, faça uma junção da sua tabela de credenciais de usuário externo com a tabela usada pelo formulário da sua página de login (por exemplo, a tabela Session) para recuperar o nome de usuário e a senha inseridos pelo usuário.

    Importante

    Não use a tabela User integrada do App Builder para validar senhas. A tabela User não expõe o campo de senha por motivos de segurança, tornando impossível validar a senha sem um plugin personalizado. Use uma fonte de dados externa para armazenar e validar credenciais de usuário.

  4. Mapeie as quatro colunas obrigatórias a seguir para o destino Authenticate:

    • AuthenticateID: Um novo GUID. Use newUUID().

    • ProviderId: O ID do seu provedor de segurança de Autenticação de Aplicativo.

  5. AppUserId: Um identificador para o usuário final que está fazendo login (como seu email ou nome de usuário). Isso é usado para auditoria através da função who('appuserid').

  6. Name: O nome da Identity do usuário genérico para mapear (por exemplo, portal.user@example.com). Isso pode ser codificado ou determinado dinamicamente com base nas credenciais do usuário.

Por exemplo, no cenário do portal do cliente, a regra SQL une a tabela Session com a tabela Customers externa no campo Email. Os mapeamentos de coluna são: AuthenticateID usa newUUID(), ProviderId é o ID do provedor CustomerPortalAuth, AppUserId é mapeado para o campo Email da tabela Session e Name é definido para o valor fixo portal.user@example.com. Note que o SQL exato para a união, incluindo como a validação de senha é tratada, dependerá da estrutura da sua fonte de dados externa.

5. Ativar redirecionamento automático no desafio

Para garantir que os usuários sejam automaticamente direcionados para sua página de login personalizada ao acessarem uma página protegida, você deve ativar estas duas configurações:

  1. Configure o provedor de autenticação padrão:

    (O provedor de autenticação padrão pode ser definido em todo o sistema ou no nível da aplicação. A configuração no nível da aplicação substitui a opção em todo o sistema.)

    Para configurar o padrão no nível da aplicação, siga estas etapas:

    1. Selecione IDE > Security Providers.

    2. No painel Security Providers, selecione More > Applications.

    3. Clique no ícone Edit para sua aplicação.

    4. Defina Default Authentication para o provedor Application Authentication que você criou.

    5. Clique em Proceed e feche o popup.

  2. Configure o redirecionamento no desafio:

    1. Na página Security Providers, clique no ícone Open record para seu provedor Application Authentication.

    2. Em Provider, clique em Edit.

    3. Marque a opção Redirect On Challenge.

    4. Clique em Save.

Por exemplo, no cenário do portal do cliente, defina Default Authentication para CustomerPortalAuth para a aplicação Customer Portal.

6. Ativar e testar

Após concluir todas as etapas acima, volte para seu provedor de segurança Application Authentication no IDE e ative-o. Agora você pode testar todo o fluxo de login.

Provisionamento de usuários e grupos

Application Authentication cuida apenas da etapa de autenticação. Isso não cria automaticamente contas de usuários nem atribui permissões de grupo. Se sua aplicação exigir que os usuários tenham direitos de acesso específicos após fazer login, você deve configurar isso separadamente.

Um problema comum após uma autenticação bem-sucedida é os usuários receberem um erro de acesso negado ao tentar acessar a página inicial da aplicação. Isso acontece quando a conta do usuário (ou a conta genérica para a qual é mapeada) não foi atribuída a um grupo com as permissões de aplicação necessárias.

Para conceder a um grupo acesso a uma aplicação, consulte Group provisioning. Você deve usar Manage Privileges para adicionar a aplicação ao conjunto de permissões do grupo e depois conceder as funções apropriadas.

Se seu fluxo também exigir criar contas de usuários programaticamente (por exemplo, registrar novos usuários no momento do login), consulte Provisionamento de usuários e grupos.

Tópicos avançados

Um dos recursos mais poderosos desse fluxo é a capacidade de enviar a um usuário um link para um registro específico ou uma exibição filtrada em sua aplicação. Como o App Builder preserva a URL originalmente solicitada (incluindo todos os parâmetros de consulta) durante o processo de autenticação, você pode construir deep links sem nenhuma formatação especial. Por exemplo, você pode enviar a um usuário um link para um pedido específico: https://<seu-domínio>/app/MyApp/Orders?Orders.OrderId=5011 Quando o usuário não autenticado clica neste link, ele é direcionado para sua página de login e, após fazer login, é redirecionado para a página Orders com o pedido 5011 carregado automaticamente.

Disparar um desafio manualmente

Embora o App Builder dispare automaticamente desafios para usuários não autenticados quando acessam uma página protegida, você também pode disparar esse processo manualmente a partir da lógica da sua aplicação. Isso é útil em cenários como expiração de sessão do usuário ou para fornecer um botão Login dedicado no cabeçalho da sua aplicação.

Para fazer isso, crie uma regra de negócio simples que insira um registro no objeto de dados público Challenge. Em seguida, anexe essa regra a um evento, como um clique de botão.

Como criar um disparador de login manual

  1. Criar uma Regra de Negócio: Crie uma nova Regra de Negócio CRUD XP e dê a ela um nome descritivo, como Manual Login Challenge.

  2. Configurar o Alvo da Regra:

    • Defina a Fonte de Dados de Destino como Vinyl.

    • Defina o Alvo como o objeto de dados público Challenge.

    • Defina a Ação como Insert.

  3. Mapear a ID do Provedor: No design da regra, você precisa apenas mapear uma coluna. Mapeie a ID do seu provedor de segurança de Autenticação de Aplicação para a coluna ProviderId no alvo Challenge. Você pode encontrar essa ID na página Security Providers no IDE.

  4. Disparar a Regra: Anexe essa nova regra de negócio a um evento. Por exemplo, você poderia adicionar um botão Login ao cabeçalho da sua aplicação e configurar seu evento on-click para executar a regra Manual Login Challenge.

Quando essa regra é executada, o App Builder redireciona imediatamente o usuário para a página de login definida no LoginPath do seu provedor de segurança, preservando a página atual do usuário para que ele possa ser retornado a ela após um login bem-sucedido.