Zum Inhalt springen

Dokumentation

ISPConfig

Provibr verwaltet ISPConfig-Hosting-Konten über die Remote-API des Panels. Der Agent wählt sich ausgehend zu Ihrer ISPConfig-Installation, es gibt also keine eingehenden Ports und kein VPN. Diese Seite beschreibt, was an ISPConfig anders ist und was die Integration tut.

Ein Konto ist eine Website

ISPConfig trennt den Client (den Kunden, mit einem Login und einer Reihe von Grenzen) vom web_domain (der Website). Ein Provibr-Hosting-Konto ist eine Website, gekennzeichnet durch ihre Domain. Um eine Website anzulegen, braucht es einen Eigentümer, deshalb legt Provibr einen frischen Client und darunter eine Website an und entfernt beide wieder, wenn Sie das Konto löschen. Der Agent leitet den Client-Login aus der Domain ab, so findet er den Eigentümer immer wieder.

Was der Agent benötigt

Vier Felder, einmalig eingetragen, wenn Sie die Integration verbinden:

  • Die Panel-Adresse: die vollständige https-URL samt Port (standardmäßig 8080).
  • Ein Remote-Benutzer: angelegt unter System → Remote Users, beschränkt auf die Client- und Site-Funktionen.
  • Das Passwort dieses Remote-Benutzers.
  • Der TLS-Fingerabdruck des Panels: empfohlen, weil eine frische Installation selbstsigniert ist.
Der Remote-Benutzer ist ein eigenes Konto, nicht Ihr Panel-Administrator. ISPConfig lässt Sie ihn auf genau die Funktionen beschränken, die Provibr verwendet, sodass die Anmeldedaten im Agenten-Tresor auf die Client- und Site-Aufrufe begrenzt werden können und auf nichts sonst.

Das Zertifikat

ISPConfig lauscht auf Port 8080 über TLS, und eine frische Installation liefert ein selbstsigniertes Zertifikat aus. Pinnen Sie dessen Fingerabdruck, damit der Agent sicher sein kann, dass er Ihr Panel erreicht. Lesen Sie ihn mit einem Shell-Befehl von jeder Maschine aus, die das Panel erreicht:

shell
openssl s_client -connect <host>:8080 </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 Panel-Hostnamen, zum Beispiel mit Let's Encrypt, bestätigt sich seine Kette und Sie können den Fingerabdruck leer lassen. Das ist dort die bessere Wahl, denn ein solches Zertifikat wird regelmäßig erneuert, und ein festgelegtes müsste jedes Mal ausgetauscht werden.

Pakete

Ein ISPConfig-Paket ist eine Client-Vorlage, also dasselbe, worauf sich ein Provibr-Plan bezieht. Sie legt die Grenzen fest, die ein Client bekommt: wie viele Websites, wie viel Speicherplatz und Datenvolumen, welche Dienste.

Sie wählen ein Paket im Bestellformular über seinen Namen und ändern es später ohne Ausfallzeit. Ein Wechsel verschiebt die Grenzen des Clients auf einmal.

Die Remote-API kann keine Client-Vorlage anlegen, deshalb bauen Sie die Pakete selbst im ISPConfig-Panel. Provibr verweist nur über den Namen auf sie; ein Name, den es nicht kennt, wird abgewiesen, bevor irgendetwas angelegt wird.

Der Lebenszyklus eines Kontos

Ein Konto anzulegen sind zwei Schritte hinter einem Befehl: ein Client und eine Website darunter. Von da an verhält sich das Konto wie jedes andere Hosting-Konto:

  • Anlegen: ein Client mit dem gewählten Paket und eine Website mit ihrer Domain und Quote.
  • Stilllegen und reaktivieren: die Website geht offline und kommt zurück, umkehrbar.
  • Paket wechseln: eine andere Client-Vorlage zuweisen.
  • Löschen: der Client und seine Website, zusammen aufgeräumt.

Stilllegen

Stilllegen kippt das Aktiv-Flag der Website. Die Website geht offline; der Client-Login bleibt. Provibr liest dasselbe Flag, das es schreibt, sodass das Panel und das, was Sie sehen, nie auseinanderlaufen.

Das Datenbank-Flag kippt sofort, aber die Webserver-Konfiguration wird vom Minuten-Job des Panels neu geschrieben. Was Provibr anzeigt, ist das Aktiv-Flag, und das ist sofort stimmig.

Verbrauch

ISPConfig meldet den Verbrauch: Speicherplatz je Website gegen ihre Quote und Datenvolumen für den laufenden Monat. Beides erscheint in den Grafiken, so wie bei einer virtuellen Maschine.

Der Speicherverbrauch steht erst, sobald der Monitor-Job des Panels gelaufen ist, auf einer frischen Website gibt es also noch keinen Wert, und das ist nicht dasselbe wie null. Das Datenvolumen stammt aus einem Aufruf für alle Sites; der Speicherplatz aus einem Aufruf je Client.

Importieren

Konten, die Sie außerhalb von Provibr in ISPConfig angelegt haben, lassen sich importieren: Die Integration listet die Websites auf, die das Panel kennt, und Sie wählen aus, welche Sie übernehmen. Konten, die Sie nicht über Provibr angelegt haben, bleiben unangetastet, bis Sie es tun.