brandembassy / hmac-request-signature
Installs: 86 440
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 7
Forks: 1
Open Issues: 0
Requires
- guzzlehttp/guzzle: ^7.5
Requires (Dev)
- brandembassy/coding-standard: ^10.0
- phpunit/phpunit: ^9.6
- roave/security-advisories: dev-latest
This package is auto-updated.
Last update: 2024-12-07 23:59:54 UTC
README
This small library will allow you to sign http reuqests for future verification. This is typically used as optional security in webhook consuming apps
Installation
composer require brandembassy/hmac-request-signature
Usage
Signed requests contains HTTP headers
X-Request-Signature: Signature itself (base64)
X-Signature-Algorithm: Algorithm used to calc signature (default: sha256)
How to sign your requests
You need to use RequestSignerMiddleware in guzzle client handlers stack, you can use SignedRequestsClientFactory::create('{{yourSecretKey}}').
This middleware will calc signature from request payload and secret key and provide it in request header X-Request-Signature.
How to validate request signature
Just use SignedRequestValidator::validateSignature where exception is thrown in case signature validation failed