Autenticação Oauth2 usando Keycloak
Possuir um servidor de autenticação com protocolo OAUTH2, exemplo Keycloak
Conectar o servidor de autenticação ao sistema
Após leitura de um novo usuário, o sistema atribuirá as seguintes permissões contidas nos seguintes parâmetros:
- Acessar o menu principal Parametrização > Método de Autenticação > Oauth2;
- Será apresentado a tela de Método de Autenticação Oauth2 com duas opções "Filtros" e "Método de Autenticação";
- A partir da versão 9.1.2.24 houve alterações na interface descritas abaixo;
- A opção "Filtros" é uma tela de pesquisa com 4 opções:
Opção | Descrição |
|---|---|
Tipo | Onde será escolhido o tipo de autenticação. Existem dois tipos: Interno ou Externo. Se a opção for externa o sistema poderá ter 3 tipos de autenticação: Interno, Oauth2 ou Ambos. Se a opção estiver como ambos o sistema irá apresentar a tela de login com a área para: "autenticação", a opção de "esqueceu sua senha" e "acesse a sua conta" que poderá ser através do Google, Facebook ou Run2biz Keycloak. Se a opção for ambos mas não tiver nenhum provedor externo cadastrado, o sistema não irá mostrar as opções de autenticação por Google, Facebook ou Run2biz Keycloak. Se a opção for Oauth2 e não tiver um provedor cadastrado ele não irá mostrar a tela com vários provedores, mostrando direto a "tela de login da Run2biz". |
Provider | Onde será escolhido se será do tipo Google, Facebook ou outros |
Domínio | Informar o domínio da autenticação |
Nome do cliente | Informar o nome do cliente da autenticação |
- Após preencher as informações em "Filtros", caso exista algum cadastro com o campo informado, ele será apresentado na tabela exibida logo abaixo em "Método de Autenticação";
- Caso não haja nenhum método autenticação cadastrado ou você deseja criar um novo, clicar em "Novo";
- Ao clicar em "Novo" será apresentado a tela para cadastro de um novo método de autenticação com 2 abas para serem preenchidas: "Identificação" e "Mapeamento de Campos";
- Para a aba de "Identificação", preencher:
Campo | Descrição |
|---|---|
Tipo de Autenticação | Existem duas opções para selecionar "Oauth2 - Interna" e "Oauth2" |
Provider | Onde será escolhido se será do tipo "Google", "Facebook" ou "outros" Se for do tipo Google ou Facebook só será preciso informar: o Id do Cliente e a Chave Secreta do Cliente; Se for do tipo Outros será preciso informar: o Nome do cliente, o Domínio que deverá ser o mesmo cadastrado nas URLs de redirecionamento do provedor |
Id do Cliente | Onde deve ser informado o client id que foi cadastrado no servidor Oauth2 |
Tipo de concessão | Identifica o grant de acesso concedido pelo provedor de autenticação. Geralmente contém o valor “password” |
Url de Autenticação | Onde deverá ser informado o caminho do servidor de autenticação Oauth2 |
Senha | Onde deverá ser informado o client secret cadastrado no servidor Oauth2 |
Situação | Onde poderá ser escolhido se a autenticação está ativa ou inativa. Essa situação determina se o sistema vai iniciar o processo de sincronização de usuário |
Botão Gravar | Salva o meio de autenticação |
Botão Excluir | Apaga o meio de autenticação do banco de dados |
Botão Limpar | Limpa todos os campos |
Botão Pesquisa | Apresentado no topo da tela, que volta para a tela de pesquisa |
- Para a aba de "Mapeamento de Campos", preencher:
Campo | Descrição |
|---|---|
Botão Gravar | Salva os campos |
Botão Limpar | Limpa todos os campos |
Botão Pesquisa | Apresentado no topo da tela, que volta para a tela de pesquisa |
- Essa aba permite o mapeamento de informações presentes no token de autenticação Oauth2. Na tela são apresentadas duas colunas: a primeira coluna com o nome dos campos existentes no cadastro de usuário do Sistema e a segunda coluna com o nome do respectivo atributo do token Oauth2;
- As informações que podem ser mapeadas são: CPF, Telefone e Data de Nascimento;
- Deverá ser configurada a URL de Retorno ao CITSmart através da Plataforma escolhida para autenticação externa.
