Os testes de segurança de API começam com uma pergunta incômoda: quantos endpoints seu aplicativo expõe hoje? Não os que estão na especificação OpenAPI, mas os que seu código realmente atende.
Para a maioria das equipes, esses dois números não coincidem. A especificação foi escrita há meses, o código continuou evoluindo e, ao longo do caminho, surgiram rotas internas, endpoints de exportação e versões antigas que ninguém documentou. Essas são APIs ocultas, e você não pode testar o que ninguém sabe que existe.
TL, DR
Testes de segurança de API em duas camadas: inventário a partir do código e comprovação em tempo de execução.
Você não pode proteger APIs que desconhece. Os testes de segurança de APIs começam com um inventário confiável, e a fonte mais confiável é o próprio código, não a especificação.
- Desvio de estoque: A comparação entre o código e a especificação revela endpoints que existem, mas não estão documentados (APIs sombra) e operações documentadas que não são mais utilizadas (APIs órfãs), ambas sob [texto ilegível]. OWASP API9:2023.
- Falhas no manipulador: Muitos problemas de API não são bugs de injeção. São falhas como a falta de uma verificação de propriedade (BOLA), uma rota administrativa sem verificação de função ou uma resposta que retorna mais campos do que deveria. A melhor maneira de identificá-los é lendo o manipulador de eventos.
- Comprovação em tempo de execução: Os testes em tempo de execução confirmam o que o código sugere: quais endpoints respondem sem autenticação, onde o seu gateway já compensa essa limitação e o que é explorável na aplicação implantada.
- Uma descoberta por problema: Juntas, as duas camadas fornecem uma única descoberta por problema, classificada pelos dados que expõe (pessoais, de pagamento, de saúde, credenciais).
O primeiro passo: Crie seu inventário de APIs a partir do código, compare-o com sua especificação OpenAPI e, em seguida, direcione os testes de tempo de execução para o catálogo completo, não apenas para a parte documentada.
Por que os testes de segurança de API típicos falham?
A maioria das equipes protege suas APIs com três elementos: um gateway que impõe autenticação na borda, um scanner que percorre as especificações e um teste de penetração manual uma ou duas vezes por ano. Todos os três ajudam, mas compartilham um ponto cego.
Todos dependem de alguém saber quais endpoints existem. O scanner testa apenas o que está na especificação. O teste de penetração cobre o escopo que lhe foi dado. E o gateway impõe autenticação na borda, mas não consegue ver que o manipulador nunca verifica se o pedido 4512 pertence ao usuário que o solicitou.
É por isso que o Top 10 de segurança da API OWASP dedica uma categoria inteira à gestão inadequada de estoque (API9:2023), e por que seu principal risco é a Autorização em Nível de Objeto Quebrada (API1): uma falha lógica sem assinatura e sem padrão de injeção.
Camada 1: um inventário de APIs construído a partir de código
Os testes de segurança de API confiáveis começam com um inventário construído a partir da única fonte que não se altera: o código. Segurança da API Xygeni Analisa os seus manifestos de dependência, detecta os frameworks web que você utiliza e extrai todos os endpoints, incluindo rotas declaradas em diversos arquivos.
Ele lê frameworks web populares nas principais linguagens do lado do servidor, como Spring Boot, ASP.NET Core, Django, FastAPI, Express e Laravel, além de OpenAPI 3.x e as especificações do Swagger 2.x. O resultado é um catálogo de serviços, módulos e endpoints, com seus métodos, parâmetros, corpos de requisição e formatos de resposta.
Com o código e as especificações lado a lado, a discrepância torna-se óbvia:
- APIs paralelas: endpoints que o código atende, mas que a especificação não documenta.
- APIs órfãs: operações de especificação que nenhum manipulador atende mais.
Se você não estiver pronto para ativar a detecção, o modo de descoberta cria o catálogo e suas lacunas automaticamente. É uma boa maneira de iniciar a conversa com as equipes de desenvolvimento sem gerar ruído no primeiro dia.
Que falhas você detecta ao ler o manipulador?
Muitas falhas de API não são bugs de injeção: são verificações ausentes. Como o Xygeni lê rotas, manipuladores e especificações em conjunto, ele consegue identificar falhas que os scanners baseados em padrões não conseguem. Cada descoberta é mapeada para sua categoria no OWASP API Security Top 10 (2023) e para o CWE.
Falhas na API que você detecta lendo o código.
Cada defeito corresponde à sua categoria no Top 10 de segurança da API OWASPAssim, as conclusões falam a mesma língua que seus auditores e testadores de intrusão.
| Falha | O que ele procura no código | categoria OWASP |
|---|---|---|
| Autorização de nível de objeto quebradoBOLA / IDOR | Endpoints que carregam um objeto por um ID da requisição sem verificar se ele pertence ao usuário. | API1 |
| Exposição excessiva de dados | Respostas que retornam mais campos do que o necessário | API3 |
| Autorização de nível de função quebrada | Rotas administrativas sem verificação de função | API5 |
| Pontos de extremidade não autenticados e atribuição em massa | Rotas abertas e órgãos de solicitação que aceitem campos que não deveriam. | API2 e API3 |
| APIs sombra e órfãs | Diferenças entre código e especificação | API9 |
Para o BOLA, a análise por linguagem verifica a propriedade dos dados, o escopo do repositório e a vinculação de identidades. Ela também resolve as regras de autorização declaradas centralmente na configuração do seu framework, e você pode adicionar os nomes das suas próprias funções de verificação de propriedade para reduzir ainda mais o ruído. As APIs GraphQL têm suas próprias verificações específicas.
O detalhe que muda a priorização: cada campo é etiquetado como dado pessoal, de pagamento, de saúde, de credencial ou criptográfico. Um endpoint não autenticado que retorna dados pessoais é classificado como crítico, em vez de se perder na fila atrás de uma centena de ocorrências menores.
Camada 2: testes em tempo de execução
O código indica o que pode acontecer. Os testes em tempo de execução indicam o que de fato acontece. Um teste completo de segurança de API exige ambas as perspectivas, e o Xygeni as conecta por meio do mesmo inventário de endpoints em três níveis:
- Verificação ao vivo da segurança da API. Ele envia uma solicitação não destrutiva para cada endpoint candidato para confirmar ou refutar as descobertas de autenticação. Se o ambiente responder com 401 ou 403, a descoberta é marcada como refutada: prova de que seu gateway já compensa isso.
- Xygeni DAST. Ele testa a execução de aplicativos web e APIs a partir de uma imagem Docker assinada, executada em seus próprios ambientes de CI ou rede interna. Em relação à produção, utiliza intensidade passiva, que não envia payloads de ataque. Para testes ativos, recomenda-se um ambiente de staging com uma conta de teste.
- Testes de penetração com IA. Um agente de IA planeja e executa ataques não prejudiciais contra alvos autorizados para comprovar quais descobertas são exploráveis, mapeadas de acordo com o OWASP API Security Top 10.
Um problema, uma descoberta
A vantagem de combinar o inventário com os testes em tempo de execução não está em gerar mais alertas, mas sim em gerar menos alertas, porém de melhor qualidade. AI SAST As descobertas no manipulador, as descobertas do DAST no endpoint em execução e as falhas da API estão correlacionadas no ASPM Gráfico de risco, com etiquetas de sensibilidade anexadas.
Inventário de API a partir de código versus testes em tempo de execução
Nenhuma das camadas substitui a outra. Os testes completos de segurança de API utilizam ambas, conectadas através do mesmo inventário de endpoints:
| Dimensão | Inventário de API a partir do código | Testes em tempo de execução |
|---|---|---|
| Quando ele funciona | Antes da implantação, em cada pull request | Contra a aplicação implantada (em ambiente de teste ou passiva em produção) |
| O que ela vê melhor | APIs paralelas, BOLA, ausência de verificação de funções, exposição de dados | O que realmente responde à questão é a configuração do ambiente e a capacidade de exploração. |
| O que isso proporciona à outra camada | O catálogo completo de endpoints para teste. | Confirmação ou refutação do que o código sugere. |
Uma falha no manipulador e no endpoint exposto que o alcança constituem um único problema, com um único responsável. E se você já utiliza outra ferramenta DAST, o Xygeni importa os resultados dela para a mesma visualização de risco, sem solicitar que você a substitua.
Quer ver as duas camadas trabalhando juntas? Assista à nossa sessão. Do código ao tempo de execução: por quê? SAST + DAST são ambos essenciais para a segurança de aplicativos moderna., onde analisamos como as descobertas no código e os testes em tempo de execução se confirmam mutuamente.
Como integrar os testes de segurança de API ao seu ciclo de vida de desenvolvimento
O padrão que funciona melhor para equipes de médio porte é simples:
- Em cada pull request: Segurança de API em CI no código alterado, além de verificações incrementais do DAST.
- Antes commit: como um pre-commit portão em arquivos em etapas.
- À noite ou na fusão: Uma varredura DAST completa.
- Antes de cada grande lançamento: Testes de penetração com IA em ambiente de teste para validar o backlog e confirmar se cada correção solucionou a vulnerabilidade.
O scanner de segurança de API funciona em qualquer lugar, incluindo ambientes isolados da internet, e envia relatórios para o Xygeni SaaS ou para o seu sistema. on-premise plataforma. Os resultados são exibidos em formato JSON. SARIF 2.1.0, CSV e Markdown para pull request comentários.
Testes e conformidade de segurança de API
Para equipes nos setores bancário, de seguros ou público, os testes de segurança de API também servem como comprovação. Cada resultado encontrado carrega etiquetas de conformidade para Artigo 32 do RGPD, PCI-DSS 4.0 (requisitos 3.4, 6.4.3, 7.1, 7.2 e 8) e NISTSP 800-53 (AC-3, AC-6, IA-2, IA-5), visíveis na plataforma e na saída JSON e SARIF.
Se a sua organização se enquadra em DORA or NIS2Os testes em tempo de execução fornecem evidências contínuas entre os testes de penetração manuais que seus órgãos reguladores ainda exigem.
Teste a API que você realmente utiliza, não a que você documentou.
Os testes de segurança de API que se limitam a ler a especificação testam a API que você acha que tem, e não a que você realmente utiliza. Comece com um inventário baseado no código, confirme-o com testes em tempo de execução e classifique cada falha de acordo com os dados que o endpoint expõe.
Quer ver todos os endpoints que seu código expõe? Agende uma sessão com um engenheiro para criar o inventário de APIs de um dos seus repositórios e analisar os resultados. Ou comece hoje mesmo gratuitamente com a análise de código e dependências!
Perguntas Frequentes
Preciso realizar testes de segurança de API se já possuo um gateway de API?
Sim. Um gateway impõe autenticação na borda, mas não consegue detectar uma verificação de propriedade ausente dentro de um manipulador ou uma resposta que retorna campos em excesso. A verificação em tempo real do Xygeni mostra até mesmo onde seu gateway já compensa isso, marcando essas constatações como refutadas.
Como encontro APIs ocultas ou não documentadas?
Compare o que seu código oferece com o que sua especificação documenta. O Xygeni API Security faz isso automaticamente: ele descobre endpoints no código-fonte, sinaliza aqueles ausentes na sua especificação OpenAPI ou Swagger como APIs sombra e sinaliza operações da especificação sem um manipulador como órfãs.
É seguro executar testes de tempo de execução em ambiente de produção?
Com a intensidade passiva do Xygeni DAST, sim: ele não envia payloads de ataque, permite limitar a taxa de requisições e identifica seu tráfego com o cabeçalho X-Xygeni-DAST. Para testes ativos e testes de penetração com IA, recomenda-se um ambiente de homologação com uma conta de teste.







