๐ EHU Tools ๐
April 14, 2026 ยท View on GitHub
๐ EHU Tools ๐
A set of CLI utilities for managing LDAP authentication, VPN connections, and 2FA for the University of the Basque Country (UPV/EHU).
๐ Features
- ๐ LDAP Authentication: Store and use your EHU credentials securely.
- ๐ก 2FA Support: Generate time-based one-time passwords (TOTP) using
oathtool. - ๐ VPN Management: Connect and disconnect from the EHU VPN using Fortinet protocol.
- ๐ก SSH Management: Save and manage SSH server connections.
- โ๏ธ Interactive Menu: Simple text-based UI for easy configuration.
๐ง Requirements
bashoathtool(for 2FA support)openconnect(for VPN connections - requires root privileges)
๐ฅ Installation
Run the following command to download and install EHU Tools:
curl -sSL https://raw.githubusercontent.com/KingJorjai/ehu-tools/main/install.sh | bash
Alternatively, you can clone the repository and install manually:
git clone https://github.com/KingJorjai/ehu-tools.git
cd ehu-tools
bash install.sh
๐ Usage
After installation, simply run:
ehu-tools
The tool provides an interactive menu with the following options:
- Connect to VPN - Establish VPN connection using openconnect
- Disconnect from VPN - Terminate VPN connection
- Manage SSH Servers - Add, remove, or connect to saved SSH servers
- Set LDAP credentials - Configure your EHU username and password
- Set 2FA secret - Configure your TOTP secret for 2FA
๐ Security Notes
- Credentials are stored locally in
~/.config/ehu-tools/ - All sensitive data is handled securely and cleared from memory after use
- VPN connections require root privileges due to openconnect requirements
๐ค Contributing
Feel free to open issues and submit pull requests to improve this tool!