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.

Primair partneraccount

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 VEREIST.

  • 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

  1. Meld u aan bij Partnercentrum met een globale beheerdersaccount en selecteer vervolgens Instellingen (tandwielpictogram).

    Notitie

    Voor het maken van een sandbox moet de globale beheerder van de partner zijn aangemeld bij partnercentrum met hun onmicrosoft.com domeinalias (bijvoorbeeld alias@domain.onmicrosoft.com). Het maken van de sandbox mislukt als de gebruiker is aangemeld met het aangepaste domein.

  2. Selecteer Accountinstellingenen vervolgens Integratiesandbox.

    Notitie

    Als u geen optie voor integratie-sandbox ziet, hebt u mogelijk geen globale beheerdersaccount. Het is ook mogelijk dat u al een integratie-sandbox-account gebruikt dat eerder is ingesteld.

  3. Uw reseller-sandbox maken:

    1. Maak een nieuwe Microsoft Entra-tenant voor gebruik als sandbox-tenant door een ondersteuningsticket te openen.
    2. Geef alle vereiste informatie op de pagina Integratie-sandbox en selecteer vervolgens Tenant koppelen onderaan de pagina.
    3. Meld u aan met de globale beheerdersreferenties van de nieuwe tenant die u in stap a hebt gemaakt.

    Nadat u zich hebt aangemeld, wordt er een Reseller Sandbox-account gemaakt. Dit account wordt niet gecontroleerd. Het account wordt geactiveerd zodra de accountinschrijving is voltooid. Noteer het sandbox-domein ter referentie.

  4. Meld u opnieuw aan met uw nieuwe sandbox-beheerdersaccount voor integratie. Gebruik de indeling username@domain voor uw referenties, samen met het wachtwoord dat u hebt opgegeven.

  5. Kies Account- instellen op de sandboxpagina van Integration om het instellen van het sandbox-account te voltooien.

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 integratiesandbox 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