© Matteo Corti, ETH Zurich, 2024.
see AUTHORS.md for the complete list of contributors
A script to manage VPN connection with Cisco Secure Client on macOS to the ETH Zurich
Usage: vpn_eth.sh [ command ] [OPTIONS]
Commands:
connect,c Connects
disconnect,d Disconnects
init,i Initializes the default settings
stats Shows the connection statistics
status,s Shows the connection status
Options:
-h,--help,-? This help message
-r,--realm realm Realm
-s,--server server VPN server
-u,--user user User
-v,--version Prints the script version number
-z,--vpz vpz VPZ
Report bugs to https://github.com/matteocorti/vpn_eth/issues
see INSTALL.md for installation instructions.
You will need the VPN server (usually sslvpn.ethz.ch) the realm and the vpz you need to connect to.
These can be specified as parameters on the command line. E.g.
vpn_eth conncect --server sslvpn.ethz.ch --realm id --vpz id --user corti
or stored in the configuration file. For example (change the username):
$ cat ~/.vpn_eth.rc
SERVER=sslvpn.ethz.ch
USER=username
REALM1=staff-net
VPZ1=staff-net
REALM2=student-net
VPZ2=student-net
The configuration file can be generated interactively with the init command:
$ vpn_eth init
Please specify the VPN server: sslvpn.ethz.ch
Please specify the realm: id
Please specify the vpz: id
The sample configuration file can be installed with
make install_conf
You will need your RADIUS password and your OTP secret: see About the «OTP Secret»
Both will be stored in your macOS keychain.
By the first run the script will ask for the credentials:
$ ./vpn_eth connect
Please specify RADIUS password:
Please specify OTP secret:
The script can be used as an xbar plugin:
Install as an xbar plugin or follow the manual installation instructions.
The majority of the documentation files are written using the GitHub Flavored Markdown language.
Report bugs to https://github.com/matteocorti/vpn_eth/issues