Files
rust-discovery/docs/operations-access.md
2026-11-17 09:40:30 +01:00

13 KiB
Raw Permalink Blame History

Zugänge für eine andere AI auf diesem Entwicklungs-PC

Stand: 17. November 2026, Prüfung 09:14–09:38 Uhr MEZ. Aktueller Produktzustand und Arbeitsgrenze: Übergabe. Diese Anleitung beschreibt vorhandene Zugänge, keine Erlaubnis für neue Jobs, Deployments, Konten, Schlüssel, Reboots oder Wiederherstellungen.

1. Vom richtigen Arbeitsverzeichnis und Benutzer ausgehen

cd /home/kevin/Schreibtisch/Coding/rust-discovery
git status --short
git log -1 --oneline

Als lokaler Benutzer kevin arbeiten, nicht Python mit sudo starten. Die Parser verlangen Dateien im Eigentum des aktuellen Unixbenutzers. Ein neuer Checkout/Worktree enthält die absichtlich ignorierten credentials/ und devstate/ nicht. Die Originale liegen hier auf diesem PC im obigen Arbeitsverzeichnis. Nicht neu enrollen oder den User nach Schlüsseldateien fragen, nur weil eine andere Arbeitskopie sie nicht enthält.

Ziel/Zweck Vorhandenes lokales Profil oder Quelle Transport
Server 88.99.80.202 credentials/server.conf root per bestehendem SSH-Key
Cloud-Linux 116.203.20.85 credentials/linux-vm.conf vorhandener Key/Benutzer aus Profil
Windowsgast credentials/windows-dev-access.json vollständiger vorhandener ssh_prefix mit ProxyCommand
Öffentliche Server-CA credentials/server-ca.pem TLS-Kette und SAN prüfen
WebUI-Testlogin credentials/server-browser-login.json nur geschützter lokaler Browserlogin
Windows-Hostpin credentials/windows-dev.known_hosts Alias rmm-windows-dev, bereits vorhandener Trust
Server-/Linuxpins normale bestehende SSH-known_hosts keine automatische Neuannahme

credentials/ hat 0700, geprüfte Profile/Keydateien 0600; Profile und devstate sind gitignoriert. Nur gezielt programmgesteuert verwenden. Keine Passwörter, Tokens, privaten Schlüssel oder gesamten Profile drucken oder in Git kopieren. Niemals source/eval für diese Dateien verwenden. Standard-SSH darf den bestehenden Schlüssel zur Authentisierung verwenden; er wird nicht exportiert.

2. Server und Cloud-Linux: geprüfter lesender SSH-Einstieg

Das Datenformat der conf-Dateien liest vm_access_check.py mit striktem Parser. Der folgende feste Befehl liest ausschließlich den Kerneltyp:

python3 - <<'PYCODE'
from pathlib import Path
import subprocess, sys
sys.path.insert(0, "deploy")
import vm_access_check as access

profile = "server.conf"  # Für die Cloud-Linux-VM: "linux-vm.conf".
cfg = access.load_config(Path("credentials") / profile)
args = [
    "ssh", "-F", "/dev/null", "-T",
    "-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes",
    "-o", "IdentitiesOnly=yes", "-o", "ForwardAgent=no",
    "-o", "ControlMaster=no", "-o", "ControlPath=none",
    "-o", "ConnectTimeout=7", "-p", cfg.get("port", "22"),
    "-i", str(Path(cfg["ssh_key_path"]).expanduser()),
    cfg["username"] + "@" + cfg["address"], "uname -s",
]
r = subprocess.run(args, capture_output=True, timeout=20)
if r.returncode:
    raise SystemExit("SSH-Prüfung fehlgeschlagen; private Fehlerausgabe zurückhalten")
print(r.stdout.decode().strip())
PYCODE

Heute beide Zielverbindungen erfolgreich, ohne SSH-Multiplexing. Der bestehende Linux-Preflight kann alternativ mit python3 deploy/vm_access_check.py aufgerufen werden; er ist lesend, prüft mehr OS-Metadaten und kann bei fehlendem Trust nur unbestätigte Scan-Fingerprints zeigen. Diese nicht automatisch übernehmen. Das neue Linux-RMM-Verbindungsziel ist direkt discovery.ease-technologies.de, kein alter PC→VM-RMM-Reversetunnel.

Serverarbeitsverzeichnis: /opt/rust-discovery. API/Gateway/Postgres heißen rust-discovery-server-api-1, rust-discovery-server-gateway-1, rust-discovery-server-postgres-1. Reine Lesebefehle über die oben gebildete SSH-Verbindung sind beispielsweise docker ps oder ein enges docker inspect. Niemals komplette Config.Env, .env, private PKI oder Tokenfiles ausgeben.

Bei einer später ausdrücklich beauftragten Bereitstellung: Die tatsächlich laufende Compose-Dateikette erst aus dem Label com.docker.compose.project.config_files der API/Gatewaycontainer lesen. Sie enthält neun Basis-/Broker-/Release-/Policydateien. Nur die Basisdatei mit compose up/recreate zu verwenden würde den falschen Stand erzeugen. Die genaue heutige Reihenfolge steht im öffentlichen Zugangsbeleg. Heute wurde kein Compose-/Dienstaufruf mit Wirkung ausgeführt.

