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

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

  1. Activeer de Provisioning Module en installeer en activeer daarna Enhance in Admin > Extensies.
  2. Open in Enhance Settings > Access Tokens, maak een token met de rol Super Admin en noteer de token en het Org ID.
  3. Sla api_url op als scheme://host[:port] zonder pad, bijvoorbeeld https://cp.example.com, de access token in api_token en het Org ID in account_id (Reseller organization id). De token wordt versleuteld opgeslagen.
  4. Laat verify_tls aan.
  5. Voer Test connection uit. Die leest de resellerorganisatie (alleen-lezen getOrg).
  6. 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, 404 en 409, geweigerde inloggegevens en fouten vóór verzending bewijzen dat er niets is aangemaakt. De claim wordt failed en een nieuwe poging maakt de ontbrekende stappen aan. Timeouts, andere fouten en onverwachte bodies laten de claim op unknown staan 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.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie