Documentatie

CyberPanel

CyberPanel is een opensource-controlepaneel voor webhosting. Provibr praat met de API ervan met de login van je hoofdbeheerder en beheert de websites die erop staan: aanmaken, opschorten en hervatten, naar een ander pakket verplaatsen en verwijderen.

API-toegang aanzetten

Op een verse CyberPanel staat de API uit, en dat geldt ook voor je hoofdbeheerder. Je zet hem aan in het paneel onder Users, API Access, voor de gebruiker admin. Meer is er niet nodig: Provibr meldt zich aan met de login die je al hebt.

Laat je hem uit staan, dan komt elke aanroep terug als API Access Disabled, wat je ook invulde. CyberPanel controleert die schakelaar voordat hij het wachtwoord controleert, dus een juist wachtwoord geeft precies hetzelfde antwoord als een fout. Alles wijst naar je inloggegevens terwijl het probleem een vinkje verderop zit.

De hoofdbeheerder moet admin heten

Een deel van de CyberPanel-API weigert elke andere naam dan admin, en dat is juist het deel dat de websites op het paneel opsomt en meldt hoe ver een nieuwe is. Provibr heeft ze allebei nodig, dus het account dat je hieronder invult is dat van admin.

Dit is geen instelling maar een voorwaarde, en hij komt van CyberPanel en niet van ons: een hernoemde beheerder is voor deze koppeling niet te gebruiken. De verbindingstest zegt dat, zodat je het weet voordat je eerste bestelling het merkt.

Wat Provibr vraagt

Vier velden. De agent bewaart ze in zijn eigen kluis op je host; Provibr kan ze niet teruglezen.

Het adres van het paneel met poort, bijvoorbeeld https://panel.example.com:8090. Laat je de poort weg, dan vult Provibr 8090 aan. Gewoon http wordt geweigerd: die poort spreekt alleen TLS.
De naam van de hoofdbeheerder, en dat is admin.
Het wachtwoord van die beheerder.
De SHA-256-fingerprint van het certificaat, zolang het paneel het zelfondertekende gebruikt.

CyberPanel heeft geen API-token dat deze opdrachten dekt: binnen zijn eigen API staat de tokenroute per endpoint aan of uit, en juist de vier die een website aanmaken, opschorten, van pakket wisselen en verwijderen vragen om het wachtwoord. Hier staat dus het volledige wachtwoord van je hoofdbeheerder, dezelfde situatie als bij Webmin.

Het certificaat

Elke verse CyberPanel toont hetzelfde zelfondertekende certificaat, uitgegeven op www.example.com en ondertekend door CyberPanel zelf. Een browser noemt het daarom onjuist in plaats van zelfondertekend, en de keten valideert nooit. Vul de fingerprint in en de agent vertrouwt dat ene certificaat in plaats van de controle uit te zetten. Je leest hem van elke machine die het paneel kan bereiken:

shell

openssl s_client -connect <host>:8090 </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.

Zet je zelf een certificaat op de hostnaam van het paneel, dan valideert de keten vanzelf en laat je dit veld leeg. Dat is daar de betere keuze, want zo een certificaat wordt af en toe vervangen en een vastgezette zou hier elke keer opnieuw ingevuld moeten worden.

Pakketten

CyberPanel beschrijft in een pakket wat een website mag gebruiken. Provibr leest die lijst en verwijst naar een pakket bij naam; de pakketten zelf maak en wijzig je in CyberPanel, niet hier.

Een webhostingplan in Provibr wijst naar een pakket op een integratie. Dat is wat je klant bestelt, en de prijs bepaal je zelf.

Een website naar een ander pakket verplaatsen verandert de administratie en verder niets. Van binnenuit gemeten met een pakket dat andere limieten droeg: de schijfquota bleven zoals ze waren en de webserverconfiguratie hield de oude waarden. Het paneel toont de nieuwe naam, dus lees die naam als administratie en niet als een limiet die meebewoog.

Wat een bestelling meestuurt

Een website op CyberPanel wordt aangewezen met zijn domein, en dat is ook in Provibr zijn identiteit. Een bestelling draagt vier dingen:

Het domein. Het moet vrij zijn op het paneel, en alles wat Provibr daarna met deze server doet wijst ernaar.
Een contactadres voor de website.
Het pakket waarop de website komt.
Een wachtwoord voor de paneellogin die CyberPanel onder de website aanmaakt.

Aanmaken duurt op CyberPanel ongeveer vijftig seconden, waarvan er zo een achtentwintig opgaan aan een SSL-poging die het paneel hoe dan ook doet. Provibr wacht de echte uitkomst af in plaats van het eerste antwoord te geloven: dat komt na een seconde of drie en zegt niets, zelfs niet of het domein nog vrij was.

Opschorten en hervatten

Allebei werken ze meteen: het paneel meldt de nieuwe stand en zijn eigen lijst toont die direct. Provibr schort een website op als je erom vraagt, en als je capaciteit overschreden wordt.

Opschorten is op CyberPanel een webservertruc en geen accountblokkade. De website wordt onbereikbaar, maar FTP, mail en databases blijven werken en de unix-gebruiker wordt niet geblokkeerd. Dat verschilt van DirectAdmin, en het telt zodra je opschorten als handhavingsmiddel gebruikt.

Schijfruimte en bandbreedte

CyberPanel is het enige controlepaneel in Provibr zonder verbruiksgrafieken, en dat laat de koppeling niet weg: het paneel meet het niet. Bandbreedteverbruik wordt berekend en daarna weggegooid, en schijfverbruik komt uit een cache die op een nieuwe website leeg bleef, dus de nul die eruit komt is niet te onderscheiden van werkelijk niets.

Een grafiek die voor altijd op nul staat ziet eruit als een meting, en daarom is er geen. Wat een website mag gebruiken staat in zijn pakket, en wat CyberPanel wel weet blijft in het paneel zelf staan.

Websites die er al staan

Websites die buiten Provibr om zijn gemaakt kun je op de integratiepagina importeren: de agent somt op wat er op het paneel staat, en jij kiest welke daarvan een server in Provibr worden.

Een geïmporteerde website telt vanaf dat moment mee voor je capaciteit, net als elke andere webserver.

Wat dit niet doet

Provibr beheert websites, niet het paneel: het installeert CyberPanel niet, werkt het niet bij en wijzigt geen serverinstellingen. Er is geen console, en DNS, mailboxen en databases blijven onaangeroerd. CyberPanel kan dat allemaal zelf, en Provibr stuurt het niet aan.

VorigeHestiaCP VolgendeCloudPanel