3. WebUI und MCP: privater SSH-Forward, gültiges TLS

API/MCP auf Server 127.0.0.1:18443, Gateway auf127.0.0.1:18444; PostgreSQL ohne Portveröffentlichung. Öffentlicher Agenteningress und SSH sind getrennt. Keine öffentliche Dev-Anmeldung einrichten.

Für einen eigenen lokalen Verwaltungsforward ist dieser Befehl vorbereitet. Er läuft im Vordergrund bis Strg+C. Vorher prüfen, ob18443 schon belegt ist; keinen fremden Listener beenden oder verwenden.

python3 - <<'PYCODE'
from pathlib import Path
import subprocess, sys
sys.path.insert(0, "deploy")
import vm_access_check as access
c = access.load_config(Path("credentials/server.conf"))
args = [
    "ssh", "-F", "/dev/null", "-N", "-T",
    "-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes",
    "-o", "IdentitiesOnly=yes", "-o", "ForwardAgent=no",
    "-o", "ExitOnForwardFailure=yes", "-o", "ConnectTimeout=7",
    "-o", "ServerAliveInterval=15", "-o", "ServerAliveCountMax=2",
    "-p", c.get("port", "22"),
    "-i", str(Path(c["ssh_key_path"]).expanduser()),
    "-L", "127.0.0.1:18443:127.0.0.1:18443",
    c["username"] + "@" + c["address"],
]
subprocess.run(args, check=True)
PYCODE

Danach WebUI https://localhost:18443/ und MCP https://localhost:18443/mcp. Die CA gezielt aus credentials/server-ca.pem verwenden; kein curl -k, ignoreHTTPSErrors oder falscher TLS-Name. Heute über einen eigenen temporären Loopbackforward tatsächlich geprüft: gültige Kette/localhost-SAN, healthz200, MCP ohne Authentisierung401. Kein neuer Browserlogin. Ein zusätzlicher authentisierter MCP-Leseaufruf ist unten separat nachgewiesen.

Vorhandene Anwendungshelfer, erst lesen und nur passend verwenden:

  • deploy/cloud_mvp_acceptance.py: Backend() spricht echtes MCP über den Server; gespeicherte Daten etwa mit inventory.get_device/jobs.get lesen. Der normale CLI-Abnahmelauf ist nicht bloß ein Zugangstest.
  • deploy/browser/windows_mvp_approve.cjs: führt echte UI-Genehmigung durch; niemals als Erreichbarkeitsprobe oder mit einem alten Checkpoint ausführen.
  • prepare_browser() aus cloud_mvp_acceptance.py richtet gezielten Browsertrust im vorhandenen isolierten NSS-Verzeichnis ein. Der Browser liest die geschützte Login-JSON selbst; keine Kennwörter kopieren.
  • Entwicklungslogin und sichtbar simulierte Freigaben sind für diesen MVP beauftragt; kein OIDC nötig. Das ersetzt keine neue Risikoentscheidung.

Heute zusätzlich tatsächlich bestanden: authentisierter MCP-Aufruf jobs.get, nur gespeicherter Job7d756c34… gelesen, Ergebnis unknown/Revision2. Die vorhandenen Zugangsdaten bleiben auf dem Server; kein Submit, Plan oder Approval. Der reproduzierbare lesende Einstieg ist:

python3 - <<'PYCODE'
import sys, json
sys.path.insert(0, "deploy")
import cloud_mvp_acceptance as c
record = c.Backend().call("jobs.get", {
    "tenant_id": "11111111-1111-4111-8111-111111111111",
    "job_id": "7d756c34-3506-4545-8ecd-0e94b9fe7569",
})
print(json.dumps({"state": record["state"], "revision": record["revision"]}))
PYCODE

Alte private Browserwrapper mit festgehaltener PID 1689414 oder historischem Portbesitzer nicht übernehmen. Einen eigenen Forwardprozess identifizieren und nach Benutzung ausschließlich diesen schließen.

4. Windows: vorhandenen Prefix benutzen, nicht neu bootstrappen

Der vorhandene Weg ist:

Entwicklungs-PC
  └─ SSH-Key/Hostpins → root@88.99.80.202
      └─ Server 127.0.0.1:22240
          └─ bestehender Windows→Server-Reversetunnel
              └─ Windows127.0.0.1:22222 (sshd)
                  └─ rmm-dev

Der ProxyCommand und die richtigen Key-/Hostpinpfade sind bereits vollständig im ssh_prefix der geschützten JSON gespeichert. Nicht von Hand aus alten Chatbefehlen rekonstruieren. Schlüssel-/Hostpinexistenz und die Optionen BatchMode/IdentitiesOnly/StrictHostKeyChecking wurden heute lokal geprüft.

Bevorzugter lesender Einstieg mit dem vorhandenen Helper:

