Naar de inhoud

Documentatie

DirectAdmin

DirectAdmin is de integratie voor controlepanelen. Hij maakt webhostingaccounts aan en beheert ze op een server die al draait. Er is geen besturingssysteem te installeren en geen machine op te starten. Een account wordt aangemaakt, krijgt een pakket, en wordt later gesuspendeerd, naar een ander pakket gezet of verwijderd.

Wat je nodig hebt

Gebruik niet het beheerderswachtwoord. DirectAdmin kent login keys, en een login key heeft precies de goede vorm hiervoor: je kunt hem beperken tot een lijst commando's, tot een lijst adressen, tot een vervaldatum en tot een aantal keren gebruik.

  • Host: het adres van het paneel. Poort 2222 wordt voor je ingevuld als je hem weglaat.
  • Gebruikersnaam: het account waar de login key bij hoort.
  • Login key: aangemaakt onder je eigen account, geen wachtwoord.
  • TLS-fingerprint: optioneel, en alleen zinvol op een HTTPS-host.
shell
openssl s_client -connect <host>:2222 </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.
Geef de key de commando's die de integratie nodig heeft en niet meer. Vertelt het paneel ons welke commando's de key mag draaien, dan weigert de agent een aanroep die de key niet mag maken vóór hij verstuurd wordt, en noemt hij het commando. Niet weten is niet hetzelfde als niet mogen: een paneel dat niets meldt blokkeert niets.

Versleuteld of niet

DirectAdmin luistert standaard op poort 2222 zonder TLS, en heel wat installaties draaien zo. Provibr accepteert dat, want weigeren zou de integratie onmogelijk maken op een verder volstrekt normale server. Wat het in plaats daarvan doet is het je vertellen.

Op een onversleutelde verbinding meldt de integratie zich als actief met een waarschuwing: de login key en alles wat deze integratie doet reizen onversleuteld. Alleen je agent kan dit weten, want het platform ziet de host niet meer nadat je hem opgeslagen hebt.

Een TLS-fingerprint samen met een onversleutelde host wordt geweigerd in plaats van genegeerd. Een certificaat pinnen op een verbinding die er geen heeft, is een belofte die niemand kan waarmaken.

Instellingen

Die zijn er niet. Een DirectAdmin-server bepaalt zelf waar een account komt te staan en welk adres het krijgt, dus er blijft niets voor jou te kiezen over. Het tabblad Instellingen bestaat wel, want daar verstuur je ook de inloggegevens opnieuw.

Hostingpakketten

Een DirectAdmin-pakket is de eigen beschrijving van het paneel van een account: schijfquotum, maandelijks verkeer, hoeveel domeinen, 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 pakketten uitlezen met wat erin zit, zodat je ziet wat je kiest in plaats van een naam uit je hoofd in te typen.

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

Hoe een account eruitziet in Provibr

Een hostingaccount is een gewone serverregel van het type webserver. Zijn identifier is de DirectAdmin-gebruikersnaam, en zijn domein, pakket, quotum en verkeer komen bij elke poll mee.

  • Een account aanmaken vraagt om een gebruikersnaam, één domein, een e-mailadres, een pakket en een wachtwoord.
  • Gebruikersnamen volgen de eigen regel van DirectAdmin: beginnen met een letter, daarna letters en cijfers, drie tot zestien tekens. Geen koppeltekens.
  • Het wachtwoord wordt nergens vastgelegd. Alleen het feit dat je er een opgaf; de waarde reist apart.
  • Daarna kun je suspenden, de suspensie opheffen, van pakket wisselen en verwijderen. Er is geen console, want een hostingaccount heeft er geen.
DirectAdmin kiest geen adres voor je. Heeft je server er precies één, dan wordt die gebruikt; heeft hij er meerdere, dan wordt de eerste gebruikt, wat ook is wat de DirectAdmin-interface zelf voorstelt. Met helemaal geen adres wordt het aanmaken geweigerd in plaats van half uitgevoerd.

Bestaande accounts overnemen

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 worden getoond maar kunnen niet nog een keer geselecteerd worden, zodat je het hele beeld ziet en niet een gefilterd beeld.

Geïmporteerde accounts tellen precies zo mee voor je capaciteit als accounts 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 account krijgt een verbruiksgrafiek zonder dat er iets extra's aangezet hoeft te worden. Maandelijks verkeer is een eigenschap van het account en geen snelheid, dus het staat als getal bij het account en niet als lijn in de grafiek.