So funktionieren Verbindungen
Was zwischen Ihrer Frage und Ihren Systemen passiert, wo Zugangsdaten liegen und wie Proxy-Gateways Netze erreichen, die Opsaido nicht erreicht.
Der Weg einer Anfrage
- Sie fragen in Ihren eigenen Worten.
- Opsaido wählt die Werkzeuge für Ihre verbundenen Systeme und sendet die Frage mit diesen Werkzeugen an Ihren KI-Anbieter.
- Die KI wählt einen Schritt, zum Beispiel „liste die VMs im Proxmox-Cluster“.
- Opsaido prüft den Schritt. Ein Lesezugriff läuft sofort; eine Änderung wartet auf Ihre Freigabe (siehe Freigaben und Probeläufe).
- Opsaido verbindet sich mit dem gespeicherten Login des Connectors, führt den Schritt aus und schreibt ihn ins Audit-Log.
- Das Ergebnis geht zurück an die KI, die den nächsten Schritt wählt oder Ihnen die Antwort schreibt.
Logins werden verschlüsselt in der Datenbank von Opsaido gespeichert und nur für den Moment einer Verbindung entschlüsselt. Die KI sieht, was ein Schritt zurückgegeben hat, nie, wie Opsaido sich angemeldet hat.
Was einen Connector nutzt
| Nutzung | Wann | Freigabe |
|---|---|---|
| Test connection | Wenn Sie den Knopf drücken; schreibt beim ersten Mal den SSH-Host-Schlüssel fest | — |
| Monitoring | Alle paar Minuten: CPU, Speicher, Platte, Status, Warnungen | — |
| Assistent | Wenn Sie etwas zu diesem System fragen | Lesen: keine · Ändern: ja |
| Geplante Aufträge | Nach ihrem Zeitplan | Wie im Auftrag eingestellt |
| Fernzugriff | SSH-Terminal oder RDP-Desktop im Browser | Benötigt die Berechtigung für Fernzugriff |
Wie jede Art von System erreicht wird
| Verbindung über | Systeme | Über ein Gateway? | Über einen HTTP-Proxy? |
|---|---|---|---|
| SSH | Linux, KVM-/libvirt-Hosts, Docker über SSH, Terraform- und Ansible-Hosts | ✓ | — |
| WinRM | Windows, Hyper-V, Exchange, Windows-DNS, AD CS, MECM | ✓ | — |
| Web-API (HTTPS) | Proxmox, Xen Orchestra (XCP-ng), Docker-API, Firewalls, NAS, Backups, DNS-Anbieter, Microsoft 365, Azure … | — | ✓ |
| Native Protokolle | Active Directory (LDAPS), Datenbanken, VMware | — | — |
Web-APIs in einem anderen Netz lassen sich meist über einen HTTP-Proxy statt über ein Gateway erreichen. Legen Sie den Standard unter Settings → General → Outbound proxy fest und wählen Sie pro Connector default, direct oder einen custom Proxy. Private Adressen umgehen den Standard-Proxy, solange Sie die Ausnahmeliste nicht ändern.
Proxy-Gateways (Jump-Hosts)
Nutzen Sie ein Gateway, wenn Opsaido manche Hosts nicht direkt erreicht: eine DMZ, ein anderer Standort, ein isoliertes VLAN oder ein Kundennetz. Das Gateway ist ein Rechner, der sie erreicht, und Opsaido geht über ihn.
Einrichten
- Gateway hinzufügen: Settings → Connectors → Add connector → Proxy gateways. Wählen Sie Linux gateway (SSH) oder Windows gateway (WinRM) und hinterlegen Sie einen Login.
- Testen. Der Test prüft den Login und schreibt den SSH-Host-Schlüssel fest. Bei einem Windows-Gateway prüft er auch, ob der OpenSSH-Client installiert ist (nötig für Linux-Ziele).
- Hosts darauf verweisen: Wählen Sie bei jedem Linux- oder Windows-Connector dahinter das Gateway im Feld Proxy gateway.
- Jeden Host testen. Ab jetzt läuft alles für diesen Host – Tests, Monitoring, Schritte des Assistenten, Aufträge – über das Gateway.
Was für jedes Ziel passiert
| Ziel | Über ein Linux-Gateway (SSH) | Über ein Windows-Gateway (WinRM) |
|---|---|---|
| Linux | SSH wird durch das Gateway getunnelt (ProxyJump). Beide Host-Schlüssel werden festgeschrieben. Auch das Browser-Terminal funktioniert. | Der OpenSSH-Client des Gateways (ssh.exe) verbindet sich. Nur Schlüssel-Login; der Host-Schlüssel des Ziels wird beim ersten Test festgeschrieben. |
| Windows | WinRM läuft über einen SOCKS-Tunnel auf dem Gateway. Namen werden auf der Gateway-Seite aufgelöst, daher funktioniert Kerberos. | Invoke-Command läuft auf dem Gateway mit dem eigenen Login des Ziels. |
Was das Gateway braucht
| Gateway | Benötigt |
|---|---|
| Linux (SSH) | SSH-Zugang und erlaubtes TCP-Forwarding (AllowTcpForwarding yes, Standard). Das Konto braucht kein sudo. |
| Windows (WinRM) | WinRM-Zugang. Für Linux-Ziele: die Funktion OpenSSH Client. Für Windows-Ziele in Arbeitsgruppen: diese Hosts in TrustedHosts. |
| Netzwerk | Es muss die Ziele über SSH (22) oder WinRM (5985/5986) erreichen; Opsaido muss es über SSH oder WinRM erreichen. |
Das Gateway speichert keine eigenen Logins für die Ziele: Opsaido schickt den Login jedes Ziels nur für diese eine Verbindung hindurch. Behandeln Sie ein Gateway trotzdem wie jeden Jump-Host – halten Sie es gepatcht und beschränken Sie, wer sich anmelden darf.
Gut zu wissen
| Frage | Antwort |
|---|---|
| Kann ein Gateway viele Hosts bedienen? | Ja, beliebig viele. Gruppieren Sie sie mit Tags. |
| Kann ich ein Gateway deaktivieren? | Ja; seine Hosts zeigen dann „Proxy gateway is disabled“, bis Sie es wieder einschalten. |
| Kann ich ein genutztes Gateway löschen? | Nein. Verschieben Sie zuerst seine Hosts auf ein anderes Gateway oder leeren Sie ihr Feld. |
| Lassen sich Gateways verketten? | Nein, ein Gateway pro Host. Wählen Sie eines, das das Ziel direkt erreicht. |
| Und Web-APIs dahinter? | Dafür einen HTTP-Proxy nutzen (siehe Tipp oben). |