Startpagina/Artikel
Esadax JournalCI

Integratie van Esadax Log Drains met elke backend

Om logboeken van Esadax te ontvangen en te verwerken met behulp van Log Drains, volgt u de onderstaande framework-agnostische stappen. Deze zijn van toepassing op elke backend die HTTP-routing en

Om logboeken van Esadax te ontvangen en te verwerken met behulp van Log Drains, volgt u de onderstaande framework-agnostische stappen. Deze zijn van toepassing op elke backend die HTTP-routing en omgevingsconfiguratie ondersteunt.


1.1. Een eindpunt instellen

Maak een HTTP-eindpunt (bijvoorbeeld /esadax/logs) in uw toepassing dat POST-verzoeken accepteert. Dit eindpunt zal loggegevens ontvangen van Esadax.

  • Zorg ervoor dat het JSON-payloads ondersteunt.
  • Accepteer alleen POST-verzoeken voor beveiliging en consistentie.

Voorbeeld (pseudocode):

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

2. Veilig met handtekeningverificatie

Esadax stuurt een handtekening header (x-esadax-signature) met elke log payload.

  • Stel een INTEGRATION_SECRET in uw omgeving in (vanuit uw Esadax dashboard).
  • Gebruik dit geheim om de handtekening te verifiëren en ervoor te zorgen dat het verzoek afkomstig is van Esadax.

Voorbeeld van handtekeningverificatie (pseudocode in Node.js-stijl):

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;
}

Drie. Log Drain Configuratie op Esadax

In het Esadax dashboard:

  • Bronnen definiëren: Kies logboekbronnen (bijvoorbeeld lambda, edge of static).
  • Selecteer omgevingen: Target alleen relevante omgevingen (zoals production of staging).
  • Bemonsteringsfrequentie instellen: Beperk eventueel het logboekvolume (bijv. 50% samplefrequentie).

4.3 Contra-indicaties Beveilig de communicatie

  • Gebruik HTTPS: Uw logeindpunt moet worden geserveerd via HTTPS om gegevens tijdens de overdracht te beschermen.
  • Headers en IP's valideren (optioneel): Als u extra bescherming wilt, beperkt u inkomende verzoeken tot Esadax IP's of valideert u User-Agent.

Vijf. Logboeken verwerken en opslaan

Na verificatie analyseert u de payload en stuurt u deze door naar uw favoriete logboekopslag- of analysetool (bijvoorbeeld Datadog, Loki, Sentry, Elasticsearch).

Voorbeeld logboekverwerkingsstroom:

  • Valideren → Analyseren → Filteren (optioneel) → Opslaan of waarschuwen

- Zes. Reageer op gepaste wijze

Reageer altijd op Esadax met de juiste HTTP-statuscode:

  • 200 OK: De payload is succesvol ontvangen en geverifieerd
  • 400 Bad Request: Misvormde of ontbrekende gegevens
  • 403 Forbidden: Ongeldige handtekening

Zeven. Test uw opstelling

Voordat je live gaat:

  • Gebruik curl of Postman om gesimuleerde payloads te verzenden.
  • Test met zowel geldige als ongeldige handtekeningen om uw logica te verifiëren.
  • Controleer logboeken en observability-tools om ervoor te zorgen dat logboeken correct worden vastgelegd en opgeslagen.

Voorbeeld curl Test (Vervang door uw geheime logica)

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

Samenvatting

Stap Beschrijving
1 Een beveiligd logeendpunt maken
2 Implementeer handtekeningverificatie
3 Logafvoeren configureren in Esadax
4 Gebruik HTTPS en optionele IP-validatie
5 Proces- en routeloggegevens
6 Correcte HTTP-reacties verzenden
7 Test de setup met geldige/ongeldige payloads

Abonneren