This directory contains the public technical documentation for RDP Session API.
- Installation and configuration — initial Linux setup, database, systemd, HTTPS, Windows server registration, Grafana, upgrades and troubleshooting.
- System architecture — context, trust boundaries, internal components, data model, ingestion/reconciliation flows and session state machine.
- Grafana logon alerting — cross-server LOGON event feed, Infinity query setup, multi-dimensional alert instances, no-data behavior and notification templates.
- systemd operations — managed Linux runtime, service status, journald, upgrades and migration from manual Uvicorn execution.
- Phase 0 baseline capture — pre-expansion operational evidence, backup/restore gate, version consistency and exit criteria.
- Phase 1 additive origin schema — additive storage for protocol, connection origin and future correlation jobs/evidence while preserving the Agent v1 contract.
- Phase 2 RDP origin support in API v1 — optional origin fields, non-rejecting normalization and session semantics required before Agent 0.3.0 rollout.
- Phase 3 generic API v2 contract — protocol-neutral provider identity, v1 normalization, v2 ingestion/read surfaces, compatibility and rollout gate.
- Phase 4 global session history API — global pagination and filters, session detail/timeline, correlation-evidence visibility and the Portal service-to-service security boundary.
Windows collection is implemented by RDP-Session-Agent.
Examples in this repository must remain infrastructure-agnostic. Do not add real credentials, internal DNS names, private IP addresses, TLS private material, or company-specific production configuration.