Connectoren
Server, Hypervisoren, DNS, Firewalls, Speicher, Cloud und Smart Home verbinden – einzeln oder Hunderte auf einmal.
Ein Connector ist ein System, mit dem Opsaido sprechen kann: ein Proxmox-Cluster, ein Linux-Server, ein DNS-Anbieter, eine Firewall. Der Assistent nutzt nur Werkzeuge für die Systeme, die Sie verbunden haben.
Einen hinzufügen
- Öffnen Sie Settings → Connectors → Add connector und wählen Sie den Typ.
- Tragen Sie Adresse und Login ein. Jeder Typ erklärt genau, was er braucht.
- Drücken Sie Test connection. Bei SSH-Hosts wird der Host-Schlüssel beim ersten Test festgeschrieben.
Geben Sie Opsaido auf jedem System ein eigenes Dienstkonto, nur mit den Rechten, die der Assistent haben soll. Leserechte genügen für Überwachung und Fehlersuche.
Was jedes System braucht
| System | Verbindet sich über | Zum Überwachen | Für Änderungen |
|---|---|---|---|
| Proxmox VE | API-Token | PVEAuditor | PVEVMAdmin + Datastore-Rechte |
| XCP-ng | Xen-Orchestra-Token | Ein XO-Benutzer mit Leserechten | Ein XO-Admin oder ACLs auf Pools / VMs |
| KVM / libvirt | Den Linux-(SSH-)Connector des Hosts | Ein Benutzer in der Gruppe libvirt | Dasselbe oder sudo |
| VMware ESXi / vCenter | vSphere-API | Nur-Lese-Rolle | VM-Energie, Snapshots, Bereitstellung |
| Linux | SSH (Schlüssel empfohlen) | Ein normaler Benutzer | sudo |
| Windows | WinRM (HTTPS 5986 empfohlen) | Ein normaler Benutzer | Lokaler Admin |
| Docker | Socket-Proxy oder SSH | Nur-Lese-Proxy | Proxy mit erlaubten Aktionen |
| Kubernetes / k3s | kubeconfig oder Token | view | edit / admin |
| Active Directory | LDAPS | Lesen auf den OUs (jeder Domänenbenutzer) | Delegierte Admin-Rechte auf den OUs zur Verwaltung von Benutzern, Computern und Gruppen (anlegen, ändern, Passwörter zurücksetzen, verschieben, löschen) |
| Cloudflare DNS | API-Token | Zone:Read | DNS:Edit |
| Microsoft 365 / Azure | App-Registrierung in Entra ID | Graph-Leserechte, Azure Reader | Passende Schreibrechte |
| Firewalls (OPNsense, pfSense, MikroTik) | REST-API-Schlüssel | Leserechte | Schreibrechte |
| FortiGate | REST-API-Admin-Token | Admin-Profil nur lesen (dieser Server als vertrauenswürdiger Host) | — (Connector nur lesend) |
| Palo Alto (PAN-OS) | XML-API-Schlüssel oder Benutzername und Passwort | Admin nur lesen | — (Connector nur lesend) |
| Check Point | Management-API (R80+), Benutzer oder API-Schlüssel | Berechtigungsprofil nur lesen | — (Connector nur lesend) |
| Meraki MX | Dashboard-API-Schlüssel | Organisationszugriff nur lesen | — (Connector nur lesend) |
| SonicWall / Sophos Firewall | SonicOS-7-REST-API / SFOS-XML-API (API aktivieren, Adresse dieses Servers erlauben) | Admin nur lesen | — (Connector nur lesend) |
| Cisco Firepower / ASA | FMC-REST-API / SSH | FMC-Benutzer nur lesen / ASA-Benutzer nur lesen (Privilege 5 reicht für show-Befehle) | — (Connector nur lesend) |
| Switches, NAS, USV, Drucker (jeder Hersteller) | SNMP v1 / v2c / v3 | Community nur lesen oder v3-Benutzer mit Passwort | — (nur lesend) |
| Citrix Virtual Apps and Desktops | WinRM zu einem Delivery Controller (und Lizenz-, StoreFront- und PVS-Server) | Read Only Administrator | Help Desk / Machine Catalog / Delivery Group Administrator |
| Backups (PBS, Veeam) | API-Token | Audit- / Betrachter-Rolle | Operator- / Admin-Rolle |
| CrowdSec | Local API | Bouncer-Schlüssel (prüft, wer gesperrt ist) | Machine-Login (cscli machines add): Alerts, sperren, entsperren |
Die vollständige Liste steht auf der Seite Integrationen.
Viele Server mit demselben Login
| Schritt | Wo | Was Sie tun |
|---|---|---|
| 1 | Settings → Credentials → New credential | Den gemeinsamen Login einmal speichern: SSH-Schlüssel, Windows-Login, API-Token … |
| 2 | Settings → Connectors → Add many | Typ und Zugangsdaten wählen, einen Server pro Zeile einfügen (name, host) oder eine CSV laden |
| 3 | Dieselbe Seite | Tags wie web oder prod vergeben; Opsaido legt die Server an und testet je zehn gleichzeitig |
Danach:
- Rotieren Sie das Passwort in den Zugangsdaten, und jeder Server, der sie nutzt, übernimmt es.
- Nach Tag fragen: „prüfe Updates auf allen #web-Servern“.
- Eine Rolle auf einen Tag beschränken; später mit diesem Tag hinzugefügte Server sind automatisch eingeschlossen.
Hosts, die nicht direkt erreichbar sind
Für eine DMZ, einen anderen Standort oder ein isoliertes VLAN fügen Sie ein Proxy-Gateway hinzu: einen Linux- oder Windows-Rechner, der diese Hosts erreicht. Ablauf und Einrichtung stehen unter So funktionieren Verbindungen.
Dieselbe Maschine zweimal hinzuzufügen – etwa als Docker-Host und als Linux-Host – ist in Ordnung. Shell- und Dateiaufgaben laufen über den SSH-Connector, Container-Aufgaben über den Docker-Connector.