# GitLab Issue

## How the connection HackenProof -> GitLab issue works <a href="#h_ed44c51bfe" id="h_ed44c51bfe"></a>

This guide explains how GitLab connection helps companies when they run a bounty program at HackenProof.

Once you connect your bug bounty program to your GitLab repository (public or private), you can automatically create a GitLab issue:

<mark style="background-color:purple;">remember, you can create a GitLab issue for reports with any STATUS</mark>&#x20;

### How to create a GitLab issue <a href="#h_ed44c51bfe" id="h_ed44c51bfe"></a>

* Open the report you want to create a GitLab issue from
* Navigate to the prerequisites section of the report and find the GitLab issue section

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2F8bP1QcY8WokMAxEJ9qBV%2Fimage.png?alt=media&#x26;token=6898f7d4-d6ed-479f-8ff6-eaf6f1a425cd" alt=""><figcaption></figcaption></figure>

* Press the Create GitLab issue button. As a result, the appropriate issue will be created in your GitLab repository.
* Also, in the report's GitLab section, you will find the link to the newly created issue:

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FBde1dVepL0GXQGmJl3jV%2Fimage.png?alt=media&#x26;token=2aa48ca5-dcad-480e-bcd7-5c1886931dfd" alt=""><figcaption></figcaption></figure>

### How to connect the GitLab repository to the HackenProof program <a href="#h_ed44c51bfe" id="h_ed44c51bfe"></a>

* Open your HackenProof program, which you want to connect to HackenProof
* Navigate to the Integrations tab and open GitLab app

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2Fu89LCfp5SvRQmoaB1D9z%2Fimage.png?alt=media&#x26;token=1f49f4d6-81c9-4f75-886c-9706d6ead5bd" alt=""><figcaption></figcaption></figure>

* Connect your HackenProof program to GitLab by specifying the Repository URL and your GitLab API token.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FqelsfVRA659CuZRL2sfw%2Fimage.png?alt=media&#x26;token=3b00a22b-410f-4cba-adaa-030575e97c26" alt=""><figcaption></figcaption></figure>

**Repository URL.** Be sure you use the correct Project ID (not name). Here is a correct sample: <mark style="background-color:purple;"><https://gitlab.com/api/v4/projects/19980000/issues></mark>, where:

* <https://gitlab.com/api/v4/projects/> - core of our integration
* 19980000 - project ID (not a name)
* *issues* - repo issue page

**GitLab API token.** To create your token: GitLab Project Settings -> Access Tokens&#x20;

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FdZ0g5auBLoqVB9seAnOh%2Fimage.png?alt=media&#x26;token=6407fb29-1bbc-4ece-9a59-69300b53ba4c" alt=""><figcaption></figcaption></figure>

* Generate personal access token.&#x20;

<mark style="background-color:purple;">Make sure to copy your personal access token now. You won’t be able to see it again!</mark>

Once you specified Project URL and your GitLab token you can connect your bug bounty program with GitLab and start creating GitLab issues