Konfigurera API-åtkomst i Partner Center
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
I den här artikeln beskrivs de konton som du behöver utveckla mot SDK:n för Partnercenter. Den här artikeln beskriver också hur du skapar ett sandbox-konto för integrering och testar i sandbox-miljön för integrering.
Kommentar
För att få åtkomst till API:er måste din klientorganisation vara en CSP-klientorganisation och du måste vara antingen en indirekt leverantör eller en direktfaktureringspartner.
Kontodefinitioner
För att hjälpa dig att integrera och testa DIN API-integrering stöder Partnercenter två typer av konton:
Primärt partnerkonto
Det är här du skapar verkliga beställningar för riktiga kunder. Om du gör ändringar eller transaktioner när du är inloggad på det primära kontot behandlas de som officiella beställningar för verkliga kunder genom att använda antingen Partnercenter SDK eller användargränssnittet för partnerinstrumentpanelen. De återspeglas i din faktura och ditt företag ansvarar för att betala för dem.
Sandbox-konto för integrering
Det här kontot är till för att testa din kod och dess integrering med Partnercenter-API:erna innan du distribuerar den brett. Ändringar och transaktioner som du gör när du är inloggad på integrationssandbox-kontot visas på din faktura, men du behöver inte betala fakturabeloppet. Faktura pdf kommer att ha en ansvarsfriskrivning som "BETALA INTE. DET HÄR ÄR EN SANDBOX-FAKTURA OCH INGEN ÅTGÄRD KRÄVS."
Integreringssandbox-kontot och det primära kontot fungerar oberoende av varandra och delar inte administratörskonton, användarkonton, kunder, beställningar, prenumerationer eller andra data.
Sandbox-miljön för integrering stöder transaktioner med ett begränsat antal kunder, beställningar, prenumerationer, licenser osv.
Efter princip är integreringssandbox-konton endast för integreringstestning.
Det finns inget sandbox-konto för integrering som standard. Du måste skapa en själv om du planerar att använda SDK:n för Partnercenter.
Konfigurera dina konton
I det här avsnittet beskrivs hur du konfigurerar ett primärt partnerkonto och ett sandbox-konto för integrering för Partnercenter SDK.
Skapa en integreringssandbox
Logga in på Partnercenter med ett globalt administratörskonto och välj Inställningar (kugghjul).
Kommentar
För att skapa en sandbox-miljö måste partnerns globala administratör loggas in på Partnercenter med sitt onmicrosoft.com domänalias (till exempel alias@domain.onmicrosoft.com). Det går inte att skapa sandbox-miljön om användaren är inloggad med sin anpassade domän.
Välj Kontoinställningar och sedan Integreringssandlåda.
Kommentar
Om du inte ser något alternativ för integrationssandbox-miljö kanske du inte har något globalt administratörskonto. Du kanske också använder ett sandbox-konto för integrering och en integreringssandbox har redan konfigurerats.
Ange kontaktinformationen för integrationssandbox-administratörskontot. Välj sedan Skapa konto. Vänta några minuter på ett bekräftelsemeddelande om att kontot har skapats.
När du har fått bekräftelsemeddelandet loggar du ut från partnerinstrumentpanelen.
Logga in igen med ditt nya administratörskonto för integreringssandbox-miljön. Se till att använda formatet username@domain för dina autentiseringsuppgifter tillsammans med det lösenord som du angav.
Välj Konfigurera konto på sidan Integration Sandbox för att slutföra konfigurationen av sandbox-kontot.
Aktivera API-åtkomst
När ditt konto har konfigurerats måste du aktivera API-åtkomst innan du kan använda SDK:t för Partnercenter med sandbox-kontot för integrering. Du måste aktivera åtkomst till API:et separat för både ditt primära partnerkonto och sandbox-kontot för integrering.
Logga in på Partnercenter med ett globalt administratörskonto och välj Inställningar (kugghjul).
Välj Kontoinställningar och sedan Apphantering.
Om du inte redan har en befintlig app lägger du till en ny webbapp. Om du har en befintlig webbapp väljer du knappen Lägg till nyckel .
Kopiera appregistreringsinformationen , särskilt nyckeln om du skapar en webbapp, och lagra den på en säker plats.
Logga ut från instrumentpanelen för partner.
Logga in igen med ditt sandbox-konto för integrering. Upprepa steg 2–5 för att aktivera API-åtkomst i integreringssandboxen.
Skriva och testa kod
Du kan skriva kod och testkod i sandbox-miljön för integrering. Du behöver följande information för att konfigurera Partnercenter-autentisering med Microsoft Entra-ID.
| Objektnamn | Objektplats |
|---|---|
| App-ID/Klient-ID | Från Inställningar (kugghjul) väljer du Kontoinställningar och sedan Apphantering. App-ID/klient-ID visas som app-ID för registrerat program. |
| Key | Om du har skapat en webbapp i avsnittet Aktivera API-åtkomst är det här nyckeln som du sparade i steg 5. |
| Domain | Domänen för integreringssandbox-miljön. |
Kör testad kod
Om du vill använda din lösning med verkliga kunddata måste du ändra från dina autentiseringsuppgifter för integreringssandbox till dina primära autentiseringsuppgifter för partnerkontot.
När du är redo att använda din testade kod i ditt primära partnerkonto måste du skaffa en Microsoft Entra-säkerhetstoken. Den här säkerhetstoken baseras på din Partner Center-app, nyckel och domän (i stället för din integrationssandbox-app, nyckel och domän).
Följ stegen i Partnercenter-autentisering för att hämta en Microsoft Entra-säkerhetstoken med dina primära autentiseringsuppgifter för Partnercenter. (Du har tidigare följt de här stegen för att hämta en Microsoft Entra-säkerhetstoken för din integreringssandbox.)
Ersätt integrationssäkerhetstoken i koden med den nya säkerhetstoken för ditt primära partnerkonto.