GitHub Issues

GitHub Issues

📋 Setting up automated task creation in GitHub Issues

Introduction

This one-time setup per workspace allows everyone in your Aikido organization to create issues directly in GitHub Issues

Following use cases are supported :

  • Automated Ticket Creation: Automatically create and push tickets to specified GitHub Issue projects/repos for seamless tracking of security issues.

  • Manual Ticket Addition: Manually sync security issue tickets to GitHub Issues.

Prerequisites

  • GitHub account needs to be an organisation account

  • Issues need to be enabled inside GitHub

Connecting the Aikido App to GitHub Issues

  1. Navigate to Integration Settings within the Aikido app.

  2. In the 'Task Trackers' section, select 'GitHub Issues'

  3. Install the Aikido Issues App inside your organisation (Install Link). This is needed in order to select your organisation (see step X).
    ​

  4. Select your organisation and repos
    ​

  5. When installed succesfully, you will get a notification on top of the page in GitHub. Return to Aikido.
    ​

  6. Select your organisation in the modal.
    ​

  7. Click Save. The status will now change to Connected.

  8. Close the modal & open the GitHub Issues Integration page.
    ​

  9. You can set a Default Label that will be send for all Aikido Issues. These will be synced and appear in GitHub.​
    ​

Options for Task Creation in GitHub Issues via Aikido

There are two different options to create new tasks from Aikido into GitHub Issues

  1. Manually create tasks from the Aikido interface

  2. Automatically create new tasks via Aikido's auto creation functionality.

Manual Task Creation

  1. Hover over any issue in your feed and click the + in the assignee column.
    ​

    Alternatively, you can click the triple dots in the last columns to open up the action menu. If you have grouped issues, the triple dot action menu is available on every subissue.
    ​

  2. Fill in the required details in the popup modal.
    ​

    ​

  3. The newly created task in GitHub Issues will be linked in the Aikido Issue Detail under the 'Tasks' tab (sidepanel).

Automated Task Creation

  1. Go to the GitHub Integration settings page

  2. Make sure to enable 'Autocreation' by clicking the toggle to On.

  3. Define the criteria for automatic task creation.
    ​

    ​

  4. Aikido will then autonomously generate GitHub Issues based on these settings 🚀


Setup GitHub Issues Integration Now →

Discover Integration Details →