Integrar login gov.br ao portal de atendimento em 6 passos

Integrar login gov.br ao portal de atendimento de um órgão público significa substituir a criação de cadastro e senha próprios do sistema pela autenticação do cidadão através da conta gov.br que ele já usa em outros serviços federais. O requerente entra com a mesma identidade digital que já utiliza para consultar o INSS ou emitir a Carteira de Trabalho, e o órgão recebe os dados de identificação validados pela própria plataforma, sem reconstruir esse cadastro do zero a cada novo sistema.

Este guia detalha como estruturar essa integração: o que muda tecnicamente, quais níveis de conta gov.br cada tipo de serviço exige e como tratar o requerente que já tinha cadastro no sistema antigo com um CPF divergente do que a conta gov.br devolve.

O que é login gov.br integrado ao portal de atendimento

Login gov.br é o sistema de autenticação única mantido pelo governo federal, que permite a qualquer plataforma pública — federal, estadual ou municipal — delegar a identificação do usuário a uma conta central em vez de manter sua própria base de senhas. Tecnicamente, a integração acontece por um protocolo de autenticação (OpenID Connect sobre OAuth 2.0): o portal de atendimento redireciona o requerente para a tela de login do gov.br, o requerente se autentica lá, e o gov.br devolve ao portal um token com CPF, nome e o nível de confiabilidade daquela conta.

Esse nível de confiabilidade importa porque nem toda conta gov.br tem o mesmo peso probatório. As contas se dividem em bronze, prata e ouro, conforme a forma como a identidade foi verificada — de um cadastro simples por e-mail até validação biométrica ou reconhecimento facial. Um serviço que emite um documento com efeito jurídico relevante deve exigir um nível mínimo mais alto do que uma simples consulta de andamento de processo.

Por que integrar login gov.br importa

Manter um cadastro e uma senha exclusivos do portal do órgão gera três problemas recorrentes:

• Abandono no meio do cadastro. Preencher CPF, nome, e-mail, criar senha e confirmar por e-mail antes de sequer começar a solicitação afasta parte do requerente, especialmente quem só precisa protocolar algo uma vez.
• Duplicidade e inconsistência de identidade. Sem uma fonte única de verdade, o mesmo cidadão pode acabar com mais de um cadastro no sistema — um com o nome abreviado, outro com erro de digitação no CPF —, dificultando localizar o histórico completo de um requerente.
• Custo de suporte com recuperação de senha. Cada sistema com login próprio multiplica os chamados de “esqueci minha senha”, sobrecarregando a equipe de atendimento com uma tarefa que a autenticação centralizada elimina.

A integração com o login único também segue a lógica de que o cidadão deve interagir com o poder público como se fosse um único ecossistema, não uma coleção de sistemas isolados — cada um pedindo a mesma informação de identificação outra vez.

Passo a passo para integrar login gov.br

1. Levante os serviços do portal por nível de exigência

Classifique cada serviço do portal de atendimento pelo nível de comprovação de identidade que ele realmente precisa: uma consulta pública de andamento de processo exige menos do que a assinatura de um requerimento com efeito patrimonial. Esse levantamento define qual nível mínimo de conta gov.br (bronze, prata ou ouro) o portal deve aceitar para cada fluxo.

2. Cadastre o serviço no ecossistema gov.br

O órgão precisa formalizar a integração junto ao Conecta gov.br — o canal pelo qual serviços públicos de qualquer ente federativo se cadastram para usar o login único. Esse cadastro gera as credenciais técnicas (client ID e client secret) que o portal usará para se comunicar com o provedor de identidade.

3. Configure o fluxo de redirecionamento de autenticação

Com as credenciais em mãos, a equipe técnica implementa o fluxo OpenID Connect: o portal redireciona o requerente para o login do gov.br, recebe de volta um código de autorização e o troca por um token contendo CPF, nome e nível da conta. Esse é o ponto em que o desenvolvimento do sistema efetivamente conversa com a API do governo federal.

4. Mapeie o CPF retornado ao cadastro interno do requerente

Defina a regra de vínculo: se já existe um processo ou histórico associado àquele CPF no sistema do órgão, o login gov.br deve carregar esse histórico automaticamente. Se é a primeira vez que aquele CPF aparece, o sistema cria o cadastro interno a partir dos dados recebidos, sem pedir ao requerente para digitar de novo o que o gov.br já confirmou.

5. Trate o caso do requerente que já tinha conta própria no sistema antigo

