# hd9s1lk/iaa_wireguard_vpn_user_auth architecture

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

- Interactive diagram: https://gitdiagram.com/hd9s1lk/iaa_wireguard_vpn_user_auth
- Repository: https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth

## Overview

IAA is a WireGuard VPN authentication portal. Users register or log in, complete TOTP or WebAuthn-based authentication, and on successful authentication the portal activates WireGuard; the dashboard reports tunnel status. The map separates authentication, risk assessment, persistence, the simulated security key, and VPN control. Edges reflect README statements or relationships visible in the excerpts and SOURCE INDEX; some UI and risk-assessment implementation details were not sampled.

Main entry points: [`idp/auth_server.py`](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py) (Auth routes), [`idp/db/rba.py`](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/rba.py) (RBA scoring), [`idp/db/data/data.db`](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/data/data.db) (Portal database), [`idp/db/db_gateway.py`](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/db_gateway.py) (DB operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication portal"]
  node_portal["Auth routes<br/>[auth_server.py]"]
  node_registration["Account registration<br/>[auth_server.py]"]
  node_totp["TOTP MFA<br/>[auth_server.py]"]
  node_webauthn["WebAuthn flows<br/>[auth_server.py]"]
  node_webui["Portal interface<br/>[index.html]"]
end

subgraph group_risk["Risk assessment"]
  node_riskengine["RBA scoring<br/>[rba.py]"]
  node_knownips["Known IP list<br/>[knownIPs.txt]"]
  node_geolookup["IP geolocation<br/>[auth_server.py]"]
end

subgraph group_data["Identity data"]
  node_dbgateway["DB operations<br/>[db_gateway.py]"]
  node_schema["DB initialization<br/>[init_db.py]"]
  node_sqlite[("Portal database<br/>[data.db]")]
end

subgraph group_fido["FIDO2 simulation"]
  node_simulator["Yubikey simulator<br/>[yubikey_auth.py]"]
  node_credentialfile["Simulated credential<br/>[yubikey_sim.json]"]
end

subgraph group_vpn["VPN access"]
  node_wireguard["WireGuard control"]
  node_vpnconfig["WireGuard config<br/>[wg_config.py]"]
end

node_user(("Portal user"))

node_user -->|"uses portal"| node_portal
node_portal -->|"routes registration"| node_registration
node_portal -->|"routes MFA"| node_totp
node_portal -->|"routes WebAuthn"| node_webauthn
node_portal -->|"renders pages"| node_webui
node_portal -->|"queries and updates"| node_dbgateway
node_portal -->|"uses scoring"| node_riskengine
node_portal -->|"looks up location"| node_geolookup
node_portal -->|"runs subprocess"| node_simulator
node_simulator -->|"reads and writes"| node_credentialfile
node_riskengine -->|"reads IPs"| node_knownips
node_riskengine -->|"queries login data"| node_sqlite
node_dbgateway -->|"reads and writes"| node_sqlite
node_schema -->|"creates tables"| node_sqlite
node_portal -->|"activates tunnel"| node_wireguard
node_portal -->|"checks and stops tunnel"| node_wireguard
node_user -.->|"VPN setup"| node_vpnconfig

click node_portal "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py"
click node_registration "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py"
click node_totp "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py"
click node_webauthn "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py"
click node_webui "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/html/index.html"
click node_riskengine "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/rba.py"
click node_knownips "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/knownIPs.txt"
click node_geolookup "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py"
click node_dbgateway "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/db_gateway.py"
click node_schema "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/init_db.py"
click node_sqlite "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/data/data.db"
click node_simulator "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/client/yubikey_auth.py"
click node_credentialfile "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/client/yubikey_sim.json"
click node_vpnconfig "https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/server/wg_config.py"

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_portal,node_registration,node_totp,node_webauthn,node_webui,node_user toneBlue
class node_riskengine,node_knownips,node_geolookup toneAmber
class node_dbgateway,node_schema,node_sqlite toneMint
class node_simulator,node_credentialfile toneRose
class node_wireguard,node_vpnconfig toneIndigo
```

## Components

### Authentication portal

- [Auth routes](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py): `idp/auth_server.py`
- [Account registration](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py): `idp/auth_server.py`
- [TOTP MFA](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py): `idp/auth_server.py`
- [WebAuthn flows](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py): `idp/auth_server.py`
- [Portal interface](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/html/index.html): `idp/html/index.html`

### Risk assessment

- [RBA scoring](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/rba.py): `idp/db/rba.py`
- [Known IP list](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/knownIPs.txt): `idp/db/knownIPs.txt`
- [IP geolocation](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/auth_server.py): `idp/auth_server.py`

### Identity data

- [DB operations](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/db_gateway.py): `idp/db/db_gateway.py`
- [DB initialization](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/init_db.py): `idp/db/init_db.py`
- [Portal database](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/idp/db/data/data.db): `idp/db/data/data.db`

### FIDO2 simulation

- [Yubikey simulator](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/client/yubikey_auth.py): `client/yubikey_auth.py`
- [Simulated credential](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/client/yubikey_sim.json): `client/yubikey_sim.json`

### VPN access

- **WireGuard control**
- [WireGuard config](https://github.com/hd9s1lk/iaa_wireguard_vpn_user_auth/blob/main/server/wg_config.py): `server/wg_config.py`

### Other components

- **Portal user**

## Connections

- Portal user → Auth routes: uses portal (evidence: `README.md`)
- Auth routes → Account registration: routes registration (evidence: `idp/auth_server.py`)
- Auth routes → TOTP MFA: routes MFA (evidence: `idp/auth_server.py`)
- Auth routes → WebAuthn flows: routes WebAuthn (evidence: `idp/auth_server.py`)
- Auth routes → Portal interface: renders pages (evidence: `idp/auth_server.py`)
- Auth routes → DB operations: queries and updates (evidence: `idp/auth_server.py`)
- Auth routes → RBA scoring: uses scoring (evidence: `idp/auth_server.py`)
- Auth routes → IP geolocation: looks up location (evidence: `idp/auth_server.py`)
- Auth routes → Yubikey simulator: runs subprocess (evidence: `idp/auth_server.py`)
- Yubikey simulator → Simulated credential: reads and writes (evidence: `client/yubikey_auth.py`)
- RBA scoring → Known IP list: reads IPs (evidence: `idp/db/rba.py`)
- RBA scoring → Portal database: queries login data (evidence: `idp/db/rba.py`)
- DB operations → Portal database: reads and writes (evidence: `idp/db/db_gateway.py`)
- DB initialization → Portal database: creates tables (evidence: `idp/db/init_db.py`)
- Auth routes → WireGuard control: activates tunnel (evidence: `idp/auth_server.py`)
- Auth routes → WireGuard control: checks and stops tunnel (evidence: `idp/auth_server.py`)
- Portal user → WireGuard config: VPN setup (evidence: `README.md`)
