> For the complete documentation index, see [llms.txt](https://docs.softwaresecured.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.softwaresecured.com/account/integrations/github.md).

# GitHub

Convert Vulnerabilities into GitHub Issues to streamline project management.

{% hint style="info" %}
Note: This integration is available with the Standard Plus package or above.
{% endhint %}

{% hint style="warning" %}
What's a GitHub App and why do I need to install it? Read more in the [GitHub Docs](https://docs.github.com/en/apps/using-github-apps/about-using-github-apps).
{% endhint %}

### **Prerequisites**

* A <code class="expression">space.vars.product\_name</code> account with <mark style="color:orange;">Org Admin</mark> permissions.
* A GitHub account that has <mark style="color:blue;">Admin</mark> permissions on the repository that you would like to integrate with. If it's an <mark style="color:blue;">Organization</mark> repository, you need an account with <mark style="color:blue;">Organization Admin</mark> permissions.

### **Steps**

{% stepper %}
{% step %}

#### Start the integration setup

1. In the <code class="expression">space.vars.product\_name</code> navigation sidebar, locate the <mark style="color:orange;">**Integrations**</mark> page near the bottom and open it
2. Find the GitHub integration card, and then click <mark style="color:orange;">**Add GitHub Account**</mark>**.**&#x20;
   {% endstep %}

{% step %}

#### Install the <code class="expression">space.vars.company\_name</code> GitHub App

1. In the integration wizard, click the button to install the Software Secured GitHub App. This app gives <code class="expression">space.vars.product\_name</code> access to create issues in your repository.&#x20;
2. You will be redirected to log in to GitHub. If you're not logged in already, log into your account.
3. When choosing where to install the app, select the owner of the repository that you want to integrate with. This account can be your own account or a GitHub Organization if it's an organization repository.
4. Next, select which repositories the app will have access to. For optimal security for your repositories, only provide access to the repository that you are integrating with <code class="expression">space.vars.product\_name</code>.
5. Click <mark style="color:blue;">**Install**</mark> to finish the process, and you will be redirected back to the integration setup in <code class="expression">space.vars.product\_name</code>.
   {% endstep %}

{% step %}

#### Select your project and repository

1. On <code class="expression">space.vars.product\_name</code>, continue enabling the integration.
2. Select the <code class="expression">space.vars.product\_name</code> Project and GitHub Repository that you would like to connect. When creating GitHub issues from <code class="expression">space.vars.product\_name</code>, they will be created in this repository.

<figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2F5DzrsVAlK7wN1btDuVZe%2FScreenshot%202026-06-17%20085813.png?alt=media&amp;token=83003835-bd4e-44f6-8e16-1728f4c9c338" alt=""><figcaption><p>Select your GitHub Repository and <code class="expression">space.vars.product_name</code> Project.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Configure issue fields

1. Configure the vulnerability information that you would like in your GitHub issues. All information is placed in the issue description in Markdown format. <code class="expression">space.vars.product\_name</code> labels can be placed in the description or added as GitHub labels.

<figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2FlwZsRFaENsH86OULcalC%2FScreenshot%202026-06-19%20102134.png?alt=media&amp;token=e21bcf77-f875-4386-8da3-664a6a02cf63" alt=""><figcaption><p>Choose the vulnerability information to include in GitHub issues.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Review and enable the integration

1. Review your integration configuration.&#x20;
2. To enable the integration, click <mark style="color:orange;">**Finish**</mark>.
   {% endstep %}
   {% endstepper %}

### Results

Use GitHub to track remediation progress for your vulnerabilities. For more information, see [Using integrations to track remediation](/after-testing/remediating-vulnerabilities/using-integrations-to-track-remediation.md).&#x20;