Aduana Digital de Defensa Argentina
Crea accesso ADDA
← Manuale ADDA

api-shield/1.0.0 · aggiornato il 9 lug 2026

Protezione delle API

Come gestire rate limit, reputazione e percorsi di integrazione senza perdere visibilità.

API Shield protegge percorsi di integrazione, automazioni e consumo programmatico con una valutazione diversa da quella di un modulo usato da una persona.

La priorità non è soltanto bloccare le request anomale: occorre anche evitare di interrompere integrazioni valide, distinguere il traffico istituzionale dallo scraping e mantenere Evidence quando una limitazione incide su un servizio rilevante.

Confrontare API Shield con Access, WAF e Secrets aiuta a gestire i casi in cui il rischio non risiede in una singola request, ma nella credenziale, nel tunnel o nella postura dell'origine.

Lista di controllo

  • • Identificare i percorsi di integrazione critici.
  • • Verificare se l'origine utilizza credenziali, tunnel o sessioni note.
  • • Sostenere la decisione con Evidence se la misura modifica la continuità del servizio.

Avvio rapido

  1. 1. Parti dal percorso di integrazione, non soltanto dalla request isolata.
  2. 2. Verifica se l'API è collegata a Secrets, Access o credenziali attive.
  3. 3. Usa le tasks quando la modifica richiede il coordinamento con un'altra area.

Flusso operativo

Contestualizzare

Leggi il percorso, l'origine e la continuità attesa del servizio.

Evitare blocchi ciechi sulle API con dipendenze a valle.

Mettere in relazione

Confronta il segnale con Secrets, Access o keyring per capire se la fiducia è cambiata.

Stabilire se il problema riguarda traffico, identità o credenziali.

Concordare la risposta

Crea una task o un incident quando la mitigazione coinvolge più team.

Mantenere la governance sulle modifiche sensibili.

flowchart LR
  S1["Contestualizzare"]
  S2["Mettere in relazione"]
  S3["Concordare la risposta"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

Eseguono una lettura contestuale di questa superficie e restituiscono passaggi suggeriti con un taglio operativo.

Convalidare la protezione API

Restituisce checks e articoli per percorsi integrati o automatizzati.

Esempi

Payload per esaminare un'API esposta

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

Link e riferimenti

APIs

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

Docs e route di supporto

  • docs/ADDA_API.md
  • docs/ADDA_WAF.md

Problemi frequenti

  • • Trattare il traffico programmatico come navigazione umana disordina la risposta.
  • • Regolare la difesa senza esaminare Secrets o Access può lasciare attiva la causa del rischio.

Azioni suggerite

  • • Confrontare sempre il segnale con credenziali, sessioni o tunnel correlati.
  • • Se un'API sostiene processi critici, dare priorità a limitazione e tracciabilità prima di un blocco improvviso.

Reason code utili

Dizionario degli score

wafRiskScore

Rischio rilevato sul percorso o sul modulo osservato.

decision

Azione decisa: consentire, verificare, limitare o bloccare.

matchedRules

Regole che spiegano perché è stata attivata la protezione.

Note di protocollo

  • • La continuità del servizio conta quanto il contenimento degli abusi.

Cronologia dell'articolo

9 lug 2026

Nuovo articolo su API Shield incentrato su continuità, credenziali e coordinamento.