# GitHub Issue

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

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

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

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

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

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

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FS3Jy5btLoel4QRgf3mWx%2Fimage.png?alt=media&#x26;token=d4b70caa-7ed6-4095-9014-07644dd24ddf" alt=""><figcaption></figcaption></figure>

* Press the Create GitHub issue button. As a result, the appropriate issue will be created in your GitHub repository
* Also, in the report's GitHub 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%2FTdNERKxFJrBaKWeGR5xM%2Fimage.png?alt=media&#x26;token=aa00dcaa-1a4c-41e3-ba96-1c27e8d5c12e" alt=""><figcaption></figcaption></figure>

### How to connect the GitHub 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 GitHub app

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2Flke9m7qjCqoOmfi17qtB%2Fimage.png?alt=media&#x26;token=e109f49f-8dea-4832-9f84-9f8ed8b4db58" alt=""><figcaption></figcaption></figure>

* Connect your HackenProof program to GitHub by specifying Repository URL and your GitHub API token

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2F8CXrkaqoaPUe2w669B4W%2Fimage.png?alt=media&#x26;token=4a47f6d1-edf1-4aa2-892f-c3ed318d6bf5" alt=""><figcaption></figcaption></figure>

**Repository URL.** <mark style="background-color:purple;">Be sure you use the correct Repository URL.</mark> Here is a correct sample: <https://api.github.com/repos/hackenproof/web3-bug-bounty-platform/issues>, where:

* *<https://api.github.com/repos/>*
* *hackenproof/* - company (owner)
* *web3-bug-bounty-platform/issues* - repo issue

**GitHub API token.** To create your token: GitHub Settings -> Developer settings -> Personal access tokens

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FxxayYjMc0yVjLWTwJTfW%2Fimage.png?alt=media&#x26;token=3596bc8b-d2e8-4c6f-9838-a8af2971d140" alt=""><figcaption><p>GitHub Settings</p></figcaption></figure>

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2Fr4HjL5oOA83JK5cfPqIA%2Fimage.png?alt=media&#x26;token=0c17c36e-decd-45c7-876d-55f5ef3c46bf" alt=""><figcaption><p>Personal settings</p></figcaption></figure>

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FF08lKFshcKjRLOCQfaZ0%2Fimage.png?alt=media&#x26;token=eea7bd91-77f5-469c-8c90-f4a875dc41fc" alt=""><figcaption><p>Developer settings</p></figcaption></figure>

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2Fpof1afBVMhRo8dH6G7GN%2Fimage.png?alt=media&#x26;token=ab2085eb-ee06-486c-b209-c50034d950a3" alt=""><figcaption><p>Personal access tokens</p></figcaption></figure>

* Press the Generate personal access token&#x20;

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2Fml8caryJJgAOAEjNlIlz%2Fimage.png?alt=media&#x26;token=a19796e9-2df7-41b1-9308-1ed91c3c5d48" alt=""><figcaption><p>Generate personal access token</p></figcaption></figure>

* To create a GitHub issue you will need <mark style="background-color:purple;">a token with access to REPO</mark>

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FYjFtjXxD6IEZ5NZsT7uT%2Fimage.png?alt=media&#x26;token=c4a3ccec-eafe-4ac5-8ccc-16abf7882075" alt=""><figcaption></figcaption></figure>

<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 Repository URL and your GitHub API token you can connect your bug bounty program with GitHub and start creating GitHub issues