Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 9ba44d8

Browse files
authored
Merge pull request Hacker0x01#63 from philipkocanda/vpn-2
Documentation for installing root CA and OpenVPN client on multiple platforms
2 parents f197142 + 8f43172 commit 9ba44d8

27 files changed

+168
-9
lines changed

docs/hackers/configure-the-hackerone-vpn.md

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,9 @@ Certain programs require you to have your own VPN instance and credentials on th
1010
1111
### VPN Configuration
1212
To configure the HackerOne VPN:
13-
1. Install the HackerOne Root CA.
14-
* HackerOne has its own Root CA Certificate that you can [download](https://hackerone-vpn-service.s3.amazonaws.com/hackerone-vpn-service.crt).
15-
* You can access the installation instructions for most operating systems and software [here](https://www.bounca.org/tutorials/install_root_certificate.html).
16-
2. Install an OpenVPN Client.
17-
* In order to use our VPN service, you need a VPN client that supports OpenVPN. Here are some clients you can use and their installation instructions:
18-
* macOS: [Tunnelblick](https://tunnelblick.net/cInstall.html)
19-
* Windows: [openvpn-gui](https://github.com/OpenVPN/openvpn-gui/blob/master/README.rst)
20-
* Linux: [Ubuntu network manager](https://torguard.net/knowledgebase.php?action=displayarticle&id=53)
21-
* Linux: [terminal](https://openvpn.net/index.php/access-server/docs/admin-guides/182-how-to-connect-to-access-server-with-linux-clients.html)
13+
1. [Install the HackerOne VPN Root CA](/hackers/vpn/root-ca.html)
14+
2. Download your VPN Credentials from HackerOne (instructions on this page)
15+
3. [Configure your OpenVPN Client](/hackers/vpn/clients.html)
2216

2317
### Accessing your VPN Credentials
2418
Once you've configured the HackerOne VPN and accepted an invitation to a VPN enabled program, to access your VPN Credentials:

docs/hackers/images/vpn-firefox-1.png

173 KB
Loading

docs/hackers/images/vpn-firefox-2.png

170 KB
Loading

docs/hackers/images/vpn-firefox-3.png

273 KB
Loading

docs/hackers/images/vpn-firefox-4.png

200 KB
Loading

docs/hackers/images/vpn-firefox-5.png

179 KB
Loading

docs/hackers/images/vpn-macos-1.png

107 KB
Loading

docs/hackers/images/vpn-macos-2.png

236 KB
Loading

docs/hackers/images/vpn-macos-3.png

524 KB
Loading

docs/hackers/images/vpn-macos-4.png

440 KB
Loading

docs/hackers/images/vpn-macos-5.png

441 KB
Loading

docs/hackers/images/vpn-windows-2.png

75 KB
Loading

docs/hackers/images/vpn-windows-3.png

89.6 KB
Loading

docs/hackers/images/vpn-windows-4.png

110 KB
Loading

docs/hackers/images/vpn-windows-5.png

86.5 KB
Loading

docs/hackers/images/vpn-windows-6.png

113 KB
Loading

docs/hackers/images/vpn-windows-7.png

76.8 KB
Loading
89.1 KB
Loading
62.7 KB
Loading
75 KB
Loading
99.5 KB
Loading
77.5 KB
Loading
230 KB
Loading

docs/hackers/images/vpn-windows.png

152 KB
Loading

docs/hackers/vpn/clients.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: "Configuring OpenVPN Clients"
3+
path: "/hackers/openvpn-clients.html"
4+
id: "hackers/openvpn-clients"
5+
---
6+
7+
In order to use the HackerOne VPN, you need to install a VPN client that supports OpenVPN.
8+
9+
Refer to these installation and configuration instructions for your platform:
10+
11+
* [Windows](#windows)
12+
* [macOS](#macos)
13+
14+
<h3 id="windows">Windows</h3>
15+
16+
1. Download the OpenVPN **Windows Installer** from <a href="https://openvpn.net/community-downloads/" target="_blank">this page</a>.
17+
2. Execute the OpenVPN Installer.
18+
3. When prompted, select these components:
19+
* OpenVPN Service
20+
* Tap Virtual Ethernet Adapter
21+
* OpenVPN GUI
22+
23+
![Screenshot](../images/vpn-windows-gui-1.png)
24+
25+
4. When prompted to install a network adapter, click **Install**.
26+
27+
![Screenshot](../images/vpn-windows-gui-2.png)
28+
29+
5. Click <b>Finish</b> to complete the setup.
30+
31+
![Screenshot](../images/vpn-windows-gui-3.png)
32+
33+
7. Start the OpenVPN GUI application
34+
35+
8. Right click the OpenVPN icon in the bottom right corner of the screen, and click <b>Import file...</b>
36+
37+
![Screenshot](../images/vpn-windows-gui-4.png)
38+
39+
9. Select the `*.openvpn` file you have downloaded from HackerOne (See [Accessing your VPN Credentials](/hackers/configure-the-hackerone-vpn.html)).
40+
41+
![Screenshot](../images/vpn-windows-gui-5.png)
42+
43+
10. Right click the OpenVPN icon on the bottom right corner of the screen, and click <b>Connect</b>
44+
45+
![Screenshot](../images/vpn-windows-gui-6.png)
46+
47+
The VPN will start connecting.
48+
49+
<h3 id="macos">macOS</h3>
50+
51+
1. Install [Tunnelblick](https://tunnelblick.net/cInstall.html).
52+
2. Start Tunnelblick.
53+
3. Find the `*.openvpn` file you have downloaded from HackerOne (See [Accessing your VPN Credentials](/hackers/configure-the-hackerone-vpn.html)).
54+
4. Drag it onto the Tunnelblick icon at the top of your screen.
55+
5. Click the Tunnelblick icon, and click the HackerOne VPN connection.
56+
57+
Your VPN will now be connected.

docs/hackers/vpn/root-ca.md

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: "Installing the HackerOne VPN Root CA"
3+
path: "/hackers/hackerone-vpn-root-ca.html"
4+
id: "hackers/hackerone-vpn-root-ca"
5+
---
6+
7+
In order to use the HackerOne VPN, you need to install the HackerOne VPN Root CA.
8+
9+
Refer to these installation and configuration instructions for your platform:
10+
11+
* [Windows](#windows)
12+
* [macOS](#macos)
13+
* [Ubuntu/Debian Linux](#ubuntu)
14+
* [Firefox](#firefox)
15+
><i>Note: Firefox manages its own trusted certificate list, so you always need to add the root authority certificate to the browser even if you've installed it system wide.</i>
16+
17+
<h3 id="windows">Windows</h3>
18+
19+
1. [Download the HackerOne VPN Root CA](https://hackerone-vpn-service.s3.amazonaws.com/hackerone-vpn-service.crt).
20+
2. Double-click on the certificate file.
21+
22+
![Screenshot](../images/vpn-windows.png)
23+
24+
3. Click <b>Install Certificate...</b>.
25+
26+
![Screenshot](../images/vpn-windows-2.png)
27+
28+
4. Select <b>Local Machine</b> and click <b>Next</b>.
29+
30+
![Screenshot](../images/vpn-windows-3.png)
31+
32+
5. Click the <b>Yes</b> to allow the changes.
33+
34+
![Screenshot](../images/vpn-windows-4.png)
35+
36+
6. Select <b>Place all certificates in the following store</b>.
37+
38+
![Screenshot](../images/vpn-windows-5.png)
39+
40+
7. From the list, select <b>Trusted Root Certification Authorities</b>, and click <b>OK</b>.
41+
42+
![Screenshot](../images/vpn-windows-6.png)
43+
44+
8. Click <b>Finish</b>.
45+
46+
![Screenshot](../images/vpn-windows-7.png)
47+
48+
<h3 id="macos">macOS</h3>
49+
50+
1. [Download the HackerOne VPN Root CA](https://hackerone-vpn-service.s3.amazonaws.com/hackerone-vpn-service.crt).
51+
2. Double-click on the certificate file.
52+
53+
![Screenshot](../images/vpn-macos-1.png)
54+
55+
3. Enter your administrator password.
56+
57+
![Screenshot](../images/vpn-macos-2.png)
58+
59+
4. Double-click on the HackerOne VPN certificate in KeyChain Access.
60+
61+
![Screenshot](../images/vpn-macos-3.png)
62+
63+
5. Set the certificate to <b>Always Trust</b> in the window that appears.
64+
65+
![Screenshot](../images/vpn-macos-4.png)
66+
67+
6. Re-open the certificate in Keychain Access. The VPN Certificate should now be trusted by the operating system.
68+
69+
![Screenshot](../images/vpn-macos-5.png)
70+
71+
<h3 id="ubuntu">Ubuntu/Debian Linux</h3>
72+
73+
Execute the following commands in your terminal to download and install the HackerOne Root CA:
74+
75+
1. `cd /usr/local/share/ca-certificates`
76+
2. `sudo wget https://hackerone-vpn-service.s3.amazonaws.com/hackerone-vpn-service.crt`
77+
3. `sudo update-ca-certificates`
78+
79+
The command will state that it has installed one (or more) new certificates, through which the certificate has been successfully added to the Operating System.
80+
81+
<h3 id="firefox">Firefox</h3>
82+
83+
1. [Download the HackerOne VPN Root CA](https://hackerone-vpn-service.s3.amazonaws.com/hackerone-vpn-service.crt).
84+
2. Open <b>Preferences</b> and go to <b>Privacy & Security</b>.
85+
3. Scroll down to the <b>Certificates</b> section, and click <b>View Certificates...</b>.
86+
87+
![Screenshot](../images/vpn-firefox-1.png)
88+
89+
4. Click the <b>Import...</b> tab.
90+
91+
![Screenshot](../images/vpn-firefox-2.png)
92+
93+
5. Select the <b>hackerone-vpn-service.crt</b> file.
94+
95+
![Screenshot](../images/vpn-firefox-3.png)
96+
97+
6. Check <b>Trust this CA to identify websites</b> and click <b>OK</b>.
98+
99+
![Screenshot](../images/vpn-firefox-4.png)
100+
101+
The "Hackerone - Hacker VPN Service" certificate is now visible in your list of certificates.
102+
103+
![Screenshot](../images/vpn-firefox-5.png)

src/pages/hackers/hackers-nav.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,11 @@
6363
path: /hackers/disclosure-assistance.html
6464
- title: HackerOne VPN
6565
path: /hackers/configure-the-hackerone-vpn.html
66+
items:
67+
- title: Installing the HackerOne VPN Root CA
68+
path: /hackers/hackerone-vpn-root-ca.html
69+
- title: Configuring OpenVPN Clients
70+
path: /hackers/openvpn-clients.html
6671
- title: Programs
6772
items:
6873
- title: Invitations

0 commit comments

Comments
 (0)