<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Autenticação e autorização: o modelo de ameaças de toda API

DA

9 min

Autenticação e autorização: o modelo de ameaças de toda API

Modelo de ameaças para APIs: ativos, fronteiras de confiança, autenticação, autorização por objeto, tokens, segredos e perguntas de revisão que revelam furos.

Neste artigo

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

  1. Qual é a lista completa de quem pode chamar esta API, e cada um tem identidade própria?
  2. Toda verificação de permissão acontece no servidor, no ponto único de acesso a dado?
  3. Existe endpoint que devolve registro sem confirmar que ele pertence a quem chamou?
  4. Token tem validade, escopo mínimo e caminho de revogação testado?
  5. Segredo está em cofre, com rotação, ou espalhado em arquivo e repositório?
  6. Erro de autenticação ou autorização revela detalhe demais sobre o sistema?
  7. 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.

FronteiraAmeaça típicaControle
Cliente para APIToken forjado ou vazadoValidação completa e credencial de curta duração
API para dadoAcesso a objeto de outro usuárioConsulta filtrada pelo dono do recurso
Serviço para serviçoSegredo estático extraídoIdentidade de carga de trabalho e rotação
API para terceiroRedirecionamento e destino maliciosoLista de permissão e validação de destino
AdministraçãoPrivilégio excessivo e conta compartilhadaConta 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.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 06/10/2026 •

Ver perfil do autor

COMPARTILHAR