API-integraties vereisen niet alleen toegangscontrole, maar ook waarborging van de authenticiteit en integriteit van elk verzoek. Om dit te doen, ondersteunen we HMAC-handtekeningen (Hash-based Message Authentication Code), evenals encryptie van het lichaam en de parameters van verzoeken, het waarborgen van gegevensbescherming, zelfs wanneer verzonden via open netwerken.
Met behulp van HMAC bevestigt elke partij (client en server) dat het verzoek is gemaakt door een geautoriseerde partij, niet is gewijzigd langs het pad, en heeft gecodeerde inhoud.
Wat wordt geïmplementeerd?
| Mechanisme | Doel en voordelen |
|---|---|
| HMAC-handtekeningen | Teken elk verzoek met een private sleutel |
| Integriteitscontrole | Controleren of de inhoud niet is gewijzigd tijdens uploaden |
| Body Encryptie aanvragen | Gebruik AES of RSA om gevoelige gegevens te beschermen |
| Getekend met tijdstempel | Replay-aanvalsbescherming |
| Query-parameters ondertekenen | Validatie van query string en payload via hash functie |
Hoe werkt het?
1. De klant genereert een aanvraagorgaan en voegt een tijdstempel toe
2. Berekend door HMAC (bijv. SHA256) gebaseerd op geheim en inhoud
3. De handtekening wordt toegevoegd aan de header (bijvoorbeeld 'X-Signature')
4. Server verifieert handtekening, tijdstempel en geldig IP
5. Als de handtekening overeenkomt, wordt het verzoek uitgevoerd, anders wordt het afgewezen
Voordelen voor API-integraties
Bescherming tegen vervanging of vervalsing van het verzoek
Mogelijkheid om veilig te communiceren zonder TLS (in gesloten netwerken)
Meer vertrouwen in de datalink
Platform of taalspecifieke onafhankelijkheid
Flexibele implementatie voor verschillende soorten klanten: kassa's, gateways, providers
Waar vooral belangrijk
Integratie met betalings-, contante of fiscale systemen
API's in een multi-lease of partner omgeving
Systemen met toegenomen eisen inzake verificatie van verzoeken
Interactie tussen interne diensten zonder permanente vergunning
HMAC handtekening en encryptie is uw API slot tegen namaak en tampering. Dergelijke mechanismen stellen u in staat om betrouwbare integratie te bouwen, zelfs in omstandigheden van verhoogde beveiligingsvereisten.