adda-signal-protocol/1.1.0 · atualizado em 8 de jul. de 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.

Checklist

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

Início rápido

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

Fluxo operacional

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

Validadores e verificações

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

Validar receta del protocolo

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

Exemplos

Score explicable sobre sesión

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

Links e referências

Rotas relacionadas

Consola ADDA Inspector público

APIs

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

Docs e rotas de apoio

docs/ADDA_PROTOCOLO.md
docs/ADDA_API.md

Problemas frequentes

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

Ações sugeridas

• 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 codes úteis

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.

Dicionário de 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.

Notas do protocolo

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

Histórico do artigo

9 de jul. de 2026

Se agregó glosario operativo de scores y reason codes.