278 lines
13 KiB
Markdown
278 lines
13 KiB
Markdown
# 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.
|