For the complete documentation index, see llms.txt. This page is also available as Markdown.

GitHub Advanced Security Integration

Create alerts in ilert based on code scanning alerts from GitHub.

With the ilert GitHub Advanced Security integration, you can create alerts in ilert based on code scans, secret scans and Dependabot scans from GitHub.

In ilert: Create a GitHub alert source

  1. Go to Alerting → Alert sources and click Create new alert source.

  2. Search for GitHub, click its tile, and click Next.

  3. Give your alert source a name, optionally assign teams, and click Next.

  4. Choose who gets notified: select Use existing escalation policy and pick a policy, or Generate new escalation policy to start with a basic one that notifies you first. Click Next.

    The escalation step of the ilert alert source wizard, headed Who should be notified about alerts, with an escalation policy selected and a preview of its escalation rules below.
    Pick an existing escalation policy, or generate a basic one without leaving the wizard.
  5. Select Default grouping and click Continue setup. It groups events by the alert key the integration sets; the other grouping options are easier to judge once events are arriving.

  6. The next page shows more settings, such as notification priority and alert templates. Click Finish setup for now; you can change them later.

  7. On the final page, ilert shows the integration key and URL for this alert source. You will need them later in this guide.

In GitHub: Create a Repository Webhook

  1. Go to your GitHub repository and then to Settings -> Webhooks and click on Add webhook to add a new webhook (https://github.com/<org>/<repo>/settings/hooks)

  1. In the Payload URL section, set the Webhook URL that you generated in ilert

  2. In the Content type section, select application/json

  1. In the Which events would you like to trigger this webhook? section, change it to Let me select individual events and select following events: Check runs, Code scanning alerts, Dependabot alerts, Issues, Secret scanning alert locations, Secret scanning alerts.

  1. Click on Save

FAQ

Will alerts in ilert be resolved automatically?

Yes, as soon as the Github alert get resolved or closed, the alert in ilert will be resolved automatically.

Can I connect Github with multiple alert sources from ilert?

Yes, simply create more webhooks in Github.

Last updated

Was this helpful?