{"id":15013270,"url":"https://github.com/hlhr202/openconnect-rs","last_synced_at":"2025-04-12T04:41:44.172Z","repository":{"id":228200161,"uuid":"766198819","full_name":"hlhr202/Openconnect-RS","owner":"hlhr202","description":"An Openconnect Lib/GUI for rust","archived":false,"fork":false,"pushed_at":"2024-05-24T02:52:07.000Z","size":4154,"stargazers_count":16,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-26T00:11:33.473Z","etag":null,"topics":["anyconnect","gui","openconnect","rust","tauri","vpn","vpn-client"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/openconnect-core","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hlhr202.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-LGPL","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-02T15:55:33.000Z","updated_at":"2025-02-27T14:27:27.000Z","dependencies_parsed_at":"2024-05-07T17:02:07.660Z","dependency_job_id":null,"html_url":"https://github.com/hlhr202/Openconnect-RS","commit_stats":null,"previous_names":["hlhr202/openconnect-rs"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlhr202%2FOpenconnect-RS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlhr202%2FOpenconnect-RS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlhr202%2FOpenconnect-RS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hlhr202%2FOpenconnect-RS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hlhr202","download_url":"https://codeload.github.com/hlhr202/Openconnect-RS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248519311,"owners_count":21117756,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anyconnect","gui","openconnect","rust","tauri","vpn","vpn-client"],"created_at":"2024-09-24T19:44:00.797Z","updated_at":"2025-04-12T04:41:44.146Z","avatar_url":"https://github.com/hlhr202.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenConnect for Rust\n\n\u003ca target=\"_blank\" href=\"https://github.com/hlhr202/Openconnect-RS/blob/main/LICENSE-LGPL\"\u003e\u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/hlhr202/Openconnect-RS\"\u003e\u003c/a\u003e \u003ca target=\"_blank\" href=\"https://crates.io/crates/openconnect-core\"\u003e\u003cimg alt=\"Crates.io Version\" src=\"https://img.shields.io/crates/v/openconnect-core?label=crates.io%20openconnect-core\"\u003e\u003c/a\u003e \u003ca target=\"_blank\" href=\"https://github.com/hlhr202/Openconnect-RS/releases\"\u003e\u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/hlhr202/Openconnect-RS?include_prereleases\"\u003e\u003c/a\u003e\n\n\u003cimg alt=\"GitHub Actions Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/hlhr202/Openconnect-RS/mingw64.yml?label=win-x86_64%20build\"\u003e \u003cimg alt=\"GitHub Actions Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/hlhr202/Openconnect-RS/mac-aarch64.yml?label=mac-aarch64%20build\" /\u003e \u003cimg alt=\"GitHub Actions Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/hlhr202/Openconnect-RS/mac-x64.yml?label=mac-x86_64%20build\"\u003e \u003cimg alt=\"GitHub Actions Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/hlhr202/Openconnect-RS/linux-x64.yml?label=linux-x86_64%20build\"\u003e\n\nThis is a cross-platform GUI client for OpenConnect, written in Rust and designed to work seamlessly on Windows, Linux, and macOS desktop systems. The program utilizes various technologies including MSYS2, Tauri, React, and NextUI. It provides a user-friendly interface for connecting to VPN servers using both password and OIDC authentication methods.\n\n## Features\n\n- Cross-platform compatibility (Windows, Linux, macOS)\n- Easy-to-use GUI interface\n- Support for both password and OIDC authentication\n- Built with MSYS2, Tauri, React, and NextUI\n\n## Screenshots\n\n\u003cimg src=\"./doc/screenshot/openconnect-1.png\" width=\"360px\" height=\"320px\" alt=\"Main\"\u003e\n\u003cimg src=\"./doc/screenshot/openconnect-2.png\" width=\"360px\" height=\"320px\" alt=\"Edit\"\u003e\n\u003cimg src=\"./doc/screenshot/openconnect-3.png\" width=\"360px\" height=\"320px\" alt=\"Connect\"\u003e\n\n## Installation of Client\n\n- GUI:\n\n  - Supports Windows(x64), Linux(x64), and macOS(aarch64, x64)\n\n  - Download can be found in [Releases](https://github.com/hlhr202/Openconnect-RS/releases)\n\n- CLI install:\n\n  - Only supports Linux(x64) and macOS(aarch64, x64)\n\n  - Run the following command in your terminal:\n\n    ```bash\n    curl -sL https://raw.githubusercontent.com/hlhr202/Openconnect-RS/main/install-cli.sh | bash\n    ```\n\n## Usage of CLI client\n\n- Run the following command in your terminal:\n\n  ```bash\n  openconnect --help\n  ```\n\n  This will print the following help message:\n\n  ```plaintext\n  A CLI client to connect to VPN using OpenConnect\n\n  Usage: openconnect \u003cCOMMAND\u003e\n\n  Commands:\n    start         Connect to a VPN server and run in daemon mode [aliases: connect, run]\n    status        Get the current VPN connection status [aliases: info, stat]\n    stop          Close the current connection and exit the daemon process [aliases: kill, disconnect]\n    add           Add new VPN server configuration to local config file [aliases: new, create, insert]\n    import        Import VPN server configurations from a base64 encoded string\n    export        Export VPN server configurations to a base64 encoded string\n    delete        Delete a VPN server configuration from local config file [aliases: rm, remove, del]\n    list          List all VPN server configurations in local config file [aliases: ls, l]\n    logs          Show logs of the daemon process [aliases: log]\n    gen-complete  Generate shell completion script\n    help          Print this message or the help of the given subcommand(s)\n\n  Options:\n    -h, --help     Print help\n    -V, --version  Print version\n  ```\n\n- For each subcommand, you can run `openconnect \u003cCOMMAND\u003e --help` to get more information\n\n  For example:\n\n  ```bash\n  openconnect start --help\n  ```\n\n  This will print the following help message:\n\n  ```plaintext\n  Connect to a VPN server and run in daemon mode\n\n  Usage: openconnect start [OPTIONS] \u003cNAME\u003e\n\n  Arguments:\n    \u003cNAME\u003e  The server name saved in local config file to connect to\n\n  Options:\n    -c, --config-file \u003cCONFIG_FILE\u003e  The path to the local config file\n    -h, --help                       Print help\n  ```\n\n### Generate shell completion script\n\n- ZSH (Oh My Zsh!)\n\n  ```bash\n  mkdir -p ~/.oh-my-zsh/custom/plugins/openconnect\n  openconnect gen-complete zsh \u003e ~/.oh-my-zsh/custom/plugins/openconnect/openconnect.plugin.zsh\n  ```\n\n  Then add `openconnect` to the `plugins` array in your `~/.zshrc` file:\n\n- Bash\n\n  ```bash\n  mkdir -p ~/.bash_completion\n  openconnect gen-complete bash \u003e ~/.bash_completion/openconnect\n  echo \"source ~/.bash_completion/openconnect\" \u003e\u003e ~/.bashrc\n  ```\n\n## Build\n\n- Read the [System Requirements](./crates/openconnect-sys/README.md) for environment setup\n- Modify it to fit your environment (For automatic setup, its WIP)\n- For windows, since openconnect provides GNU automake, we currently only support MSYS2-MINGW64 and `x86_64-pc-windows-gnu` toolchain\n  - Install MSYS2\n  - Install `x86_64-pc-windows-gnu` toolchain with command `rustup default stable-x86_64-pc-windows-gnu`\n  - Run cargo under MINGW64 shell\n\n## License\n\nSince Openconnect is released under LGPL license, the core libraries (openconnect-core and openconnect-sys) of this project is licensed under the GNU Lesser General Public License (LGPL). See the [LICENSE](./LICENSE-LGPL) file for details.\n\nFor some part of this library (openconnect-oidc), it is licensed under the MIT license.\n\n## Acknowledgements\n\nSpecial thanks to (MORE THAN) the following projects and technologies for making this project possible:\n\n- [OpenConnect](https://www.infradead.org/openconnect/)\n- [MSYS2](https://www.msys2.org/)\n- [Tauri](https://tauri.app/)\n- [Tokio](https://tokio.rs/)\n- [Windows-rs](https://github.com/microsoft/windows-rs)\n- [OpenIDConnect](https://github.com/ramosbugs/openidconnect-rs)\n- [React](https://reactjs.org/)\n- [NextUI](https://nextui.org/)\n- [Vite](https://vitejs.dev/)\n\n## Roadmap\n\n### Openconnect sys\n\n- [x] Automatically build openconnect\n- [x] Automatically search library path\n  - [ ] Optimize search path for more cases\n- [ ] better docs\n\n### Openconnect core\n\n- [x] implement safe ffi\n- [x] implement username + password login\n- [x] implement cookie login\n- [x] implement ssl certificate validation\n- [ ] implement public key login\n- [ ] implement various auth methods\n- [ ] better docs\n\n### Client\n\n- [x] implement username + password login\n- [x] implement oidc login\n- [x] implement logs\n  - [x] tracing file rotation\n  - [ ] optimize log search\n- [x] implement CLI\n  - [x] Add/Remove configurations\n  - [x] Daemon mode\n  - [x] Password login\n  - [x] OIDC login\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhlhr202%2Fopenconnect-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhlhr202%2Fopenconnect-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhlhr202%2Fopenconnect-rs/lists"}