kundencenter/docs/connector-plesk.md
Kundencenter 119a4fe07e Plesk: Domains, Postfächer, Datenbanken und FTP anlegen, ändern, löschen
- 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>
2026-10-05 21:35:11 +02:00

6.1 KiB
Raw Permalink Blame History

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

  1. 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).
  2. Kundencenter → Einstellungen → Verbindungen → „Plesk (Webhosting)“: Adresse, Secret Key; bei selbstsigniertem Zertifikat (Port 8443 üblich) den SHA-256-Fingerabdruck.
  3. 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 Abonnement kc<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.