mirror of
https://github.com/yuezk/GlobalProtect-openconnect.git
synced 2025-04-02 18:31:50 -04:00
141 lines
3.6 KiB
Markdown
141 lines
3.6 KiB
Markdown
# GlobalProtect-openconnect
|
|
A GlobalProtect VPN client (GUI) for Linux based on Openconnect and built with Qt5, supports SAML auth mode, inspired by [gp-saml-gui](https://github.com/dlenski/gp-saml-gui).
|
|
|
|
<p align="center">
|
|
<img src="screenshot.png">
|
|
</p>
|
|
|
|
## Features
|
|
|
|
- Similar user experience as the official client in macOS.
|
|
- Supports both SAML and non-SAML authentication modes.
|
|
- Supports automatically selecting the preferred gateway from the multiple gateways.
|
|
- Supports switching gateway from the system tray menu manually.
|
|
|
|
## Future plan
|
|
|
|
- [ ] Improve the release process
|
|
- [ ] Process bugs and feature requests
|
|
- [ ] Support for bypassing the `gpclient` parameters
|
|
- [ ] Support the CLI mode
|
|
|
|
## Passing the Custom Parameters to `OpenConnect` CLI
|
|
|
|
Custom parameters can be appended to the `OpenConnect` CLI with the following settings.
|
|
<p align="center">
|
|
<img src="https://user-images.githubusercontent.com/3297602/129464304-94eb8a2b-1c4a-47e1-b931-4422fff6eb81.png" />
|
|
<p>
|
|
|
|
## Prerequisites
|
|
|
|
- Openconnect v8.x
|
|
- Qt5, qt5-webengine, qt5-websockets
|
|
|
|
### Ubuntu
|
|
1. Install openconnect v8.x
|
|
|
|
```sh
|
|
sudo apt install openconnect
|
|
openconnect --version
|
|
```
|
|
|
|
For Ubuntu 18.04 you might need to [build the latest openconnect from source code](https://gist.github.com/yuezk/ab9a4b87a9fa0182bdb2df41fab5f613).
|
|
|
|
2. Install the Qt dependencies
|
|
|
|
For Ubuntu 20, this should work.
|
|
|
|
```sh
|
|
sudo apt install qtbase5-dev libqt5websockets5-dev qtwebengine5-dev qttools5-dev debhelper
|
|
```
|
|
|
|
For Ubuntu 21, you need to install the base pieces separately as QT5 is the default.
|
|
|
|
```sh
|
|
sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools libqt5websockets5-dev qtwebengine5-dev qttools5-dev debhelper
|
|
```
|
|
|
|
### OpenSUSE
|
|
Install the Qt dependencies
|
|
|
|
```sh
|
|
sudo zypper install libqt5-qtbase-devel libqt5-qtwebsockets-devel libqt5-qtwebengine-devel
|
|
```
|
|
|
|
### Fedora
|
|
Install the Qt dependencies:
|
|
|
|
```sh
|
|
sudo dnf install qt5-qtbase-devel qt5-qttools-devel qt5-qtwebengine qt5-qtwebsockets-devel qt5-qtwebengine-devel
|
|
```
|
|
|
|
## Install
|
|
|
|
### Install from AUR (Arch/Manjaro)
|
|
|
|
Install [globalprotect-openconnect](https://aur.archlinux.org/packages/globalprotect-openconnect/).
|
|
|
|
### Build from source code
|
|
|
|
```sh
|
|
git clone https://github.com/yuezk/GlobalProtect-openconnect.git
|
|
cd GlobalProtect-openconnect
|
|
git submodule update --init
|
|
|
|
# qmake or qmake-qt5
|
|
qmake CONFIG+=release
|
|
make
|
|
sudo make install
|
|
```
|
|
Open `GlobalProtect VPN` in the application dashboard.
|
|
|
|
### Debian package
|
|
|
|
Relatively manual process for now:
|
|
|
|
* Clone the source tree
|
|
|
|
```
|
|
git clone https://github.com/yuezk/GlobalProtect-openconnect.git
|
|
cd GlobalProtect-openconnect
|
|
```
|
|
|
|
* Install git-archive-all using the pip. Remember to adjust the version numbers etc.
|
|
|
|
```
|
|
pip install git-archive-all
|
|
```
|
|
|
|
* Next create an upstream source tree using git archive.
|
|
|
|
```
|
|
git-archive-all --force-submodules --prefix=globalprotect-openconnect-1.3.0/ ../globalprotect-openconnect_1.3.0.orig.tar.gz
|
|
```
|
|
|
|
* Finally extract the source tree, build the debian package, and install it.
|
|
|
|
```
|
|
cd ..
|
|
tar -xzvf globalprotect-openconnect_1.3.0.orig.tar.gz
|
|
cd globalprotect-openconnect-1.3.0
|
|
fakeroot dpkg-buildpackage -uc -us -sa 2>&1 | tee ../build.log
|
|
sudo dpkg -i globalprotect-openconnect_1.3.0-1ppa1_amd64.deb
|
|
```
|
|
|
|
### NixOS
|
|
In `configuration.nix`:
|
|
|
|
```
|
|
services.globalprotect = {
|
|
enable = true;
|
|
# if you need a Host Integrity Protection report
|
|
csdWrapper = "${pkgs.openconnect}/libexec/openconnect/hipreport.sh";
|
|
};
|
|
|
|
environment.systemPackages = [ globalprotect-openconnect ];
|
|
```
|
|
|
|
|
|
## [License](./LICENSE)
|
|
GPLv3
|