Dela via

Konfigurera API-åtkomst i Partnercenter

  • Artikel

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 integrationssandbox-konto och testar i sandbox-miljön för integrering.

Anteckning

För att få åtkomst till API:er måste din klientorganisation vara en CSP-klient (Cloud Solution Provider) och du måste vara antingen en indirekt provider eller en direktfaktureringspartner.

Förstå kontodefinitionerna

Partnercenter har stöd för två typer av konton för att hjälpa dig att integrera och testa DIN API-integrering.

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. Pdf-fakturan innehåller en ansvarsfriskrivning: "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. De 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 och så vidare.
  • Integreringssandbox-kontona är endast för integreringstestning efter princip.
  • 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

Om du vill skapa en integreringssandlåda följer du stegen i Skapa ett CSP-integreringskonto (Cloud Solution Provider).

Aktivera API-åtkomst

När ditt konto har konfigurerats måste du aktivera API-åtkomst innan du kan använda Partnercenter SDK med integreringssandlådan. Du måste aktivera åtkomst till API:et separat för både ditt primära partnerkonto och ditt sandbox-konto för integrering.

  1. Logga in på Partnercenter med ett globalt administratörskonto och välj sedan Inställningar (kugghjulsikon).
  2. Välj Kontoinställningaroch sedan Apphantering.
  3. 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.
  4. Kopiera appregistreringsinformationen, särskilt Key om du skapar en webbapp och lagra den på en säker plats.
  5. Logga ut från Partnerdashboarden.
  6. 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 ett Microsoft Entra-ID.

  • App-ID/Klient-ID: Anges som registrerat programapp-ID i Inställningar (kugghjulsikon) >Kontoinställningar>Apphantering.
  • Key: Om du skapade en ny webbapp i föregående avsnitt, använd den nyckeln.
  • Domain: Är för integreringssandboxen.

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 behöver du en Microsoft Entra-säkerhetstoken. Den här säkerhetstoken baseras på din PartnerCenter app, nyckel och domän (i stället för din integreringssandbox- app, nyckel och domän).

  1. 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.)
  2. Ersätt integrationssäkerhetstoken i koden med den nya säkerhetstoken för ditt primära partnerkonto.

Relaterat innehåll