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.
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:
openssl s_client -connect <host>:8080 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Zet 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 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.
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.
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.