Het idee
Een webhook laat een ander systeem een endpoint informeren over veranderingen. Het openbare endpoint ontvangt invoer van buiten zijn vertrouwensgrens. Authenticatie, bescherming tegen herhaling en invoerlimieten horen daarom bij het berichtontwerp.
Ontwerpkeuze
Controleer de afzender met het gedocumenteerde ondertekeningsschema voordat u op de inhoud handelt. Controleer tijdstempels wanneer het schema die ondersteunt, beperk de berichtgrootte en bewaar de gebeurtenis-ID. Bevestig geaccepteerd werk snel en gebruik zo nodig een duurzame wachtrij.
Uitgewerkt voorbeeld
Een documentdienst ontvangt een ondertekende wijzigingsmelding. De dienst controleert de oorspronkelijke verzoekbytes, slaat de gebeurtenis eenmaal op en plant het ophalen van het actuele document. Een herhaalde melding leidt niet tot dubbele verwerking.
Voor ingebruikname
- Controleer voordat invoer vertrouwde toestand wordt.
- Test ongeldige en herhaalde handtekeningen.
- Bewaar ondertekeningssleutels buiten versiebeheer.
De voorbeelden zijn illustratief. Pas de controles aan uw eigen omgeving aan.