python3 - <<'PYCODE'
import sys, json
sys.path.insert(0, "deploy/windows")
import client_bootstrap as cb
result = cb.powershell(r"""
[pscustomobject]@{
  utc = [DateTime]::UtcNow.ToString('o')
  sshd = [string](Get-Service sshd).Status
  tunnel = [string](Get-ScheduledTask RmmDevReverseTunnel).State
  agent = [string](Get-Service RmmDiscoveryWindows).Status
  helper = [string](Get-Service RmmDiscoverySystemHelper).Status
} | ConvertTo-Json -Compress
""", timeout=30)
print(json.dumps(result))
PYCODE

Dieser konkrete Gaststatusbefehl ist heute nicht erfolgreich ausgeführt: Windows-SSH scheitert bereits am fehlenden Serverlistener 22240. Eine frische Verbindung mit deaktiviertem äußerem Multiplexing bestätigte Connection refused. Der Serverzugang selbst funktioniert. Keine neue Windows-Hostkeyprüfung oder Anmeldung war dadurch möglich.

Der User hat am 16. November permanenten Entwicklungs-SSH ausdrücklich erlaubt. Konto rmm-dev ohne Ablaufdatum und SYSTEM-Task RmmDevReverseTunnel sind historisch eingerichtet und nachgewiesen. expires_at in der lokalen JSON ist noch der historische abgelaufene Bootstrapwert. Die Funktion client_bootstrap.powershell() nutzt den vorhandenen Prefix und prüft dieses alte Fristfeld nicht. JSON nicht nur für alte Runner umschreiben und keinen neuen User-Wartungsfensterbefehl erzeugen. Historischer Nachweis.

Weitere Stolperstellen: cb.powershell() erwartet eine einzelne JSON-Ausgabe. Keine Schlüssel/Tokens oder breite Diagnoseausgaben zurückgeben. [Console]::In.ReadLine()-Payloads haben über diesen Transport bereits gehangen; alte Upload-/Renewal-CLI nicht als Allzweckzugang ausführen. Für einen später beauftragten Import nur die vorhandenen geprüften Hash-/Stagingpfade verwenden. remote_signed=True setzt RemoteSigned nur für den einzelnen Bootstrapprozess; keine globale ExecutionPolicy ändern.

5. Wenn der Windows-Tunnel fehlt: lokale Gastkonsole ist der zweite Weg

Tatsächlich heute lesend geprüft:

  • libvirt-Verbindung qemu:///system, Domain win11-test: Running.
  • DHCP-Lease laut libvirt192.168.122.170/24; keine Aussage über einen dortigen SSH-Listener. Windows-sshd ist absichtlich nur an Gast-Loopback gebunden.
  • virsh, virt-viewer und virt-manager sind auf diesem PC vorhanden.
  • Konsole konnte ohne Tasteneingabe aufgenommen werden. Bild schwarz, ein entsperrter Administrator-PowerShellprompt wurde heute nicht bestätigt.
virsh -c qemu:///system domstate win11-test
virsh -c qemu:///system domifaddr win11-test --source lease

Zum späteren Öffnen der bestehenden Konsole ist vorbereitet, hier nicht gestartet:

virt-viewer --connect qemu:///system win11-test

Der schon benutzte lokale Tastatur-/Screenshothelfer liegt unter devstate/windows-client/mvp-closeout-20261116/console.py. Er verwendet virsh send-key für diesen Gast, deutsche Tastenbelegung und nur eingeschränkte Zeichen. Ein Aufruf mit Argument tippt tatsächlich in die gerade aktive Gastoberfläche; enter sendet Enter. Nicht blind aufrufen, importieren oder unbekannte laufende Befehle unterbrechen. Ohne Argument überschreibt er seine privaten live-Bilder. Heutige neue, getrennte Bilder: devstate/ai-handover-20261117/windows-console.png und .ppm.

Bei beauftragter Zugangswartung zuerst die Konsole/Anmeldung klären und ausschließlich den bestehenden Task und sshd lesen. Erst danach gegebenenfalls den bereits beauftragten Entwicklungstransport erhaltend wieder starten. Kein RMM-Dienstwechsel, kein Reboot/Update, keine neuen Schlüssel/Accounts/Ports und kein alter Bootstrap-Reparaturlauf sind dafür automatisch nötig/autorisiert. Heute wurde nichts davon ausgeführt. Ein vorhandener Konsolenlogin wurde nicht vorausgesetzt; erforderliche Benutzerinteraktion offen melden.

6. Historische Werkzeuge sind keine Wiederaufnahmeanweisung

console_access_recovery.py/precision/hash/original_bootstrap, Open-Window, Recover-, Set-PersistentDevelopmentAccess, die221-/205-SDKs, Install-*Successor und windows_system_scope_renew.py besitzen feste alte Fälle, Fristen, Inodes oder create-once-Intents. Nicht erneut ausführen oder deren Guards passend machen. Ebenso keine credentials-/devstate-Snapshots über die aktuellen Originale kopieren.

Heute wurden ausschließlich Profile/Dateiexistenz, SSH, gespeicherter Serverzustand, VMstatus und TLS geprüft. Kein Zugang ist als Jobgenehmigung zu verstehen.