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

278 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](handover.md).
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
~~~bash
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](../deploy/vm_access_check.py) mit striktem Parser.
Der folgende feste Befehl liest ausschließlich den Kerneltyp:
~~~bash
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](evidence/ai-handover-access-20261117.json).
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.
~~~bash
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:
~~~bash
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:
~~~text
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:
~~~bash
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](windows-development-access.md).
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.
~~~bash
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:
~~~bash
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.