Naar de inhoud

Documentatie

Plesk

Plesk is de tweede integratie voor controlepanelen. Hij maakt abonnementen aan en beheert ze op een server die al draait. Er is geen besturingssysteem te installeren en geen machine op te starten. Een abonnement wordt aangemaakt, krijgt een serviceplan, en wordt later gesuspendeerd, naar een ander plan gezet of verwijderd.

Wat je nodig hebt

Gebruik niet het beheerderswachtwoord. Plesk kent API-sleutels, en een sleutel heeft precies de goede vorm hiervoor: hij hoort bij het account dat hem aanmaakte, je kunt hem beperken tot een reeks adressen, en je kunt hem intrekken zonder iemands wachtwoord te veranderen.

  • Host: het adres van het paneel. Poort 8443 wordt voor je ingevuld als je hem weglaat, en het adres moet https zijn.
  • API-sleutel: aangemaakt onder Tools & Settings, met een beheerdersaccount.
  • TLS-fingerprint: optioneel, en nodig zodra het paneel nog zijn self-signed certificaat heeft.
shell
openssl s_client -connect <host>:8443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Commando's en terminaluitvoer zijn overal Engels, in het paneel en op deze pagina's. Één tekst, één waarheid: wat je hier leest is letterlijk wat je host teruggeeft.
Een sleutel die met een reseller- of klantaccount is aangemaakt ziet alleen de abonnementen van dat account zelf. De agent merkt dat bij de eerste probe en weigert de inloggegevens in plaats van stilletjes een half paneel te beheren.

Eén sleutel, twee API's

Plesk heeft een REST-API en een oudere XML/RPC-API, en geen van beide is op zichzelf compleet: REST kent geen abonnementen en geen serviceplannen, XML kent alles maar antwoordt in XML. Provibr gebruikt ze allebei: aanmaken en verwijderen over REST, lezen, suspenden en van plan wisselen over XML. Dezelfde sleutel opent ze allebei, dus je vult één waarde in.

De twee API's falen verschillend: REST beantwoordt een onbruikbare sleutel met een lege HTTP 401, terwijl XML met HTTP 200 antwoordt en de fout erin verpakt. De verbindingstest probeert daarom allebei en meldt ze apart. Een groen REST-resultaat naast een zwijgende XML-API betekent dat de accountlijst, de planlijst en het wisselen van plan alle drie leeg blijven.

Altijd versleuteld

Anders dan bij DirectAdmin is er hier geen onversleutelde optie: Plesk stuurt http op zowel 8880 als 8443 door naar https, dus Provibr weigert een http-adres in plaats van te doen alsof het zou kunnen werken.

Wat een verse installatie wél heeft is een self-signed certificaat. Vul de fingerprint ervan in en de agent vertrouwt dat ene certificaat in plaats van de controle uit te zetten; vervang je dat certificaat later, dan moet de fingerprint mee.

Serviceplannen

Een Plesk-serviceplan is de eigen beschrijving van het paneel van een abonnement: schijfquotum, maandelijks verkeer, hoeveel domeinen en mailboxen, welke diensten aan staan. Het is geen Provibr-plan en geen besturingssysteem. Het is een naam waar we naar verwijzen, en de inhoud ervan kan op je server veranderen zonder dat wij het merken.

De integratiepagina kan de lijst met serviceplannen uit het paneel uitlezen, zodat je ziet wat je kiest in plaats van een naam uit je hoofd in te typen.

Een webplan legt één serviceplan op één integratie vast en geeft het een naam van jezelf. Bestellen met een plan is beter dan een los serviceplan kiezen, en de losse keuze blijft beschikbaar voor de gevallen die een plan niet dekt.

Hoe een abonnement eruitziet in Provibr

Een abonnement is een gewone serverregel van het type webserver. Zijn identifier is de naam van het abonnement, wat in Plesk het hoofddomein is, en zijn serviceplan, quotum en verkeer komen bij elke poll mee.

  • Een abonnement aanmaken vraagt om een hoofddomein, een e-mailadres, een serviceplan en een wachtwoord. Er is geen aparte accountnaam om te bedenken.
  • Het domein is de identiteit: het is wat het paneel toont, waar de API van het paneel op filtert, en wat Provibr opslaat. Het kan achteraf niet meer gewijzigd worden.
  • Het wachtwoord wordt nergens vastgelegd. Alleen het feit dat je er een opgaf; de waarde reist apart en wordt zowel het klantwachtwoord als het FTP-wachtwoord.
  • Daarna kun je suspenden, de suspensie opheffen, van serviceplan wisselen en verwijderen. Er is geen console, want een hostingaccount heeft er geen.
Plesk kiest het adres zelf uit zijn eigen pool, dus er valt voor jou niets te kiezen. Provibr reserveert ook geen adres voor een abonnement, en daarom blijft het adresveld van een hostingaccount leeg tot het paneel er een meldt.

Bestaande abonnementen overnemen

Het tabblad Importeren toont de abonnementen op het paneel en laat je de abonnementen die je wilt in Provibr opnemen. Abonnementen die al bekend zijn worden getoond maar kunnen niet nog een keer geselecteerd worden, zodat je het hele beeld ziet en niet een gefilterd beeld.

Geïmporteerde abonnementen tellen precies zo mee voor je capaciteit als abonnementen die je bestelde. Importeer je er meer dan je ruimte hebt, dan opent er een overschrijding, met de gebruikelijke respijt.

Verbruik

Quotum en verkeer rijden mee met de gewone poll, dus een abonnement krijgt een verbruiksgrafiek zonder dat er iets extra's aangezet hoeft te worden. Maandelijks verkeer is een eigenschap van het abonnement en geen snelheid, dus het staat als getal bij het account en niet als lijn in de grafiek.