Criar um aplicativo no Azure AD
Introdução
O SSO (Single Sign-On) é um termo utilizado na área de segurança da informação para descrever um método de autenticação que permite que um usuário acesse vários sistemas ou aplicativos usando apenas um conjunto de credenciais de login.
Em termos de segurança, o SSO pode melhorar a proteção de dados, como as credenciais de login são verificadas em um servidor centralizado, é possível aplicar políticas de segurança consistentes em todos os sistemas conectados ao SSO. Isso significa que, se um usuário tiver seu acesso revogado ou suas credenciais comprometidas, a revogação será aplicada em todos os sistemas vinculados ao SSO, reduzindo assim o risco de acesso não autorizado.
Em resumo, o SSO simplifica o processo de autenticação para os usuários, ao mesmo tempo, em que aprimora a segurança dos sistemas e aplicativos.
Pré-requisitos
Para começar, você precisará dos seguintes itens:
- Uma assinatura do Azure AD. Caso você não tenha uma assinatura, obtenha uma conta gratuita
Observações
- Supondo que a URL de acesso ao GAT seja https://cliente.gat.digital/login, sua Identificação de Cliente GAT que será utilizada no decorrer deste documento, será `cliente_gat_digital` (apenas o host é utilizado, os pontos são substituídos por underline e a barra é substituída por underline)
- Supondo que a URL de acesso ao GAT seja https://gat.cliente.com.br/login, sua Identificação de Cliente GAT que será utilizada no decorrer deste documento, será `gat_cliente_com_br` (apenas o host é utilizado, os pontos são substituídos por underline e a barra é substituída por underline)
- Para obter os endpoints SAML do GAT, acesse a URL https://kcgat.gat.digital/realms/IDENTIFICACAO_CLIENTE_GAT/broker/saml/endpoint/descriptor
- Substitua IDENTIFICACAO_CLIENTE_GAT pela identificação do cliente GAT (vide observações)
Criar um aplicativo no Azure AD
- Acesse o portal do Azure e faça login com uma conta de administrador
- No menu lateral, clique em Enterprise applications
- Registre uma nova aplicação seguindo as informações na tela
- Entre na aplicação recém criada e clique em Single sign-on
- Na nova tela, clique em Go to application
- Na nova tela, clique em Endpoints
- Copie e abra a URL Federation Metadata Document
- Copie o valor do atributo entityID (logo na primeira linha) e salve em um arquivo de texto
- Copie o valor do atributo Location do elemento SingleSignOnService e salve em um arquivo de texto
- Copie o valor do atributo Location do elemento SingleLogoutService e salve em um arquivo de texto
- Acesso o menu lateral Authentication
-
Em Redirect URIs e adicione uma nova URL de redirecionamento do app
-
A URL a ser adicionada segue o seguinte padrão: https://kcgat.gat.digital/realms/IDENTIFICACAO_CLIENTE_GAT/broker/saml/endpoint
-
Substitua IDENTIFICACAO_CLIENTE_GAT pela identificação do cliente GAT (vide observações). Exemplo: https://kcgat.gat.digital/realms/cliente_gat_digital/broker/saml/endpoint
-
-
Em Front-channel logout URL informe a seguinte URL: https://kcgat.gat.digital/realms/IDENTIFICACAO_CLIENTE_GAT/broker/saml/endpoint
-
Substitua IDENTIFICACAO_CLIENTE_GAT pela identificação do cliente GAT (vide observações). Exemplo: https://kcgat.gat.digital/realms/cliente_gat_digital/broker/saml/endpoint
-
Caso seja necessário informar uma **Logout URL**, informe a mesma do login
-
-
Clique em Save
-
- Em Overview, acesse Application ID URI e adicione uma URI ID da aplicação
- A URI a ser adicionada segue o seguinte padrão:
https://kcgat.gat.digital/auth/realms/IDENTIFICACAO_CLIENTE_GAT
- Substitua IDENTIFICACAO_CLIENTE_GAT pela identificação do cliente GAT (vide observações). Ex.: https://kcgat.gat.digital/auth/realms/cliente_gat_digital
- A URI a ser adicionada segue o seguinte padrão:
-
No menu lateral, acesse Token configuration e clique em Add groups claim
- Escolha quais grupos deseja adicionar ao token (por padrão, escolhemos All groups)
- Clique em Add
Configurar o GAT Core
- Acesse o GAT com uma conta de administrador
- Acesse o menu/tela de configurações do SSO
- Preencha os parâmetros conforme abaixo:
- Company name e Display name: informe o nome de sua empresa
- SAML entity descriptor: informe o valor do Application ID URI (vide item 2.12)
- Identity provider entity ID: informe o valor do entityID (vide item 2.8)
- Single sign-on service URL: informe o valor do Location do elemento SingleSignOnService
- Single logout service URL: informe o valor do Location do elemento SingleLogoutService
- NameID policy format: escolha o valor Email
- Deixar os demais parâmetros com os valores padrões
- Clique em Salvar