summaryrefslogtreecommitdiff
path: root/docs/vpn
diff options
context:
space:
mode:
authorroot <ronie@vyos.io>2020-09-10 02:29:37 -0500
committerroot <ronie@vyos.io>2020-09-11 07:28:49 -0500
commit393d03faf458b98e6b1b87d8c9a74cab5345ca96 (patch)
tree03d16995044837c932f1ef09e2565d523d96a081 /docs/vpn
parentca432e2ec6bf8c33c652aee9bc7bc0e2b4a4bd6a (diff)
parentefa25bc32dad395b8fdc8f62b0ed032fa653fa0d (diff)
downloadvyos-documentation-393d03faf458b98e6b1b87d8c9a74cab5345ca96.tar.gz
vyos-documentation-393d03faf458b98e6b1b87d8c9a74cab5345ca96.zip
Revert "T2810: Docs for vpn anyconnect-server"
This reverts commit ca432e2ec6bf8c33c652aee9bc7bc0e2b4a4bd6a.
Diffstat (limited to 'docs/vpn')
-rw-r--r--docs/vpn/anyconnect.rst5
-rw-r--r--docs/vpn/index.rst2
-rw-r--r--docs/vpn/openconnect.rst80
3 files changed, 86 insertions, 1 deletions
diff --git a/docs/vpn/anyconnect.rst b/docs/vpn/anyconnect.rst
index 64c3e49f..e8945fbb 100644
--- a/docs/vpn/anyconnect.rst
+++ b/docs/vpn/anyconnect.rst
@@ -7,6 +7,7 @@ OpenConnect-compatible server feature is available from this release.
Openconnect VPN supports SSL connection and offers full network access. SSL VPN network extension connects the end-user system to the corporate network with access controls based only on network layer information, such as destination IP address and port number. So, it provides safe communication for all types of device traffic across public networks and private networks, also encrypts the traffic with SSL protocol.
The remote user will use the openconnect client to connect to the router and will receive an IP address from a VPN pool, allowing full access to the network.
+
.. note:: All certificates should be stored on VyOS under /config/auth. If certificates are not stored in the /config directory they will not be migrated during a software update.
@@ -44,6 +45,7 @@ Server Configuration
set vpn openconnect ssl cert-file <file>
set vpn openconnect ssl key-file <file>
+
Example
----
@@ -62,12 +64,15 @@ The Gateway IP Address must be in one of the router´s interfaces.
set vpn openconnect ssl cert-file '/config/auth/cert.pem'
set vpn openconnect ssl key-file '/config/auth/privkey.pem'
+
Verification
----
.. code-block:: none
+
vyos@RTR1:~$ show openconnect-server sessions
+
interface username ip remote IP RX TX state uptime
----------- ---------- ------------ ------------- -------- -------- --------- --------
sslvpn0 user4 100.64.0.105 xx.xxx.49.253 127.3 KB 160.0 KB connected 12m:28s
diff --git a/docs/vpn/index.rst b/docs/vpn/index.rst
index aea1ada2..4441c003 100644
--- a/docs/vpn/index.rst
+++ b/docs/vpn/index.rst
@@ -15,4 +15,4 @@ VPN
site2site_ipsec
sstp
wireguard
- anyconnect
+ OpenConnect
diff --git a/docs/vpn/openconnect.rst b/docs/vpn/openconnect.rst
new file mode 100644
index 00000000..9d6dd6da
--- /dev/null
+++ b/docs/vpn/openconnect.rst
@@ -0,0 +1,80 @@
+.. _vpn-openconnect:
+
+OpenConnect
+-----
+
+OpenConnect-compatible server feature is available from this release.
+Openconnect VPN supports SSL connection and offers full network access. SSL VPN network extension connects the end-user system to the corporate network with access controls based only on network layer information, such as destination IP address and port number. So, it provides safe communication for all types of device traffic across public networks and private networks, also encrypts the traffic with SSL protocol.
+The remote user will use the openconnect client to connect to the router and will receive an IP address from a VPN pool, allowing full access to the network.
+
+
+.. note:: All certificates should be stored on VyOS under /config/auth. If certificates are not stored in the /config directory they will not be migrated during a software update.
+
+
+Configuration
+^^^^^^^^^^
+
+SSL Certificates
+----
+
+We need to generate the certificate which authenticates users who attempt to access the network resource through the SSL VPN tunnels.
+The following command will create a self signed certificates and will be stored in the file path /config/auth
+
+.. code-block:: none
+
+ openssl req -newkey rsa:4096 -new -nodes -x509 -days 3650 -keyout /config/auth/server.key -out /config/auth/server.crt
+ openssl req -new -x509 -key /config/auth/server.key -out /config/auth/ca.crt
+
+We can also create the certificates using Cerbort which is an easy-to-use client that fetches a certificate from Let’s Encrypt — an open certificate authority launched by the EFF, Mozilla, and others—and deploys it to a web server.
+
+.. code-block:: none
+
+ sudo certbot certonly --standalone --preferred-challenges http -d <domain name>
+
+Server Configuration
+-------------------------
+
+.. code-block:: none
+
+ set vpn openconnect authentication local-users username <user> password <pass>
+ set vpn openconnect authentication mode <local|radius>
+ set vpn opneconnect network-settings client-ip-settings subnet <subnet>
+ set vpn openconnect network-settings name-server <address>
+ set vpn openconnect network-settings name-server <address>
+ set vpn openconnect ssl ca-cert-file <file>
+ set vpn openconnect ssl cert-file <file>
+ set vpn openconnect ssl key-file <file>
+
+
+Example
+----
+
+Use local user name "user4" with password "SecretPassword"
+Client IP addresses will be provided from pool 100.64.0.0/24
+The Gateway IP Address must be in one of the router´s interfaces.
+
+.. code-block:: none
+
+ set vpn openconnect authentication local-users username user4 password 'SecretPassword'
+ set vpn openconnect authentication mode 'local'
+ set vpn openconnect network-settings client-ip-settings subnet '100.64.0.0/24'
+ set vpn openconnect network-settings name-server '1.1.1.1'
+ set vpn openconnect network-settings name-server '8.8.8.8'
+ set vpn openconnect ssl ca-cert-file '/config/auth/fullchain.pem'
+ set vpn openconnect ssl cert-file '/config/auth/cert.pem'
+ set vpn openconnect ssl key-file '/config/auth/privkey.pem'
+
+
+Verification
+----
+
+.. code-block:: none
+
+
+ vyos@RTR1:~$ show openconnect-server sessions
+
+ interface username ip remote IP RX TX state uptime
+ ----------- ---------- ------------ ------------- -------- -------- --------- --------
+ sslvpn0 user4 100.64.0.105 xx.xxx.49.253 127.3 KB 160.0 KB connected 12m:28s
+
+.. note:: It is compatible with Cisco (R) AnyConnect (R) clients.