cPanel en WHM

Een WHM API-token, geen wachtwoord en geen cPanel-login. Je maakt hem in WHM zelf aan, en hij reist als gewone header mee met elke aanroep die de agent doet.

• Host: het adres van WHM, inclusief https. Laat je de poort weg, dan vult Provibr 2087 in.
• WHM-gebruiker: het account waar het token bij hoort, meestal root.
• API-token: aangemaakt onder Manage API Tokens in WHM, en één keer aan je getoond.
• TLS-fingerprint: optioneel, en op een cPanel-server laat je hem in de regel leeg. De sectie hieronder legt uit waarom.

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

Het token maak je in WHM, als de gebruiker waar hij bij gaat horen. Provibr ziet hem daarna nooit meer: hij wordt één keer naar je agent geduwd en in de vault van die agent verzegeld, en het platform bewaart alleen de veldnamen.

1. 01Log in op WHM als de gebruiker waar het token bij hoort, meestal root.
2. 02Open Development en daarna Manage API Tokens.
3. 03Maak een token aan en geef het een naam waaraan te zien is dat het van Provibr is, zodat je het later terugvindt als je het wilt intrekken.
4. 04Kopieer het token voordat je de pagina verlaat. WHM toont hem één keer en kan hem daarna niet meer laten zien; kwijt is een nieuwe maken.

Poort 2087 is de versleutelde, en een cPanel-server draagt doorgaans een certificaat van een publieke autoriteit dat het paneel zelf vernieuwt, ongeveer elke negentig dagen. In dat gewone geval blijft het fingerprint-veld leeg en controleert de agent het certificaat zoals een browser dat doet.

Vul hem alleen in als de server een certificaat toont waar geen publieke autoriteit voor instaat, en dat betekent in de praktijk een eigen interne certificaatautoriteit. Neem de fingerprint op de agenthost, zodat je precies vastlegt wat de agent te zien krijgt, en neem hem opnieuw zodra dat certificaat vervangen wordt.

Die zijn er niet. Een WHM bepaalt zelf op welke machine een account landt en welk adres het krijgt, dus er valt voor jou niets te kiezen. Het tabblad Instellingen blijft wel bestaan, want daar stuur je ook inloggegevens opnieuw op.

Een WHM-pakket is de eigen beschrijving van het paneel van een account: schijfquotum, maandelijkse bandbreedte, hoeveel subdomeinen en mailboxen, welke functielijst. 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 pakketten ophalen inclusief wat erin zit, zodat je kiest uit wat je server werkelijk heeft in plaats van een naam uit je hoofd te typen. Pakketten maak je in WHM; Provibr maakt ze niet aan.

Een webplan legt één pakket op één integratie vast en geeft het een eigen naam. Bestellen met een plan wint van een los pakket kiezen, en de losse keuze blijft bestaan voor de gevallen die een plan niet dekt.

Een cPanel-server dwingt schijfquota's alleen af als het bestandssysteem waar de accounts op staan quota-ondersteuning heeft. Zonder dat accepteert WHM het pakket, accepteert hij het getal, en dwingt hij niets af.

De verbindingstest meldt dit. Hij leest de accounts op de server en zegt of hun quota werkelijk afgedwongen worden, naast de WHM-versie en de aantallen. Op een server zonder accounts valt er niets te meten, en dat zegt hij dan ook in plaats van te gokken.

Het is ook de reden dat Provibr de schijfgrens uit het account leest en niet uit het pakket. Wat het account meldt is wat er geldt; het getal in het pakket is wat iemand bedoelde.

Quota aanzetten is werk op de server en niet in Provibr: het bestandssysteem moet met gebruikersquota gemount worden en de accounts moeten opnieuw doorgemeten. Wat dat kost hangt af van het bestandssysteem en van hoe de machine is opgezet, dus je hostingleverancier of de cPanel-documentatie is daar de plek voor.

Een hostingaccount is een gewone serverrij van het type webserver. Zijn identificatie is de cPanel-gebruikersnaam, en zijn hoofddomein, pakket, schijfverbruik en bandbreedte rijden met elke poll mee.

• Een account aanmaken vraagt een gebruikersnaam, een hoofddomein, een contactadres, een pakket en een wachtwoord.
• Gebruikersnamen volgen de eigen regel van WHM: beginnen met een letter, daarna letters en cijfers, ten hoogste zestien tekens. Geen koppeltekens en geen liggende streepjes.
• Het wachtwoord wordt nergens vastgelegd. Alleen dát je er een meegaf staat er; de waarde reist apart.
• Daarna kun je suspenderen, hervatten, van pakket wisselen en verwijderen. Er is geen console, want een hostingaccount heeft er geen.
• Geen enkel resultaat wordt op zijn eigen woord geloofd. WHM bevestigt een wijziging met een pagina procesuitvoer in plaats van met de nieuwe staat, dus elke wijziging eindigt met het account opnieuw uitlezen.

Het tabblad Importeren toont de accounts op het paneel en laat je de accounts die je wilt in Provibr opnemen. Accounts die al bekend zijn staan er wel bij maar zijn niet opnieuw te selecteren, zodat je het hele beeld ziet en niet een gefilterd beeld.

Schijfverbruik en bandbreedte rijden mee met de gewone poll, dus een account krijgt een verbruiksgrafiek zonder dat er iets extra's aangezet hoeft te worden. Bandbreedte is een maandtotaal dat de server zelf terugzet, dus het staat als getal bij het account en niet als lijn in de grafiek.

• De server zelf beheren bestaat niet. Provibr maakt, wijzigt en verwijdert accounts op een WHM die jij beheert; de diensten, DNS-zones, mailrouting en de instellingen van het paneel zelf blijven waar ze zijn.
• Er is geen console. Een hostingaccount is geen machine, dus er valt geen terminal aan te koppelen.
• Mailboxen, databases en DNS binnen een account zijn van cPanel. Provibr maakt het account aan en draagt het over; wat er daarna binnen gebeurt is tussen je klant en het paneel.
• Resellersaccounts zijn niet gemodelleerd. Provibr praat met WHM als één beheerder, en een token van een reseller ziet een kleinere wereld dan root. Dat geval is niet gemeten en wordt hier niet beschreven.