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
- Activeer de Provisioning Module en installeer en activeer daarna DirectAdmin in Admin > Extensies.
- Maak de Login Key aan zoals hierboven beschreven.
- Sla
api_urlop alshttps://host:2222zonder pad of inloggegevens, samen metapi_username, de Login Key inapi_tokenen hetipvoor nieuwe gebruikers. De Login Key wordt versleuteld opgeslagen en nooit opnieuw getoond. - Laat
verify_tlsaan. Buiten lokale ontwikkeling moet die aan blijven. - Voer Test connection uit. Die toont de gebruikerspackages van het API-account (alleen-lezen).
- 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 statuscreatingvóó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
revisionvastgelegd. error=1maakt de claimfailed. Timeouts, niet-200-antwoorden en onleesbare bodies maken de claimunknown. Een nieuwe poging leest eerst de opgeslagen gebruikersnaam: afwezig betekent opnieuw aanmaken met dezelfde naam, aanwezig en passend betekent actief, al het andere blijftunknownen wordt geweigerd. Eenfailedclaim neemt nooit een bestaande gebruiker over.- Beëindigen verwijdert alleen gebruikers van een
activeofsuspendedclaim en bewaart de rij alsterminated. - 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 dedemo-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.