Providerhandleidingen
Enhance: instellen en beheren
Maak Enhance-klantorganisaties, abonnementen en websites, met opschorten, beëindigen, gecontroleerde planwijzigingen en statussync.
Op deze pagina
Status en werkwijze
De Enhance-extension levert hosting via de API van het Enhance-controlepaneel. Per Agovena-dienst maakt de extension een klantorganisatie onder je resellerorganisatie, een abonnement op het productplan en een website voor het productdomein. De extension ondersteunt opschorten, hervatten, beëindigen, gecontroleerde planwijzigingen, plannen tonen, statussynchronisatie en een klantpaneel.
Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de officiële Enhance orchd OpenAPI-specificatie (versie 12.25.14) en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Enhance-account blijft de verantwoordelijkheid van de beheerder: maak, schort op, hervat, wijzig en beëindig één wegwerpabonnement op je eigen controlepaneel 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 Enhance-controlepaneel dat via HTTPS bereikbaar is.
- Een access token met de rol Super Admin en het Org ID van de resellerorganisatie, beide te vinden onder Settings > Access Tokens in Enhance.
- Numerieke plan-ID's van de resellerorganisatie.
Het pakket instellen
- Activeer de Provisioning Module en installeer en activeer daarna Enhance in Admin > Extensies.
- Open in Enhance Settings > Access Tokens, maak een token met de rol Super Admin en noteer de token en het Org ID.
- Sla
api_urlop alsscheme://host[:port]zonder pad, bijvoorbeeldhttps://cp.example.com, de access token inapi_tokenen het Org ID inaccount_id(Reseller organization id). De token wordt versleuteld opgeslagen. - Laat
verify_tlsaan. - Voer Test connection uit. Die leest de resellerorganisatie (alleen-lezen
getOrg). - Zet op elk provisionable product Plan id op een numeriek plan-ID van de resellerorganisatie en Domain op het domein van de website.
Ondersteunde bewerkingen
Calls gaan naar https://host:port/api/... met een bearer token. Lijsten worden pagina voor pagina gelezen tot alle items zijn gezien.
| Bewerking | operationId |
|---|---|
| Health check | getOrg op de resellerorganisatie |
| Plannen tonen bij aanmaken en planwijziging | getPlans |
| Klantorganisatie aanmaken | createCustomer |
| Abonnement aanmaken | createCustomerSubscription |
| Website aanmaken | createWebsite |
| Onderbroken aanmaak van abonnement of website reconciliëren, controle bij beëindigen | getCustomerSubscriptions, getWebsites |
| Statussync, controle van planwijziging | getSubscription |
| Opschorten, hervatten, plan wijzigen | updateSubscription |
| Beëindigen | deleteSubscription, soft delete zonder force |
| Klantorganisatie verwijderen | deleteOrg, soft delete zonder force |
Statussync vereist dat het abonnement bij de vastgelegde klantorganisatie en jouw reseller hoort; suspendedBy betekent opgeschort. Een planwijziging wordt pas vastgelegd als getSubscription de nieuwe planId meldt.
Niet ondersteund
- Klantlogins, memberships en single sign-on. Klanten krijgen paneltoegang via de merchant in Enhance.
- Poweracties, capaciteitscontroles, keuze van een specifieke server en geforceerd verwijderen van data.
Foutafhandeling en eigendom
- Eigendom wordt alleen bewezen door een rij in
enhance_accounts, ingevoegd vóór elke aanmaakcall. Een domein dat op hetzelfde paneel al geclaimd is, wordt zonder providercall geweigerd. Elke aanmaakstap legt het teruggegeven ID vast onder de revisiecontrole, en elke levenscycluscall houdt een lock per dienst vast buiten databasetransacties. - Antwoorden
400,404en409, geweigerde inloggegevens en fouten vóór verzending bewijzen dat er niets is aangemaakt. De claim wordtfaileden een nieuwe poging maakt de ontbrekende stappen aan. Timeouts, andere fouten en onverwachte bodies laten de claim opunknownstaan en de dienst gaat naar handmatige controle. - Een onderbroken aanmaak van een klantorganisatie wordt nooit herhaald en vraagt handmatige controle. Een onderbroken aanmaak van abonnement of website wordt alleen herhaald als de door Agovena aangemaakte klantorganisatie er helemaal geen heeft. Niets wat op naam wordt gevonden, wordt overgenomen.
- Statussync, opschorten en planwijzigingen vereisen dat claimstatus en huidig endpoint overeenkomen. Een abonnement dat verwijderd is, bij een andere organisatie hoort of door een andere vendor is verkocht, wordt geweigerd voor handmatige controle.
- Beëindigen verwijdert alleen het vastgelegde abonnement, waarmee ook de websites soft deleted worden. De klantorganisatie wordt alleen verwijderd als al haar abonnementen en websites verwijderd zijn; anders blijft ze bestaan en wordt ze uit de claim losgemaakt.
- Er worden geen wachtwoorden gegenereerd of opgeslagen, en de access token verschijnt nooit in claimrijen, dienst-meta, exceptions of paneldata.
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
api_url |
string |
Ja | Nee | Leeg |
api_token |
string |
Ja | Ja | Leeg |
account_id |
string |
Ja | Nee | Leeg |
verify_tls |
boolean |
Nee | Nee | true |
timeout |
string |
Nee | Nee | "20" |
account_id is het Org ID van de resellerorganisatie, geen klantorganisatie. 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.