Package Exports

@octokit/webhooks-methods
@octokit/webhooks-methods/dist-node/index.js
@octokit/webhooks-methods/dist-web/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@octokit/webhooks-methods) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

webhooks-methods.js

Methods to handle GitHub Webhook requests

Table of contents

usage
Methods
- sign()
- verify()
Contributing
License

usage

Browsers	🚧 `@octokit/webhooks-methods` is not meant to be used in browsers. The webhook secret is a sensitive credential that must not be exposed to users. Load `@octokit/webhooks-methods` directly from cdn.skypack.dev <script type="module"> import { sign, verify, } from "https://cdn.skypack.dev/@octokit/webhooks-methods"; </script>
Node	Install with `npm install @octokit/core @octokit/webhooks-methods` const { sign, verify } = require("@octokit/webhooks-methods");

Browsers

🚧 @octokit/webhooks-methods is not meant to be used in browsers. The webhook secret is a sensitive credential that must not be exposed to users.

Load @octokit/webhooks-methods directly from cdn.skypack.dev

<script type="module">
  import {
    sign,
    verify,
  } from "https://cdn.skypack.dev/@octokit/webhooks-methods";
</script>

Node

Install with npm install @octokit/core @octokit/webhooks-methods

const { sign, verify } = require("@octokit/webhooks-methods");

await sign("mysecret", eventPayloadString);
// resolves with a string like "sha256=4864d2759938a15468b5df9ade20bf161da9b4f737ea61794142f3484236bda3"

await sign({ secret: "mysecret", algorithm: "sha1" }, eventPayloadString);
// resolves with a string like "sha1=d03207e4b030cf234e3447bac4d93add4c6643d8"

await verify("mysecret", eventPayloadString, "sha256=486d27...");
// resolves with true or false

Methods

`sign()`

await sign(secret, eventPayloadString);
await sign({ secret, algorithm }, eventPayloadString);

secret (String) Required. Secret as configured in GitHub Settings.


        algorithm

(String)

Algorithm to calculate signature. Can be set to sha1 or sha256. sha1 is supported for legacy reasons. GitHub Enterprise Server 2.22 and older do not send the X-Hub-Signature-256 header. Defaults to sha256.

Learn more at Validating payloads from GitHub

eventPayloadString (String) Required. Webhook request payload as received from GitHub.

If you have only access to an already parsed object, stringify it with JSON.stringify(payload)

Resolves with a signature string. Throws an error if an argument is missing.

`verify()`

await verify(secret, eventPayloadString, signature);

`secret` (String)	Required. Secret as configured in GitHub Settings.
`eventPayloadString` (String)	Required. Webhook request payload as received from GitHub. If you have only access to an already parsed object, stringify it with `JSON.stringify(payload)`
`signature` (String)	Required. Signature string as calculated by `sign()`.

Resolves with true or false. Throws error if an argument is missing.

Contributing

See CONTRIBUTING.md

License

MIT