Neste artigo
- Por que a API virou o alvo preferencial
- Autenticação: provar quem é o cliente
- Autorização: o furo mais comum é por objeto
- Validação de entrada e de saída
- Limites de uso e proteção contra abuso
- Segredos, transporte e configuração
- Inventário, versionamento e a superfície esquecida
- Registro e monitoramento
- Lista de verificação antes da publicação
- Qual é a diferença entre autenticação e autorização em uma API?
- O que é autorização quebrada em nível de objeto?
- Preciso usar OAuth 2.0 em qualquer API?
- Basta HTTPS para proteger a API?
- Com que frequência revisar a segurança da API?
API é a porta de entrada mais exposta de qualquer sistema moderno. Ela precisa aceitar requisição de aplicativo, de parceiro e de serviço interno, e cada uma dessas origens é um caminho legítimo que um atacante pode tentar imitar. A diferença entre uma API sóbria e uma frágil raramente está em um único recurso avançado: está em decisões básicas bem tomadas e verificadas antes de cada publicação. É exatamente esse conjunto que o roadmap de melhores práticas de segurança de API do roadmap.sh organiza como referência.
Este guia percorre essas práticas na ordem de risco, com o erro típico que cada uma evita e uma lista de verificação para usar antes do deploy.
Por que a API virou o alvo preferencial
Aplicação web tradicional entrega tela para gente; API entrega dado para outro sistema, geralmente sem ninguém olhando a resposta na tela. Isso muda o perfil do risco: um endpoint que devolve dado a mais passa despercebido por muito tempo, um identificador previsível permite varrer registros alheios e um recurso de teste esquecido segue respondendo em produção. O catálogo de riscos específicos de API mantido pelo projeto OWASP existe justamente porque as falhas mais graves aqui não são as mesmas da aplicação web.
O ponto de partida é aceitar que a API será descoberta. Documentação, aplicativo móvel e tráfego de rede revelam endpoints, e esconder caminho não é controle de segurança. O trabalho real é garantir que cada endpoint, mesmo conhecido, exija exatamente a identidade e a permissão certas.
Autenticação: provar quem é o cliente
Autenticação responde quem está chamando. Senha isolada é insuficiente para qualquer sistema que importa, e a prática mínima é combinar segundo fator ou usar um provedor de identidade consagrado com protocolo aberto, como o OAuth 2.0 e a camada de identidade do OpenID Connect. Para comunicação entre serviços, o certificado de cliente costuma ser mais adequado do que segredo compartilhado, porque identifica a máquina e não depende de um valor que pode vazar em arquivo de configuração.
Duas armadilhas comuns aparecem aqui. A primeira é aceitar token sem validar assinatura, emissor e público, o que permite token forjado ou emitido para outro sistema. A segunda é tratar autenticação como garantia de permissão: provar quem é o cliente não diz nada sobre o que ele pode fazer. Essa confusão é a origem de boa parte dos incidentes, e é o tema central do conteúdo sobre por que autenticação não basta e o que a segurança precisa cobrir além da identidade.
Autorização: o furo mais comum é por objeto
Autorização responde o que aquele cliente pode fazer com aquele recurso específico. A falha mais frequente em APIs não é permitir uma ação administrativa, é permitir que um usuário legítimo acesse o objeto de outro usuário apenas trocando o identificador na URL. O nome técnico é autorização quebrada em nível de objeto, e a causa é sempre a mesma: a verificação confere se o usuário está autenticado, mas não confere se aquele registro pertence a ele.
A correção é estrutural, não pontual. Toda consulta a dado de usuário deve nascer filtrada pelo dono do recurso, e a checagem precisa viver em um ponto único do código, não espalhada por endpoint. Negar por padrão e liberar por exceção explícita é a postura que evita o esquecimento. O caso de falhas em serviços financeiros embarcados mostra como uma checagem ausente nesse nível escala para prejuízo real, como analisa o conteúdo sobre falhas em banking as a service e o alerta que fica para quem constrói API.
⚠️ Atenção: teste de autorização não termina no caminho feliz. Para cada endpoint, verifique o acesso com o dono do recurso, com outro usuário comum, com usuário sem a permissão e sem autenticação. É nos três últimos casos que o furo aparece.
Validação de entrada e de saída
Validação de entrada é o controle que impede dado malformado de chegar à regra de negócio. O princípio é lista de permissão: aceitar exatamente o formato esperado, com tipo, tamanho e faixa definidos, e rejeitar o resto. Isso corta injeção de comando em banco, caminho de arquivo manipulado e deserialização perigosa antes que alcancem o ponto de execução.
Um cuidado específico merece atenção: quando a API busca uma URL informada pelo cliente, ela pode ser induzida a acessar recurso interno que não deveria estar exposto. É a falsificação de requisição do lado do servidor, e a defesa passa por validar destino contra lista de permissão e bloquear rede interna. O tratamento desse tipo de falha em framework moderno aparece no conteúdo sobre segurança contra falsificação de requisição do lado do servidor em APIs modernas. Validação de saída completa o par: a resposta devolve só os campos que o cliente precisa, nunca o registro inteiro do banco.
Limites de uso e proteção contra abuso
Sem limite, uma API autenticada vira ferramenta de força bruta, de varredura de identificadores e de esgotamento de recurso. A prática é combinar limite por cliente e por rota, com janela de tempo e resposta clara quando o teto é atingido, além de paginação obrigatória em listagem e teto de tamanho para corpo de requisição e envio de arquivo.
Operações sensíveis, como login, recuperação de senha e geração de token, pedem limite mais rígido e atraso progressivo. A regra prática é imaginar o custo de cada chamada: quanto mais caro o processamento ou mais sensível o dado, menor deve ser a janela permitida. Bloqueio temporário e registro do abuso transformam tentativa repetida em sinal detectável em vez de ruído silencioso.
Segredos, transporte e configuração
Chave de API no código do aplicativo móvel, token em repositório e senha de banco em arquivo versionado continuam sendo causas frequentes de exposição. Segredo deve viver em cofre com acesso auditado e rotação planejada, nunca em texto no código ou em variável de ambiente sem controle de quem lê. No transporte, versão atual do protocolo de segurança e configuração restritiva de cifra, com redirecionamento obrigatório para conexão segura.
Configuração também é superfície: mensagem de erro detalhada entrega versão e estrutura interna, cabeçalho permissivo demais libera origem indevida, ambiente de teste com dado real é vazamento esperando acontecer. Reduzir o que a resposta revela e revisar cada permissão de compartilhamento de origem é trabalho de rotina, não de auditoria anual.
Inventário, versionamento e a superfície esquecida
Não existe segurança sem inventário. Endpoint antigo que continua no ar, versão anterior mantida por compatibilidade e recurso de depuração ativo formam a superfície esquecida, e é ali que a falha sobrevive depois que o time já corrigiu o caminho principal. A prática é manter catálogo de versões, com política de desativação e data de encerramento comunicada.
O mesmo vale para integração de terceiro e serviço interno que consome a API. Cada consumidor deveria ter identidade própria, permissão mínima e registro de uso, para que revogar acesso seja uma operação simples e não uma investigação. Como referência de desenho, os fundamentos que explicam tudo sobre uma API ajudam a estruturar recurso, método e representação antes de discutir segurança em cima de um desenho confuso.
Registro e monitoramento
Log é o que transforma suspeita em investigação. A API deve registrar quem chamou, qual recurso, qual resultado e de qual origem, com identificador de correlação entre serviços, e nunca registrar senha, token ou dado pessoal em claro. Alerta útil nasce de padrão: aumento de negativa de acesso, varredura sequencial de identificador e chamada fora do horário habitual do cliente.
Sem esse alicerce, a resposta a incidente começa tarde e termina sem evidência. Detecção é o elo que fecha o ciclo das práticas anteriores: uma falha que escapou da validação ainda pode ser contida se o comportamento anômalo for percebido a tempo.
| Prática | Falha que ela evita | Sinal de que está frágil |
|---|---|---|
| Autenticação com segundo fator e token validado | Token forjado e senha vazada | Token aceito sem conferir emissor e assinatura |
| Autorização por objeto no ponto único | Acesso a dado de outro usuário | Checagem espalhada e esquecida em endpoint novo |
| Validação com lista de permissão | Injeção e dado malformado | Regra de negócio recebendo entrada sem formato definido |
| Limite de uso e paginação | Força bruta e esgotamento | Listagem devolvendo base inteira sem teto |
| Cofre de segredos e transporte seguro | Vazamento de credencial | Chave em código ou em repositório |
| Inventário e monitoramento | Superfície esquecida e intrusão silenciosa | Versão antiga no ar sem dono conhecido |
Lista de verificação antes da publicação
- Cada endpoint tem identidade exigida e permissão mínima definida?
- Toda consulta a dado de usuário filtra pelo dono do recurso?
- Entrada é validada por formato, tamanho e faixa, e saída devolve só o necessário?
- Limite de uso, paginação e teto de corpo estão ativos nas rotas sensíveis?
- Segredos estão em cofre, com rotação e acesso auditado?
- Versão antiga e recurso de depuração estão desativados ou com data de encerramento?
- Log registra o essencial sem dado sensível e gera alerta para padrão anômalo?
ℹ️ Info: revise a lista em cada mudança de contrato, não só no lançamento. A maior parte das falhas nasce em endpoint novo adicionado depois que o padrão de segurança já estava estabelecido no restante da API.
Para quem quer aprofundar no desenho de API moderna e praticar integração entre serviços, a Samsung Ocean abre em 07/10, às 16:00, o curso online e gratuito Programação Backend com gRPC: Construindo APIs Modernas e Escaláveis, com uma aula. Segurança se constrói sobre desenho claro, e é isso que a aula entrega.
Perguntas frequentes
Qual é a diferença entre autenticação e autorização em uma API?
Autenticação prova quem está chamando, por token, certificado ou outro mecanismo. Autorização decide o que aquele cliente pode fazer com aquele recurso específico. Confundir as duas é a causa mais comum de furo de acesso.
O que é autorização quebrada em nível de objeto?
É quando o usuário autenticado acessa o registro de outra pessoa trocando o identificador na requisição. A API confere se ele está logado, mas não confere se o objeto pertence a ele. A correção é filtrar toda consulta pelo dono do recurso.
Preciso usar OAuth 2.0 em qualquer API?
Não em qualquer uma, mas é o padrão consagrado para delegação de acesso e para integração com provedor de identidade. API interna simples pode usar outro mecanismo, desde que valide identidade, permissão e expiração com o mesmo rigor.
Basta HTTPS para proteger a API?
Não. HTTPS protege o transporte, não impede acesso indevido, injeção ou vazamento na resposta. Ele é um dos controles, e precisa vir acompanhado de autenticação, autorização, validação e monitoramento.
Com que frequência revisar a segurança da API?
A cada mudança de contrato, endpoint novo ou alteração de permissão, além de uma revisão periódica do inventário. Segurança de API é processo contínuo: a superfície muda junto com o produto, e a lista precisa acompanhar.