Inicio/Artículo
Esadax JournalCI

Integración de drenajes de troncos Esadax con cualquier backend

Para recibir y manejar registros de Esadax usando Log Drains, siga los pasos agnósticos de marco a continuación. Estos se aplican a cualquier backend que admita el enrutamiento HTTP y la configuración

Para recibir y manejar registros de Esadax usando Log Drains, siga los pasos agnósticos de marco a continuación. Estos se aplican a cualquier backend que admita el enrutamiento HTTP y la configuración del entorno.


1. Aplicación. Configurar un punto final

Cree un punto final HTTP (por ejemplo, /esadax/logs) en su aplicación que acepte solicitudes POST. Este punto final recibirá datos de registro de Esadax.

  • Asegúrese de que admita cargas útiles JSON.
  • Solo acepta solicitudes POST por seguridad y coherencia.

Ejemplo (pseudocódigo):

POST /esadax/logs
Content-Type: application/json
Body: { logs: [...] }

2. Seguridad con verificación de firma

Esadax envía un encabezado de firma (x-esadax-signature) con cada carga útil de registro.

  • Establezca un INTEGRATION_SECRET en su entorno (desde su tablero de Esadax).
  • Utilice este secreto para verificar la firma y asegurarse de que la solicitud es de Esadax.

Ejemplo de verificación de firma (pseudocódigo estilo Node.js):

const crypto = require('crypto');

function verifySignature(secret, body, signature) {
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(body);
  const expectedSig = hmac.digest('hex');
  return expectedSig === signature;
}

3. Configuración de drenaje de registros en Esadax

En el tablero de Esadax:

  • Definir fuentes: Elija las fuentes de registro (por ejemplo, lambda, edge o static).
  • Seleccionar entornos: Selecciona solo los entornos relevantes (como production o staging).
  • Establecer frecuencia de muestreo: Opcionalmente, limite el volumen del registro (por ejemplo, 50% de frecuencia de muestreo).

4. Asegure la comunicación

  • Usar HTTPS: Su punto final de registro debe servirse a través de HTTPS para proteger los datos en tránsito.
  • Validar Encabezados e IPs (opcional): Si desea una protección extra, restrinja las solicitudes entrantes a las IPs de Esadax o valide User-Agent.

Artículo 5. Manejar y almacenar registros

Una vez verificada, analice la carga útil y reenvíela a su herramienta de almacenamiento o análisis de registros preferida (por ejemplo, Datadog, Loki, Sentry, Elasticsearch).

Ejemplo de flujo de manejo de registros:

  • Validar → Analizar → Filtrar (opcional) → Almacenar o alertar

Artículo 6. Responda de manera apropiada

Responda siempre a Esadax con el código de estado HTTP correcto:

  • 200 OK: Recibida y verificada correctamente la carga útil
  • 400 Bad Request: Datos mal formados o faltantes
  • 403 Forbidden: Firma no válida

Artículo 7. Prueba tu configuración

Antes de ir en vivo:

  • Use curl o Postman para enviar cargas útiles simuladas.
  • Pruebe con firmas válidas e inválidas para verificar su lógica.
  • Compruebe los registros y las herramientas de observabilidad para garantizar que los registros se capturen y almacenen correctamente.

Prueba de rizo de ejemplo (Reemplace con su lógica secreta)

curl -X POST https://yourdomain.com/esadax/logs \
  -H "Content-Type: application/json" \
  -H "x-esadax-signature: <calculated_signature>" \
  -d '{ "logs": [...] }'

1. Resumen

Escalón Descripción
1 Crear un extremo de registro seguro
2 Implementar la verificación de firmas
3 Configurar drenajes de troncos en Esadax
4 Usa HTTPS y la validación de IP opcional
5 Datos de registro de procesos y rutas
6 Enviar respuestas HTTP adecuadas
7 Probar la configuración con cargas útiles válidas/inválidas

Suscribirse