Provisioner¶
Das ProvisionerPanel ist ein eigenes Panel unter /provision und verbindet HostAdmin mit den Hosting-Control-Panels (Plesk, Enhance) und dem Registrar (InternetX/AutoDNS). Es zeigt Live-Daten direkt aus den APIs an und verknüpft HostAdmin-Webhostings mit deren Accounts auf den Servern.
Aktueller Stand
Der Provisioner arbeitet derzeit strikt lesend (read-only). Schreibende Aktionen wie das Aktivieren/Deaktivieren von Hostings folgen in einer späteren Ausbaustufe.
Aktivierung¶
Zwei Bedingungen müssen erfüllt sein:
- Systemweit aktivieren — in der
.env:PROVISIONER_ENABLED=true - Benutzer freischalten — im AdminPanel unter System > Admin-Benutzer den Toggle „Zugriff auf ProvisionerPanel" aktivieren
Danach erscheint im Benutzermenü des AdminPanels der Eintrag „Zum ProvisionerPanel". Das Panel nutzt dieselben Benutzer und Logins wie das AdminPanel.
Für den passwortlosen Plesk-Panel-Login braucht der Benutzer zusätzlich den Toggle „Server-Login (Plesk-Panel)".
Dashboard¶
Zeigt drei Kennzahlen: Anzahl Server, Hostings und Domains (mit Hinweis, wie viele Server eine Panel-Anbindung haben).
Server¶
Navigation: Provisioner > Server
Liste aller Server. Stammdaten (Name, Hostname, IP, ...) werden im AdminPanel gepflegt — im Provisioner wird nur die API-Verbindung verwaltet.
API-Verbindung einrichten¶
| Feld | Beschreibung |
|---|---|
| Control Panel Typ | Plesk, Enhance, cPanel, DirectAdmin, Sonstiges oder Keins — bestimmt die API-Anbindung |
| API Endpoint | Basis-URL der Control-Panel-API |
| API Key / Token | Zugangsschlüssel — verschlüsselt gespeichert und nie wieder angezeigt (leer lassen = beibehalten) |
| Organisations-ID (orgId) | Nur bei Enhance erforderlich |
| Nur Lesen (Readonly) | Schreibschutz für diesen Server (Standard: aktiv) |
Endpoint-Formate:
- Plesk:
https://server.example.com:8443/api/v2— Key über die Plesk-Extension „Keychain for API Secret Keys" erzeugen - Enhance:
https://cp.example.com/api/v2— Access Token in Enhance erzeugen (Super-Admin-Zugriff), zusätzlich die orgId eintragen
Funktionen (Zeile / Detailseite)¶
| Funktion | Beschreibung |
|---|---|
| Server-Info | Detailseite mit Live-Daten des Control Panels (Hostname, Version, Plattform ...) |
| API-Verbindung bearbeiten | Endpoint/Key/Readonly pflegen (auf der Detailseite) |
| Verbindung testen | Prüft Endpoint + Key gegen die echte API |
| Ins Plesk-Panel | Öffnet das Plesk-Panel per Einmal-Login (nur Plesk, nur mit Server-Login-Recht) |
Empfehlung
Produktive Server, die aus einer DEV-/TEST-Umgebung heraus verbunden werden, immer auf Readonly lassen.
Hostings¶
Navigation: Provisioner > Hostings
Zeigt alle Webhosting-Services. Jedes Hosting wird hier mit seinem Account auf dem Server verknüpft — die Verbindung gehört zum Webhosting, nicht zum Kunden (ein Kunde kann mehrere Hostings auf verschiedenen Servern haben). Die Control-Panel-Spalte zeigt, welche Hostings anbindbar sind.
Funktionen¶
| Funktion | Beschreibung |
|---|---|
| Verknüpfen | Lädt die Accounts live vom Server; Vorauswahl bei Login-Match; Anzeige mit Name + E-Mail |
| Automatisch abgleichen | Verknüpft unverknüpfte Hostings mit exaktem Login-Match (praktisch v.a. Plesk) |
| Lösen | Entfernt nur die Verknüpfung in HostAdmin |
| Details | Detailseite mit Live-Daten des Hostings (siehe unten) |
| Kunde | Öffnet den Kunden im AdminPanel |
Filter: Server und Verknüpfung (verknüpft/unverknüpft).
Enhance
Enhance-Kunden sind Organisationen ohne Login-Namen — der automatische Abgleich greift dort meist nicht. Diese über Verknüpfen manuell zuordnen (Anzeige mit Name und E-Mail des Owners).
Hosting-Details (Live)¶
Die Detailseite eines verknüpften Hostings zeigt live vom Server:
- Paket / Webspace — Paketname, Status, Speicher (genutzt/Limit), Traffic
- Domains / Webspaces — Domainname, Hosting-Typ, DocRoot, Aliase
- SSL-Zertifikate — Aussteller, gültig bis, SANs
- E-Mail-Postfächer — Adressen (bei Enhance mit Status/Weiterleitungen)
Domains¶
Navigation: Provisioner > Domains
Liste aller Domain-Services aus HostAdmin. Domains können einem Hosting untergeordnet sein oder eigenständig ohne Server existieren.
- Details — Detailseite mit den Registrar-Daten aus AutoDNS (Status, Zahlbar-bis, Auto-Renew, Nameserver) und den zugeordneten Kontakt-Handles (Inhaber/Admin/Tech/Zone)
- Kunde — öffnet den Kunden im AdminPanel
Registrar-Domains vs. Domains
Domains (Hauptnavigation) zeigt die Domain-Services aus HostAdmin. Davon getrennt liegt unter DomainRobot > Registrar-Domains die Registrar-Sicht direkt aus InternetX/AutoDNS.
DomainRobot (InternetX / AutoDNS)¶
Navigation: Provisioner > DomainRobot (nur sichtbar, wenn in den Einstellungen aktiviert)
Read-only-Zugriff auf den Registrar.
- Registrar-Domains — alle Domains des Accounts (Zahlbar-bis, Registry-Status). Details-Ansicht mit Nameservern, Auto-Renew und Flags.
- Contact Handles — alle Kontakt-Handles. Details-Ansicht mit Anschrift, E-Mail und NIC-Handles.
API-Benutzer
Für die Anbindung einen dedizierten API-Benutzer ohne 2FA verwenden — bei aktivem 2FA werden Domain-Abfragen abgelehnt. Der Context ist die kontospezifische Nummer (Reseller haben eine eigene, nicht zwingend „4").
Einstellungen¶
Navigation: Provisioner > System > Einstellungen
- API-Timeout — Zeitlimit für alle Provider-Aufrufe
- Schreibzugriff (Phase 2) — globaler Schalter für spätere schreibende Aktionen
- DomainRobot — Umgebung (Live/Demo), Context, Benutzername, Passwort (verschlüsselt), „Verbindung testen"
Geplante Funktionen¶
- Phase 2 — Schreibzugriff: Hostings/Kunden aktivieren und deaktivieren (mit Audit-Log), abgesichert über den globalen Schreib-Schalter und den Pro-Server-Readonly-Schutz
- Optionale Artisan-Commands (z.B. Verbindungen prüfen, Zertifikatsabläufe melden)