2021-07-28 15:20:06 +00:00
|
|
|
# gohookr
|
|
|
|
|
|
|
|
A _really_ simple webhook receiver.
|
|
|
|
|
|
|
|
Check config.json for an example configuration.
|
|
|
|
|
|
|
|
Default config path is `/etc/ghookr.conf`, can be overriden with `CONFIG` environment variable.
|
2021-07-29 06:35:16 +00:00
|
|
|
|
|
|
|
## Signature Verification
|
|
|
|
|
|
|
|
Signature verificaiton is done using SHA256 HMACs.
|
|
|
|
You can set which header gohookr will receive a signature from using the `SignatureHeader` key for
|
|
|
|
each service.
|
|
|
|
You can also specify a shared secret in the `Secret` key.
|
|
|
|
|
|
|
|
### Disable Signature Verification
|
|
|
|
|
|
|
|
You can disable signature verification altogether by setting environment variable `NO_SIGNATURE_VERIFICATION`
|
|
|
|
to `true`.
|
|
|
|
|
|
|
|
## Tests
|
|
|
|
|
|
|
|
gohookr can run test before running your script.
|
|
|
|
Tests must be in the form of bash scripts.
|
|
|
|
A non-zero return code is considered a fail and gohookr will run no further tests and will not
|
|
|
|
deploy.
|
|
|
|
|
|
|
|
Tests are run in the order they're listed so any actions that need to be done before
|
|
|
|
tests are run can simply be put before the tests.
|