GitHub Destination

Configuring Github as an alert destination in your Panther Console


Destinations are integrations that receive alerts from rules, policies, system health notifications, and rule errors. Panther supports configuring Github as the destination where you will receive alerts.

The GitHub Destination requires a Repository name and an API Token.

When an alert is forwarded to a GitHub Destination, it creates an Issue in the repository. The repository must have Issues enabled.

The integration is most useful when infrastructure is defined in code such as with AWS CloudFormation or with Terraform.

How to set up Github alert destinations in Panther


We recommend creating a dedicated Panther Alerts service account in Github.

Generating an API Token in Github

Follow GitHub's documentation on generating a Personal Access Token.

  1. Log in to your Github account using your service account (or any developer service account that has access to the repo)

  2. Fill out the form to configure your token. Select the repo permissions checkbox.

  3. Click Generate Token. Copy the token and store it in a secure location, as you will need it in the next steps.

Configure the Github Destination in Panther

  1. Log in to the Panther Console.

  2. In the left sidebar, click Configure > Alert Destinations.

  3. Click +Add your first Destination.

    • If you have already created Destinations, click Create New in the upper right side of the page to add a new Destination.

  4. Click Github.

  5. Fill out the form to configure the Destination:

    • Display Name: Enter a descriptive name.

    • Repository Name: Enter the Github repository name. This will be in the format owner/repo_name.

    • Token: Enter the token you generated in Github during the previous steps of this documentation.

    • Severity: Select the severity level of alerts to send to this Destination.

    • Alert Types: Select the alert types to send to this Destination.

  6. Click Add Destination.

  7. On the final page, optionally click Send Test Alert to test the integration. When you are finished, click Finish Setup.

Additional Information on Destinations

For more information on alert routing order, modifying or deleting destinations, and workflow automation, please see the Panther docs: Destinations.

Last updated