aboutsummaryrefslogtreecommitdiff
path: root/content/docs/openbsd
diff options
context:
space:
mode:
Diffstat (limited to 'content/docs/openbsd')
-rw-r--r--content/docs/openbsd/wireguard.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/content/docs/openbsd/wireguard.md b/content/docs/openbsd/wireguard.md
new file mode 100644
index 0000000..71d670e
--- /dev/null
+++ b/content/docs/openbsd/wireguard.md
@@ -0,0 +1,60 @@
+---
+title: Wireguard
+description: How to configure a wireguard endpoint on OpenBSD
+---
+
+## Introduction
+
+OpenBSD does things elegantly as usual : where linux distributions have a service, OpenBSD has a simple `/etc/hostname.wg0` file. The interface is therefore managed without any tool other than the standard ifconfig, it's so simple and elegant!
+
+## Configuration example
+
+Here is a configuration example to create a tunnel listening on udp port 342 and several peers :
+{{< highlight cfg >}}
+wgport 342 wgkey '4J7O3IN7+MnyoBpxqDbDZyAQ3LUzmcR2tHLdN0MgnH8='
+10.1.2.1/24
+wgpeer 'LWZO5wmkmzFwohwtvZ2Df6WAvGchcyXpzNEq2m86sSE=' wgaip 10.1.2.2/32
+wgpeer 'SjqCIBpTjtkMvKtkgDFIPJsAmQEK/+H33euekrANJVc=' wgaip 10.1.2.4/32
+wgpeer '4CcAq3xqN496qg2JR/5nYTdJPABry4n2Kon96wz981I=' wgaip 10.1.2.8/32
+wgpeer 'vNNic3jvXfbBahF8XFKnAv9+Cef/iQ6nWxXeOBtehgc=' wgaip 10.1.2.6/32
+{{< /highlight >}}
+
+Your private key goes on the first line as argument to `wgkey`, the other keys are public keys for each peer.
+
+## Administration
+
+Private keys can be generated with the following command :
+{{< highlight sh >}}
+openssl rand -base64 32
+{{< /highlight >}}
+
+The tunnel can be managed with the standard `ifconfig` command:
+{{< highlight sh >}}
+root@yen:~# ifconfig wg0
+wg0: flags=80c3<UP,BROADCAST,RUNNING,NOARP,MULTICAST> mtu 1420
+ index 4 priority 0 llprio 3
+ wgport 342
+ wgpubkey R4A01RXXqRJSY9TiKQrZGR85HsFNSXxhRKKEu/bEdTQ=
+ wgpeer LWZO5wmkmzFwohwtvZ2Df6WAvGchcyXpzNEq2m86sSE=
+ wgendpoint 90.66.117.156 1024
+ tx: 158515972, rx: 151576036
+ last handshake: 93 seconds ago
+ wgaip 10.1.2.2/32
+ wgpeer SjqCIBpTjtkMvKtkgDFIPJsAmQEK/+H33euekrANJVc=
+ wgendpoint 90.66.117.156 51110
+ tx: 30969024, rx: 14034688
+ last handshake: 9527 seconds ago
+ wgaip 10.1.2.4/32
+ wgpeer 4CcAq3xqN496qg2JR/5nYTdJPABry4n2Kon96wz981I=
+ wgendpoint 90.66.117.156 46247
+ tx: 36877516, rx: 19036472
+ last handshake: 23 seconds ago
+ wgaip 10.1.2.8/32
+ wgpeer vNNic3jvXfbBahF8XFKnAv9+Cef/iQ6nWxXeOBtehgc=
+ wgendpoint 90.66.117.156 1025
+ tx: 150787792, rx: 146836696
+ last handshake: 43 seconds ago
+ wgaip 10.1.2.6/32
+ groups: wg
+ inet 10.1.2.1 netmask 0xffffff00 broadcast 10.1.2.255
+{{< /highlight >}}