Dokumentation

CyberPanel

CyberPanel ist ein quelloffenes Control Panel für Webhosting. Provibr spricht mit dessen API über die Anmeldedaten Ihres Hauptadministrators und verwaltet die Websites darauf: anlegen, stilllegen und reaktivieren, in ein anderes Paket verschieben und löschen.

Den API-Zugriff einschalten

Auf einem frischen CyberPanel ist die API abgeschaltet, und das gilt auch für Ihren Hauptadministrator. Sie schalten sie im Panel unter Users, API Access für den Benutzer admin ein. Mehr braucht es nicht: Provibr meldet sich mit den Anmeldedaten an, die Sie ohnehin haben.

Bleibt sie aus, kommt jeder Aufruf als API Access Disabled zurück, ganz gleich was Sie eingetragen haben. CyberPanel prüft diesen Schalter vor dem Passwort, deshalb liefert ein richtiges Passwort genau dieselbe Antwort wie ein falsches. Alles deutet auf Ihre Anmeldedaten, während das Problem ein Häkchen weiter liegt.

Der Hauptadministrator muss admin heißen

Ein Teil der CyberPanel-API weist jeden anderen Namen als admin ab, und genau dieser Teil listet die Websites auf dem Panel auf und meldet, wie weit eine neue ist. Provibr braucht beides, deshalb ist das Konto, das Sie unten eintragen, dasjenige mit dem Namen admin.

Das ist keine Einstellung, sondern eine Voraussetzung, und sie kommt von CyberPanel und nicht von uns: ein umbenannter Administrator lässt sich für diese Integration nicht verwenden. Der Verbindungstest sagt es Ihnen, damit Sie es vor Ihrer ersten Bestellung wissen.

Was Provibr verlangt

Vier Felder. Der Agent bewahrt sie in seinem eigenen Tresor auf Ihrem Host auf; Provibr kann sie nicht zurücklesen.

Die Adresse des Panels samt Port, zum Beispiel https://panel.example.com:8090. Ohne Port ergänzt Provibr 8090. Einfaches http wird abgelehnt: dieser Port spricht ausschließlich TLS.
Der Name des Hauptadministrators, und der lautet admin.
Das Passwort dieses Administrators.
Der SHA-256-Fingerabdruck des Zertifikats, solange das Panel das selbstsignierte verwendet.

CyberPanel hat kein API-Token, das diese Befehle abdeckt: innerhalb der eigenen API ist der Token-Weg je Endpunkt an- oder abgeschaltet, und ausgerechnet die vier Befehle zum Anlegen, Stilllegen, Umstellen des Pakets und Löschen einer Website verlangen das Passwort. Hier steht also das vollständige Passwort Ihres Hauptadministrators, dieselbe Lage wie bei Webmin.

Das Zertifikat

Jedes frische CyberPanel liefert dasselbe selbstsignierte Zertifikat aus, ausgestellt auf www.example.com und von CyberPanel selbst signiert. Ein Browser nennt es deshalb ungültig statt selbstsigniert, und die Kette wird nie bestätigt. Tragen Sie den Fingerabdruck ein, dann vertraut der Agent genau diesem einen Zertifikat, statt die Prüfung abzuschalten. Auslesen lässt er sich von jeder Maschine aus, die das Panel erreicht:

shell

openssl s_client -connect <host>:8090 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Befehle und Terminal-Ausgaben sind überall auf Englisch, im Panel und auf diesen Seiten. Ein Text, eine Wahrheit: Was Sie hier lesen, ist wörtlich das, was Ihr Host zurückschreibt.

Legen Sie ein eigenes Zertifikat auf den Hostnamen des Panels, dann bestätigt sich die Kette von selbst und das Feld bleibt leer. Dort ist das die bessere Wahl, denn ein solches Zertifikat wird hin und wieder ausgetauscht, und ein festgelegtes müsste hier jedes Mal neu eingetragen werden.

Pakete

