Servant combinators to facilitate writing GitHub webhooks. https://github.com/tsani/servant-github-webhook
|Latest on Hackage:||0.3.1.0|
This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.
This library facilitates writing Servant routes that can safely act as GitHub webhooks.
- Dispatching to routes based on the type of repository event.
- Automatic verification of request signatures.
- Route protection expressed in the type system, so webhook routes and regular routes cannot be confused.
Why use servant-github-webhook?
A webhook server needs to be publicly hosted. How can legitimate requests sent by GitHub be distinguished from (malicious) requests sent by other clients?
When a webhook is configured on a repository, a secret key is added. This key is used by GitHub to compute a signature of the request body that it sends; this signature is included in the request headers. The routing combinators in servant-github-webhook compute the signature of the received request body using the same key, and check that the signature in the request headers matches. If it does, then the request is legitimate.
Revision history for servant-github-webhook
0.3.1.0 -- 2017-08-06
- Drop support for GHC <8.
- Drop support for Servant <0.11.
- Switch from Crypto package to cryptonite package.
- Now servant-github-webhook builds with stack.
0.3.0.0 -- 2016-09-22
Pass reflected key index to the handler function for GitHubSignedReqBody. This allows for more generic handler functions, as they can determine programmatically which repository they are responding to.
0.2.0.1 -- 2016-09-13
Improve documentation (formatting and typos) and examples (remove unnecessary verbosity).
0.2.0.0 -- 2016-09-11
GitHubSignedReqBody''to allow for configuring multiple signing keys, on a per-route basis.
GitHubKeytake a function instead of simply an
KProxy, to make writing
0.1.0.0 -- 2016-09-10
GitHubSignedReqBodycombinator for automatic signature verification during routing.
GitHubEventcombinator for dispatching to routes based on the webhook type.
- Known issue: only one global
GitHubKeycan be used across all routes.