openconnect: list the defaultroute option
[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 token_mode 'rsa' # when built with stoken support
14 option token_secret 'secret' # when built with stoken support
15 option defaultroute '0'
16 option authgroup 'DEFAULT'
17
18 The additional files are also used:
19 /etc/openconnect/user-cert-vpn-MYVPN.pem: The user certificate
20 /etc/openconnect/user-key-vpn-MYVPN.pem: The user private key
21 /etc/openconnect/ca-vpn-MYVPN.pem: The CA certificate (instead of serverhash)
22
23 After these are setup you can initiate the VPN using "ifup MYVPN", and
24 deinitialize it using ifdown. You may also use the luci web interface
25 (Network -> Interfaces -> MYVPN Connect).
26
27 Note that you need to configure the firewall to allow communication between
28 the MYVPN interface and lan.
29
30
31 There is a luci plugin to allow configuring an openconnect interface from
32 the web environment; see the luci-proto-openconnect package.