> 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

{% 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**

1. A Portal account with <mark style="color:orange;">Org Admin</mark> permissions.
2. A GitHub account that has Admin permissions on the repository you would like to integrate with. If it's an Organization repository, you need an account with Organization Admin permissions.

#### **Steps**

1. Integrate GitHub and <code class="expression">space.vars.product\_name</code>.
   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;
2. Install the Software Secured GitHub App.
   1. The first step of the integration setup wizard will present a button to install the Software Secured GitHub App. This gives us access to create issues on your repository. Click the button to start the process.
   2. The button will redirect you to login to GitHub (if you're not logged in already), log into your account
   3. When selecting where to install the App, select the owner of the repository you want to integrate with. It could be your own account, or a GitHub Organization if it's an organization repository.
   4. Next, you'll select which repositories the app will have access to. We suggest limiting access to only the repository you will be integrating with Portal.
   5. Click the "Install" button to finish the process, and you will be redirected back to the integration setup in Portal.
3. Select your project and repository.

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

   <figure><img src="/files/qxjc1swCPJiTN5W2LJOe" alt=""><figcaption><p>Select your GitHub Repository and Portal Project.</p></figcaption></figure>
4. Configure Issue Fields&#x20;

   1. Configure the vulnerability information you would like in your GitHub issues. All information will be placed in the issue description formatted as Markdown. Portal labels can be placed in the descripiton, or added as GitHub labels.

   <figure><img src="/files/ClcM2Jl0T8XxDo9R0uAM" alt=""><figcaption><p>Choose the vulnerability information to include in GitHub issues.</p></figcaption></figure>
5. Review and enable the integration.
   1. Review your integration configuration.&#x20;
   2. To enable the integration, click <mark style="color:orange;">**Finish**</mark>.

#### 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;