GitHub Security Alerts Workflow

This script is for teams that want to leverage GitHub Security Alerts into their workflow. It currently supports creating Jira tickets from the GitHub GraphQL API for security alerts.

Table of Contents

• Background
• Install
• Configuration
• Usage
• Contribute
• License

Background

This purpose of this project is to manage security vulnerabilities for open source projects using GitHub’s security alerts at scale.

Install

This script requires Python3 to run, so ensure you have this installed first. Installation of this script is as simple as the following:

git clone https://github.com/yahoo/GitHub-Security-Alerts-Workflow.git $$ cd GitHub-Security-Alerts-Workflow

Usage

Use the following command to run this script:

python3 graph_ql.py graph_ql_authorization_key jira_authorization_key jira_url jira_project_key

• graph_ql_authorization_key - A GitHub GraphQL access token that has the ability to view security alerts for the chosen repo.
• jira_authorization_key - An authorization key for your Jira instance with the ability to create and modify tickets.
• jira_url - The endpoint for your Jira instance's issue API, e.g. https://jira.xyz.com/rest/api/2/issue/
• jira_project_key - The identifier key for the Jira project you want to create issues for.

Contribute

Please refer to the contributing.md file for information about how to get involved. We welcome issues, questions, and pull requests. Pull Requests are welcome.

Maintainers

Manikandan Subramaniam: manikandan.subramaniam@verizonmedia.com
Ashley Wolf: awolf@verizonmedia.com

License

This project is licensed under the terms of the Apache 2.0 open source license. Please refer to LICENSE for the full terms.