# Introduction to HackerOne Code for On-Premise Integrations

### HackerOne's PullRequest Proxy

HackerOne integrates with self-housed source code providers with the installation of **PullRequest Proxy**. This is a lightweight proxy server that facilitates required communications with our server.

This integration is used for [**h1 Validation**](https://www.hackerone.com/hub/continuous-validation), [**HackerOne Code**](https://www.hackerone.com/product/code), [**HackerOne Code Security Audit**](https://www.hackerone.com/product/code-security-audit)**,** and Software Composition Analysis (SCA).

### Dataflow Diagram

For a visualization of how PullRequest Proxy and our systems interact with self-hosted providers, see and download the diagram below.

<figure><img src="https://624363444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNMKNsDv2KL9GI5L5YY%2Fuploads%2F7qU07l9MCdc8xaUAyPia%2FHackerOne-PullRequest-Proxy-Dataflow-Diagram.png?alt=media&#x26;token=8417356e-6378-4642-83b3-f3d6436099de" alt=""><figcaption><p>Dataflow diagram</p></figcaption></figure>

{% file src="<https://624363444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNMKNsDv2KL9GI5L5YY%2Fuploads%2F7qU07l9MCdc8xaUAyPia%2FHackerOne-PullRequest-Proxy-Dataflow-Diagram.png?alt=media&token=8417356e-6378-4642-83b3-f3d6436099de>" %}
Click to download
{% endfile %}

### System Compatibility

PullRequest Proxy compatible with:

<table><thead><tr><th width="188.2109375">Provider</th><th>Product(s)</th><th>Version(s)</th></tr></thead><tbody><tr><td><strong>GitHub</strong></td><td><a href="https://docs.github.com/en/enterprise-server@3.10/admin/overview/about-github-enterprise-server"><strong>GitHub Enterprise Server</strong></a></td><td><ul><li>2.18 and above</li><li>GitHub API v3</li></ul></td></tr><tr><td><strong>GitLab</strong></td><td><a href="https://docs.gitlab.com/ee/topics/offline/quick_start_guide.html"><strong>GitLab Self-Managed</strong></a><br><a href="https://about.gitlab.com/dedicated/"><strong>GitLab Dedicated</strong></a></td><td><ul><li>11.0 and above</li><li>GitLab API v4</li></ul></td></tr><tr><td><strong>Azure DevOps</strong></td><td><a href="https://azure.microsoft.com/en-us/products/devops/server"><strong>Azure DevOps Server</strong></a></td><td><ul><li>2019 and above</li></ul></td></tr><tr><td><strong>Bitbucket</strong></td><td><a href="https://www.atlassian.com/software/bitbucket/enterprise"><strong>Bitbucket Data Center</strong></a><br><a href="https://confluence.atlassian.com/bitbucketserver/bitbucket-server-5-release-notes-892802659.html"><strong>Bitbucket Server</strong></a></td><td><ul><li>5.5 and above</li></ul></td></tr></tbody></table>

### Before Getting Started

Please review the following system requirements for each of our source code management on-premises integrations below.&#x20;

{% tabs %}
{% tab title="GitHub Enterprise" %}
Be sure to send your PullRequest point of contact the version of [**GitHub Enterprise**](https://enterprise.github.com/releases) your team is currently running (along with any plans you have to update or change versions).

{% hint style="warning" %}
HackerOne's Pull Request Proxy for GitHub Enterprise standard integration is compatible with [**GitHub Enterprise 2.18 and above**](https://docs.github.com/en/enterprise-server) and **optimized for GitHub API version 3**.

If your team is running a prior version, *we highly recommend updating*. Previous versions may or may not work. Please contact us at  with any issues.
{% endhint %}

If you have any custom needs or requirements that have not been discussed with HackerOne, please be sure to bring them to attention as early in the installation process as possible.

And, of course, if ever you have any questions or become blocked during the integration please get in touch with your dedicated HackerOne implementation specialist or account manager.
{% endtab %}

{% tab title="Bitbucket Data Center" %}
Be sure to send your HackerOne point of contact the version of [**Bitbucket Data Center**](https://confluence.atlassian.com/bitbucketserver/bitbucket-server-release-notes-872139866.html) **(or Bitbucket Server)** your team is currently running along with any plans you have to update or change versions.

{% hint style="warning" %}
HackerOne's Pull Request Proxy  for Bitbucket Data Center and Bitbucket Server integration requires Personal Access Tokens which were introduced in **Bitbucket Server 5.5**.

For best performance, we recommend **Bitbucket Server 5.10** or higher.

If your team is running a prior version of Bitbucket Server 5.5, we recommend upgrading before continuing if feasible. If not, please reach out to to your HackerOne contact to discuss options.
{% endhint %}

If you have any custom needs or requirements that have not been discussed with HackerOne, please be sure to bring them to attention as early in the installation process as possible.

And, of course, if ever you have any questions or become blocked during the integration please get in touch with your dedicated HackerOne implementation specialist or account manager.
{% endtab %}

{% tab title="GitLab Self-Managed" %}
Be sure to send your HackerOne point of contact the version of [**GitLab Self-Managed**](https://about.gitlab.com/releases/) your team is currently running (along with any plans you have to update or change versions).

{% hint style="warning" %}
HackerOne's Pull Request Proxy for GitLab Self-Managed integration was built and optimized for **GitLab 11.0 and above** and **GitLab API v4.0**.

If your team is running a prior version, *we highly recommend updating*. Previous versions may or may not work. Please contact us at  with any issues.
{% endhint %}

If you have any custom needs or requirements that have not been discussed with HackerOne, please be sure to bring them to attention as early in the installation process as possible.

And, of course, if ever you have any questions or become blocked during the integration please get in touch with your dedicated HackerOne implementation specialist or account manager.
{% endtab %}

{% tab title="Azure DevOps Server" %}
Be sure to send your HackerOne point of contact the version of [Azure DevOps 2019](https://docs.microsoft.com/en-us/azure/devops/server/release-notes/azuredevops2019u1?view=azure-devops) or [Azure DevOps 2020](https://docs.microsoft.com/en-us/azure/devops/server/release-notes/azuredevops2020?view=azure-devops) your team is currently running (along with any plans you have to update or change versions).

{% hint style="warning" %}
HackerOne's Pull Request Proxy for Azure DevOps Server integration was built and optimized for **Azure DevOps Server 2019 and above**.

If your team is running a prior version, *we highly recommend updating*. Previous versions may or may not work. Please contact us at  with any issues.
{% endhint %}

If you have any custom needs or requirements that have not been discussed with HackerOne, please be sure to bring them to attention as early in the installation process as possible.

And, of course, if ever you have any questions or become blocked during the integration please get in touch with your dedicated HackerOne implementation specialist or account manager.
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pullrequest.com/on-premise-server/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.