# hendrikkoelbel/runasadmin architecture

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

- Interactive diagram: https://gitdiagram.com/hendrikkoelbel/runasadmin
- Repository: https://github.com/hendrikkoelbel/runasadmin

## Overview

RunAsAdmin is a Windows desktop utility for launching a selected program with elevated privileges from a standard-user session. The principal workflow is credential selection, program selection, then credential-backed elevation; the sampled MainWindow excerpt shows process-launch logic and its use of security and helper code. Supporting branches cover local/AD account discovery, DPAPI credential protection, settings, logging, and GitHub-based updates. Some discovery wiring and startup details are documented but not visible in the excerpts, so those links are marked unverified or omitted.

Main entry points: [`RunAsAdmin/Views/MainWindow.xaml.cs`](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/MainWindow.xaml.cs) (Main window), [`RunAsAdmin/GlobalVars.cs`](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs) (Saved settings), [`RunAsAdmin/Views/LogViewerWindow.xaml.cs`](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/LogViewerWindow.xaml.cs) (Log viewer), [`RunAsAdmin/Views/UpdateWindow.xaml.cs`](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/UpdateWindow.xaml.cs) (Update window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_main["Main window<br/>[MainWindow.xaml.cs]"]
  node_settingsui["Settings window"]
  node_logsui["Log viewer"]
  node_updateui["Update window"]
end

subgraph group_identity["Identity and elevation"]
  node_accounts["Account discovery<br/>[UserListHelper.cs]"]
  node_directory["Domain discovery<br/>[Helper.cs]"]
  node_domainhelper["Domain utilities<br/>[DomainHelper.cs]"]
  node_credential["Credential protection<br/>[SecurityHelper.cs]"]
  node_elevation["Process elevation<br/>[MainWindow.xaml.cs]"]
end

subgraph group_operations["Operations"]
  node_fileaccess["File access rules<br/>[FileHelper.cs]"]
  node_directoryaccess["Directory access rules<br/>[DirectoryHelper.cs]"]
end

subgraph group_state["Application state"]
  node_appstate["Runtime configuration<br/>[GlobalVars.cs]"]
  node_settings["Saved settings<br/>[GlobalVars.cs]"]
  node_logstore[("Log database<br/>[GlobalVars.cs]")]
end

node_operator(("Administrator"))
node_actordirectory{{"Windows / AD"}}
node_github{{"GitHub releases"}}

node_operator -->|"selects credentials"| node_main
node_operator -->|"selects program"| node_main
node_main -->|"decrypts password"| node_credential
node_main -->|"starts process"| node_elevation
node_main -->|"uses helpers"| node_directory
node_main -.->|"uses access rules"| node_directoryaccess
node_main -.->|"loads accounts"| node_accounts
node_directory -.->|"queries accounts"| node_actordirectory
node_accounts -->|"discovers users"| node_actordirectory
node_main -->|"opens viewer"| node_logsui
node_logsui -->|"reads logs"| node_logstore
node_appstate -->|"writes logs"| node_logstore
node_main -->|"opens updater"| node_updateui
node_updateui -->|"checks releases"| node_github
node_settingsui -->|"updates preferences"| node_settings
node_main -->|"reads credentials"| node_settings
node_appstate -.->|"provides settings"| node_settings

click node_main "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/MainWindow.xaml.cs"
click node_settingsui "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/SettingsWindow.xaml.cs"
click node_logsui "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/LogViewerWindow.xaml.cs"
click node_updateui "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/UpdateWindow.xaml.cs"
click node_accounts "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/UserListHelper.cs"
click node_directory "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/Helper.cs"
click node_domainhelper "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/DomainHelper.cs"
click node_credential "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/SecurityHelper.cs"
click node_elevation "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/MainWindow.xaml.cs"
click node_fileaccess "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/FileHelper.cs"
click node_directoryaccess "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/DirectoryHelper.cs"
click node_appstate "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs"
click node_settings "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs"
click node_logstore "https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs"

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_main,node_settingsui,node_logsui,node_updateui toneBlue
class node_accounts,node_directory,node_domainhelper,node_credential,node_elevation toneAmber
class node_fileaccess,node_directoryaccess toneMint
class node_appstate,node_settings,node_logstore toneRose
class node_operator,node_actordirectory,node_github toneIndigo
```

## Components

### Desktop interface

- [Main window](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/MainWindow.xaml.cs): `RunAsAdmin/Views/MainWindow.xaml.cs`
- [Settings window](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/SettingsWindow.xaml.cs): `RunAsAdmin/Views/SettingsWindow.xaml.cs`
- [Log viewer](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/LogViewerWindow.xaml.cs): `RunAsAdmin/Views/LogViewerWindow.xaml.cs`
- [Update window](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/UpdateWindow.xaml.cs): `RunAsAdmin/Views/UpdateWindow.xaml.cs`

### Identity and elevation

- [Account discovery](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/UserListHelper.cs): `RunAsAdmin/Core/UserListHelper.cs`
- [Domain discovery](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/Helper.cs): `RunAsAdmin/Core/Helper.cs`
- [Domain utilities](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/DomainHelper.cs): `RunAsAdmin/Core/DomainHelper.cs`
- [Credential protection](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/SecurityHelper.cs): `RunAsAdmin/Core/SecurityHelper.cs`
- [Process elevation](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Views/MainWindow.xaml.cs): `RunAsAdmin/Views/MainWindow.xaml.cs`

### Operations

- [File access rules](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/FileHelper.cs): `RunAsAdmin/Core/FileHelper.cs`
- [Directory access rules](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/Core/DirectoryHelper.cs): `RunAsAdmin/Core/DirectoryHelper.cs`

### Application state

- [Runtime configuration](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs): `RunAsAdmin/GlobalVars.cs`
- [Saved settings](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs): `RunAsAdmin/GlobalVars.cs`
- [Log database](https://github.com/hendrikkoelbel/runasadmin/blob/master/RunAsAdmin/GlobalVars.cs): `RunAsAdmin/GlobalVars.cs`

### Other components

- **Administrator**
- **Windows / AD**
- **GitHub releases**

## Connections

- Administrator → Main window: selects credentials (evidence: `README.md`)
- Administrator → Main window: selects program (evidence: `README.md`)
- Main window → Credential protection: decrypts password (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Main window → Process elevation: starts process (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Main window → Domain discovery: uses helpers (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Main window → Directory access rules: uses access rules (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Main window → Account discovery: loads accounts
- Domain discovery → Windows / AD: queries accounts
- Account discovery → Windows / AD: discovers users (evidence: `RunAsAdmin/Core/UserListHelper.cs`)
- Main window → Log viewer: opens viewer (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Log viewer → Log database: reads logs (evidence: `RunAsAdmin/Views/LogViewerWindow.xaml.cs`)
- Runtime configuration → Log database: writes logs (evidence: `RunAsAdmin/GlobalVars.cs`)
- Main window → Update window: opens updater (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Update window → GitHub releases: checks releases (evidence: `RunAsAdmin/Views/UpdateWindow.xaml.cs`)
- Settings window → Saved settings: updates preferences (evidence: `RunAsAdmin/Views/SettingsWindow.xaml.cs`)
- Main window → Saved settings: reads credentials (evidence: `RunAsAdmin/Views/MainWindow.xaml.cs`)
- Runtime configuration → Saved settings: provides settings (evidence: `RunAsAdmin/GlobalVars.cs`)
