---
title: Configuração para autenticação gov.br
slug: cit-9/configuracao-para-autenticacao-govbr
description: Learn how to implement OAuth2 authentication on your platform with this comprehensive document. It covers all the required configurations and parameters, along with detailed explanations of the authentication method. Explore examples of the login process
docTags:
createdAt: 2023-03-24T19:17:10.000Z
---
## Objetivo
Este documento descreve os requisitos e configurações necessárias para **implementar a autenticação OAuth2** ***gov.br*** na plataforma, conforme documentação disponível no [site do Roteiro de Integração do Login Único](https://manual-roteiro-integracao-login-unico.servicos.gov.br/pt/stable/).
## Parametrização
- A propriedade *AUTHENTICATION\_PROTOCOL* do arquivo **application.ini **deve estar com o valor **OAUTH2** (somente autenticação Oauth2 externa) ou **BOTH** (autenticação interna e externa).
- A propriedade *AUTHENTICATION\_CREATE\_USER* (default *FALSE*) deve estar com o valor **TRUE**, caso a opção seja criar o usuário automaticamente quando ele não existe no banco de dados do Plataforma.
- Como os usuários do [ambiente de testes do gov.br](https://sso.staging.acesso.gov.br) tem o mesmo nome (Meu nome) é importante que o parâmetro 277 (Permite o cadastro de colaborador com mesmo nome?) esteja habilitado com “sim”.
## Método de Autenticação
Na funcionalidade `Parametrização > Método de autenticação > Oauth2` deve ser criado
um método de autenticação com as seguintes informações:
- **Tipo de autenticação:** OAuth2 - Externa
- **Provider:** Outros
- **Domínio:** govbr
- **Nome do cliente:** Entrar com *GOV.BR*
- **ID do cliente:** \{client id fornecido pelo órgão}
- **Chave secreta do cliente:** \{client secret fornecido pelo órgão}
- **Situação: **Ativo
- **URL de autenticação:** https\://sso.staging.acesso.gov.br/token
- **URI autorização:** https\://sso.staging.acesso.gov.br/authorize
- **URI informações do usuário:** https\://sso.staging.acesso.gov.br/userinfo
- **Escopo**: openid+(email/phone)+profile
- **Atributo identificador do usuário:** sub
- **Renovar o token automaticamente:** sim
A descrição “**Entrar com *****gov.b**********r***” para o atributo **Nome do cliente** é recomendado pela documentação disponível no [site do Roteiro de Integração do Login Único](https://manual-roteiro-integracao-login-unico.servicos.gov.br/pt/stable/).
Os atributos URL de autenticação, URI autorização e URI informações do usuário acima estão apontando para o ambiente de testes da autenticação *gov.br*
### Exemplo configurado para o ambiente de homologação
A aba “**Mapeamento de campos**” deve estar com os valores:
- **CPF/CNPJ:** sub
## Autenticação
Exemplo de tela de login quando a propriedade *AUTHENTICATION\_PROTOCOL* tem o valor **BOTH**:
Ao clicar em “**entrar com *****gov.br***” o usuário é redirecionado para a tela de autenticação configurada no domínio *govbr*:
No ambiente de testes *gov.br*, digite um CPF válido e cumpra as etapas de validação do usuário:
Para simplificar o processo escolha opção “**Não tenho celular**”:
Escolha “**Tentar de outra forma**”:
O nome da mãe é sempre ******"**MAMAE**" e a data de nascimento é sempre **01/01/1980**:
Informe um e-mail para receber o código de verificação:
:::hint{type="warning"}
⚠️ **Atenção!** É importante escolher a opção “**Por e-mail**” para que o usuário já seja criado com Email no Plataforma
:::
Informe o código de verificação:
E defina uma senha:
Logo em seguida, o usuário é redirecionado para a tela de login da plataforma. Escolha novamente a opção “**Entrar com *****gov.br***”, digite o usuário e a senha cadastrados na etapa anterior e autorize o acesso:
Pronto! O usuário foi cadastrado no Plataforma com o nome de usuário **\{domínio cadastrado no método de autenticação}\CPF**.
O perfil e a unidade do usuário são definidos nos parâmetros 39 e 390, respectivamente.