Delen via

API-toegang instellen in Partnercentrum

  • Artikel

van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

In dit artikel worden de accounts beschreven die u moet ontwikkelen op basis van de Partner Center SDK. In dit artikel wordt ook uitgelegd hoe u een integratiesandbox-account maakt en test in de integratiesandbox.

Notitie

Als u toegang wilt krijgen tot API's, moet uw tenant een CSP-tenant (Cloud Solution Provider) zijn en moet u een indirecte provider of een partner voor directe facturering zijn.

Inzicht in de accountdefinities

Partner Center ondersteunt twee soorten accounts om uw API-integratie te integreren en te testen.

Primaire partner account

In dit account maakt u echte orders voor echte klanten. Als u wijzigingen of transacties aanbrengt wanneer u bent aangemeld bij het primaire account, met behulp van de Partner Center SDK of de gebruikersinterface van het Partnerdashboard, worden deze beschouwd als officiële orders voor echte klanten. Ze worden weergegeven in uw factuur en uw bedrijf is verantwoordelijk voor het betalen ervan.

Sandbox-account voor integratie

Dit account is bedoeld voor het testen van uw code en de integratie ervan met de Partner Center-API's voordat u deze breed implementeert. Wijzigingen en transacties die u aanbrengt wanneer u bent aangemeld bij het sandbox-account voor integratie, worden weergegeven in uw factuur, maar u hoeft het factuurbedrag niet te betalen. De pdf van de factuur bevat een disclaimer: "NIET BETALEN. DIT IS EEN SANDBOX-FACTUUR EN ER IS GEEN ACTIE NODIG.

  • Het sandbox-integratieaccount en het primaire account handelen onafhankelijk. Ze delen geen beheerdersaccounts, gebruikersaccounts, klanten, orders, abonnementen of andere gegevens.
  • De integratie-sandbox ondersteunt transacties met een beperkt aantal klanten, orders, abonnementen, licenties, enzovoort.
  • De sandbox-accounts voor integratie zijn alleen bedoeld voor integratietests op basis van beleid.
  • Er bestaat standaard geen sandbox-account voor integratie. U moet er zelf een maken als u van plan bent om de Partner Center SDK te gebruiken.

Stel uw accounts in

In deze sectie wordt beschreven hoe u een primair partneraccount en een sandbox-account voor integratie instelt voor de Partner Center SDK.

Een integratie-sandbox maken

Als u een integratie-sandbox wilt maken, volgt u de stappen in Een CSP-integratieaccount (Cloud Solution Provider) maken.

API-toegang inschakelen

Nadat uw account is ingesteld, moet u API-toegang inschakelen voordat u de Partner Center SDK kunt gebruiken met de integratie-sandbox. U moet de toegang tot de API afzonderlijk inschakelen voor zowel uw primaire partneraccount als uw sandbox-account voor integratie.

  1. Meld u aan bij Partnercentrum met een globale beheerdersaccount en selecteer vervolgens Instellingen (tandwielpictogram).
  2. Selecteer accountinstellingenen app-beheer.
  3. Als u nog geen bestaande app hebt, voegt u een nieuwe web-app toe. Als u een bestaande web-app hebt, kiest u de knop Sleutel toevoegen.
  4. Kopieer de app-registratiegegevens, met name de Key als u een web-app maakt en deze op een veilige plaats opslaat.
  5. Meld u af bij partnerdashboard.
  6. Meld u opnieuw aan met uw sandbox-account voor integratie. Herhaal stap 2-5 om API-toegang in te schakelen in de integratie-sandbox.

Code schrijven en testen

U kunt code schrijven en code testen in de integratie-sandbox. U hebt de volgende informatie nodig om verificatie in partnercentrum in te stellen met een Microsoft Entra-id.

  • app-id/client-id: vermeld als de geregistreerde applicatie App ID in Instellingen (tandwielpictogram) >Accountinstellingen>App-beheer.
  • Sleutel: Als u een nieuwe webapp hebt gemaakt in de vorige sectie, gebruik die sleutel.
  • Domain: is voor de integratie-sandbox.

Geteste code uitvoeren

Als u uw oplossing wilt gebruiken met echte klantgegevens, moet u de referenties van uw integratie-sandbox wijzigen in de primaire-referenties van uw partneraccount.

Wanneer u klaar bent om uw geteste code in uw primaire partneraccount te gebruiken, hebt u een Microsoft Entra-beveiligingstoken nodig. Dit beveiligingstoken is gebaseerd op uw Partnercentrum app, sleutel en domein (in plaats van uw integratie sandbox app, sleutel en domein).

  1. Volg de stappen in Partnercentrum-authenticatie om een Microsoft Entra-beveiligingstoken op te halen met behulp van uw primaire Partnercentrum-referenties. (U hebt deze stappen eerder gevolgd om een Microsoft Entra-beveiligingstoken voor uw integratie-sandbox op te halen.)
  2. Vervang het integratiebeveiligingstoken in uw code door het nieuwe beveiligingstoken voor uw primaire partneraccount.

Verwante inhoud