Keycloak além do login: autorização fina que escala com o negócio
Autenticar é só o começo. Veja como modelar papéis, escopos e permissões no Keycloak para que a autorização não vire um emaranhado de ifs.
Ler artigoSegurança da Informação
LGPD no código vai além da política de privacidade. Veja como aplicar proteção de dados da modelagem aos logs sem travar o desenvolvimento.

Muitas empresas trataram a LGPD como um projeto jurídico: revisaram contratos, publicaram uma política de privacidade, nomearam um encarregado e consideraram o assunto encerrado. Enquanto isso, os sistemas continuaram guardando CPF em texto aberto, gravando dados de clientes em logs e mantendo cópias de produção em ambientes de teste.
A Lei Geral de Proteção de Dados (Lei 13.709/2018) é clara ao exigir que as medidas de segurança sejam observadas desde a concepção do produto ou serviço até a sua execução. Em outras palavras, privacidade é requisito de software, não apenas de documento.
A boa notícia é que aplicar a LGPD no código não exige parar o desenvolvimento. Exige incorporar algumas decisões ao jeito como o time já trabalha.
A lei não fala de linguagens, frameworks ou bancos de dados. Ela define princípios, e cada um deles tem uma tradução técnica direta:
• Finalidade e necessidade: coletar apenas os dados necessários para um propósito definido. No código, isso significa questionar cada campo novo do formulário.
• Segurança e prevenção: adotar medidas técnicas para proteger os dados contra acessos não autorizados e incidentes. Criptografia, controle de acesso e monitoramento entram aqui.
• Livre acesso e qualidade dos dados: o titular tem direito de consultar e corrigir suas informações. O sistema precisa permitir isso de forma prática.
• Responsabilização e prestação de contas: a empresa precisa demonstrar que cumpre a lei. Sem registros e evidências técnicas, essa demonstração é impossível.
Quando esses princípios viram critérios de aceite das histórias de usuário, a conformidade deixa de depender de revisões pontuais.
Não é possível proteger o que você não sabe que tem. O primeiro passo técnico é mapear onde os dados pessoais estão:
• Quais tabelas e campos contêm dados pessoais
• Quais deles são dados sensíveis, como saúde, biometria, religião ou origem racial, que exigem cuidado redobrado
• Em quais sistemas, integrações, arquivos e backups esses dados circulam
• Quem tem acesso a cada conjunto de dados e por quê
Uma prática simples e eficaz é classificar os campos diretamente no modelo de dados, com anotações ou comentários que indiquem "pessoal" ou "sensível". Assim, a informação acompanha o código e pode ser usada por ferramentas de varredura e por revisões de pull request.
O dado mais seguro é aquele que você não coletou. Antes de adicionar um campo, vale perguntar:
• Esse dado é realmente necessário para a funcionalidade?
• Dá para usar uma versão menos detalhada, como faixa etária em vez de data de nascimento?
• Por quanto tempo ele precisa ficar guardado?
Defina políticas de retenção por tipo de dado e automatize a exclusão ou anonimização ao fim do prazo. Rotinas agendadas que limpam cadastros inativos, logs antigos e arquivos temporários reduzem o risco e o custo de armazenamento ao mesmo tempo.
Atenção aos backups: eles também contêm dados pessoais e precisam seguir as mesmas regras de acesso e retenção.
Criptografia é a medida mais citada, mas ela precisa estar no lugar certo:
• Em trânsito: TLS em todas as comunicações, inclusive entre serviços internos e integrações com parceiros
• Em repouso: criptografia do banco de dados e dos discos, e criptografia em nível de campo para dados sensíveis como documentos e informações de saúde
• Senhas: sempre com algoritmos de hash próprios para isso, como bcrypt ou Argon2, nunca com criptografia reversível
• Chaves: guardadas em cofres de segredos, com rotação periódica, e nunca versionadas no repositório
Para muitos cenários, a pseudonimização é uma aliada: substituir o identificador real por um código permite processar e analisar dados sem expor diretamente quem é o titular.
Boa parte dos incidentes com dados pessoais não vem de ataques sofisticados, e sim de acesso excessivo. Um atendente que vê todos os dados de todos os clientes, um relatório que exporta a base inteira, um usuário de serviço com permissão de administrador.
O caminho é aplicar o princípio do menor privilégio:
• Perfis de acesso baseados em papéis e, quando necessário, em atributos como unidade ou carteira de clientes
• Mascaramento de dados na interface, exibindo apenas parte do CPF ou do telefone quando o dado completo não for necessário
• Revisão periódica de acessos, removendo permissões de quem mudou de função ou saiu da empresa
• Trilha de auditoria registrando quem consultou, alterou ou exportou dados pessoais
Se você usa Keycloak ou outro provedor de identidade, o artigo Keycloak além do login: autorização fina que escala com o negócio mostra como modelar essas permissões sem espalhar regras pelo código.
Três pontos costumam passar despercebidos e concentram muitos riscos.
É comum logar o corpo inteiro de requisições para facilitar o diagnóstico. O resultado são CPFs, e-mails, endereços e até tokens gravados em ferramentas de log acessadas por muita gente. A solução é configurar filtros que mascaram campos sensíveis antes da gravação e revisar o que cada log realmente precisa conter.
Copiar a base de produção para homologação é prático e perigoso. Esses ambientes geralmente têm controles mais frouxos. Use dados sintéticos ou bases anonimizadas, geradas por rotinas que preservam o formato e a consistência sem expor pessoas reais.
Colar trechos de base de clientes em assistentes de IA para depurar um problema é, na prática, compartilhar dados pessoais com terceiros. Defina regras claras sobre o que pode ser enviado a essas ferramentas e prefira opções corporativas com garantias contratuais. O tema aparece também no artigo IA no desenvolvimento: onde o ganho de tempo é real.
A LGPD garante ao titular direitos como confirmação da existência de tratamento, acesso, correção, portabilidade, eliminação de dados tratados com base no consentimento e revogação do consentimento. Quando essas solicitações chegam, alguém precisa atendê-las.
Se o atendimento depende de um desenvolvedor rodando consultas manuais no banco, o processo é lento, caro e sujeito a erro. Vale prever no sistema:
• Exportação dos dados de um titular em formato estruturado
• Correção pelo próprio usuário ou por uma área responsável
• Exclusão ou anonimização que percorra todos os sistemas e integrações, e não só a tabela principal
• Registro do consentimento, com data, versão do termo e finalidade, e da sua revogação
Nenhum sistema é imune a incidentes. A diferença está na capacidade de detectar, conter e comunicar rapidamente.
Pelo Regulamento de Comunicação de Incidente de Segurança da ANPD (Resolução CD/ANPD nº 15/2024), o controlador deve comunicar à ANPD e aos titulares, em até três dias úteis, os incidentes que possam acarretar risco ou dano relevante. Esse prazo é contado em dobro para agentes de tratamento de pequeno porte, e a comunicação pode ser complementada depois com mais informações.
Três dias úteis é pouco tempo para descobrir, do zero, quais dados foram afetados. Por isso, o preparo técnico importa:
• Monitoramento e alertas para acessos anormais e exportações em volume
• Inventário de dados atualizado, que permita saber rapidamente o que foi exposto
• Logs de auditoria íntegros e protegidos contra alteração
• Um plano de resposta testado, com responsáveis definidos
Para que tudo isso não dependa de lembrança, a privacidade precisa entrar no fluxo normal do time:
1. Na concepção, avaliar quais dados a funcionalidade vai tratar e com qual finalidade
2. No refinamento, incluir critérios de aceite de privacidade nas histórias
3. No desenvolvimento, usar bibliotecas e padrões já aprovados para criptografia, mascaramento e autenticação
4. Na revisão de código, checar dados pessoais em logs, respostas de API e consultas
5. No pipeline, executar varreduras de segredos expostos e análise estática de segurança
6. Em produção, monitorar acessos e revisar permissões periodicamente
Para funcionalidades de alto risco, como as que tratam dados sensíveis em larga escala, vale produzir um Relatório de Impacto à Proteção de Dados Pessoais junto com a área jurídica e o encarregado.
A ITCODE desenvolve sistemas sob medida com privacidade e segurança tratadas como requisitos desde a primeira linha de código. Para sistemas que já estão em produção, a assessoria técnica faz o diagnóstico de dados pessoais, controles de acesso, logs e ambientes, e entrega um plano de adequação priorizado por risco. A sustentação garante que essas práticas continuem valendo à medida que o sistema evolui.
A LGPD não se cumpre só com documentos. Ela se cumpre no código: quando o sistema coleta apenas o necessário, protege o que guarda, controla quem acessa, registra o que acontece e permite atender o titular sem improviso.
Tratar privacidade como requisito técnico reduz o risco jurídico, diminui o impacto de incidentes e ainda aumenta a confiança de clientes e parceiros. E, quando incorporada ao ciclo de desenvolvimento, ela deixa de ser um freio e passa a ser parte da qualidade do software.
Este conteúdo tem caráter informativo e não substitui orientação jurídica especializada.
Continue lendo
Autenticar é só o começo. Veja como modelar papéis, escopos e permissões no Keycloak para que a autorização não vire um emaranhado de ifs.
Ler artigoVamos construir juntos
Conte o desafio. A ITCODE avalia o contexto e propõe o caminho mais adequado — seja desenvolvimento, sustentação, assessoria ou outsourcing.
ou pelo WhatsApp
(54) 98134-6930 ↗