Se o portal já operava com cadastro e senha próprios antes da integração, é preciso decidir o que acontece com quem já tinha uma conta lá — geralmente por meio de uma etapa única de vinculação, em que o requerente confirma, no primeiro login via gov.br, que aquele CPF corresponde ao cadastro anterior. Sem essa etapa, o histórico de solicitações antigas fica órfão, associado a uma conta que ninguém mais acessa.

6. Publique o botão de acesso mantendo alternativa quando necessário

Disponibilize o login gov.br como opção principal na tela de acesso do portal. Em órgãos que atendem público sem CPF regularizado ou situações excepcionais previstas em lei municipal, mantenha um fluxo alternativo de cadastro — o login único substitui a maior parte dos casos, não necessariamente todos.

O que a legislação exige

A Lei nº 14.129/2021 (Lei do Governo Digital) estabelece, entre seus princípios, a disponibilização em plataforma única do acesso às informações e aos serviços públicos e a interoperabilidade de sistemas como diretrizes da transformação digital da administração pública — o que dá amparo direto a um órgão municipal ou estadual optar por delegar a autenticação a uma identidade digital já reconhecida em todo o território nacional, em vez de manter uma base de credenciais isolada. Como o CPF e o nome do requerente são dados pessoais, o tratamento dessas informações recebidas do gov.br também se sujeita à Lei nº 13.709/2018 (LGPD), cujo art. 6º exige que a coleta se limite ao mínimo necessário para a finalidade do serviço prestado.

Como o Aprova resolve isso

• Portal de atendimento com login gov.br como opção de acesso, sem exigir que o requerente crie uma nova senha específica do sistema.
• Vínculo automático do CPF retornado pelo gov.br ao cadastro e ao histórico de processos já existentes do requerente.
• Configuração do nível mínimo de conta gov.br exigido por tipo de solicitação, conforme o risco e o efeito jurídico de cada processo.
• Manutenção de fluxo interno de conta própria para os casos em que a autenticação federal não se aplica, sem duplicar cadastro para quem já usa o gov.br.

Indicadores para medir a integração

• Percentual de requerentes que optam pelo login gov.br em vez de cadastro próprio, quando as duas opções coexistem.
• Tempo médio entre o clique em “acessar” e a conclusão do login, antes e depois da integração.
• Volume de chamados de suporte relacionados a recuperação de senha do portal.
• Número de contas duplicadas identificadas e unificadas após a adoção do login único.

FAQ sobre login gov.br no portal de atendimento

Uma câmara municipal pode integrar login gov.br do mesmo jeito que uma prefeitura?

Sim. O login único gov.br está disponível para qualquer ente da administração pública que formalize o cadastro do serviço no Conecta gov.br, independentemente de ser Poder Executivo ou Legislativo.

O que acontece se o cidadão não tiver conta gov.br?

Ele pode criar uma conta gov.br diretamente na hora do primeiro acesso ao portal — o processo de criação é conduzido pelo próprio gov.br, não pelo sistema do órgão. Em situações excepcionais previstas em lei municipal, é recomendável manter um canal alternativo de atendimento.

É preciso pedir autorização ao cidadão para usar os dados do gov.br?

O consentimento à captura de nome e CPF acontece na própria tela de login do gov.br, quando o usuário autoriza o compartilhamento desses dados com o serviço integrado. O órgão ainda precisa tratar esses dados conforme a finalidade declarada, nos termos da LGPD.

Login gov.br substitui a assinatura eletrônica de documentos?

Não. São mecanismos diferentes: o login gov.br autentica quem está acessando o portal, enquanto a assinatura eletrônica formaliza a manifestação de vontade sobre um documento específico dentro do processo — os dois podem, e costumam, operar juntos.

Conclusão

Integrar login gov.br ao portal de atendimento retira do requerente o atrito de criar mais uma senha e devolve ao órgão uma identidade de requerente única e verificada, em vez de cadastros fragmentados por sistema. O ganho fica mais evidente quando essa integração já nasce conectada ao cadastro de usuários internos e externos do protocolo eletrônico e à emissão automática de documentos a partir de modelo padrão, fechando o fluxo entre quem solicita e o que a administração devolve.

Se o portal de atendimento do seu órgão ainda pede ao cidadão para criar uma senha específica a cada novo serviço digital, agende uma demonstração e veja como estruturar o login único gov.br dentro do fluxo de protocolo.