API-toegang instellen in Partnercentrum

Artikel
11/28/2023

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 sandbox-account voor integratie maakt en test in de integratie-sandbox.

Notitie

Als u toegang wilt krijgen tot API's, moet uw tenant een CSP-tenant zijn en moet u een indirecte provider of een directe factuurpartner zijn.

Accountdefinities

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

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

Sandboxaccount 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 integratie sandbox-account, worden weergegeven in uw factuur, maar u hoeft het factuurbedrag niet te betalen. Factuur pdf heeft een disclaimer als "NIET BETALEN. DIT IS EEN SANDBOX-FACTUUR EN ER IS GEEN ACTIE VEREIST.

Het sandbox-account voor integratie en het primaire account werken onafhankelijk en delen geen beheerdersaccounts, gebruikersaccounts, klanten, orders, abonnementen of andere gegevens.

De integratie-sandbox ondersteunt transacties met een beperkt aantal klanten, orders, abonnementen, licenties, enzovoort.

Op basis van beleid zijn sandbox-accounts voor integratie alleen bedoeld voor integratietests.

Standaard is er geen sandboxaccount voor integratie. U moet er zelf een maken als u van plan bent om de Partner Center SDK te gebruiken.

Uw accounts instellen

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

Een integratie-sandbox maken

Meld u aan bij partnercentrum met een globale beheerdersaccount en selecteer Instellingen (tandwiel).

Notitie

Voor het maken van een sandbox moet de globale partner-Beheer worden aangemeld bij partnercentrum met hun onmicrosoft.com domeinalias (bijvoorbeeldalias@domain.onmicrosoft.com). Het maken van de sandbox mislukt als de gebruiker is aangemeld met het aangepaste domein.
Selecteer Accountinstellingen en vervolgens Integratie-sandbox.

Notitie

Als u geen optie voor integratie-sandbox ziet, hebt u mogelijk geen globale beheerdersaccount. Mogelijk gebruikt u ook een sandbox-account voor integratie en is er al een integratie-sandbox ingesteld.
Voer de contactgegevens in voor het account van de integratie-sandbox-beheerder. Kies vervolgens Account maken. Wacht enkele minuten totdat er een bevestigingsbericht wordt weergegeven dat het account is gemaakt.
Nadat u het bevestigingsbericht hebt weergegeven, meldt u zich af bij partnerdashboard.
Meld u opnieuw aan met uw nieuwe sandbox-beheerdersaccount voor integratie. Zorg ervoor dat u de notatie gebruikt username@domain voor uw referenties, samen met het wachtwoord dat u hebt opgegeven.
Kies Account instellen op de pagina Integratie sandbox om de configuratie van het sandbox-account te voltooien.

API-toegang inschakelen

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

Meld u aan bij partnercentrum met een globale beheerdersaccount en selecteer Instellingen (tandwiel).
Selecteer Accountinstellingen en vervolgens App-beheer.
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.
Kopieer de app-registratiegegevens, met name de sleutel als u een web-app maakt en sla deze op een veilige plaats op.
Meld u af bij partnerdashboard.
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 Partnercentrum-verificatie in te stellen met Microsoft Entra-id.

Itemnaam	Itemlocatie
App-id/client-id	Selecteer in Instellingen (tandwiel) accountinstellingen en vervolgens App Management. De app-id/client-id wordt vermeld als de app-id geregistreerd.
Key	Als u een web-app hebt gemaakt in de sectie API-toegang inschakelen, is dit de sleutel die u in stap 5 hebt opgeslagen.
Domain	Het domein 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 uw primaire partneraccountreferenties.

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

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