Ir para o conteúdo

Configurar autenticação para um app offline no Jitterbit App Builder

Introdução

A autenticação para um app offline exige etapas de configuração tanto no app principal quanto no app offline. Esta página descreve essas etapas e como testá-las.

App principal

Quando um usuário faz login em um app offline, ele é autorizado e recebe permissões por meio do app principal associado. Para permitir isso, é necessário configurar o seguinte no app principal:

Grupo de provedor de segurança

Deve-se criar um grupo de provedor de segurança no ambiente de desenvolvimento e propagá-lo para os ambientes de QA ou produção usando o método usual de gerenciamento de pacotes de aplicação.

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

  1. Abra o app principal para edição.

  2. Selecione App Workbench na gaveta de ações ou Workbench no menu de aplicação e clique em Roles.

  3. Clique no botão Application Groups para abrir o diálogo Group e Roles.

  4. Em Group, clique no botão Create.

  5. Digite um nome (por exemplo Offline App Security Provider) e uma descrição para o grupo e clique no ícone para salvá-lo.

  6. Feche o diálogo.

Dica

As permissões não são fornecidas por esse grupo, mas pela associação do grupo com o provedor de segurança, feita na próxima seção.

Provedor de segurança de autorização

O provedor de segurança de autorização habilita a autenticação OpenID para o app offline. Ele deve ser configurado em qualquer ambiente com o qual o app offline possa se autenticar.

Para configurar um provedor de segurança de autorização, siga estas etapas:

  1. Selecione IDE > Security Providers.

  2. No painel Security Providers, clique no ícone ao final da linha Authorization Server para abrir o registro.

  3. Em Provider, clique no botão Edit e faça as alterações necessárias.

  4. Quando o provedor estiver configurado, clique em Enabled para habilitá-lo e clique no botão Save.

  5. Em Provider, selecione More > Manage Groups.

  6. No diálogo Groups, clique no botão Create.

  7. No diálogo Provider Group, defina os seguintes valores:

    • Name: Offline App Security Provider

    • Identifier: Offline App Security Provider

    • Group: Clique para abrir o menu e selecione o grupo Offline App Security Provider.

  8. Feche o diálogo Provider Group e depois feche o diálogo Groups.

Dica

O identificador do grupo de segurança (Offline App Security Provider neste exemplo) é usado posteriormente para configurar o provedor de segurança do app offline.

Cliente

Para criar um cliente, siga estas etapas:

  1. Selecione IDE > User Management.

  2. Selecione a aba Clients.

  3. Clique no botão + Client.

  4. No diálogo, defina valores para o seguinte em Client:

    • Name: Offline App Client

    • Description: Digite uma descrição.

  5. Clique no botão Save.

  6. Em Redirects, clique no botão + URL.

  7. Digite o seguinte no campo e clique no ícone para salvá-lo:

    https://localhost:5001/signin-OpenID
    
    • localhost: Esta é uma string literal; não é necessário substituir um nome de host ou endereço IP.

    • OpenID: Esta parte da URL pode ser diferente, mas deve corresponder exatamente ao nome do provedor de segurança OpenID (definido posteriormente).

  8. Em Client, selecione More > Advanced.

  9. Na caixa de diálogo Advanced Settings, clique para ativar tanto Require PKCE quanto Public e feche a caixa de diálogo.

  10. Copie ou anote o Client ID para usar depois e feche a caixa de diálogo.

Aplicativo offline

Para configurar o aplicativo offline, você deve fazer o seguinte:

Grupos de usuários

Como em qualquer aplicativo do App Builder, você deve criar grupos de usuários para os diferentes tipos de usuário que se espera usem o aplicativo, ou pelo menos os seguintes:

  • Um grupo User (Usuário), para usuários gerais do aplicativo.

  • Um grupo Administrator (Administrador), para desenvolvedores e administradores.

Provedor de segurança OpenID

