-
Notifications
You must be signed in to change notification settings - Fork 40
/
Copy pathhelp.tmpl.html
151 lines (130 loc) · 11.8 KB
/
help.tmpl.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
{{ define "content" }}
<div class="container" id="infopage">
<div class="row mb-botpage">
<div class="col-lg-4 col-md-0"></div>
<div class="col-lg-12 col-md-0">
<h1 class="text-center mt-toppage mb-2"><span class="material-icons-outlined" style="font-size:xxx-large ">help_outline</span> Help</h1>
</div>
<div class= "col-lg-12 col-md-12" style="text-align: right">
<a href="https://github.com/aau-network-security/haaukins/edit/master/svcs/amigo/resources/private/info.tmpl.html"><i class="fas fa-edit " aria-hidden="true"></i> Edit this page</a>
</div>
<div style="width: 100%">
<div role="alert" class="alert alert-primary mt-3" style="text-align: center;">
<p>This page contains some basic instructions and troubleshooting for your environment. </p>
{{ if .IsVPN }}
<p> Use following information below to setup your VPN configuration and manage the situations when you receive error. </p>
{{ end }}
</div>
<div class="alert alert-warning mt-3 " style="text-align: center;" role="alert">
<i class="fa fa-exclamation-triangle" aria-hidden="true"></i> YOUR LAB SUBNET: <b style="font-weight: bold; color:red;"> {{ .LabSubnet }} </b>
</div>
<div>
<div class=" mb-3">
<div class="nav nav-tabs nav-fill" id="info-tab" role="tablist">
{{ if or (eq .IsVPN 1) (eq .IsVPN 2 ) }}
<a class="nav-item nav-link active" id="vpn-conn-tab" data-toggle="tab" href="#vpn-conn" role="tab">VPN Connection</a>
{{ end }}
{{ if or (eq .IsVPN 0) (eq .IsVPN 2) }}
<a {{ if eq .IsVPN 0 }} class="nav-item nav-link active" {{ else }} class="nav-item nav-link" {{ end }} id="copy-clipboard-tab" data-toggle="tab" href="#copy-clipboard" role="tab" style="z-index: 1;"><i class="fas fa-clipboard"></i> Copy / Paste</a>
<a class="nav-item nav-link" style="z-index: 1;"id="conn-error-tab" data-toggle="tab" href="#conn-error" role="tab"><i class="fas fa-exclamation-circle"></i> Connection Error</a>
{{ end }}
</div>
<div class="tab-content p-3" id="nav-tabContent">
{{ if or (eq .IsVPN 1) (eq .IsVPN 2 ) }}
<div class="tab-pane fade show active" id="vpn-conn" role="tabpanel" aria-labelledby="vpn-conn-tab">
In order to have VPN connection into virtualized lab environment on Haaukins,
you need to install Wireguard client for your computer. <br>
<b>Installation guideline for variety of clients are available on official website of Wireguard.</b>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; color:red;">Install Wireguard Client</p>
<li> Installation instructions for all clients: <a href="https://www.wireguard.com/install/">https://www.wireguard.com/install/</a></li>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; color:red;">User Scripts</p>
<li> Install Wireguard script : <a href="https://raw.githubusercontent.com/Mymaqn/wireguardhaaukins/main/install_wireguard.sh">install_wireguard.sh</a> </li>
<li> Connect Event script: <a href="https://raw.githubusercontent.com/Mymaqn/wireguardhaaukins/main/connectwireguard.py">connect_event.py</a> </li>
<li> Connect Event script is making your Wireguard interface up and modifies your <code>/etc/hosts</code> file</li>
<li> If you notice outdated information, help us to update :)</li>
<li> Use the scripts with your responsibility. </li>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; color:red;">Lab Information</p>
<li>Your Lab subnet: <b><code>{{ .LabSubnet }}</code></b></li>
<li>To begin, start with scanning lab subnet</li>
<li>Ignore first IP address from AllowedIPs (etc 10.33.212.1)</li>
<li>A team has four different configuration files</li>
<li>Four people can solve challenges simultaneously on VPN connection</li>
<li>Make sure each member of team using different configuration file</li>
<li>In configuration file, you will have hosts information.</li>
<li>Append hosts information in configuration file to your local <code>/etc/hosts</code> file.</li>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; color:red;">For Linux users: (after installation of client)</p>
<li> * If you used scripts given above, you can skip steps below </li>
<li> Download the configuration file from the event page</li>
<li> Place the configuration file under <b><code>/etc/wireguard/</code></b></li>
<li> Connect VPN by typing <b><code>wg-quick up filename</code></b></li>
<li> If you receive <b><code> resolvconf: command not found </code></b> error: </li>
<li> (On KALI and Debian Based Operating Systems)</li>
<li> <b><code> ln -s /usr/bin/resolvectl /usr/local/bin/resolvconf </code></b> </li>
<li> If given command DOES NOT solve your problem do following: ( if the problem solved <b>SKIP THIS STEP</b> ) </li>
<li> <b><code> sudo apt-get update -y && sudo apt-get install resolvconf -y </code></b></li>
<li>If you receive <b><code>Unknown interface 'tun': No such device</code></b>, remove <code>DNS = 1.1.1</code> from VPN configuration file</li>
<li> Make sure about filename when you are connecting to VPN</li>
<li> Check connection with <b><code>wg</code></b> command </li>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; color:red;">For MacOS users: (after installation of client)</p>
<li> Install GUI or CLI client from <a href="https://www.wireguard.com/install/">installation page</a></li>
<li> If you are using GUI, just import configuration file and activate it </li>
<li> If you are using CLI, place conf file under <b><code>/etc/wireguard/</code></b></li>
<li> Connect VPN by typing <b><code>wg-quick up filename</code></b> </li>
<li> Make sure about filename when you are connecting to VPN</li>
<li> Check connection with <b><code>wg</code></b> command</li>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; ">GUI Example (For MacOS users)</p>
<video class="img-fluid" controls>
<source src="/assets/img/wireguard_conn_mac.mp4" type="video/mp4">
Your browser does not support the video tag.
</video>
<p class="p-2 mt-2 dark-color mb-0" style="font-weight: bold; color:red;">For Windows users: (after installation of client)</p>
<li> Download application from <a href="https://www.wireguard.com/install/">installation page</a></li>
<li> Import configuration file as shown for MacOS</li>
<li> Make sure handshake is successfully done.</li>
</div>
{{ end }}
{{ if or (eq .IsVPN 0) (eq .IsVPN 2) }}
<div {{ if eq .IsVPN 0 }} class="tab-pane fade show active" {{ else }} class="tab-pane fade" {{ end }} id="copy-clipboard" role="tabpanel" aria-labelledby="copy-clipboard-tab">
<p class="dark-color">
In order to copy from Host to VM on the browser and the way around, these are the following command:
<br>
<li> On Windows & Linux: <strong class="text-black">Ctrl+Alt+Shift</strong></li>
<li> On MacOS: <strong class="text-black">Ctrl+Command+Shift</strong></li>
<br>
You might need to logout and login to VM cause sometimes keyboard combination is getting broken.
For example, when you type A it writes E.
</p>
<video class="img-fluid" controls>
<source src="/assets/img/CopyToClipboard.mp4" type="video/mp4">
Your browser does not support the video tag.
</video>
</div>
<div class="tab-pane fade" id="conn-error" role="tabpanel" aria-labelledby="conn-error-tab">
<div class="text-center">
<img class="img-fluid" src="/assets/img/connection-error.png">
</div>
<p class="p-2 mt-2 dark-color mb-0">
There are multiple reasons behind this error for example:
<br>
<li> The VM crashed and you can not connect it </li>
<li> There might be multiple open tabs with same VM instance</li>
<li> After a while without any activity the VM goes into sleep mode</li>
<li> There might be poor internet connection</li>
<br>
In order to solve this error try out those steps:
<br>
<li> Close all the VM Tabs</li>
<li> Log out and login on event page</li>
<li> Click <strong>RESET Kali Machine</strong> button from challenges page</li>
<li> In case you still get the error create a new team</li>
</p>
</div>
{{ end }}
</div>
</div>
</div>
</div>
</div>
</div>
</div>
{{ end }}