CyberPanel beschreibt in einem Paket, was eine Website nutzen darf. Provibr liest diese Liste und verweist auf ein Paket über seinen Namen; die Pakete selbst werden in CyberPanel angelegt und geändert, nicht hier.

Ein Webhosting-Plan in Provibr zeigt auf ein Paket einer Integration. Das ist es, was Ihre Kundschaft bestellt, und den Preis legen Sie selbst fest.

Eine Website in ein anderes Paket zu verschieben ändert die Buchführung und sonst nichts. Von innen gemessen, mit einem Paket, das andere Grenzen trug: die Plattenquote blieb wie sie war und die Konfiguration des Webservers behielt die alten Werte. Das Panel zeigt den neuen Namen an, lesen Sie diesen Namen also als Verwaltung und nicht als eine Grenze, die mitgewandert wäre.

Was eine Bestellung mitschickt

Eine Website auf CyberPanel wird über ihre Domain angesprochen, und das ist auch in Provibr ihre Identität. Eine Bestellung trägt vier Dinge:

Die Domain. Sie muss auf dem Panel frei sein, und alles, was Provibr danach mit diesem Server tut, zeigt auf sie.
Eine Kontaktadresse für die Website.
Das Paket, in das die Website kommt.
Ein Passwort für die Panel-Anmeldung, die CyberPanel unterhalb der Website anlegt.

Das Anlegen dauert auf CyberPanel etwa fünfzig Sekunden, wovon rund achtundzwanzig auf einen SSL-Versuch entfallen, den das Panel in jedem Fall unternimmt. Provibr wartet das wirkliche Ergebnis ab, statt der ersten Antwort zu glauben: die kommt nach etwa drei Sekunden und sagt nichts, nicht einmal, ob die Domain noch frei war.

Stilllegen und reaktivieren

Beides wirkt sofort: das Panel meldet den neuen Stand und seine eigene Liste zeigt ihn unmittelbar. Provibr legt eine Website still, wenn Sie darum bitten, und wenn Ihre Kapazität überschritten wird.

Stilllegen ist auf CyberPanel ein Kniff im Webserver und keine Kontosperre. Die Website wird unerreichbar, aber FTP, Mail und Datenbanken laufen weiter, und der Unix-Benutzer wird nicht gesperrt. Das unterscheidet sich von DirectAdmin, und es zählt, sobald Sie das Stilllegen zur Durchsetzung nutzen.

Speicherplatz und Datenvolumen

CyberPanel ist das einzige Control Panel in Provibr ohne Verbrauchsgrafiken, und das lässt nicht die Integration weg: das Panel misst es nicht. Das Datenvolumen wird berechnet und danach verworfen, und der Speicherverbrauch stammt aus einem Zwischenspeicher, der bei einer neuen Website leer blieb, sodass sich die Null, die dabei herauskommt, von wirklich nichts nicht unterscheiden lässt.

Eine Grafik, die auf Dauer auf null steht, sieht aus wie eine Messung, und deshalb gibt es keine. Was eine Website nutzen darf, steht in ihrem Paket, und was CyberPanel doch weiß, bleibt im Panel selbst stehen.

Websites, die es schon gibt

Websites, die außerhalb von Provibr angelegt wurden, lassen sich auf der Integrationsseite importieren: der Agent listet auf, was auf dem Panel steht, und Sie wählen aus, welche davon ein Server in Provibr werden.

Eine importierte Website zählt ab diesem Moment zu Ihrer Kapazität, wie jeder andere Webserver auch.

Was dies nicht tut

Provibr verwaltet Websites und nicht das Panel: es installiert CyberPanel nicht, aktualisiert es nicht und ändert keine Servereinstellungen. Eine Konsole gibt es nicht, und DNS, Postfächer und Datenbanken bleiben unberührt. CyberPanel kann das alles selbst, und Provibr steuert es nicht.

ZurückHestiaCP WeiterCloudPanel