Esta diretriz estabelece o Keycloak como provedor de identidade corporativo para as aplicações do DATASUS-MS. A adoção de um Identity Provider (IdP) corporativo elimina silos de autenticação, reduz superfície de ataque por credenciais dispersas e viabiliza a integração nativa com o Gov.br como provedor externo de identidade, em conformidade com a Estratégia de Governo Digital e a Portaria nº 3.000/2019 do Ministério da Saúde.
O Keycloak atua como camada de abstração entre as aplicações e o Gov.br, além de gerenciar identidades internas (servidores e colaboradores). A aplicação nunca conhece a origem da credencial — se Gov.br ou repositório local —, recebendo apenas um token padronizado (JWT) após o fluxo de autenticação ser concluído com sucesso.
Importante: Esta diretriz trata exclusivamente de autenticação. A gestão de autorização (controle de acesso a funcionalidades e dados) é de responsabilidade de cada sistema, devendo ser implementada localmente com base nos atributos do usuário fornecidos pelo token.
| Benefício | Descrição |
|---|---|
| Single Sign-On (SSO) | O usuário autentica uma vez e acessa múltiplas aplicações do DATASUS sem nova digitação de credenciais, dentro da mesma sessão. |
| Identidade Federada com Gov.br | Integração nativa com o Gov.br, permitindo que cidadãos e profissionais de saúde utilizem sua identidade digital oficial, com níveis de confiabilidade Bronze, Prata e Ouro. |
| Repositório Corporativo Unificado | Centralização de usuários internos (servidores, colaboradores, terceirizados) em um único diretório, com possibilidade de integração com Active Directory ou bases institucionais. |
| Desacoplamento | Frontend e backend não implementam lógica de login. Recebem tokens e validam assinaturas, simplificando o código e reduzindo vulnerabilidades. |
| Gestão Unificada de Consentimento | O Keycloak gerencia os consentimentos do usuário por cliente/aplicação (quais dados ele autoriza compartilhar), atendendo a requisitos da LGPD. |
| Políticas Centralizadas | Regras de MFA (múltiplo fator), força de senha, expiração de sessão e bloqueio por tentativas são configuradas uma vez e herdadas por todos os clientes. |
| Open Source e Governança | Sem custos de licenciamento, com comunidade ativa e suporte a protocolos abertos (OAuth 2.0, OIDC, SAML), evitando vendor lock-in. |
| Auditoria Consolidada | Todos os eventos de login, logout, troca de senha e revogação de token são registrados em um único ponto, facilitando trilhas de auditoria e detecção de anomalias. |
| Conformidade Legal | Atendimento à LGPD, à Política Nacional de Segurança da Informação e ao Decreto nº 10.046/2019, que dispõe sobre a governança compartilhada dos dados. |
O Keycloak no DATASUS-MS está configurado com o Gov.br como provedor de identidade externo primário, convergindo para um único Realm corporativo. Adicionalmente, gerencia identidades internas via repositório próprio ou integração com Active Directory.
Cenário Exemplo: Serviços voltados ao cidadão (Conecte SUS, Carteira Digital de Vacinação, agendamentos, exames) e sistemas que exigem autenticação forte governamental para profissionais de saúde e gestores.
Integração: Via OIDC, onde o Keycloak atua como Relying Party do Gov.br. O usuário é redirecionado ao Gov.br, autentica com selo Prata ou Ouro (conforme a sensibilidade do sistema), e retorna ao Keycloak com as informações de identificação (CPF, nome, e-mail, CNS quando aplicável).
Benefício: Conformidade com a Estratégia de Governo Digital, reaproveitando os níveis de confiabilidade do Gov.br e eliminando a necessidade de repositórios locais de credenciais para cidadãos.
A separação de responsabilidades entre frontend e backend materializa-se em Clientes distintos registrados no Keycloak, cada um com seu tipo e escopo apropriados.
| Tipo de Cliente | Access Type | Fluxo Recomendado | Características |
|---|---|---|---|
| Frontend Web (SPA) | Público | Authorization Code com PKCE | Armazena apenas client_id. Não possui client_secret. |
| Backend / API | Confidencial | Client Credentials ou validação de JWT do frontend | Possui client_secret armazenado em Secret do Kubernetes. |
| Microsserviços | Confidencial | Client Credentials (service-to-service) | Um client_id por serviço, com scopes limitados à sua função. |
| Aplicações CLI / Scripts | Público | Device Authorization Grant | Para automações que rodam em terminais ou ambientes sem navegador. |
O backend (API) não participa do fluxo de login do frontend. Sua única responsabilidade é validar o JWT que chega no header Authorization: Bearer .
O processo de validação local (stateless) consiste em:
Atenção: O JWT emitido pelo Keycloak não contém roles/grupos para autorização fina (guarda de rotas). A autorização deve ser implementada pelo sistema consumidor com base nos atributos do usuário (CPF, CNS, ocupação, etc.) presentes no token.
Como a autorização é de responsabilidade de cada sistema, o token JWT deve conter atributos suficientes para que a aplicação tome decisões de acesso. Recomenda-se que o Keycloak forneça, no mínimo:
| Atributo | Origem | Descrição |
|---|---|---|
| cpf | Gov.br / Cadastro | CPF do usuário (identificador único) |
| nome | Gov.br / Cadastro | Nome completo do usuário |
| Gov.br / Cadastro | E-mail do usuário |
Cada sistema deve implementar sua lógica de autorização com base nesses atributos, podendo enriquecê-los com informações de bases locais (ex: consulta ao CNES para validar vínculo ativo).
Este documento deve ser revisado a cada 6 meses ou quando houver mudanças significativas nos protocolos OAuth/OIDC, nas políticas do Gov.br ou na arquitetura de autenticação do DATASUS-MS.