Você precisa de um provedor de segurança para testar a autenticação em instâncias de desenvolvimento (fora do dispositivo) do seu aplicativo offline. As informações deste provedor de segurança podem ser exportadas como um arquivo JSON e usadas para configurar automaticamente o provedor em dispositivos móveis. O suporte da Jitterbit usa o arquivo JSON ao criar compilações do aplicativo offline para seus dispositivos móveis.

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

  1. Selecione IDE > Security Providers.

  2. Clique no botão + Security Provider.

  3. Em Provider, defina os seguintes valores:

    • Settings

      • Name: OpenID

        Importante

        Este valor deve corresponder exatamente ao sufixo da URL de redirecionamento do cliente (definido anteriormente) no aplicativo principal.

      • Type: Vinyl / OpenID Connect

      • Priority: (Padrão).

      • Enabled: Habilitado.

    • Tokens

      • Owner: User (padrão).
    • Sign In

      • Redirect On Challenge: Desabilitado (padrão).

      • Show On Login Form: Habilitado.

      • Default Page: Em branco (padrão).

      • Sign Out Page: Em branco (padrão).

    • Provisioning

      • User Provisioning: Habilitado.

      • Match Existing User: Habilitado.

      • Supplies Group Membership: Habilitado.

      • Name Format: Em branco (padrão).

      • Name Identifier Format: Em branco (padrão).

      • Identity Provider URL: Em branco (padrão).

  4. Clique no botão Save para salvar o provedor.

  5. Em Endpoints, clique no botão + Endpoint.

  6. Na caixa de diálogo Endpoint, defina o seguinte:

    • Endpoint Type: Clique para abrir o menu e selecione OpenID Connect Issuer.

    • URL: Digite a URL do servidor App Builder do aplicativo principal com o qual o aplicativo offline se autentica.

  7. Clique no botão Save e feche a caixa de diálogo Endpoint.

  8. Em Credentials, clique no botão + Credential.

  9. Na caixa de diálogo Credential, defina o seguinte:

    • Type: Clique para abrir o menu e selecione Client.

    • User Name: Digite o Client ID (anotado anteriormente).

  10. Clique no botão Save e feche a caixa de diálogo Credential.

  11. Em Properties, clique no botão + Property.

  12. Na caixa de diálogo Properties, defina o seguinte:

    • Parameter: Clique para abrir o menu e selecione Scopes.

    • Value: openid profile email phone api groups

  13. Clique no botão Save e feche a caixa de diálogo Properties.

Associação de grupo

O aplicativo offline recebe acesso por meio do identificador do grupo do provedor de segurança OpenID configurado na instância do App Builder do aplicativo principal.

Para associar o grupo ao provedor, siga estas etapas:

  1. Selecione IDE > Security Providers.

  2. No painel Security Providers, clique no ícone ao final da linha OpenID para abrir o registro.

  3. Em Provider, selecione More > Manage Groups.

  4. No diálogo Groups, clique no botão Create.

  5. No diálogo Provider Group, defina os seguintes valores:

    • Name: Digite um nome de sua escolha.

    • Identifier: Offline App Security Provider

    • Group: Clique para abrir o menu e selecione o grupo Offline App Security Provider.

  6. Clique no botão Save e feche os diálogos Provider Group e Groups.

Fontes de dados do conector

Qualquer fonte de dados do conector App Builder do aplicativo offline que acesse o aplicativo principal deve usar o provedor de segurança OpenID criado anteriormente.

Para todos esses conectores, faça o seguinte:

  1. Selecione IDE > Data Servers.

  2. Na tabela Data Servers, clique no botão Details da fonte de dados.

  3. No diálogo Server, verifique se a URL é sua instância App Builder do aplicativo principal e clique no botão Edit.

  4. Expanda o grupo Security Settings.

  5. Clique para abrir o menu Security Provider e selecione OpenID (o provedor de segurança criado anteriormente).

  6. Clique no botão Save e feche o diálogo Server.

Teste

Quando a configuração for concluída, um botão Sign in with OpenID aparecerá na tela de login do App Builder do aplicativo offline.

A seguir, um exemplo de um padrão de teste simples:

  1. Na instância App Builder do aplicativo principal, crie um usuário local com uma senha.

  2. Na instância App Builder do aplicativo offline, faça login com esse usuário.

  3. Verifique o acesso ao seu aplicativo offline e verifique a funcionalidade de qualquer página que use conectores App Builder.