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

Providerhandleidingen

Plesk: instellen en beheren

Maak Plesk-klanten en hostingabonnementen via de Plesk XML-API, met opschorten, beëindigen, gecontroleerde planwijzigingen en statussync.

Op deze pagina

Status en werkwijze

De Plesk-extension maakt per Agovena-dienst een Plesk-klant en een hostingabonnement via de Plesk Obsidian XML-API. De extension ondersteunt plancontrole, aanmaken met idempotente herhaling en reconciliatie, statussynchronisatie, opschorten, hervatten, beëindigen met opruimen van de klant, gecontroleerde planwijzigingen naar een bestaand service plan en een alleen-lezen klantpaneel met status, Plesk-gebruikersnaam, plan en domein.

Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de Plesk Obsidian XML-API-documentatie en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Plesk-account blijft de verantwoordelijkheid van de beheerder: maak, schort op, hervat, wijzig en beëindig één wegwerpabonnement op je eigen Plesk-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 Plesk Obsidian-server die via HTTPS bereikbaar is en een secret key van de beheerder.
  • Het IP-adres waarop nieuwe abonnementen draaien, en bestaande service plans van de beheerder.

Het pakket instellen

  1. Activeer de Provisioning Module en installeer en activeer daarna Plesk in Admin > Extensies.
  2. Sla api_url op als alleen scheme://host:port, bijvoorbeeld https://server.example.com:8443.
  3. Sla de secret key van de beheerder op in api_token en het hosting-IP in ip_address. De key wordt versleuteld opgeslagen.
  4. Laat verify_tls aan.
  5. Voer Test connection uit. Die verstuurt het alleen-lezen packet server get_protos.
  6. Zet op elk provisionable product Service plan op de exacte naam van een bestaand service plan van de beheerder en Domain op het domein van het abonnement.

Ondersteunde bewerkingen

Elke call is POST https://host:port/enterprise/control/agent.php met een XML-packet en de secret key in de KEY-header.

Bewerking Packet
Health check server/get_protos
Plannen tonen bij aanmaken en planwijziging service-plan/get
Klant aanmaken customer/add
Abonnement aanmaken webspace/add met plannaam en hosting-IP
Klant reconciliëren customer/get op login
Abonnement reconciliëren, statussync, plancontrole webspace/get op naam of ID
Opschorten, hervatten webspace/set met status 16 of 0
Abonnement beëindigen webspace/del
Controle voor opruimen klant webspace/get op owner-id
Klant verwijderen customer/del
Plan wijzigen webspace/switch-subscription met de plan-GUID

Statussync zet 0 om naar actief en 16, 32, 64 en 256 naar opgeschort, na controle van de owner-id. Een planwijziging wordt pas vastgelegd als het abonnement de nieuwe plan-GUID toont.

Niet ondersteund

  • Poweracties voor klanten, single sign-on en het doorgeven van wachtwoorden.
  • Plannen van resellers en add-on-plannen.
  • Capaciteitscontroles in de checkout en een abonnement naar een andere server verplaatsen.
  • Bestaande Plesk-klanten of -abonnementen overnemen.

Foutafhandeling en eigendom

  • Plesk antwoordt ook bij fouten met HTTP 200, dus elke result/status moet ok zijn. Een system-fout op packetniveau laat de call falen (1001 betekent geweigerde inloggegevens). Alleen foutcode 1013, object bestaat niet, geldt als afwezig. Elke andere structuur, een niet-200-status of een redirect faalt veilig.
  • Antwoorden worden zonder netwerktoegang geparsed. Document type declarations en entities worden geweigerd.
  • Eigendom wordt alleen bewezen door een rij in plesk_accounts, ingevoegd vóór de eigen aanmaakcalls van Agovena. Endpoint plus abonnement, domein en klantlogin zijn uniek. Klanten en abonnementen worden nooit overgenomen uit provider_mapping, external_ref, productinstellingen of een zoekactie.
  • Elke levenscycluscall vereist dat het endpoint van de claim gelijk is aan de huidige verbinding, en statuswijzigingen zijn een compare-and-swap op revision.
  • De klantlogin is agv, acht willekeurige kleine letters en het base36-dienst-ID. Die wordt vóór customer/add opgeslagen en is ook de FTP-login. Een geweigerde customer/add vervangt de opgeslagen login, omdat de oude van iemand anders kan zijn.
  • Een timeout, HTTP-fout of onjuist antwoord maakt de claim unknown. De nieuwe poging leest de opgeslagen login en het domein; code 1013 betekent afwezig en het object wordt aangemaakt, en een abonnement wordt alleen geaccepteerd als de owner-id de door Agovena aangemaakte klant is. Al het andere gaat naar handmatige controle.
  • Beëindigen verwijdert alleen het geclaimde abonnement en daarna de door Agovena aangemaakte klant, alleen als die geen ander abonnement heeft. Mislukt het opruimen, dan blijft het klant-ID bewaard zodat een nieuwe poging verdergaat. Een ontbrekend abonnement wordt nooit als beëindigd gemeld.
  • Klant- en FTP-wachtwoorden worden per verzoek gegenereerd, één keer verstuurd en nooit opgeslagen, gelogd of teruggegeven. De klant stelt een nieuw wachtwoord in via de wachtwoordreset van Plesk.

Configuratiecontract

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

api_token bevat de secret key van de Plesk-beheerder en ip_address het hosting-IP voor nieuwe abonnementen. 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.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie