Git-Discord-HookRouter

Manage all your GitHub / GitLab webhooks with one URL.
This lightweight API allows you to route GitHub and GitLab webhook requests to Discord. Allows easy management of multiple webhooks.

Features:

+ Routing all GitHub and GitLab request to one URL.
+ Transfer request to all discord webhooks configured.
+ Same format for both GitHub and GitLab to keep consistency.
+ Signature verification.
+ Rate-limit handling (discord webhooks).
+ IP banning and verification, IP auto-banning for repeated unauthorized requests.
+ Cool logging.

It allows you to forward GitHub and GitLab requests to multiple Discord webhooks. As you guessed it, this API will act as the POSTman in delivering the requests. It also auto-bans IP addresses on repeated access if the request is unauthorized.

Precautions:

1. It is highly recommended to protect this endpoint with signature verification to prevent unauthorized access to your API. More info about creating a secure secret with a high entropy could be found here.
2. The content type should be set to application/json when the GitHub webhook is being created, or it will cause unintended issues as Discord can't parse any other content-type.
3. Although this API supports handling requests from the baseURL, we recommend you to use the allocated path of the webhook. For example, use the path /github if you're using this API for managing GitHub requests and /gitlab when using this API for managing GitLab requests.

Instructions on setting it up!

1. Copy paste the template/config.template.json in configs/config.json.

{
    "port": "3000",
    "auth": true,
    "authorizationGithub": "Secret key",
    "authorizationGitlab": "Secret key",
    "blacklisted": ["ip", "ip"]
}

2. If you want to secure your API using the GitHub webhook secret, set auth to ̀true and set the property of authorization as the secret key.

3. You can manually blacklist IP addresses by adding those to the blacklisted property. The API will automatically refuse connections from those IP addresses.

4. Copy paste the template/webhooks.template.json in configs/webhooks.json.

[
    {
        "name": "webhook",
        "id": "webhookID",
        "token": "webhookToken"
    }
]

The webhooks config contains the array of all webhooks you want to manage. Provide a name, webhook's id, and token and you are good to go.

5. When setting up the webhook in GitHub, copy the url to access this API with the path as /github. Don't forget to change the content type to application/json and provide a secret token if you are going to use one. Same goes for setting up GitLab webhooks.

6. Start this API by executing node src/app.js in the console. PM2 script is located in the scripts folder which could be used if you want to use PM2. Alternatively, you can use npm start or npm pm2start.

7. If you want to quickly host this API, you could use ngrok; which is available here.

Contributions

Feel free to contribute to this project by opening Pull-Request or Issues. Contributions are always welcome.

Honorable mentions

Huge thanks to Santhosh-Annamalai for being helpful when building this API.