Aduana Digital de Defensa Argentina
Crea accesso ADDA
← Manuale ADDA

adda-signal-protocol/1.1.0 · aggiornato il 8 lug 2026

ADDA Signal Protocol

Marco común para entender riesgo, decisiones y evidencia con un lenguaje compartido.

Protocolo adda-signal-protocol/1.0.0 para señales verificables.

Lista di controllo

  • • Verificar que la lectura quede registrada con fecha y versión.
  • • Confirmar que los motivos de la decisión puedan explicarse con claridad.
  • • Sellar evidence si hubo acción bloqueante o incidente.

Avvio rapido

  1. 1. Leé severity y action juntas: nunca una sin la otra.
  2. 2. Revisá los reason codes antes de justificar una medida frente a terceros.
  3. 3. Si la medida toca acceso, DNS, WAF o credenciales, dejá evidence asociada.

Flusso operativo

Normalizar

La señal entra con tipo, severidad, contexto y referencia de origen.

Mantener consistencia entre módulos y superficies públicas.

Explicar

Los reason codes convierten la lectura del motor en lenguaje utilizable por el equipo.

Documentar por qué se actuó y no solo qué se hizo.

Respaldar

Evidence, audit logs y governance conectan la decisión con su rastro institucional.

Conservar la trazabilidad antes de cerrar el flujo.

flowchart LR
  S1["Normalizar"]
  S2["Explicar"]
  S3["Respaldar"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

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

Validar receta del protocolo

Devuelve artículos y próximos pasos para decisiones explicables.

Esempi

Score explicable sobre sesión

{
  "domain": "login.capacero.ar",
  "ip": "203.0.113.10",
  "sessionId": "sess_demo_001"
}

Link e riferimenti

APIs

  • /api/adda/v1/trust/score
  • /api/adda/v1/events/ingest
  • /api/adda/v1/evidence/seal

Docs e route di supporto

  • docs/ADDA_PROTOCOLO.md
  • docs/ADDA_API.md

Problemi frequenti

  • • Tomar una acción solo por score, sin reason codes, vuelve opaca la operación.
  • • No registrar versión del criterio dificulta comparar decisiones entre campañas.

Azioni suggerite

  • • Escalar a verificación humana cuando los motivos sean pocos o contradictorios.
  • • Revisar manual, incidentes y evidence como una misma cadena de explicación.

Reason code utili

UA_SUSPICIOUS

El agente o la navegación parecen poco confiables.

Verificar o seguir de cerca antes de permitir sin control.

DNS_SUSPICIOUS

El dominio exhibe rasgos de riesgo o suplantación.

Cruzar con DNS, mail o intelligence antes de habilitar confianza.

BOT_HIGH

La automatización estimada es alta para el contexto.

Activar verificación o limitación progresiva.

Dizionario degli score

severity

Prioridad institucional de la señal en escala ADDA.

action

Siguiente paso operativo recomendado por el motor.

reasonCodes

Motivos explicables para justificar la lectura.

Note di protocollo

  • • La explicación es parte del producto, no un apéndice documental.
  • • Una señal ambigua bien tratada vale más que una decisión rápida sin respaldo.

Cronologia dell'articolo

9 lug 2026

Se agregó glosario operativo de scores y reason codes.