KUVPN v0.6.4

KUVPN is a simple Rust cli to retrieve the DSID cookie and execute the OpenConnect command to connect to the VPN for Koç University.

Features

• Login to vpn.ku.edu.tr in linux/mac.
• Retrieve DSID cookie
• Execute OpenConnect command
• Customizable URL
• Remembers your login session safely
• Nix build for reliable building
• Logging for debugging tool

Prerequisites

• Mandatory: OpenConnect
  • On ubuntu: sudo apt install openconnect
  • Optional: when used with --dsid / -d flag.
• Optional (AutoInstall: when not found): Chromium/Chrome

Binary Install (Recommended)

curl --proto '=https' --tlsv1.2 -sSfL https://raw.githubusercontent.com/KUACC-VALAR-HPC-KOC-UNIVERSITY/kuvpn/main/install.sh | bash

Note: Always inspect scripts before running commands from the internet!

Binary Install (Manual)

1. Download the latest binary from the GitHub releases page.

2. Move the binary to a directory in your $PATH, for example:

   sudo mv kuvpn /usr/local/bin/

3. Make the binary executable:

   sudo chmod +x /usr/local/bin/kuvpn

4. Verify the installation by running:

   kuvpn --version

Alternatively, Build & Install (Source Code)

First, install Rustup using this command or your package manager. While you can use Cargo from a package manager, it is not recommended:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Afterward, you can install KUVPN from source using this command:

cargo install --git https://github.com/KUACC-VALAR-HPC-KOC-UNIVERSITY/kuvpn

Usage

You may simply run:

kuvpn

For help you may run:

kuvpn --help

For more information on what it does while running, you may use:

kuvpn --level info

kuvpn --help:

Simple program to retrieve DSID cookie and execute OpenConnect command

Usage: kuvpn [OPTIONS]

Options:
  -u, --url <URL>
          The URL to the page where we will start logging in and looking for DSID
          
          [default: https://vpn.ku.edu.tr]

  -l, --level <LEVEL>
          The level of logging
          
          [default: error]

          Possible values:
          - off:   No logs
          - info:  Informational messages
          - warn:  Warning messages
          - debug: Debugging messages
          - error: Error messages
          - trace: Detailed stacktrace messages

  -d, --dsid
          Gives the user the dsid without running openconnect

  -c, --clean
          Delete session information

  -a, --agent <AGENT>
          User agent for browser
          
          [default: Mozilla/5.0]

  -r, --run-command <RUN_COMMAND>
          Command to run openconnect with (e.g., doas, sudo, pkexec, or a custom script)

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

We welcome contributions from everyone! If you have an idea, fix, or improvement, please feel free to get involved.