# openconnect/openconnect-gui architecture

> Architecture diagram of the GitHub repository openconnect/openconnect-gui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/openconnect/openconnect-gui
- Repository: https://github.com/openconnect/openconnect-gui

## Overview

OpenConnect GUI is a desktop client for configuring and managing OpenConnect VPN connections. The main workflow starts in the application window: users select or create a profile, then connect; VPN session code handles authentication, certificate checks, and tunnel setup while the window presents status and statistics. Separate capabilities include profile credentials and protocol settings, certificate/key handling, and logging. The source index and excerpts support the main wiring; links for unsampled implementation details are omitted rather than inferred.

Main entry points: [`src/vpninfo.cpp`](https://github.com/openconnect/openconnect-gui/blob/develop/src/vpninfo.cpp) (VPN session), [`src/server_storage.cpp`](https://github.com/openconnect/openconnect-gui/blob/develop/src/server_storage.cpp) (Profile storage), [`src/dialog/mainwindow.cpp`](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/mainwindow.cpp) (Main window), [`src/main.cpp`](https://github.com/openconnect/openconnect-gui/blob/develop/src/main.cpp) (Application startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_application["Application startup<br/>[main.cpp]"]
  node_mainwindow["Main window<br/>[mainwindow.cpp]"]
  node_profile_create["Profile creation"]
  node_profile_edit["Profile editor<br/>[editdialog.cpp]"]
  node_protocols["VPN protocols"]
  node_log_view["Log viewer<br/>[logdialog.cpp]"]
  node_input_dialog["Input dialogs<br/>[MyInputDialog.cpp]"]
  node_cert_dialog["Certificate prompts<br/>[MyCertMsgBox.cpp]"]
  node_message_dialog["Message dialogs<br/>[MyMsgBox.cpp]"]
end

subgraph group_vpn["VPN Session"]
  node_vpn_session["VPN session<br/>[vpninfo.cpp]"]
  node_vpn_library["OpenConnect library"]
end

subgraph group_profiles["Profiles and Credentials"]
  node_profiles_store[("Profile storage<br/>[server_storage.cpp]")]
  node_certificates["Certificate handling<br/>[cert.cpp]"]
  node_keys["Private key handling<br/>[key.cpp]"]
  node_keypairs["Client keypairs<br/>[keypair.cpp]"]
  node_secret_codec["Secret encoding<br/>[cryptdata.cpp]"]
  node_trust_db[("Trust database<br/>[gtdb.cpp]")]
end

subgraph group_support["Logging and Utilities"]
  node_logger["Logging service<br/>[logger.cpp]"]
  node_file_logger["File logging<br/>[FileLogger.cpp]"]
end

node_user(("User"))
node_vpn_server(("VPN server"))

node_user -->|"launches"| node_application
node_application -->|"creates"| node_mainwindow
node_application -->|"starts"| node_file_logger
node_mainwindow -->|"opens"| node_profile_create
node_mainwindow -->|"opens"| node_profile_edit
node_mainwindow -->|"opens"| node_log_view
node_mainwindow -->|"loads profiles"| node_profiles_store
node_mainwindow -->|"runs connection"| node_vpn_session
node_profile_create -->|"uses model"| node_protocols
node_profile_create -->|"saves profile"| node_profiles_store
node_profile_edit -->|"uses model"| node_protocols
node_profile_edit -->|"edits profile"| node_profiles_store
node_vpn_session -->|"calls"| node_vpn_library
node_vpn_session -->|"connects to"| node_vpn_server
node_vpn_session -->|"reads credentials"| node_profiles_store
node_vpn_session -->|"checks trust"| node_trust_db
node_vpn_session -->|"requests input"| node_input_dialog
node_vpn_session -->|"prompts certificate"| node_cert_dialog
node_vpn_session -->|"shows messages"| node_message_dialog
node_vpn_session -->|"records events"| node_logger
node_profiles_store -->|"encodes secrets"| node_secret_codec
node_profiles_store -->|"stores certificates"| node_certificates
node_profiles_store -->|"stores client keys"| node_keypairs
node_keypairs -->|"uses certificate"| node_certificates
node_keypairs -->|"uses key"| node_keys

click node_application "https://github.com/openconnect/openconnect-gui/blob/develop/src/main.cpp"
click node_mainwindow "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/mainwindow.cpp"
click node_profile_create "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/NewProfileDialog.cpp"
click node_profile_edit "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/editdialog.cpp"
click node_protocols "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/VpnProtocolModel.cpp"
click node_log_view "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/logdialog.cpp"
click node_input_dialog "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/MyInputDialog.cpp"
click node_cert_dialog "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/MyCertMsgBox.cpp"
click node_message_dialog "https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/MyMsgBox.cpp"
click node_vpn_session "https://github.com/openconnect/openconnect-gui/blob/develop/src/vpninfo.cpp"
click node_profiles_store "https://github.com/openconnect/openconnect-gui/blob/develop/src/server_storage.cpp"
click node_certificates "https://github.com/openconnect/openconnect-gui/blob/develop/src/cert.cpp"
click node_keys "https://github.com/openconnect/openconnect-gui/blob/develop/src/key.cpp"
click node_keypairs "https://github.com/openconnect/openconnect-gui/blob/develop/src/keypair.cpp"
click node_secret_codec "https://github.com/openconnect/openconnect-gui/blob/develop/src/cryptdata.cpp"
click node_trust_db "https://github.com/openconnect/openconnect-gui/blob/develop/src/gtdb.cpp"
click node_logger "https://github.com/openconnect/openconnect-gui/blob/develop/src/logger.cpp"
click node_file_logger "https://github.com/openconnect/openconnect-gui/blob/develop/src/FileLogger.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_application,node_mainwindow,node_profile_create,node_profile_edit,node_protocols,node_log_view,node_input_dialog,node_cert_dialog,node_message_dialog,node_user toneBlue
class node_vpn_session,node_vpn_library toneAmber
class node_profiles_store,node_certificates,node_keys,node_keypairs,node_secret_codec,node_trust_db,node_vpn_server toneMint
class node_logger,node_file_logger toneRose
```

## Components

### Application UI

- [Application startup](https://github.com/openconnect/openconnect-gui/blob/develop/src/main.cpp): `src/main.cpp`
- [Main window](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/mainwindow.cpp): `src/dialog/mainwindow.cpp`
- [Profile creation](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/NewProfileDialog.cpp): `src/dialog/NewProfileDialog.cpp`
- [Profile editor](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/editdialog.cpp): `src/dialog/editdialog.cpp`
- [VPN protocols](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/VpnProtocolModel.cpp): `src/dialog/VpnProtocolModel.cpp`
- [Log viewer](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/logdialog.cpp): `src/dialog/logdialog.cpp`
- [Input dialogs](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/MyInputDialog.cpp): `src/dialog/MyInputDialog.cpp`
- [Certificate prompts](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/MyCertMsgBox.cpp): `src/dialog/MyCertMsgBox.cpp`
- [Message dialogs](https://github.com/openconnect/openconnect-gui/blob/develop/src/dialog/MyMsgBox.cpp): `src/dialog/MyMsgBox.cpp`

### VPN Session

- [VPN session](https://github.com/openconnect/openconnect-gui/blob/develop/src/vpninfo.cpp): `src/vpninfo.cpp`
- **OpenConnect library**

### Profiles and Credentials

- [Profile storage](https://github.com/openconnect/openconnect-gui/blob/develop/src/server_storage.cpp): `src/server_storage.cpp`
- [Certificate handling](https://github.com/openconnect/openconnect-gui/blob/develop/src/cert.cpp): `src/cert.cpp`
- [Private key handling](https://github.com/openconnect/openconnect-gui/blob/develop/src/key.cpp): `src/key.cpp`
- [Client keypairs](https://github.com/openconnect/openconnect-gui/blob/develop/src/keypair.cpp): `src/keypair.cpp`
- [Secret encoding](https://github.com/openconnect/openconnect-gui/blob/develop/src/cryptdata.cpp): `src/cryptdata.cpp`
- [Trust database](https://github.com/openconnect/openconnect-gui/blob/develop/src/gtdb.cpp): `src/gtdb.cpp`

### Logging and Utilities

- [Logging service](https://github.com/openconnect/openconnect-gui/blob/develop/src/logger.cpp): `src/logger.cpp`
- [File logging](https://github.com/openconnect/openconnect-gui/blob/develop/src/FileLogger.cpp): `src/FileLogger.cpp`

### Other components

- **User**
- **VPN server**

## Connections

- User → Application startup: launches (evidence: `src/main.cpp`)
- Application startup → Main window: creates (evidence: `src/main.cpp`)
- Application startup → File logging: starts (evidence: `src/main.cpp`)
- Main window → Profile creation: opens (evidence: `src/dialog/mainwindow.cpp`)
- Main window → Profile editor: opens (evidence: `src/dialog/mainwindow.cpp`)
- Main window → Log viewer: opens (evidence: `src/dialog/mainwindow.cpp`)
- Main window → Profile storage: loads profiles (evidence: `src/dialog/mainwindow.cpp`)
- Main window → VPN session: runs connection (evidence: `src/dialog/mainwindow.cpp`)
- Profile creation → VPN protocols: uses model (evidence: `src/dialog/NewProfileDialog.cpp`)
- Profile creation → Profile storage: saves profile (evidence: `src/dialog/NewProfileDialog.cpp`)
- Profile editor → VPN protocols: uses model (evidence: `src/dialog/editdialog.cpp`)
- Profile editor → Profile storage: edits profile (evidence: `src/dialog/editdialog.cpp`)
- VPN session → OpenConnect library: calls (evidence: `src/vpninfo.cpp`)
- VPN session → VPN server: connects to (evidence: `README.md`)
- VPN session → Profile storage: reads credentials (evidence: `src/vpninfo.cpp`)
- VPN session → Trust database: checks trust (evidence: `src/vpninfo.cpp`)
- VPN session → Input dialogs: requests input (evidence: `src/vpninfo.cpp`)
- VPN session → Certificate prompts: prompts certificate (evidence: `src/vpninfo.cpp`)
- VPN session → Message dialogs: shows messages (evidence: `src/vpninfo.cpp`)
- VPN session → Logging service: records events (evidence: `src/vpninfo.cpp`)
- Profile storage → Secret encoding: encodes secrets (evidence: `src/server_storage.cpp`)
- Profile storage → Certificate handling: stores certificates (evidence: `src/server_storage.cpp`)
- Profile storage → Client keypairs: stores client keys
- Client keypairs → Certificate handling: uses certificate
- Client keypairs → Private key handling: uses key
