Providerhandleidingen
cPanel: instellen en beheren
Maak cPanel-hostingaccounts aan en schort ze op, hervat, beëindig of wijzig ze via WHM API 1, met statussync en een alleen-lezen klantpaneel.
Op deze pagina
Status en werkwijze
De cPanel-extension levert cPanel-hostingaccounts via WHM API 1. De extension ondersteunt aanmaken met idempotente herhaling en reconciliatie, statussynchronisatie, opschorten, hervatten, beëindigen, planwijzigingen naar een bestaand creatable package en een alleen-lezen klantpaneel met status, gebruikersnaam, package en domein.
Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de WHM API 1-specificatie en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen WHM-account blijft de verantwoordelijkheid van de beheerder: maak, schort op, hervat, wijzig en beëindig één wegwerpaccount op je eigen WHM-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 WHM-server die via HTTPS bereikbaar is, een WHM-gebruikersnaam (
rootof een reseller) en een WHM API-token van die gebruiker. - Minimaal één bestaand WHM-package dat de token mag toewijzen.
Het pakket instellen
- Activeer de Provisioning Module en installeer en activeer daarna CPanel in Admin > Extensies.
- Sla
api_urlop als alleenscheme://host:port, bijvoorbeeldhttps://server.example.com:2087. - Sla
api_usernameen de WHM API-token inapi_tokenop. De token wordt versleuteld opgeslagen. - Laat
verify_tlsaan. - Voer Test connection uit. Die doet de alleen-lezen call
version. - Kies op elk provisionable product deze provider en zet Package op een bestaand WHM-package dat de token mag toewijzen.
Ondersteunde bewerkingen
Elke call is GET https://host:port/json-api/<function>?api.version=1 met de header Authorization: whm. Een call slaagt alleen als metadata.command de functie herhaalt en metadata.result 1 is.
| Bewerking | WHM-functie | Parameters |
|---|---|---|
| Health check | version |
geen |
| Packagecontrole bij aanmaken en planwijziging | listpkgs |
want=creatable |
| Aanmaken | createacct |
username, plan, showpass=n |
| Onderbroken aanmaak reconciliëren | listaccts |
searchtype=user, searchmethod=exact, search |
| Statussync | accountsummary |
user |
| Opschorten | suspendacct |
user, reason |
| Hervatten | unsuspendacct |
user |
| Beëindigen | removeacct |
username |
| Plan wijzigen | changepackage |
user, pkg |
Statussync zet suspended 1 om naar opgeschort en 0 naar actief, en legt plan en domein vast. Er wordt geen klantwachtwoord verstuurd, opgeslagen of teruggegeven; WHM genereert er zelf een.
Niet ondersteund
- Poweracties voor klanten, single sign-on en het doorgeven van wachtwoorden.
- Een door de klant gekozen hoofddomein. WHM wijst een tijdelijk domein toe.
- Capaciteitscontroles in de checkout en een account naar een andere server verplaatsen.
Foutafhandeling en eigendom
- Eigendom wordt alleen bewezen door een rij in
cpanel_accountsdie Agovena vóór de eigencreateacct-call invoegt. Accounts worden nooit overgenomen uitprovider_mapping,external_ref, productinstellingen of een zoekactie, en een dienst met zo'n verwijzing maar zonder claimrij wordt zonder netwerkcall geweigerd. - Elke levenscycluscall vereist dat het endpoint van de claim gelijk is aan de huidige verbinding. Een omgezette server wordt zonder netwerkcall geweigerd. Statuswijzigingen gebeuren na de HTTP-call als compare-and-swap op
revision, dus een gelijktijdige wijziging wordt nooit overschreven. - De gebruikersnaam is
a, zeven willekeurige kleine letters en het base36-dienst-ID, maximaal 16 tekens. Die wordt vóórcreateacctopgeslagen, zodat een nieuwe poging dezelfde naam gebruikt. Een lock per dienst zet aanmaakverzoeken achter elkaar. metadata.result0of geweigerde inloggegevens maken de claimfailed. Een nieuwe poging controleert de oude gebruikersnaam metlistaccts: duidelijk afwezig betekent een nieuwe naam claimen en aanmaken, aanwezig houdt de claimfailedvoor handmatige controle.- Een timeout, HTTP-fout of onjuist antwoord maakt de claim
unknown. De nieuwe poging leest de opgeslagen gebruikersnaam en accepteert een bestaand account alleen als eigenaar, package en aanmaaktijd bij de claim passen. Al het andere gaat naar handmatige controle. - Beëindigen bewaart de claimrij als
terminated, zodat de gebruikersnaam geclaimd blijft. Tokens verschijnen nooit in exceptions, logs, dienst-meta of paneldata.
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
api_url |
string |
Ja | Nee | Leeg |
api_token |
string |
Ja | Ja | Leeg |
api_username |
string |
Ja | Nee | Leeg |
verify_tls |
boolean |
Nee | Nee | true |
timeout |
string |
Nee | Nee | "20" |
api_url moet scheme://host:port zonder pad zijn. Calls volgen nooit redirects, controleren TLS, pinnen DNS via de gedeelde provisioning-HTTP-client en worden geweigerd in de demo-omgeving. Productie weigert gewone HTTP en ongecontroleerde TLS. Bewaar geheime waarden alleen in de beschermde extension-instellingen, nooit in productbeschrijvingen, URL's, screenshots of gedeelde voorbeelden.