Naar de inhoud

Documentatie

ISPConfig

Provibr beheert ISPConfig-hostingaccounts via de remote API van het paneel. De agent belt uitgaand naar je ISPConfig-installatie, dus er zijn geen inkomende poorten en geen VPN. Deze pagina beschrijft wat er anders is aan ISPConfig en wat de koppeling doet.

Eén account is één website

ISPConfig scheidt de client (de klant, met een login en een set limieten) van het web_domain (de website). Eén Provibr-hostingaccount is één website, aangewezen met zijn domein. Om een website aan te maken heb je een eigenaar nodig, dus Provibr maakt een verse client en een website daaronder, en verwijdert beide weer als je het account verwijdert. De agent leidt de client-login af uit het domein, zodat hij de eigenaar altijd terugvindt.

Wat de agent nodig heeft

Vier velden, eenmalig ingevuld als je de koppeling verbindt:

  • Het paneeladres: de volledige https-URL, inclusief de poort (standaard 8080).
  • Een remote user: aangemaakt onder System → Remote Users, beperkt tot de client- en site-functies.
  • Het wachtwoord van die remote user.
  • De TLS-fingerprint van het paneel: aanbevolen, omdat een verse installatie zelfondertekend is.
De remote user is een apart account, niet je paneelbeheerder. ISPConfig laat je hem tot precies de functies beperken die Provibr gebruikt, zodat de inloggegevens in de agentkluis begrensd kunnen worden tot de client- en site-aanroepen en verder niets.

Het certificaat

ISPConfig luistert op poort 8080 over TLS, en een verse installatie levert een zelfondertekend certificaat. Pin de fingerprint zodat de agent zeker weet dat hij bij jouw paneel uitkomt. Lees hem met een shell-opdracht van elke machine die het paneel kan bereiken:

shell
openssl s_client -connect <host>:8080 </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 paneelhostnaam, bijvoorbeeld met Let's Encrypt, dan valideert de keten en kun je de fingerprint leeg laten. Dat is daar de betere keuze, want zo’n certificaat wordt regelmatig vernieuwd en een vastgezette zou elke keer vervangen moeten worden.

Pakketten

Een ISPConfig-pakket is een clientsjabloon, hetzelfde waar een Provibr-plan naar verwijst. Het legt de limieten vast die een client krijgt: hoeveel websites, hoeveel schijf en verkeer, welke diensten.

Je kiest een pakket bij naam in het bestelformulier, en wijzigt het later zonder downtime. Wisselen verschuift de limieten van de client in één keer.

De remote API kan geen clientsjabloon aanmaken, dus de pakketten bouw je zelf in het ISPConfig-paneel. Provibr verwijst er alleen bij naam naar; een naam die het niet kent, wordt geweigerd voordat er iets wordt aangemaakt.

De levenscyclus van een account

Een account aanmaken zijn twee stappen achter één opdracht: een client en een website daaronder. Vanaf dan gedraagt het account zich als elk ander hostingaccount:

  • Aanmaken: een client met het gekozen pakket, en een website met zijn domein en quota.
  • Opschorten en hervatten: de website gaat offline en komt terug, omkeerbaar.
  • Van pakket wisselen: een andere clientsjabloon toewijzen.
  • Verwijderen: de client en zijn website, samen opgeruimd.

Opschorten

Opschorten kantelt de actief-vlag van de website. De site gaat offline; de client-login blijft. Provibr leest dezelfde vlag die het schrijft, zodat het paneel en wat je ziet nooit uit elkaar lopen.

De databasevlag kantelt meteen, maar de webserverconfiguratie wordt herschreven door de minuuttaak van het paneel. Wat Provibr toont is de actief-vlag, en die klopt onmiddellijk.

Verbruik

ISPConfig meldt het verbruik: schijf per website tegen zijn quota, en verkeer voor de lopende maand. Beide verschijnen in de grafieken zoals bij een virtuele machine.

Het schijfverbruik staat er pas zodra de monitortaak van het paneel gelopen heeft, dus op een verse website is er nog geen waarde, en dat is niet hetzelfde als nul. Het verkeer komt uit één aanroep voor alle sites; de schijf uit één aanroep per client.

Importeren

Accounts die je buiten Provibr om in ISPConfig aanmaakte, kun je importeren: de koppeling somt de websites op die het paneel kent, en jij kiest welke je overneemt. Accounts die je niet via Provibr aanmaakte, blijven met rust tot je dat doet.