Merge pull request #5211 from dibdot/adblock
[feed/packages.git] / net / openconnect / README
1 The openconnect client expects to be configured using the uci interface.
2
3 To setup a VPN connection, add the following to /etc/config/network:
4
5 config interface 'MYVPN'
6 option proto 'openconnect'
7 option interface 'wan'
8 option server 'vpn.example.com'
9 option port '4443'
10 option username 'test'
11 option password 'secret'
12 option serverhash 'AE7FF6A0426F0A0CD0A02EB9EC3C5066FAEB0B25'
13 option defaultroute '0'
14 option authgroup 'DEFAULT'
15
16 # For second factor auth:
17
18 # when a fixed 2FA password can be used
19 #option password2 'my-fixed-2fa-password'
20
21 # RSA tokens, must be built with stoken support
22 #option token_mode 'rsa'
23 #option token_secret 'secret'
24
25 # HOTP/TOTP tokens
26 #option token_mode 'hotp'
27 #option token_secret '00'
28
29 # Juniper vpn support
30 #option juniper '1'
31
32 The additional files are also used:
33 /etc/openconnect/user-cert-vpn-MYVPN.pem: The user certificate
34 /etc/openconnect/user-key-vpn-MYVPN.pem: The user private key
35 /etc/openconnect/ca-vpn-MYVPN.pem: The CA certificate (instead of serverhash)
36
37 After these are setup you can initiate the VPN using "ifup MYVPN", and
38 deinitialize it using ifdown. You may also use the luci web interface
39 (Network -> Interfaces -> MYVPN Connect).
40
41 Note that you need to configure the firewall to allow communication between
42 the MYVPN interface and lan.
43
44
45 There is a luci plugin to allow configuring an openconnect interface from
46 the web environment; see the luci-proto-openconnect package.