Ga naar de inhoud
agovena.
agovena.
Aan de slag
Community

Providerhandleidingen

DirectAdmin: instellen en beheren

Maak DirectAdmin-gebruikersaccounts aan en schort ze op, hervat, beëindig of wijzig ze, met statussync en een alleen-lezen klantpaneel.

Op deze pagina

Status en werkwijze

De DirectAdmin-extension levert DirectAdmin-gebruikersaccounts onder een reseller- of admin-account via de gedocumenteerde legacy API van DirectAdmin. De extension ondersteunt aanmaken, opschorten, hervatten, beëindigen, packagewijzigingen met controle, statussynchronisatie, reconciliatie van onderbroken aanmaak en een alleen-lezen klantpaneel.

Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de legacy API-documentatie van DirectAdmin en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen DirectAdmin-account blijft de verantwoordelijkheid van de beheerder: maak, schort op, hervat, wijzig en beëindig één wegwerpgebruiker op je eigen DirectAdmin-server voordat je het product verkoopt. Bewerkingen onder Niet ondersteund worden niet aangeboden.

Vereisten

  • Agovena Core ^0.0.1.
  • De Provisioning Module, geactiveerd vóór deze extension.
  • Een DirectAdmin-server die via HTTPS bereikbaar is en een reseller- of admin-account dat de aangemaakte gebruikers bezit.
  • Een eigen DirectAdmin Login Key voor dat account, beperkt tot de opdrachten hieronder en tot het IP-adres van de Agovena-server.
  • Een vrij of gedeeld IP-adres voor nieuwe gebruikers en bestaande DirectAdmin-gebruikerspackages.

Het pakket instellen

  1. Activeer de Provisioning Module en installeer en activeer daarna DirectAdmin in Admin > Extensies.
  2. Maak de Login Key aan zoals hierboven beschreven.
  3. Sla api_url op als https://host:2222 zonder pad of inloggegevens, samen met api_username, de Login Key in api_token en het ip voor nieuwe gebruikers. De Login Key wordt versleuteld opgeslagen en nooit opnieuw getoond.
  4. Laat verify_tls aan. Buiten lokale ontwikkeling moet die aan blijven.
  5. Voer Test connection uit. Die toont de gebruikerspackages van het API-account (alleen-lezen).
  6. Stel op elk provisionable product een bestaand DirectAdmin-gebruikerspackage en het domein in.

Ondersteunde bewerkingen

Bewerking DirectAdmin-opdracht
Aanmaken POST /CMD_API_ACCOUNT_USER met action=create, username, email, passwd, passwd2, domain, package, ip en notify=yes
Opschorten POST /CMD_API_SELECT_USERS met dosuspend=yes
Hervatten POST /CMD_API_SELECT_USERS met dounsuspend=yes
Beëindigen POST /CMD_API_SELECT_USERS met confirmed=Confirm en delete=yes
Plan wijzigen GET /CMD_API_PACKAGES_USER, daarna POST /CMD_API_SELECT_USERS met dopackage=yes, gecontroleerd met CMD_API_SHOW_USER_CONFIG
Plannen tonen en health GET /CMD_API_PACKAGES_USER
Statussync GET /CMD_API_SHOW_USER_CONFIG (suspended=yes of no)
Reconciliatie lezen GET /CMD_API_SHOW_USERS, daarna CMD_API_SHOW_USER_CONFIG

Authenticatie gebruikt HTTP Basic met de Login Key. Antwoorden worden gelezen in het gedocumenteerde url-encoded formaat. Het klantpaneel toont de status, de gewone DirectAdmin-login-URL, de gebruikersnaam en het domein van een actief of opgeschort geclaimd account, zonder single sign-on of inloggegevens.

Niet ondersteund

  • Poweracties, single sign-on voor klanten en capaciteitscontroles. Capaciteit in de checkout blijft uit, zoals bij elke provider zonder geverifieerde capaciteits-API.
  • Een eigen domein per order. Het domein komt uit de productinstelling, dus één product maakt één account per domein en server.
  • Bestaande DirectAdmin-gebruikers overnemen.

Foutafhandeling en eigendom

  • Eigendom wordt alleen bewezen door een rij in directadmin_accounts, ingevoegd met status creating vóór de aanmaakcall. De dienst, de gebruikersnaam per server en het domein per server zijn uniek, dus twee diensten kunnen nooit dezelfde gebruikersnaam of hetzelfde domein op één server claimen.
  • Elke levenscyclusactie wordt zonder remote call geweigerd als de huidige serverinstellingen naar een ander endpoint wijzen.
  • De gebruikersnaam is willekeurig, acht kleine letters of cijfers die met een letter beginnen, eenmalig gegenereerd en in de claim opgeslagen, zodat een nieuwe poging dezelfde naam gebruikt. Productinstellingen kunnen die naam niet kiezen.
  • De aanmaakcall loopt buiten elke databasetransactie onder een lock per dienst, en de uitkomst wordt als compare-and-swap op revision vastgelegd.
  • error=1 maakt de claim failed. Timeouts, niet-200-antwoorden en onleesbare bodies maken de claim unknown. Een nieuwe poging leest eerst de opgeslagen gebruikersnaam: afwezig betekent opnieuw aanmaken met dezelfde naam, aanwezig en passend betekent actief, al het andere blijft unknown en wordt geweigerd. Een failed claim neemt nooit een bestaande gebruiker over.
  • Beëindigen verwijdert alleen gebruikers van een active of suspended claim en bewaart de rij als terminated.
  • Het gegenereerde wachtwoord van 24 tekens gaat één keer naar DirectAdmin, dat de inloggegevens naar de klant mailt. Het wordt nooit opgeslagen, gelogd of teruggegeven. De Login Key gaat alleen mee in de Authorization-header. Redirects worden niet gevolgd en calls worden geweigerd in de demo-omgeving.

Configuratiecontract

Veld Type Verplicht Geheim Standaard
api_url string Ja Nee Leeg
api_username string Ja Nee Leeg
api_token string Ja Ja Leeg
ip string Ja Nee Leeg
verify_tls boolean Nee Nee true
timeout string Nee Nee "20"

api_token bevat de DirectAdmin Login Key. Reconciliatie gebruikt de gebruikerslijst van het API-account, en een admin-API-gebruiker ziet alleen de gebruikers die hij zelf heeft aangemaakt. Bewaar geheime waarden alleen in de beschermde extension-instellingen, nooit in productbeschrijvingen, URL's, screenshots of gedeelde voorbeelden.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie