Drongo

El grupo de comandos drongo gestiona la conexión, autenticación mTLS, telemetría y reglas conductuales con el motor centralizado Drongo.

Acciones disponibles

Acción	Descripción
`status`	Muestra el estado del emparejamiento, modo de autenticación, transporte y métricas del outbox.
`test`	Verifica la conectividad y credenciales con el endpoint HTTP o brokers Kafka de Drongo.
`dispatch`	Drena eventos de contexto acumulados en la tabla outbox hacia Drongo.
`sync-feed`	Descarga el feed de reglas conductuales de Drongo y las despliega inmediatamente en los sensores.
`token`	Genera un token OTP de emparejamiento de un solo uso (válido 15 minutos).
`enroll`	Emite credenciales mTLS y completa el emparejamiento directamente en local.

Para consultar las opciones y ejemplos detallados de cada comando desde el terminal, ejecute suricatavel drongo help.

Consultar estado de la integración

Muestra si el nodo está emparejado, el modo de autenticación (mTLS/Bearer), el transporte (Kafka/HTTP) y las métricas de la cola outbox:

suricatavel drongo status

Probar conectividad

Comprueba la alcanzabilidad y credenciales con el destino configurado:

suricatavel drongo test

Drenar cola outbox

Envía eventos de contexto pendientes hacia Drongo:

# Procesar lotes pendientes con límites personalizados
suricatavel drongo dispatch --limit=100 --max-attempts=5 --time-budget=50

Opciones de `dispatch`

--limit: Número máximo de registros a enviar por ciclo (por defecto: tamaño de lote configurado).
--max-attempts: Intentos máximos antes de marcar un registro como fallido (por defecto: 5).
--time-budget: Tiempo límite en segundos para vaciar la cola outbox (0 sin límite, por defecto: 50).

Sincronizar feed de reglas

Fuerza la descarga inmediata de reglas conductuales publicadas por Drongo y las despliega en los sensores Suricata:

suricatavel drongo sync-feed

Generar token de emparejamiento

Genera un token de un solo uso (OTP) para que un nodo remoto de Drongo se registre a través de POST /api/v1/drongo/pki/enroll:

suricatavel drongo token

Enrolar nodo de Drongo

Emite certificados mTLS firmados por la CA interna de Suricatavel y activa el emparejamiento:

# Auto-generar clave privada, certificado y CA en el directorio especificado:
suricatavel drongo enroll --out-dir=/etc/drongo/certs

# Firmar un CSR generado previamente por Drongo:
suricatavel drongo enroll --csr=/etc/drongo/drongo.csr --cert-out=/etc/drongo/drongo.crt --force

Opciones de `enroll`

--out-dir: Directorio donde guardar drongo.crt, drongo.key y ca.crt.
--csr: Ruta al archivo CSR de entrada para firma directa.
--cert-out: Ruta destino del certificado firmado.
--key-out: Ruta destino de la clave privada generada.
--ca-out: Ruta destino del certificado de la CA raíz.
--validity: Días de validez del certificado emitido (por defecto: 365).
--force: Sobreescribe los archivos existentes si ya existen.