- Unterobjekte schreibbar (children.write): Sites/Subdomains anlegen und löschen (Hauptdomain geschützt), Postfächer (anlegen, Passwort, Größe, löschen), MySQL-Datenbanken mit Benutzer (anlegen, Passwort, löschen), FTP-Benutzer (anlegen, Passwort/Verzeichnis, löschen) - Mandantentrennung: vor jeder Änderung Zugehörigkeit zum Abonnement prüfen; Anlegen wiederholbar, Löschen idempotent - Live an Plesk 18.0.81 geprüft; Eigenheiten berücksichtigt: set-db-user mit <id>, create-non-existent, Fehler 1024 (Limit) = Ablehnung statt Retry, Teilanlage von Postfächern bei Größenfehler wird zurückgerollt - Nachbau verhält sich entsprechend; 5 neue Tests (22 gesamt) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.1 KiB
Plesk-Connector
Umsetzungsstand (05.10.2026)
Paket packages/connector-plesk, gebaut nach der Plesk-Dokumentation (XML-API, Plesk Obsidian 18), getestet gegen einen Nachbau (test/fake.ts) und am 05.10.2026 live gegen Plesk Obsidian 18.0.81 (Debian 13, Testserver) vom Kundencenter-Server aus. Zugang: Plesk-Adresse mit Port (meist https://host:8443) + Secret Key.
Einrichtung
- Auf dem Plesk-Server als root:
plesk bin secret_key -c -ip-address <IP des Kundencenter-Servers> -description Kundencenter→ Schlüssel kopieren. Er ist an diese IP gebunden und hat Administratorrechte (verschlüsselt gespeichert, nur Superadmins). - Kundencenter → Einstellungen → Verbindungen → „Plesk (Webhosting)“: Adresse, Secret Key; bei selbstsigniertem Zertifikat (Port 8443 üblich) den SHA-256-Fingerabdruck.
- Nur für die Bereitstellung neuer Konten: IP-Adresse für neue Abonnements (gemeinsame IPv4) und Domain für neue Abonnements (z. B.
kunden.example.de).
Abbildung
| Kundencenter | Plesk | Bemerkung |
|---|---|---|
| Hosting-Konto (Ressource) | Abonnement (webspace) |
externalRef = Abonnement-ID. Name „domain · login des Besitzers“. |
| Kontaktdaten bei der Übernahme | Plesk-Kunde (Besitzer des Abonnements) | Je Abonnement ein Eintrag. Hat ein Kunde mehrere Abonnements, das zweite bei der Übernahme mit dem bereits angelegten Kunden verknüpfen. Abonnements des Administrators haben keinen Kunden. |
| Produktvorlage | Service-Plan | plan:<id>, fest vorgegeben; Bereitstellungsparameter planId (+ planName zur Anzeige). |
| Zustand | gen_info/status |
0 aktiv, 4 Sicherung läuft (aktiv), 16/32/64 gesperrt, 256 abgelaufen. |
| Limits / Nutzung | limits (Plan), stat, real_size |
Gleiche Schlüssel wie beim KeyHelp-Connector (disk_space, traffic, domains, subdomains, email_accounts, databases, ftp_users); -1 = unbegrenzt; expiration → „gültig bis“. |
Funktionen
- Lesen/Abgleich: Health mit Plesk-Version, Abonnements mit Besitzer, Plan, Limits, Nutzung (3 Abfragen, unabhängig von der Anzahl).
- Kunden übernehmen, Service-Pläne übernehmen (Produkte → Aus Verbindung übernehmen).
- Bereitstellung (Bestellung): Kunde mit Login
kc+ Ziffern der Vertragsnummer und Vermerk „Kundencenter K-… V-…“, dann Abonnementkc<Nr>.<Domain für neue Abonnements>auf dem Plan. Wiederholung findet Kunde (am Vermerk) und Abonnement (am Besitzer) wieder statt doppelt anzulegen. Passwörter (Kunde, FTP) werden zufällig erzeugt und nie gespeichert; Zugang über den Panel-Login. - Aktionen: Sperren/Entsperren (Status 16/0), Planwechsel (
switch-subscription), Löschen des Abonnements (Kunde bleibt; nie automatisch wiederholt), Passwort des Besitzers neu setzen. - Panel-Login: Einmal-Sitzung für den Besitzer (
server/create_session→rsession_init.php), nie gespeichert. - Unterobjekte (Freigabe pro Produkt/Ressource wie bei KeyHelp): Domains (weitere Sites/Subdomains anlegen und löschen; Hauptdomain geschützt), Postfächer (anlegen, Passwort/Größe, löschen), Datenbanken (MySQL mit gleichnamigem Benutzer, Passwort, löschen), FTP-Benutzer (anlegen, Passwort/Verzeichnis, löschen;
/www/aus der Oberfläche wird zu/httpdocs). Vor jeder Änderung wird geprüft, dass das Objekt zum Abonnement gehört; Anlegen ist wiederholbar, Löschen idempotent. Domain-Einstellungen (PHP, Let’s Encrypt) bitte im Plesk-Panel ändern.
Sicherheit
- Alle Werte werden in XML maskiert (keine Element-Injektion); Antworten mit DOCTYPE/ENTITY werden abgelehnt (kein XXE).
- Der Secret Key steht nur im Header
KEY, nie im Paket. Lesende Pakete werden bei 5xx/Netzfehler wiederholt, schreibende nie automatisch.
Live-Prüfung (Plesk 18.0.81, 05.10.2026)
| Punkt | Ergebnis |
|---|---|
Secret Key im Header KEY, Zertifikat per Fingerabdruck |
✅ bestätigt |
Leerer <filter/> liefert alles, 1013 = nicht gefunden |
✅ bestätigt |
Elementreihenfolge customer/add, webspace/add |
✅ bestätigt (Bereitstellung + Wiederholung ohne Doppelanlage) |
subscriptions/plan-guid, effektive limits, expiration |
✅ bestätigt |
Größen in Byte, cr_date als Datum |
✅ bestätigt |
server/get: Reihenfolge |
❌ war stat, gen_info → Plesk verlangt gen_info vor stat (behoben) |
Panel-Login (create_session) |
❌ Sitzung ist an user_ip gebunden; mit 127.0.0.1 landet der Kunde auf der Anmeldeseite → IP des Browsers wird übergeben (SDK: loginUrl(ctx, ref, { userIp }), API: clientIp(req)), danach ✅ |
site/get, mail/get_info, database/get-db, ftp-user/get |
✅ bestätigt; bei 0 Treffern liefert Plesk ein leeres <result> ohne id → wird ausgefiltert (behoben) |
| Sperren/Entsperren, Planwechsel, Passwort, Löschen | ✅ bestätigt (Zielzustand, Wiederholung unschädlich) |
| Mandantentrennung bei Unterobjekten | ✅ bestätigt |
Unterobjekte ändern (site/add·del, mail/create·update·remove, database/add-db·add-db-user·set-db-user·del-db, ftp-user/add·set·del) |
✅ bestätigt; Eigenheiten: set-db-user erwartet <id> direkt (kein <filter>), Element heißt create-non-existent (für neue FTP-Verzeichnisse nötig), Plan-/Lizenzlimits kommen als Fehler 1024 (jetzt Ablehnung statt Wiederholung), mail/create legt das Postfach an und meldet erst danach einen Größenfehler → Connector rollt zurück |
Hinweis: Mit der kostenlosen Edition „Web Admin SE“ sind höchstens 3 Kunden/3 Domains möglich; für echten Betrieb ist eine Plesk-Lizenz mit Kundenverwaltung (z. B. Web Pro/Web Host) nötig.
Noch nicht umgesetzt
Neue Service-Pläne aus dem Kundencenter anlegen, Domain-Einstellungen (PHP-Version, Let’s Encrypt), Weiterleitungen/Aliase von Postfächern, SSL-Zertifikate, DNS, Reseller, mehrere Abonnements je Bestellung.
Testen ohne eigenen Server
Plesk bietet ein offizielles Docker-Image (plesk/plesk) und eine kostenlose Testlizenz (14 Tage). Das Skript für den Live-Test liegt nicht im Repo (nutzt echte Zugangsdaten); Ablauf: read → provision → actions → sso → children → cleanup.