Área do Desenvolvedor

O Painel do Desenvolvedor("Área do desenvolvedor") é a seção do Login Cidadão Gov.br para gestão de seu serviço. Para acessar utilize as URLs:

E acesse o menu Área do desenvolvedor

2. Nela conterá a lista dos serviços do qual você faz parte da equipe de administração

Dica: caso este menu não apareça para você, é preciso solicitar que seu perfil seja alterado para "Desenvolvedor" no Login Cidadão Gov.br, via atendimento-login@procergs.rs.gov.br.

Acesso a Client Id e Client Secret

Ao acessar um serviço você terá as informações de client_id e client_secret para a integração.

Gerenciando seu serviço

É possível visualizar e alterar algumas informações relacionadas a seu serviço dentro do Login Cidadão Gov.br.

Configuração do OAuth

URLs de callback (redirecionamento) - aqui precisam estar as URLs que a aplicação pode redirecionar. É possível adicionar ou remover alguma que não esteja mais em uso.
Post logout redirect uris - aqui precisam estar as URLs de redirecionamento para o logout do seu serviço

Liberando escopos

Para verificar os escopos, acessar a opção toggle options:

Nessa tela se encontram os escopos permitidos, você pode selecionar múltiplos:

Lembrando: para selecionar mais de um escopo, pressione a tecla “Control (Ctrl)“. E pode ser habilitado um ou mais, depende apenas da necessidade do serviço.

Esta é apenas a liberação da permissão do uso do escopo.

Será necessário implementar a chamada do escopo novo em seu serviço.

Importante! Qualquer alteração de escopo fará uma solicitação de acesso ao usuário semelhante ao primeiro acesso feito pelo serviço.!

Liberando escopos especiais e utilizando escopos do GovBr

O administrador do serviço pode alterar a qualquer momento as permissões aos escopos especiais.

A lista dos “Restricted Scopes" é a lista dos escopos.

Cada escopo representa informações que será adicionado ao retornado no endpoint de informação do usuário:

Endpoint: GET https://meu.hml.rs.gov.br/api/v5/person

Escopo: govbrselos

"govbr_selos": [
  {    "id": "string",
    "dataAtualizacao": "string"
  }
]

Escopo: govbrniveis

"govbr_niveis": [
  {    
    "id": "string",
    "dataAtualizacao": "string"
  }
]

Escopo: govbrcategorias

"govbr_categorias": [
  {    
    "id": "string",
    "dataAtualizacao": "string"
  }
]

Escopo: govbrconfiabilidade

"govbr_confiabilidade": [
  {    
    "id": "string",
    "dataAtualizacao": "string"
  }
]

Escopo: govbrempresa

"govbr_dados_empresa_cnpj": "string",
"govbr_dados_empresa": {
  "cpf": "string",
  "atuacao": "SOCIO",
  "cadastrador": true,
  "cpfCadastrador": "string",
  "dataCriacao": "2026-03-18T12:48:07.160Z",
  "dataExpiracao": "2026-03-18T12:48:07.160Z"

},
"govbr_empresas_vinculadas": [
  {    
    "cnpj": "string",
    "razaoSocial": "string",
    "dataCriacao": "2026-03-18T12:48:07.160Z"
  }
]

Escopo: govbrrecuperacertificadox509

"govbr_recupera_certificado_x509": {
 "provider": "string",
 "amr": [ "string" ],
 "certificate": "string",
 "type": "device"
}

Escopo: govbrtipoacesso

"govbr_tipo_acesso": [ "passwd" ]

Consulta Adicional de Empresas

O escopo govbrempresa também concede acesso ao endpoint para consulta de dados vinculados:

URL: GET https://meu.hml.rs.gov.br/api/v5/person/login/govbr/dadosempresa

Parâmetro: cnpj (CNPJ da empresa associada ao usuário logado)

Retorno:

[
  {    
    "cpf": "string",
    "atuacao": "SOCIO",
    "cadastrador": true,
    "cpfCadastrador": "string",
    "dataCriacao": "2026-03-18T13:19:33.914Z",
    "dataExpiracao": "2026-03-18T13:19:33.914Z"
  }
]