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_SECRETin 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,edgeofstatic). - Selecteer omgevingen: Target alleen relevante omgevingen (zoals
productionofstaging). - 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 geverifieerd400 Bad Request: Misvormde of ontbrekende gegevens403 Forbidden: Ongeldige handtekening
Zeven. Test uw opstelling
Voordat je live gaat:
- Gebruik
curlof 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 |
