Skip to content

Commit 1ecb7fd

Browse files
committed
docs: describe the elevation service as it actually is
Section 7 still named the `trusted_installer` alias (removed) and listed `run_powershell()`, `run_powershell_as_system()`, and `run_schtasks_as_system()`, none of which exist. Replaced with the real surface: one `run_ops` entry point, typed effects only, and how the two tokens are acquired.
1 parent f22fc10 commit 1ecb7fd

1 file changed

Lines changed: 9 additions & 5 deletions

File tree

docs/ARCHITECTURE.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -284,11 +284,15 @@ per effect), with atomic rollback on any failure (see [TWEAK_SYSTEM.md](./TWEAK_
284284
- `validate_profile()` - Validate profile against current system
285285
- See [PROFILE_SYSTEM.md](./PROFILE_SYSTEM.md) for complete documentation
286286

287-
### 7. `trusted_installer` - SYSTEM Elevation & PowerShell
288-
- Execute commands as SYSTEM via winlogon.exe token
289-
- Registry writes as SYSTEM for protected keys
290-
- PowerShell execution: `run_powershell()`, `run_powershell_as_system()`
291-
- Schtasks execution: `run_schtasks_as_system()`
287+
### 7. `elevation` - SYSTEM and TrustedInstaller privilege
288+
- `run_ops(level, ops)` is the only entry point: a batch of typed `BrokerOp`s run in one elevated
289+
child, which is this same binary re-spawned with `--broker`
290+
- SYSTEM comes from duplicating winlogon.exe's token; TrustedInstaller from spoofing the TI service
291+
process as the child's parent
292+
- Every op is a typed effect (registry value or key, service startup type, scheduled task). There is
293+
no "run this string" op, so nothing the child can be asked to do is an interpreter
294+
- The request crosses as a file, created through `exclusive_temp` so no other process running as the
295+
same user can rewrite it before the elevated child reads it
292296

293297
### 8. `system_info_service` - System Detection
294298
- Windows version detection (10 vs 11)

0 commit comments

Comments
 (0)