Neste artigo
- O que um modelo de ameaças responde
- Ativos, atores e fronteiras de confiança
- Autenticação: escolher o método pelo tipo de cliente
- Autorização: do papel ao objeto
- Ciclo de vida do token e da sessão
- Segredos e chaves fora do código
- Perguntas de revisão que revelam furo
- Como levar o modelo para o time
- O que é modelo de ameaças em uma API?
- Qual a diferença entre autenticação e autorização?
- OAuth 2.0 resolve autenticação e autorização?
- Por que autorização por objeto é tão crítica?
- Com que frequência revisar o modelo de ameaças?
Toda API carrega um modelo de ameaças, mesmo quando ninguém escreveu esse modelo. A diferença é que na maioria dos sistemas ele está implícito, espalhado por decisão solta de código, e é justamente por isso que o furo aparece. Modelar ameaça é tornar explícito o que a API protege, de quem, em quais pontos de confiança e com qual controle, antes que o atacante responda essas perguntas por você.
Este guia percorre o modelo de ameaças de autenticação e autorização em API, do levantamento de ativos às perguntas de revisão, com os métodos e as armadilhas de cada etapa. É o complemento natural da lista de práticas de segurança de API: aqui o foco é o raciocínio, não o catálogo.
O que um modelo de ameaças responde
Modelo de ameaças responde cinco perguntas: o que estou protegendo, quem pode querer atacar, por onde ele passa, o que pode fazer de errado e o que estou fazendo para impedir. A resposta vira documento curto, não tese: um diagrama de fluxo com fronteiras de confiança e uma lista de ameaça com mitigação e dono.
O valor aparece cedo. A conversa sobre fronteira revela suposição errada, como achar que tráfego interno é confiável ou que o aplicativo móvel guarda segredo. Suposição não verificada é a raiz da maioria das falhas de autenticação e autorização, e é mais barato descobri-la em quadro branco do que em incidente de produção.
Ativos, atores e fronteiras de confiança
Ativo é o que tem valor: dado pessoal, credencial, token, capacidade de executar operação financeira, reputação do serviço. Ator é quem interage: usuário final, aplicativo parceiro, serviço interno, administrador e o atacante, que pode ser externo ou alguém com acesso legítimo e intenção indevida. Fronteira de confiança é todo ponto em que o dado passa de uma zona para outra: do navegador para a API, da API para o banco, do serviço para a integração de terceiro.
Cada fronteira exige verificação independente. Essa é a lição prática da postura de confiança zero, aprofundada no conteúdo sobre segurança além da identidade no modelo de confiança zero: não importa que a chamada venha de dentro da rede, ela precisa provar quem é e o que pode fazer. O desenho que assume rede interna confiável transforma qualquer invasão de máquina em acesso total.
Autenticação: escolher o método pelo tipo de cliente
Não existe método único de autenticação que sirva para todo consumidor. Usuário humano pede senha com segundo fator ou entrada por provedor de identidade. Aplicativo de terceiro pede fluxo de delegação com protocolo aberto, como o OAuth 2.0 com a camada de identidade do OpenID Connect. Serviço interno pede identidade de carga de trabalho, idealmente com certificado de cliente ou credencial de curta duração emitida por autoridade confiável.
Dois erros são recorrentes. O primeiro é guardar segredo de aplicativo móvel achando que ele é secreto, quando qualquer pessoa consegue extrair o valor do binário. O segundo é aceitar token sem validar assinatura, emissor, público e validade, o que permite token forjado ou reaproveitado de outro sistema. Autenticação é verificação, não leitura de campo.
ℹ️ Info: senha de usuário nunca é armazenada, apenas o resultado de função de hash própria para senha, com sal e fator de custo. Se o banco vazar, o invasor não pode reverter o valor. Recuperação de senha segue o mesmo rigor do login e não revela se o e-mail existe.
Autorização: do papel ao objeto
Autorização tem camadas, e cada camada responde uma pergunta diferente. O modelo por papel verifica se o perfil do usuário permite a ação. O modelo por atributo refina com contexto, como departamento, horário e nível de risco. O modelo por relacionamento verifica se aquele usuário tem vínculo com aquele recurso específico, que é o que resolve o caso mais comum de falha.
A falha mais frequente não é permitir ação administrativa, é permitir que um usuário legítimo alcance o objeto de outro trocando o identificador na requisição. A defesa é checar permissão no nível do objeto, no ponto único de acesso a dado, com consulta sempre filtrada pelo dono do recurso. Negar por padrão e liberar por exceção explícita é a postura que sobrevive ao crescimento do sistema.
Ciclo de vida do token e da sessão
Token não é selo eterno. O modelo de ameaças precisa definir tempo de vida curto para credencial de acesso, mecanismo de renovação controlado, possibilidade real de revogação e vínculo com o cliente que o recebeu. Token de vida longa sem revogação transforma um vazamento em acesso permanente.
Para sessão de navegador, entram proteção de cookie, exigência de conexão segura, expiração por inatividade e encerramento no logout. Para token entre serviços, entra escopo mínimo e rotação. O critério é sempre o mesmo: reduzir a janela de uso indevido e garantir que exista um caminho para cortar acesso quando algo dá errado.
Segredos e chaves fora do código
Chave de assinatura, segredo de cliente, senha de banco e credencial de integração não pertencem ao código nem ao repositório, nem ao arquivo de configuração copiado por e-mail. Pertencem a um cofre com acesso auditado, rotação planejada e permissão mínima por serviço. Um ambiente em que qualquer pessoa do time lê todos os segredos não tem controle de acesso, tem conveniência. Além do cofre, vale reduzir o número de pessoas com acesso a segredo de produção e registrar cada leitura, porque segredo compartilhado por muita gente perde rastreabilidade e dificulta saber o que vazou quando algo dá errado.
Autenticação entre serviços também pede identidade de curta duração em vez de segredo estático sempre que possível. A prática de emitir credencial temporária reduz o valor de um vazamento e simplifica a revogação, além de registrar qual carga de trabalho usou qual acesso.
Perguntas de revisão que revelam furo
- Qual é a lista completa de quem pode chamar esta API, e cada um tem identidade própria?
- Toda verificação de permissão acontece no servidor, no ponto único de acesso a dado?
- Existe endpoint que devolve registro sem confirmar que ele pertence a quem chamou?
- Token tem validade, escopo mínimo e caminho de revogação testado?
- Segredo está em cofre, com rotação, ou espalhado em arquivo e repositório?
- Erro de autenticação ou autorização revela detalhe demais sobre o sistema?
- Log registra tentativa negada e mudança de permissão sem gravar dado sensível?
Responder essas perguntas em conjunto, com o time que constrói a API, produz mais resultado do que auditoria isolada: quem escreveu o código conhece o caminho que o desenho nunca mostrou, e essa conversa costuma revelar furo que nenhuma ferramenta apontaria.
| Fronteira | Ameaça típica | Controle |
|---|---|---|
| Cliente para API | Token forjado ou vazado | Validação completa e credencial de curta duração |
| API para dado | Acesso a objeto de outro usuário | Consulta filtrada pelo dono do recurso |
| Serviço para serviço | Segredo estático extraído | Identidade de carga de trabalho e rotação |
| API para terceiro | Redirecionamento e destino malicioso | Lista de permissão e validação de destino |
| Administração | Privilégio excessivo e conta compartilhada | Conta nominal e elevação registrada |
Como levar o modelo para o time
Modelo de ameaças que fica no documento não protege nada. O caminho é transformá-lo em artefato vivo: desenho de fluxo atualizado junto com a arquitetura, ameaça com dono e prazo, e verificação de controle automatizada sempre que possível. A revisão entra no ciclo de mudança, não em reunião anual.
Para praticar autenticação e autorização com estrutura, o material de fundamentos de uma API organiza o vocabulário de recurso, método e representação, e o conteúdo sobre por que autenticação não basta mostra como o tema evolui quando entram agentes automatizados. Para quem quer aprofundar em identidade na nuvem, o caso de replicação multirregião em serviço de identidade ilustra as decisões de disponibilidade que também fazem parte do modelo.
Quem quer estudar identidade com trilha estruturada encontra base no curso de segurança de identidade e acesso, que organiza os conceitos de autenticação, autorização e proteção de credencial em sequência. É o próximo passo natural depois de fechar o modelo de ameaças da sua API.
Perguntas frequentes
O que é modelo de ameaças em uma API?
É o levantamento estruturado do que a API protege, de quem pode atacá-la, por quais fronteiras o dado passa e quais controles impedem cada abuso. Ele transforma suposição de segurança em decisão explícita com dono e verificação.
Qual a diferença entre autenticação e autorização?
Autenticação prova quem está chamando, por token, certificado ou senha com segundo fator. Autorização decide o que aquele cliente pode fazer com aquele recurso específico. Uma não substitui a outra, e a maioria dos furos graves está na segunda.
OAuth 2.0 resolve autenticação e autorização?
OAuth 2.0 é um protocolo de delegação de acesso, e o OpenID Connect acrescenta a camada de identidade. Os dois resolvem bem o fluxo com provedor, mas não dispensam autorização por objeto nem validação de token no seu sistema.
Por que autorização por objeto é tão crítica?
Porque o ataque não precisa de permissão especial: basta trocar o identificador na requisição para acessar dado de outra pessoa. É a falha mais comum em API e a que mais aparece em vazamento real de dado pessoal.
Com que frequência revisar o modelo de ameaças?
Sempre que mudar fluxo, permissão, integração ou tipo de cliente, além de uma revisão periódica. O modelo envelhece rápido porque a API muda rápido, e ameaça nova em desenho antigo costuma passar sem controle.