api-shield/1.0.0 · atualizado em 9 de jul. de 2026

Proteção de APIs

Como operar limites de taxa, reputação e rotas de integração sem perder visibilidade.

O API Shield protege rotas de integração, automações e consumo programático com uma avaliação diferente da aplicada a um formulário operado por uma pessoa.

A prioridade não é apenas bloquear requests anômalos: também é preciso evitar quebrar integrações válidas, distinguir tráfego institucional de scraping e manter Evidence quando uma limitação afeta um serviço relevante.

Cruzar o API Shield com Access, WAF e Secrets ajuda a responder a casos em que o risco não está em uma única request, mas na credencial, no túnel ou na postura da origem.

Checklist

• Identificar rotas de integração críticas.
• Verificar se a origem usa credenciais, túneis ou sessões conhecidas.
• Sustentar a decisão com Evidence se a medida alterar a continuidade do serviço.

Início rápido

1. Comece pela rota de integração, não apenas pela request isolada.
2. Confira se a API está ligada a Secrets, Access ou credenciais ativas.
3. Use tasks quando o ajuste exigir coordenação com outra área.

Fluxo operacional

Contextualizar

Leia a rota, a origem e a continuidade esperada do serviço.

Evitar bloqueios cegos em APIs com dependências posteriores.

Relacionar

Cruze o sinal com Secrets, Access ou keyring para saber se a confiança mudou.

Verificar se o problema é tráfego, identidade ou credencial.

Acordar a resposta

Crie uma task ou incident quando a mitigação envolver várias equipes.

Manter a governança sobre mudanças sensíveis.

flowchart LR
  S1["Contextualizar"]
  S2["Relacionar"]
  S3["Acordar a resposta"]
  S1 --> S2
  S2 --> S3

Validadores e verificações

Executam uma leitura contextual desta superfície e devolvem passos sugeridos com foco operacional.

Validar a proteção da API

Retorna checks e artigos para rotas integradas ou automatizadas.

Exemplos

Payload para revisar uma API exposta

{
  "moduleKey": "api-shield",
  "query": "token reuse scraping",
  "domain": "api.capacero.ar"
}

Links e referências

Rotas relacionadas

API Shield no workspace Secrets

APIs

/api/adda/v1/shields/events
/api/adda/v1/secrets/status
/api/adda/v1/access/status

Docs e rotas de apoio

docs/ADDA_API.md
docs/ADDA_WAF.md

Problemas frequentes

• Tratar tráfego programático como navegação humana desorganiza a resposta.
• Ajustar a defesa sem revisar Secrets ou Access pode manter ativa a causa do risco.

Ações sugeridas

• Cruzar sempre o sinal com credenciais, sessões ou túneis relacionados.
• Se uma API sustentar processos críticos, priorizar limitação e rastreabilidade antes de um bloqueio abrupto.

Reason codes úteis

Dicionário de score

wafRiskScore

Risco detectado na rota ou no formulário observado.

decision

Ação decidida: permitir, verificar, limitar ou bloquear.

matchedRules

Regras que explicam por que a proteção foi ativada.

Notas do protocolo

• A continuidade do serviço importa tanto quanto a contenção do abuso.

Histórico do artigo

9 de jul. de 2026

Novo artigo do API Shield com foco em continuidade, credenciais e coordenação.