diff --git a/AGENTS.md b/AGENTS.md index c045777..0b3050d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,7 +19,7 @@ Ein Server mit WebUI und MCP verwaltet Linux- und Windows-Clients. Die Clients m - Jeder **Skript- oder Wartungsjob** aus UI, MCP oder Automatik wird zunächst als `pending_approval` gespeichert. Erst eine berechtigte Person genehmigt den unveränderlichen Plan mit Ziel, Skriptbytes, Rechten, Grenzen und festen Versuchen in der WebUI. Vorher bleiben ausführbare Jobs, Outbox, Angebote und Startgrants leer. Policies begrenzen. Direkte API-/DB-Freigaben durch KI oder Automatik sind ausgeschlossen. - Ausschließlich im expliziten dev/test-Profil darf ein sichtbar **simulierter Testprincipal** die tatsächliche WebUI per Browser bedienen. Audit bindet `approval_origin`, `testsimulation`, Principal und Plan. In Produktion gilt die menschliche Freigabe. Redelivery darf keine zweite Ausführung auslösen. Neue Versuche und Folgejobs brauchen eine eigene feste Freigabe. - Passive Standardtelemetrie und gespeicherte Lesezugriffe laufen ohne Job. Version 1.33 spezifiziert zusätzlich die automatische Installation **veröffentlichter signierter Agent-Releases**. Der Releasepfad akzeptiert ausschließlich die festgelegten Agentkomponenten. Eine Live-Diagnose oder ein OS-Update ist ein Wartungsjob. -- WebUI und MCP bleiben im Entwicklungsaufbau über den SSH-Tunnel erreichbar. Dockerports an Loopback binden, PostgreSQL intern betreiben. Für die öffentlichen Geräte- und Bootstrapwege TLS-Kette und SAN/SNI prüfen, für registrierte Geräte mTLS und Mandantenbindung durchsetzen. Der öffentliche Installer braucht einen auf dem frischen Gerät bereits vertrauenswürdigen TLS-Anker. +- WebUI und MCP sind öffentlich über HTTPS mit lokalem Passwort/TOTP beziehungsweise scoped Bearer-Tokens erreichbar. Der [öffentliche Zugang](docs/public-access.md) ist der maßgebliche Aufbau seit Spezifikation 1.35. Der separate dev/test-Zugang bleibt intern über den SSH-Tunnel erreichbar. Dockerports an Loopback binden, PostgreSQL intern betreiben. Für die öffentlichen Geräte- und Bootstrapwege TLS-Kette und SAN/SNI prüfen, für registrierte Geräte mTLS und Mandantenbindung durchsetzen. Der öffentliche Installer braucht einen auf dem frischen Gerät bereits vertrauenswürdigen TLS-Anker. - `credentials/` bleibt ignoriert und privat (0700, Dateien 0600). Die [Zugangsanleitung](docs/operations-access.md) nennt Parser und bestätigte Hostpins. Profile ausschließlich als Daten verarbeiten, kein `source` oder `eval`. Schlüssel, Token und private Diagnoseausgaben gehören weder ins Repository noch in Agentkontexte. - Bei einem normalen Binärwechsel Identität, PKI, Konfiguration, Journale und Dateirechte erhalten. Im aktuellen Entwicklungssystem dürfen ausdrücklich freigegebene Altanträge und blockierende Testprojektionen gezielt entfernt werden. Nach einer Bereinigung das Fehlen des Auftrags und den frischen Geräteabgleich prüfen. Zielreboots, OS-Updates und destruktive Tests brauchen einen konkreten Auftrag. Vom Status `unknown` führt nur der belegte Abgleich oder der dokumentierte WebUI-Abschluss weiter. Niemals blind wiederholen. diff --git a/README.md b/README.md index d4f4141..dcf62d2 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,6 @@ Die beiden über den öffentlichen Installer aufgenommenen Geräte haben ein Bib | Linux- und Windows-Dienst | [Linux-Agent](crates/agent/src/main.rs), [Windows-Laufzeit](crates/agent-windows/src/runtime.rs) | | Releases und Selbstupdate | [Releasekatalog und Downloads](crates/server/src/agent_updates.rs), [Manifestprüfung](crates/updater/src/manifest.rs) | -Der Server läuft auf `discovery.ease-technologies.de`. Im Entwicklungsaufbau sind Verwaltung und MCP über den [privaten SSH-Tunnel](docs/operations-access.md) erreichbar. Die Cloud-Linux-VM und der Windows-11-Gast dienen als Testgeräte. Das Notebook ist der Entwicklungsrechner. +Der Server läuft auf `discovery.ease-technologies.de`. Die [öffentliche WebUI](https://discovery.ease-technologies.de:8443/) verwendet Passwort und TOTP. Der [MCP-Endpunkt](https://discovery.ease-technologies.de:8443/mcp) verwendet eigene Bearer-Tokens. [Einrichtung und Betrieb](docs/public-access.md) Die Cloud-Linux-VM und der Windows-11-Gast dienen als Testgeräte. Das Notebook ist der Entwicklungsrechner. [Agenthinweise](AGENTS.md) · [Spezifikation](Rust_RMM_Implementierungsspezifikation.md) · [Entscheidungen](docs/project-decisions.md) · [Historische Linux-Abnahme](docs/mvp-final-audit.md) · [Windows-Nachweise](docs/windows-gates.md) diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index efcf3f5..53eac6b 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.34 · 2026-11-17 · Sprache: Deutsch +Version 1.35 · 2026-11-17 · Sprache: Deutsch **Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. @@ -114,6 +114,12 @@ Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3. ## 0 Auftrag und verbindliche Produktanforderungen +### 0.6 Öffentliche Verwaltung mit lokaler Authentisierung (Version 1.35) + +Userentscheidung vom 17. November 2026. WebUI und MCP sind über öffentliches HTTPS erreichbar. OAuth ist für diesen Aufbau ausgeschlossen. Die WebUI verwendet lokale Benutzer mit Passwort und TOTP. MCP verwendet individuell widerrufbare zufällige Bearer-Tokens mit Mandantenbindung, festen Scopes und Ablauf. Tokens werden nur gehasht gespeichert und einmal ausgegeben. Die feste WebUI-Genehmigung von Jobs bleibt an die echte interaktive Person gebunden. Die öffentliche Anmeldung verwendet das Produktionsprofil ohne simulierte Testidentität. Der private Entwicklungszugang bleibt für native Abnahmen verfügbar. + +Diese Entscheidung ersetzt die frühere ausschließliche SSH-Tunnel-Verwaltung und die Pflicht zu OIDC für den öffentlichen Anmeldeweg. Geräte-mTLS, ausgehendes HTTPS-Polling, TLS-Prüfung und Tenantgrenzen gelten weiterhin. [Öffentlicher Aufbau und Abnahme](docs/public-access.md) + ### 0.5 Entwicklungssystem für den MVP (Version 1.34) Der Betreiber hat die Löschung des als `closed_unknown` abgeschlossenen Entwicklungsantrags und das Entfernen blockierender Entwicklungsdaten ausdrücklich beauftragt. Für die MVP-Abnahme darf ein Testgerät mit neuer Identität über den Installer aufgenommen werden. Ein bereinigter Testauftrag erzeugt keine Ausführung und keinen neuen Versuch. Bei einem regulären Selbstupdate behält das Gerät seine Identität. Der verbindliche Nachweis steht im [Lieferplan](docs/mvp-completion-plan.md). @@ -165,7 +171,7 @@ Diese Fortsetzung erteilt keine implizite Freigabe unangekündigter destruktiver Tests oder Betriebssystemupdates. Aktueller Nachweisstand: `docs/windows-mvp-completion.md`. -**Userentscheidung Version 1.25, MVP-Verwaltung ausschließlich per SSH-Tunnel.** +**Historische Userentscheidung Version 1.25, durch Version 1.35 in Kapitel 0.6 ersetzt.** Der Betreiber verwendet aktuell keinen OIDC-Anbieter. Für den MVP werden WebUI und MCP ausschließlich auf Server-Loopback angeboten und über den SSH-Tunnel bedient. Der vorhandene gekennzeichnete Entwicklungslogin und diff --git a/deploy/server-bootstrap-ingress.conf b/deploy/server-bootstrap-ingress.conf index f3379e9..9c86d68 100644 --- a/deploy/server-bootstrap-ingress.conf +++ b/deploy/server-bootstrap-ingress.conf @@ -11,13 +11,15 @@ http { fastcgi_temp_path /run/rmm-install-ingress/fastcgi; uwsgi_temp_path /run/rmm-install-ingress/uwsgi; scgi_temp_path /run/rmm-install-ingress/scgi; - client_max_body_size 1k; + client_max_body_size 256m; + limit_req_zone $binary_remote_addr zone=public_login:1m rate=6r/m; server_tokens off; keepalive_timeout 10; server { listen 0.0.0.0:8443 ssl; listen [::]:8443 ssl; server_name discovery.ease-technologies.de; + if ($host != discovery.ease-technologies.de) { return 421; } ssl_protocols TLSv1.2 TLSv1.3; ssl_certificate /run/credentials/rmm-install-ingress.service/chain.pem; ssl_certificate_key /run/credentials/rmm-install-ingress.service/key.pem; @@ -35,6 +37,28 @@ http { limit_except GET { deny all; } proxy_pass https://127.0.0.1:18444$uri$is_args$args; } - location / { return 404; } + location = /auth/dev/login { return 404; } + location ~ ^/auth/oidc/ { return 404; } + location = /auth/local/login { + limit_req zone=public_login burst=6 nodelay; + limit_req_status 429; + client_max_body_size 4k; + proxy_pass_request_body on; + proxy_pass_request_headers on; + proxy_set_header Host $http_host; + proxy_ssl_trusted_certificate /run/credentials/rmm-install-ingress.service/api-ca.pem; + proxy_ssl_name localhost; + proxy_pass https://127.0.0.1:18445; + } + location / { + proxy_pass_request_body on; + proxy_pass_request_headers on; + proxy_set_header Host $http_host; + proxy_set_header Connection ""; + proxy_ssl_trusted_certificate /run/credentials/rmm-install-ingress.service/api-ca.pem; + proxy_ssl_name localhost; + proxy_read_timeout 300s; + proxy_pass https://127.0.0.1:18445; + } } } diff --git a/deploy/server-bootstrap-ingress.service b/deploy/server-bootstrap-ingress.service index d1fa50d..ae491d4 100644 --- a/deploy/server-bootstrap-ingress.service +++ b/deploy/server-bootstrap-ingress.service @@ -1,5 +1,5 @@ [Unit] -Description=Public HTTPS installer and tenant bootstrap downloads +Description=Public HTTPS WebUI, MCP and device bootstrap After=network-online.target docker.service [Service] @@ -8,6 +8,7 @@ RuntimeDirectory=rmm-install-ingress LoadCredential=chain.pem:/opt/rmm-bootstrap-download/chain.pem LoadCredential=key.pem:/opt/rmm-bootstrap-download/domain.key LoadCredential=gateway-ca.pem:/opt/rust-discovery/devstate/pki/ca.pem +LoadCredential=api-ca.pem:/opt/rust-discovery/devstate/api-pki/ca.pem ExecStart=/usr/sbin/nginx -c /etc/rmm-install-ingress.conf -g "daemon off;" Restart=on-failure NoNewPrivileges=true diff --git a/deploy/server.public-access.compose.yaml b/deploy/server.public-access.compose.yaml new file mode 100644 index 0000000..55ca888 --- /dev/null +++ b/deploy/server.public-access.compose.yaml @@ -0,0 +1,41 @@ +services: + gateway: + environment: + RMM_LOCAL_AUTH_FILE: /local-auth/users.json + volumes: + - ../devstate/public-auth:/local-auth:ro + public-api: + image: ${RMM_PUBLIC_API_IMAGE:?} + pull_policy: never + user: "10001:10001" + environment: + RMM_PROFILE: production + RMM_DEV_AUTH: "false" + RMM_SERVER_ROLE: api + DATABASE_URL: ${DATABASE_URL:?} + RMM_UI_ORIGIN: https://discovery.ease-technologies.de:8443 + RMM_LOCAL_AUTH_FILE: /local-auth/users.json + RMM_TLS_DIR: /pki + RMM_JOB_KEY_FILE: /jobs/ed25519.pem + RMM_WEB_DIR: /web + RMM_BOOTSTRAP_ORIGIN: https://discovery.ease-technologies.de:8443 + RMM_AGENT_UPDATE_ARTIFACT_DIR: /release-objects + RMM_AGENT_UPDATE_LINUX_KEYRING_FILE: /release-config/linux-keyring.json + RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE: /release-config/windows-keyring.json + RMM_AGENT_UPDATE_WINDOWS_GNU_KEYRING_FILE: /release-config/windows-gnu-keyring.json + RMM_AGENT_BOOTSTRAP_LINUX_FILE: /release-config/linux-bootstrap.json + RMM_AGENT_BOOTSTRAP_WINDOWS_FILE: /release-config/windows-bootstrap.json + RMM_AGENT_BOOTSTRAP_WINDOWS_GNU_FILE: /release-config/windows-gnu-bootstrap.json + ports: ["127.0.0.1:18445:18443"] + volumes: + - ../devstate/api-pki:/pki:ro + - ../devstate/jobs:/jobs:ro + - ../devstate/public-auth:/local-auth:ro + - ../devstate/mvp-releases/config:/release-config:ro + - ../devstate/mvp-releases/objects:/release-objects:rw + - ../web/dist:/web:ro + read_only: true + cap_drop: [ALL] + security_opt: [no-new-privileges:true] + networks: [backend, ingress] + restart: unless-stopped diff --git a/docs/development.md b/docs/development.md index 35dfc67..f96e380 100644 --- a/docs/development.md +++ b/docs/development.md @@ -88,3 +88,7 @@ Für die separate Veröffentlichung eines korrigierten stabilen Workers ohne neu ## Windows-Wartungsvorlage im Entwicklungsbetrieb nutzen Der [Operatorablauf](windows-update-dev-window.md) beschreibt die Einrichtung der SYSTEM-Rechte auf dem aufgenommenen Testgerät. `python3 tools/windows_update_scope.py inspect` liest den Iststand. `plan` zeigt den vorgesehenen Eingriff. `window --minutes 15` öffnet ein geräte- und releasegebundenes Fenster. Der Befehl bleibt während der Wartung aktiv und schließt das Fenster anschließend. Ein vorzeitiges `close --case UUID` entzieht die zentrale Richtlinie, wartet auf terminale Aufträge und baut den lokalen Helper zurück. Der feste Skriptauftrag wird in der WebUI geprüft und genehmigt. + +## Öffentliche Verwaltung + +`tools/dev_public_access.py` provisioniert den lokalen Passwort-/TOTP-Zugang, startet die zusätzliche API intern und aktiviert den vorhandenen öffentlichen TLS-Ingress. Die tatsächlichen Befehle und die privaten Dateipfade stehen im [Betriebsablauf](public-access.md). Der normale Deploymentrunner aktualisiert anschließend auch den öffentlichen API-Dienst. diff --git a/docs/evidence/powershell-output-encoding-20261117.json b/docs/evidence/powershell-output-encoding-20261117.json index 2a984b0..10fcf2c 100644 --- a/docs/evidence/powershell-output-encoding-20261117.json +++ b/docs/evidence/powershell-output-encoding-20261117.json @@ -12,5 +12,16 @@ "raw_download_bytes": 212, "raw_download_sha256": "3f8fac19ab7631108d738b68a47e2a4f25e7064cd838ec3212524aacb2d3adc5", "checks": "Six targeted console-output tests and production WebUI build passed; actual stored job result verified over TLS in browser", - "source_encoding": "CP850 is an explicitly labeled display choice for native PowerShell bytes, not a new source encoding assertion." + "source_encoding": "CP850 is an explicitly labeled display choice for native PowerShell bytes, not a new source encoding assertion.", + "public_webui_verification": { + "origin": "https://discovery.ease-technologies.de:8443", + "observed_at": "2026-11-17T19:21:48.408Z", + "authentication": "local password and TOTP; genuine human session; read-only result inspection", + "cp850_verified": true, + "utf8_switch_verified": true, + "poll_preserves_selection": true, + "raw_download_bytes": 212, + "raw_download_sha256": "3f8fac19ab7631108d738b68a47e2a4f25e7064cd838ec3212524aacb2d3adc5", + "screenshot": "output/playwright/public-powershell-umlaute.png" + } } diff --git a/docs/evidence/public-access-20261117.json b/docs/evidence/public-access-20261117.json new file mode 100644 index 0000000..634449e --- /dev/null +++ b/docs/evidence/public-access-20261117.json @@ -0,0 +1,33 @@ +{ + "origin": "https://discovery.ease-technologies.de:8443", + "tenant": "11111111-1111-4111-8111-111111111111", + "checks": { + "public_tls_and_local_auth": true, + "blocked_/auth/dev/login": true, + "blocked_/auth/oidc/login": true, + "anonymous_data_denied": true, + "anonymous_mcp_denied": true, + "invalid_token_denied": true, + "no_development_principal_on_login": true, + "wrong_password_denied": true, + "wrong_totp_denied": true, + "password_totp_login_succeeds": true, + "secure_session_cookie": true, + "real_human_session": true, + "totp_replay_denied": true, + "token_creation_requires_csrf": true, + "single_token_display_and_no_store": true, + "bearer_mcp_initialize": true, + "scoped_inventory_read": true, + "foreign_tenant_denied": true, + "bearer_cannot_manage_tokens": true, + "read_token_cannot_plan": true, + "bearer_cannot_approve_jobs": true, + "listing_has_no_token_secret": true, + "revocation_via_webui": true, + "revoked_token_denied_in_existing_session": true, + "no_token_in_browser_storage": true + }, + "token_id": "a49cef2a-63ea-4a9c-a0d3-c429ebf8ab56", + "observed_at": "2026-11-17T19:24:16.607Z" +} diff --git a/docs/evidence/windows-gateway-reconnect-20261117.json b/docs/evidence/windows-gateway-reconnect-20261117.json new file mode 100644 index 0000000..931497c --- /dev/null +++ b/docs/evidence/windows-gateway-reconnect-20261117.json @@ -0,0 +1,47 @@ +{ + "date": "2026-11-17", + "environment": "development", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "agent_version": "0.1.4", + "incident": { + "trigger_context": "Gateway deployment/reconnect", + "reported_native_error": "TIME_NATIVE_DISCONTINUITY_OR_BOOT", + "heartbeats_continued": true, + "exact_root_cause_proven": false + }, + "recovery": { + "source": "Native Windows checks reported by windows_live integrator subtask", + "action": "Restart RmmDiscoveryWindows service only", + "at": "2026-11-17T19:22:28Z", + "pid_before": 5552, + "pid_after": 5716, + "os_reboot": false, + "new_job": false, + "agent_sha256": "f30ffac8b9f674c4933d50645bf93f6ee89442608ff73f597cedef3a42172292", + "release_pull_service": "Running", + "helper_service_registered": false, + "native_clock_qualified_at": "2026-11-17T19:22:41Z", + "signed_checkpoint_later": 1530 + }, + "central_followup": { + "source": "Read-only server SQL from integrator", + "observed_at": "2026-11-17T19:27:48.299164+00:00", + "active_mcp_tokens": 0, + "open_jobs": 0, + "devices": [ + { + "agent_id": "dda2c891-40ca-4546-a928-c6dd85fe5cdb", + "last_contact_at": "2026-11-17T19:27:45.581274+00:00", + "sync_ready": true, + "connection_generation": 5 + }, + { + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "last_contact_at": "2026-11-17T19:27:24.204836+00:00", + "sync_ready": true, + "connection_generation": 49 + } + ] + }, + "remaining_work": "Reproduce and verify automatic recovery after time correction and gateway reconnect without service restart. A changed CIM-derived boot ID is a clue, not a confirmed root cause." +} diff --git a/docs/handover.md b/docs/handover.md index 17997e5..c53c819 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -2,7 +2,11 @@ **Der nächste Auftrag steht im [Umsetzungsplan](mvp-completion-plan.md).** Er enthält den letzten Betriebsbefund je Nutzeranforderung und die Reihenfolge für die nächste Lieferung. [Entwicklungsbefehle](development.md) und [Zugänge](operations-access.md) beschreiben den Arbeitsweg. -**Abschlussstand am 17. November, 18:05 Uhr MEZ.** Der Lieferbranch ist `codex/mvp-development-release`. API und Gateway laufen mit Revision `a799272`, Datenbankschema 25. Die WebUI wurde separat mit der geprüften 3.600-Sekunden-Planvalidierung bereitgestellt. Linux betreibt `0.1.0-mvp.2`, Windows GNU `0.1.4`. Ältere aufgabenfremde Arbeiten sind im Arbeitsbaum erhalten. +**Abschlussstand am 17. November, 20:28 Uhr MEZ.** Lieferbranch `codex/mvp-development-release`, API/Gateway/öffentliche API auf Revision `9fa0fb8`, Datenbankschema 27. WebUI und MCP sind unter `https://discovery.ease-technologies.de:8443/` beziehungsweise `/mcp` erreichbar. Die WebUI verwendet das lokale Passwort-/TOTP-Konto, MCP eigene scoped Bearer-Tokens. Die private Bootstrapdatei für die Einrichtung liegt unter `credentials/public-webui-login.json`. Öffentlicher dev/test-Login und OAuth sind deaktiviert. [Öffentliche Abnahme](public-access.md) + +Nach dem Gatewaywechsel benötigte der Windows-Agent wegen einer gehaltenen Zeitsperre einen gezielten Dienstneustart. Anschließend waren beide aktuellen Testgeräte wieder synchronisationsbereit; null offene Jobs und null aktive MCP-Testtokens. Der automatische Wiederanlauf dieses konkreten Fehlerfalls bleibt als nächster gezielter Clientpunkt im [Plan](mvp-completion-plan.md) dokumentiert. [Beleg](evidence/windows-gateway-reconnect-20261117.json) + +Die CP850-Darstellung des gespeicherten PowerShell-Ergebnisses wurde in der privaten und öffentlichen WebUI geprüft, einschließlich Umschaltung, Polling und bytegleichem Download. [Umlautnachweis](evidence/powershell-output-encoding-20261117.json) Die beiden zuletzt offenen Punkte sind erledigt. Die Windows-Test-VM hat KB890830 v5.147 über die gespeicherte Updatevorlage installiert. Ein vorbestehender Neustartbedarf wurde vorher durch einen autorisierten administrativen SSH-Neustart behoben. Der ursprüngliche Installationsversuch wurde genau einmal ausgeführt und nach signiertem Abgleich als erfolgreich bestätigt. Windows-Ereignis 19 und beide nativen Journale bestätigen die Installation. Ein weiterer Neustart war nicht erforderlich. Agent und Updater laufen nach geschlossenem Wartungsfenster wieder, Sync ist bereit und SYSTEM-Rechte sind entzogen. [Installation](evidence/windows-update-installation-20261117.json) diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 2e0b9d2..0a9c3e6 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -2,6 +2,11 @@ **Abschlussstand 17. November 2026. Echte Windows-Updates und der Wiederanlauf nach frühem Abbruch sind nativ abgenommen.** Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) +## Ergänzte Lieferungen am 17. November 2026 + +- Umlautdarstellung für native PowerShell-Ausgabe korrigiert und am gespeicherten Updateergebnis in der WebUI geprüft. [Darstellung](evidence/powershell-output-encoding-20261117.json) +- Öffentliche WebUI mit Passwort/TOTP sowie MCP mit eigenen widerrufbaren Bearer-Tokens bereitgestellt. 25 öffentliche Prüfungen bestanden, die Testtokens sind widerrufen. [Betrieb](public-access.md) · [Nachweis](evidence/public-access-20261117.json) + ## Produkt und Betriebsstand | Funktion | Im Entwicklungssystem nachgewiesen | Nächster Schritt oder Beleg | @@ -59,7 +64,7 @@ Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der R Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen. -Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte API-/Gatewayrevision ist `a799272`, Datenbankschema 25. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.4`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum. +Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte Revision für API, Gateway und öffentliche API ist `9fa0fb8`, Datenbankschema 27. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.4`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum. ### Wiederanlauf nach frühem Abbruch — nativ abgenommen @@ -68,3 +73,9 @@ Der Controller wurde nach registriertem Helperkontakt vor der zentralen Freigabe ### Tatsächliche Updateinstallation — abgenommen Der ursprüngliche Installationsversuch `6d5f9437…` wurde nach kurzzeitigem `unknown` durch den signierten Abgleich als `succeeded`, Revision 2 bestätigt. Es gab genau einen nativen Grantverbrauch und Start je Ledger, keinen weiteren Versuch. Das Wartungsfenster wurde anschließend geschlossen. Um 17:05 UTC liefen Agent und ReleasePull mit bereitem Sync, ohne SYSTEM-Fähigkeit und ohne offene Jobs. Die Windows-Zeitsynchronisation wurde aktiviert und ihre zuvor gemessene Abweichung korrigiert. Die WebUI erlaubt nun das feste 3.600-Sekunden-Budget der Originalvorlage auch in der gemeinsamen Planprüfung. Drei Python-Zeitstempelregressionen und 68 WebUI-Tests bestanden. [Gesamtbeleg](evidence/windows-update-installation-20261117.json) + +### Offener Folgepunkt: Windows-Zeitfreigabe nach Verbindungswechsel + +Beim Gatewaywechsel blieb der Windows-Agent mit `TIME_NATIVE_DISCONTINUITY_OR_BOOT` gesperrt, obwohl Heartbeats weiter ankamen. Ein gezielter administrativer Neustart des Agentdienstes um 19:22:28 UTC stellte die native Zeitqualifikation und den signierten Geräteabgleich wieder her. Kein Betriebssystemneustart, kein neuer Job und keine erneute Skriptausführung. Die Abschlusskontrolle um 19:27 UTC bestätigte auf beiden aktuellen Testgeräten `sync_ready=true` und null offene Jobs. + +Für die nächste gezielte Clientkorrektur: den automatischen Wiederanlauf nach Zeitkorrektur und Gateway-Reconnect auf der Windows-VM reproduzieren, die tatsächlich gespeicherte Boot-/Zeitbindung erfassen und das Verhalten ohne Dienstneustart nachweisen. Die genaue Ursache der gehaltenen Sperre ist noch nicht belegt. Die früher beobachtete Änderung der aus CIM abgeleiteten Boot-ID nach einer Uhrkorrektur ist ein Hinweis, keine bestätigte Ursache. [Beobachtung und Eingriff](evidence/windows-gateway-reconnect-20261117.json) diff --git a/docs/operations-access.md b/docs/operations-access.md index e7eea4c..3084d0c 100644 --- a/docs/operations-access.md +++ b/docs/operations-access.md @@ -1,5 +1,8 @@ # Zugänge für eine andere AI auf diesem Entwicklungs-PC +**Aktuell öffentlich.** WebUI und MCP sind über [den Passwort-/TOTP- und Tokenzugang](public-access.md) erreichbar. Die nachstehende SSH-Anleitung beschreibt zusätzlich den internen Entwicklungsweg. + + Die nachstehenden Zugangsproben stammen vom 17. November 2026, 09:14–09:38 Uhr MEZ. Am Nachmittag waren alle drei SSH-Ziele erreichbar. Den aktuellen Produktzustand mit Zeitstempeln und Zielbelegen nennt der [Lieferplan](mvp-completion-plan.md). Die [Bestandsaufnahme](evidence/product-audit-20261117.json) dokumentiert den Zustand vor der Reparatur. Für die direkte Entwicklungsbereitstellung siehe [Entwicklungsweg](development.md). Diese Anleitung beschreibt vorhandene Zugänge, keine Erlaubnis für neue Jobs, Deployments, Konten, Schlüssel, Reboots oder Wiederherstellungen. diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 613e32d..f5416ff 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -1,6 +1,10 @@ # Verbindliche Projektentscheidungen -Stand: **2026-11-17**, Spezifikation **1.34** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. +Stand: **2026-11-17**, Spezifikation **1.35** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. + +## Öffentliche WebUI und MCP ohne OAuth (Version 1.35) + +Der Betreiber will beide Verwaltungsoberflächen über das Internet erreichen und hat OAuth ausdrücklich ausgeschlossen. Für die WebUI hat er Passwort plus TOTP gewählt. Der öffentliche Produktions-API-Dienst verwendet deshalb lokale Human-Accounts, der MCP-Endpunkt eigenständige mandanten- und rechtegebundene Bearer-Tokens mit Ablauf und Widerruf. Die frühere Tunnelpflicht und öffentliche OIDC-Pflicht werden ersetzt. Der interne Entwicklungszugang bleibt für native Abnahmen bestehen. [Aufbau und Belege](public-access.md) ## Native Windows-Updateabnahme am 17. November 2026 diff --git a/docs/public-access.md b/docs/public-access.md new file mode 100644 index 0000000..963b3cb --- /dev/null +++ b/docs/public-access.md @@ -0,0 +1,45 @@ +# Öffentlicher Zugang ohne OAuth + +Die WebUI ist unter https://discovery.ease-technologies.de:8443/ erreichbar. Der MCP-Endpunkt lautet https://discovery.ease-technologies.de:8443/mcp. Beide verwenden die öffentliche TLS-Zertifikatskette des bestehenden HTTPS-Ingresses. Der Gerätekanal auf Port 443 verwendet weiterhin seine eigene Geräte-PKI. + +## WebUI + +Die Anmeldung benötigt den lokalen Benutzernamen, das Passwort und einen sechsstelligen TOTP-Code aus einer Authenticator-App. TOTP verwendet SHA-1, 30 Sekunden und sechs Stellen. Für die Ersteinrichtung liegt auf dem Entwicklungs-PC die private Datei `credentials/public-webui-login.json` mit Benutzername, Passwort, Base32-Schlüssel und `otpauth_uri`. Die Datei hat Modus 0600 und ist gitignoriert. Sie dient der Übernahme des Passworts in den Passwortmanager und der Einrichtung der Authenticator-App. + +Der Server speichert den Passwortprüfwert als Scrypt mit zufälligem Salt und 128 MiB Arbeitsspeicher. Bereits benutzte TOTP-Zeitschritte werden atomar in PostgreSQL gesperrt. Passwortprüfungen sind parallel begrenzt. Anmeldung und Sitzung nutzen HTTPS, Loginbegrenzung, `Secure`-/`HttpOnly`-/`SameSite=Strict`-Cookies sowie Origin- und CSRF-Prüfungen für Änderungen. Eine Sitzung gilt eine Stunde. Das öffentliche Produktionsprofil bietet den lokalen Login. Die simulierte Entwicklungsanmeldung ist nur am internen API-Dienst verfügbar. + +Die Kontokonfiguration liegt auf dem Server unter `/opt/rust-discovery/devstate/public-auth/users.json`, Besitzer 10001, Modus 0600, im Container schreibgeschützt. Änderung von Passwort, TOTP oder `disabled` erfordert den Neustart von öffentlicher API und Gateway. Ein Membership-Widerruf wirkt auch auf bestehende Sitzungen beim nächsten Zugriff. Der vorhandene SSH-Zugang ermöglicht die administrative Wiederherstellung eines verlorenen Authenticator-Zugangs. + +## MCP-Tokens + +Nach der WebUI-Anmeldung im Bereich **MCP-Tokens** einen Namen, die benötigten Rechte und ein Ablaufdatum wählen. Standard sind gespeichertes Inventar, Protokolle und Aufträge/Ergebnisse lesen. Der Tokenwert wird einmal angezeigt. Er kann anschließend im MCP-Client als HTTP-Header hinterlegt werden. + +```http +Authorization: Bearer +``` + +Ein Token besteht aus einem Präfix und 32 zufälligen Bytes. Der Server speichert ausschließlich dessen SHA-256-Prüfwert. Jedes Token besitzt einen eigenen Principal, Mandanten, feste Scopes, Ablauf und Widerruf. Jede Anfrage wird erneut geprüft. Die wirksamen Rechte sind die Schnittmenge aus Scopes und aktiver Membership. Der Widerruf greift auch bei einer bereits geöffneten MCP-Sitzung. Tokens können mit entsprechenden Rechten Anträge planen und einreichen. Die Jobgenehmigung erfolgt durch die Person in der WebUI. Tokenverwaltung verlangt eine echte interaktive Sitzung mit `tokens:manage` und CSRF-Schutz. + +Der verwendete MCP-Client muss einen manuell konfigurierbaren Bearer-Header unterstützen. Die standardisierte automatische MCP-HTTP-Autorisierung beschreibt einen OAuth-Ablauf. Die hier eingerichtete statische Tokenanmeldung verwendet den vorhandenen HTTP-Transport mit selbst verwalteten Zugangsdaten. [MCP-Autorisierung](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization) + +## Entwicklung und Deployment + +Der öffentliche API-Dienst `public-api` läuft unprivilegiert auf `127.0.0.1:18445`, im Produktionsprofil mit lokalem Passwort/TOTP und ohne Entwicklungszugänge. Der private Entwicklungsdienst bleibt auf `127.0.0.1:18443`. PostgreSQL hat keinen veröffentlichten Port. Der Reverseproxy verifiziert das TLS-Zertifikat des jeweiligen internen Dienstes. Öffentliche Anmeldung und MCP gehen an `public-api`, die vorhandenen Bootstrapdownloads an das Gerätegateway. + +Die erstmalig ausgeführten Befehle sind wiederverwendbar. + +```sh +python3 tools/dev_public_access.py prepare +python3 tools/dev_public_access.py activate +python3 tools/dev_public_access.py publish +``` + +`prepare` erzeugt das private Bootstrapkonto und seine echte Human-Membership. `activate` startet die zusätzliche API intern und prüft die angebotenen Anmeldemodi. `publish` validiert die Nginx-Konfiguration und stellt den TLS-Ingress um. Bei einem Aktivierungsfehler wird die vorherige Ingresskonfiguration wiederhergestellt. Wiederholtes `prepare` verwendet die vorhandene private Kontokonfiguration. Abweichende bestehende Daten verlangen einen bewussten administrativen Abgleich. + +Weitere Serverupdates verwenden `tools/build.py server-arm64 --ssh --ref REVISION` und `tools/dev_deploy_server.py --ref REVISION`. Der Deploymentrunner übernimmt die aktive Compose-Dateikette des öffentlichen Dienstes und aktiviert auch `public-api`. Reine WebUI-Änderungen verwenden `--web-only`. + +## Abnahme am 17. November 2026 + +76 WebUI-Tests, drei Browser-Bedientests der Tokenverwaltung sowie fünf Backendtests gegen isoliertes PostgreSQL bestanden. Alle 27 Migrationen wurden mit einem eingeschränkten Migrationsbenutzer geprüft. Die öffentliche HTTPS-Abnahme bestätigte 25 Fälle einschließlich Passwort/TOTP, Replay, CSRF, Tenantgrenze, beschränktem Lesetoken und Widerruf in derselben MCP-Sitzung. Alle während der Abnahme erstellten Testtokens sind widerrufen; die Abschlusskontrolle fand null aktive Tokens. [Öffentlicher Nachweis](evidence/public-access-20261117.json) + +Die verwendeten Schutzmaßnahmen orientieren sich an den OWASP-Hinweisen zu Anmeldung, Passwortspeicherung und Sitzungen. [Authentifizierung](https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html) · [Passwortspeicherung](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html) · [Sitzungen](https://cheatsheetseries.owasp.org/cheatsheets/Session_Management_Cheat_Sheet.html) diff --git a/docs/server-deployment.md b/docs/server-deployment.md index 0120ab5..d7f692d 100644 --- a/docs/server-deployment.md +++ b/docs/server-deployment.md @@ -1,6 +1,9 @@ # Dedizierter RMM-Server: aktuelle Verweise und historische Bereitstellung -## Öffentlicher Zugang zur Erstaufnahme, 17. November 2026 +## Öffentliche Verwaltung und Erstaufnahme, 17. November 2026 + +WebUI und MCP sind inzwischen ebenfalls auf dem öffentlichen TLS-Ingress erreichbar. Passwort/TOTP und eigenständige MCP-Tokens sind im [aktuellen Aufbau](public-access.md) beschrieben. Die folgenden Angaben zum engeren Installer-Ingress dokumentieren dessen frühere Freischaltung. + Die Geräte verwenden `discovery.ease-technologies.de:443` mit der Geräte-PKI. Auf Port 8443 liefert `rmm-install-ingress.service` den [Linux-Installer](https://discovery.ease-technologies.de:8443/install/linux.sh) und den [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) über die öffentliche Zertifikatskette. Im Test antworteten beide Skripte mit HTTP 200, der Releaseabruf ohne Einmalcode mit 401 und die privaten Routen `/mcp` und `/auth/dev/login` mit 404. Die Konfiguration prüft das Gateway-Zertifikat auch intern. [Ingress-Konfiguration](../deploy/server-bootstrap-ingress.conf) diff --git a/tools/dev_deploy_server.py b/tools/dev_deploy_server.py index e6fa81c..a0e1cfc 100644 --- a/tools/dev_deploy_server.py +++ b/tools/dev_deploy_server.py @@ -91,6 +91,8 @@ def activate(payload): with (work/'deployment.lock').open('a') as lock: fcntl.flock(lock,fcntl.LOCK_EX) active = inspect('api') + queried_public = subprocess.run(['docker','inspect','rust-discovery-server-public-api-1'], capture_output=True, text=True) + public_api = json.loads(queried_public.stdout)[0] if queried_public.returncode == 0 else None dist = next(Path(m['Source']) for m in active['Mounts'] if m['Destination'] == '/web') if dist != root / 'web/dist' or active['Config']['Labels']['com.docker.compose.project'] != 'rust-discovery-server': raise RuntimeError('Unexpected development WebUI deployment') @@ -111,13 +113,18 @@ def activate(payload): raise RuntimeError('Server build digest mismatch') if inspect('gateway')['Image'] != active['Image']: raise RuntimeError('API and Gateway have different base images') - labels = active['Config']['Labels'] + labels = (public_api or active)['Config']['Labels'] if labels['com.docker.compose.project'] != 'rust-discovery-server': raise RuntimeError('Unexpected compose project') files = [Path(x) for x in labels['com.docker.compose.project.config_files'].split(',')] base_files = [f for f in files if not (f.parent.parent == work and f.name == 'image.compose.yaml')] compose = ['docker','compose','--project-name','rust-discovery-server','--project-directory',str(root/'deploy'), '--env-file',str(root/'devstate/.env')] + public_env = root / 'devstate/public-access/image.env' + if public_api is not None: + if not public_env.is_file(): + raise ValueError('Missing public API image configuration') + compose.extend(['--env-file', str(public_env)]) for path in base_files: if not path.is_file() or not path.resolve().is_relative_to(root): raise ValueError('Missing deployment overlay') @@ -139,7 +146,8 @@ def activate(payload): if subprocess.run(['docker','image','inspect',tag],stdout=subprocess.DEVNULL,stderr=subprocess.DEVNULL).returncode: run('docker','build','--network=none','--pull=false','-t',tag,str(context)) overlay=role_dir/'image.compose.yaml' - write_atomic(overlay,('services:\n'+''.join(f' {r}:\n image: {tag}\n pull_policy: never\n' for r in ('migrate','api','gateway'))).encode()) + deployed_roles = ['api', 'gateway'] + (['public-api'] if public_api is not None else []) + write_atomic(overlay,('services:\n'+''.join(f' {r}:\n image: {tag}\n pull_policy: never\n' for r in ['migrate', *deployed_roles])).encode()) for path, content in payload['overlays'].items(): file = (root / 'deploy') / path if not re.fullmatch(r'server\.[\w.-]+\.compose\.yaml', path) or file.is_symlink(): @@ -149,7 +157,7 @@ def activate(payload): compose.extend(['-f',str(file)]) compose.extend(['-f',str(overlay)]) config=json.loads(run(*compose,'config','--format','json'))['services'] - for role,port in [('api','18443'),('gateway','18444')]: + for role,port in [('api','18443'),('gateway','18444')] + ([('public-api','18445')] if public_api is not None else []): svc=config[role] if (svc['ports'][0]['host_ip']!='127.0.0.1' or str(svc['ports'][0]['published'])!=port or len(svc['ports'])!=1 or svc['user']!='10001:10001' or not svc['read_only']): @@ -161,8 +169,8 @@ def activate(payload): recorded = dict(line.split('|') for line in run(*sql,"SELECT version,encode(checksum,'hex') FROM _sqlx_migrations WHERE success").splitlines()) if recorded != payload['migrations']: raise RuntimeError('Applied migrations differ from the build revision') - run(*compose,'up','-d','--no-deps','--no-build','--pull','never','api','gateway') - for role,host,port,ca in [('api','localhost','18443','api-pki'),('gateway','discovery.ease-technologies.de','18444','pki')]: + run(*compose,'up','-d','--no-deps','--no-build','--pull','never',*deployed_roles) + for role,host,port,ca in [('api','localhost','18443','api-pki'),('gateway','discovery.ease-technologies.de','18444','pki')] + ([('public-api','localhost','18445','api-pki')] if public_api is not None else []): for _ in range(25): res=subprocess.run(['curl','--noproxy','*','--resolve',f'{host}:{port}:127.0.0.1','--cacert',str(root/f'devstate/{ca}/ca.pem'), '--max-time','2','--silent','--fail',f'https://{host}:{port}/healthz'],capture_output=True) diff --git a/tools/dev_public_access.py b/tools/dev_public_access.py new file mode 100644 index 0000000..2f46e5e --- /dev/null +++ b/tools/dev_public_access.py @@ -0,0 +1,179 @@ +#!/usr/bin/env python3 +"""Provision and activate the public password/TOTP API on the development server.""" +import argparse +import base64 +import hashlib +import json +import os +from pathlib import Path +import secrets +import shlex +import subprocess +import uuid + +ROOT = Path(__file__).resolve().parents[1] +ORIGIN = 'https://discovery.ease-technologies.de:8443' +TENANT = '11111111-1111-4111-8111-111111111111' + + +def on_server(payload): + import fcntl + import time + root = Path('/opt/rust-discovery') + def run(*args): + return subprocess.check_output(list(args),text=True).strip() + def inspect_role(role): + return json.loads(run('docker','inspect','rust-discovery-server-'+role+'-1'))[0] + def write(path, content, mode=0o600, owner=None): + import tempfile + with tempfile.NamedTemporaryFile(dir=path.parent,delete=False) as stream: + temporary=Path(stream.name) + try: + stream.write(content);stream.flush();os.fsync(stream.fileno()) + os.fchmod(stream.fileno(),mode) + if owner is not None:os.fchown(stream.fileno(),owner,owner) + os.replace(temporary,path) + finally:temporary.unlink(missing_ok=True) + work=root/'devstate/public-access' + work.mkdir(mode=0o700,exist_ok=True) + with (work/'deployment.lock').open('a') as lock: + fcntl.flock(lock,fcntl.LOCK_EX) + if payload['action']=='prepare': + config=payload['accounts'] + user,=config['users'] + if str(uuid.UUID(user['principal'].removeprefix('local:'))) != user['principal'][6:]: + raise ValueError('Invalid local principal') + folder=root/'devstate/public-auth' + folder.mkdir(mode=0o700,exist_ok=True) + os.chown(folder,10001,10001);os.chmod(folder,0o700) + path=folder/'users.json' + encoded=json.dumps(config,separators=(',',':')).encode() + if path.exists() and path.read_bytes()!=encoded: + raise ValueError('Existing account configuration differs. Review before replacing it.') + write(path,encoded,owner=10001) + # Bootstrap membership only. No plan, approval or job is created. + query=f"""BEGIN; + SELECT set_config('app.tenant_id','{TENANT}',true); + INSERT INTO memberships(tenant_id,principal,kind,permissions) + SELECT '{TENANT}','{user['principal']}','human',array_append(array_remove(permissions,'apt:native_acceptance'),'tokens:manage') + FROM memberships WHERE tenant_id='{TENANT}' AND principal='simulated-testprincipal-a' + ON CONFLICT(tenant_id,principal) DO NOTHING; + COMMIT;""" + subprocess.run(['docker','exec','-i','rust-discovery-server-postgres-1','psql','-XqAt','-v','ON_ERROR_STOP=1','-U','postgres','-d','rmm'],input=query,text=True,check=True,stdout=subprocess.DEVNULL) + print(json.dumps({'accounts_prepared':True,'username':user['username'],'principal':user['principal']})) + return + if payload['action']=='publish': + ca=root/'devstate/api-pki/ca.pem' + auth=json.loads(run('curl','--noproxy','*','--silent','--show-error','--fail','--max-time','5','--cacert',str(ca),'https://localhost:18445/auth/config')) + if auth.get('dev_login_enabled') or auth.get('oidc_configured') or not auth.get('local_login_enabled'): + raise ValueError('Public API authentication is not ready') + source=payload['files'] + nginx=base64.b64decode(source['server-bootstrap-ingress.conf'],validate=True) + service=base64.b64decode(source['server-bootstrap-ingress.service'],validate=True) + validation=nginx.decode() + for name, path in { + 'chain.pem':'/opt/rmm-bootstrap-download/chain.pem', + 'key.pem':'/opt/rmm-bootstrap-download/domain.key', + 'gateway-ca.pem':str(root/'devstate/pki/ca.pem'), + 'api-ca.pem':str(ca), + }.items(): + validation=validation.replace('/run/credentials/rmm-install-ingress.service/'+name,path) + check=work/'nginx-validation.conf' + write(check,validation.encode()) + run('/usr/sbin/nginx','-t','-c',str(check)) + targets={Path('/etc/rmm-install-ingress.conf'):nginx, + Path('/etc/systemd/system/rmm-install-ingress.service'):service} + backup={path:path.read_bytes() for path in targets} + try: + for path,raw in targets.items():write(path,raw,0o644) + run('systemctl','daemon-reload') + run('systemctl','restart','rmm-install-ingress.service') + for attempt in range(20): + try: + verified=json.loads(run('curl','--noproxy','*','--resolve','discovery.ease-technologies.de:8443:127.0.0.1','--silent','--show-error','--fail','--max-time','5',ORIGIN+'/auth/config')) + if verified!=auth:raise ValueError('Public authentication response differs') + break + except subprocess.CalledProcessError: + if attempt==19:raise + time.sleep(1) + except Exception: + for path,raw in backup.items():write(path,raw,0o644) + run('systemctl','daemon-reload');run('systemctl','restart','rmm-install-ingress.service') + raise + print(json.dumps({'public_origin':ORIGIN,'local_password_totp':True,'dev_login':False,'oauth':False})) + return + active=inspect_role('api') + if inspect_role('gateway')['Image'] != active['Image']: + raise ValueError('API and gateway images differ') + tag='rmm-public-api:'+active['Image'].split(':')[1] + run('docker','tag',active['Image'],tag) + write(work/'image.env',('RMM_PUBLIC_API_IMAGE='+tag+'\n').encode()) + compose=['docker','compose','--project-name','rust-discovery-server','--project-directory',str(root/'deploy'),'--env-file',str(root/'devstate/.env'),'--env-file',str(work/'image.env')] + files=[Path(x) for x in active['Config']['Labels']['com.docker.compose.project.config_files'].split(',')] + for file in files: + if not file.is_file() or not file.resolve().is_relative_to(root):raise ValueError('Missing deployment file') + compose+=['-f',str(file)] + for name,encoded in payload['files'].items(): + dest=(root/'deploy'/name) + if name != 'server.public-access.compose.yaml':raise ValueError('Unexpected deployment overlay') + write(dest,base64.b64decode(encoded,validate=True),0o644) + if dest not in files:compose+=['-f',str(dest)] + os.environ['RMM_PUBLIC_API_IMAGE']=tag + cfg=json.loads(run(*compose,'config','--format','json'))['services'] + public=cfg['public-api'] + if (public['environment']['RMM_PROFILE']!='production' or public['environment']['RMM_DEV_AUTH']!='false' + or public['ports'][0]['host_ip']!='127.0.0.1' or str(public['ports'][0]['published'])!='18445' + or any(k.startswith('RMM_DEV_') and k!='RMM_DEV_AUTH' for k in public['environment']) + or public['user']!='10001:10001' or not public['read_only'] or cfg['postgres'].get('ports')): + raise ValueError('Unexpected public API boundary') + run(*compose,'up','-d','--no-deps','gateway','public-api') + ca=root/'devstate/api-pki/ca.pem' + for attempt in range(30): + try: + auth=json.loads(run('curl','--noproxy','*','--silent','--show-error','--fail','--max-time','5','--cacert',str(ca),'https://localhost:18445/auth/config')) + if auth.get('dev_login_enabled') or auth.get('oidc_configured') or not auth.get('local_login_enabled'): + raise ValueError('Unexpected public authentication modes') + break + except subprocess.CalledProcessError: + if attempt==29:raise + time.sleep(1) + print(json.dumps({'public_api_running':True,'authentication':auth,'image':active['Image'],'loopback_port':18445})) + + +def main(): + parser=argparse.ArgumentParser(description=__doc__) + parser.add_argument('action',choices=('prepare','activate','publish')) + args=parser.parse_args() + os.umask(0o077) + payload={'action':args.action} + if args.action=='prepare': + path=ROOT/'credentials/public-webui-login.json' + if path.exists(): + info=path.lstat() + if not path.is_file() or path.is_symlink() or info.st_uid!=os.getuid() or info.st_mode & 0o077: + raise ValueError('Unsafe bootstrap credential file') + credentials=json.loads(path.read_bytes()) + else: + secret=base64.b32encode(secrets.token_bytes(20)).decode().rstrip('=') + password=secrets.token_urlsafe(32);salt=secrets.token_bytes(32) + derived=hashlib.scrypt(password.encode(),salt=salt,n=1<<17,r=8,p=1,dklen=64,maxmem=256*1024*1024) + account={'username':'kevin','principal':'local:'+str(uuid.uuid4()),'tenant_id':TENANT,'disabled':False, + 'password_scrypt':{'salt_hex':salt.hex(),'hash_hex':derived.hex()},'totp_secret_base32':secret} + credentials={'origin':ORIGIN,'username':'kevin','password':password,'totp_secret_base32':secret, + 'otpauth_uri':'otpauth://totp/RustDiscovery:kevin?secret='+secret+'&issuer=RustDiscovery&algorithm=SHA1&digits=6&period=30', + 'accounts':{'schema_version':1,'users':[account]}} + with path.open('x') as stream:json.dump(credentials,stream,indent=2) + path.chmod(0o600) + payload['accounts']=credentials['accounts'] + else: + names=['server.public-access.compose.yaml'] if args.action=='activate' else ['server-bootstrap-ingress.conf','server-bootstrap-ingress.service'] + payload['files']={name:base64.b64encode((ROOT/'deploy'/name).read_bytes()).decode() for name in names} + from dev_stage import ssh_prefix + code=Path(__file__).read_text().rsplit("\nif __name__",1)[0] + code+='\non_server('+repr(payload)+')\n' + subprocess.run([*ssh_prefix('server'),shlex.join(['python3','-I','-'])],input=code,text=True,check=True) + if args.action=='prepare':print('Bootstrap credentials stored privately at credentials/public-webui-login.json') + + +if __name__=='__main__': + main()