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:
-
Um grupo de provedor de segurança. Isso permite que o app offline acesse o app principal por meio do servidor de autorização.
-
Um cliente.
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:
-
Abra o app principal para edição.
-
Selecione App Workbench na gaveta de ações ou Workbench no menu de aplicação e clique em Roles.
-
Clique no botão Application Groups para abrir o diálogo Group e Roles.
-
Em Group, clique no botão Create.
-
Digite um nome (por exemplo
Offline App Security Provider) e uma descrição para o grupo e clique no ícone para salvá-lo. -
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:
-
Selecione IDE > Security Providers.
-
No painel Security Providers, clique no ícone ao final da linha Authorization Server para abrir o registro.
-
Em Provider, clique no botão Edit e faça as alterações necessárias.
-
Quando o provedor estiver configurado, clique em Enabled para habilitá-lo e clique no botão Save.
-
Em Provider, selecione More > Manage Groups.
-
No diálogo Groups, clique no botão Create.
-
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.
-
-
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:
-
Selecione IDE > User Management.
-
Selecione a aba Clients.
-
Clique no botão + Client.
-
No diálogo, defina valores para o seguinte em Client:
-
Name:
Offline App Client -
Description: Digite uma descrição.
-
-
Clique no botão Save.
-
Em Redirects, clique no botão + URL.
-
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).
-
-
Em Client, selecione More > Advanced.
-
Na caixa de diálogo Advanced Settings, clique para ativar tanto Require PKCE quanto Public e feche a caixa de diálogo.
-
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:
-
Criar grupos de usuários.
-
Configurar um provedor de segurança OpenID.
-
Fazer uma associação de grupo para o provedor de segurança.
-
Configurar as fontes de dados do conector do aplicativo.
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:
-
Selecione IDE > Security Providers.
-
Clique no botão + Security Provider.
-
Em Provider, defina os seguintes valores:
-
Settings
-
Name:
OpenIDImportante
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).
-
-
-
Clique no botão Save para salvar o provedor.
-
Em Endpoints, clique no botão + Endpoint.
-
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.
-
-
Clique no botão Save e feche a caixa de diálogo Endpoint.
-
Em Credentials, clique no botão + Credential.
-
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).
-
-
Clique no botão Save e feche a caixa de diálogo Credential.
-
Em Properties, clique no botão + Property.
-
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
-
-
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:
-
Selecione IDE > Security Providers.
-
No painel Security Providers, clique no ícone ao final da linha OpenID para abrir o registro.
-
Em Provider, selecione More > Manage Groups.
-
No diálogo Groups, clique no botão Create.
-
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.
-
-
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:
-
Selecione IDE > Data Servers.
-
Na tabela Data Servers, clique no botão Details da fonte de dados.
-
No diálogo Server, verifique se a URL é sua instância App Builder do aplicativo principal e clique no botão Edit.
-
Expanda o grupo Security Settings.
-
Clique para abrir o menu Security Provider e selecione OpenID (o provedor de segurança criado anteriormente).
-
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:
-
Na instância App Builder do aplicativo principal, crie um usuário local com uma senha.
-
Na instância App Builder do aplicativo offline, faça login com esse usuário.
-
Verifique o acesso ao seu aplicativo offline e verifique a funcionalidade de qualquer página que use conectores App Builder.