vpn_eth

© 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

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

Configuration

see INSTALL.md for installation instructions.

Parameters

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

$ cat ~/.vpn_eth.rc
SERVER=sslvpn.ethz.ch
USER=corti
REALM=id
VPZ=id

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

Credentials

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:

Documentation

The majority of the documentation files are written using the GitHub Flavored Markdown language.

Bugs

Report bugs to https://github.com/matteocorti/vpn_eth/issues