Aduana Digital de Defensa Argentina
ADDA-Zugang erstellen
← ADDA-Handbuch

adda-signal-protocol/1.1.0 · aktualisiert am 08.07.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.

Checkliste

  • • 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.

Schnellstart

  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.

Operativer Ablauf

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

Validatoren und Prüfungen

Sie führen eine kontextbezogene Auswertung dieser Oberfläche aus und liefern vorgeschlagene Schritte mit operativem Fokus.

Validar receta del protocolo

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

Beispiele

Score explicable sobre sesión

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

Links und Referenzen

APIs

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

Docs und unterstützende Routen

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

Häufige Probleme

  • • 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.

Empfohlene Aktionen

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

Nützliche Reason Codes

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.

Score-Wörterbuch

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.

Protokollhinweise

  • • 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.

Artikelverlauf

09.07.2026

Se agregó glosario operativo de scores y reason codes.