vpnc

pass integration with OpenVPN.
git clone https://codeberg.org/tilt/vpnc.git
Log | Files | Refs | README | LICENSE

README.md (1173B)


      1 vpnc
      2 ====
      3 
      4 OpenVPN script integrated with [The Standard Unix Password Manager][],
      5 also known as `pass`.
      6 
      7 When this script is in users path with correct variables set, to connect to
      8 OpenVPN, all you need to do is run `vpnc`, give PGP key/root password and you
      9 get connected.
     10 
     11 # Configuration
     12 
     13 1. **Note: Do not do this step if you already got pass setup.**
     14 Install pass, generate a PGP key if you do not got one already and initiate the
     15 password store using that GPG key.
     16 
     17 ``` sh
     18 gpg --full-gen-key
     19 gpg --list-secret-keys --keyid-format LONG
     20 pass init "KEYID-GOES-HERE"
     21 ```
     22 
     23 2. Encrypt your vpn username in one password file and your vpn password in
     24 another password file. For instance, if you add them like so:
     25 
     26 ``` sh
     27 pass add vpn_username
     28 pass add vpn_password
     29 ```
     30 
     31 You would then in the script change "pass/path/to/username" into "vpn_username"
     32 and "pass/path/to/password" into "vpn_password".
     33 
     34 3. Set `config_dir` variable in script to your OpenVPN directory where the
     35 OpenVPN config file is stored and variable `config_file` the name of the 
     36 OpenVPN config file including its .ovpn extension.
     37 
     38 ---
     39 
     40 [The Standard Unix Password Manager]: https://www.passwordstore.org/