Nastavení přístupu k rozhraní API v Partnerském centru

Článek
11/28/2023

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Tento článek popisuje účty, které potřebujete vyvíjet v sadě SDK Partnerského centra. Tento článek také vysvětluje, jak vytvořit účet sandboxu integrace a otestovat ho v sandboxu integrace.

Poznámka:

Pokud chcete získat přístup k rozhraním API, musí být váš tenant CSP a musíte být nepřímým poskytovatelem nebo partnerem s přímým vyúčtováním.

Definice účtu

Partnerské centrum podporuje dva druhy účtů, které vám pomůžou integrovat a otestovat integraci rozhraní API:

Primární partner účet

Tento účet je místo, kde vytváříte skutečné objednávky pro skutečné zákazníky. Pokud provedete jakékoli změny nebo transakce při přihlášení k primárnímu účtu pomocí sady SDK Partnerského centra nebo uživatelského rozhraní partnerského řídicího panelu, budou se považovat za oficiální objednávky skutečných zákazníků. Projeví se na vaší faktuře a vaše společnost za ně zodpovídá.

Účet sandboxu pro integraci

Tento účet slouží k otestování kódu a jeho integrace s rozhraními API Partnerského centra před tím, než ho nasadíte široce. Změny a transakce, které provedete při přihlášení k účtu sandboxu integrace, se zobrazí na faktuře, ale nemusíte platit částku faktury. Faktura PDF bude mít právní omezení jako "NEPLATIT. JEDNÁ SE O FAKTURU ZA SANDBOX A NEVYŽADUJE SE ŽÁDNÁ AKCE.

Účet sandboxu integrace a primární účet fungují nezávisle a nesdílely účty správců, uživatelské účty, zákazníky, objednávky, předplatná ani jiná data.

Sandbox integrace podporuje transakce s omezeným počtem zákazníků, objednávek, předplatných, licencí atd.

Účty sandboxu integrace jsou podle zásad určené jenom pro účely testování integrace.

Ve výchozím nastavení žádný účet sandboxu pro integraci neexistuje. Pokud plánujete používat sadu SDK Partnerského centra, musíte si ji vytvořit sami.

Nastavení účtů

Tato část popisuje, jak nastavit primární partnerový účet a účet sandboxu integrace pro sadu SDK Partnerského centra.

Vytvoření sandboxu integrace

Přihlaste se k Partnerskému centru pomocí účtu globálního správce a vyberte Nastavení (ozubené kolo).

Poznámka:

Vytvoření sandboxu vyžaduje, aby se globální Správa partnera přihlásili do Partnerského centra pomocí svého aliasu domény onmicrosoft.com (napříkladalias@domain.onmicrosoft.com). Vytvoření sandboxu selže, pokud je uživatel přihlášený pomocí vlastní domény.
Vyberte Nastavení účtu a pak Sandbox integrace.

Poznámka:

Pokud možnost Sandboxu integrace nevidíte, možná nemáte účet globálního správce. Můžete také použít účet sandboxu integrace a už je nastavený integrační sandbox.
Zadejte kontaktní informace pro účet správce sandboxu integrace. Pak zvolte Vytvořit účet. Počkejte několik minut, než se zobrazí potvrzovací zpráva o vytvoření účtu.
Po zobrazení potvrzovací zprávy se odhlaste z řídicího panelu partnera.
Znovu se přihlaste pomocí nového účtu správce sandboxu integrace. Nezapomeňte použít formát username@domain přihlašovacích údajů spolu s heslem, které jste zadali.
Zvolte Nastavit účet na stránce Integrační sandbox a dokončete nastavení účtu sandboxu.

Povolení přístupu k rozhraní API

Po nastavení účtu musíte povolit přístup k rozhraní API, a teprve pak budete moct používat sadu SDK Partnerského centra se sandboxem pro integraci. Přístup k rozhraní API musíte povolit zvlášť pro svůj primární partnerský účet a účet sandboxu pro integraci.

Přihlaste se k Partnerskému centru pomocí účtu globálního správce a vyberte Nastavení (ozubené kolo).
Vyberte Nastavení účtu a pak správu aplikací.
Pokud ještě nemáte existující aplikaci, přidejte novou webovou aplikaci. Pokud máte existující webovou aplikaci, zvolte tlačítko Přidat klíč .
Zkopírujte informace o registraci aplikace, zejména klíč , pokud vytváříte webovou aplikaci, a uložte je na bezpečném místě.
Odhlaste se z řídicího panelu partnera.
Přihlaste se zpět pomocí svého účtu sandboxu integrace. Opakováním kroků 2 až 5 povolte přístup k rozhraní API v sandboxu integrace.

Psaní a testování kódu

V sandboxu integrace můžete napsat kód a testovat kód. K nastavení ověřování v Partnerském centru s ID Microsoft Entra budete potřebovat následující informace.

Název položky	Umístění položky
ID aplikace / ID klienta	V Nastavení (ozubené kolo) vyberte Nastavení účtu a pak Správu aplikací. ID aplikace nebo ID klienta je uvedené jako ID registrované aplikace.
Key	Pokud jste vytvořili webovou aplikaci v části Povolení přístupu k rozhraní API, jedná se o klíč, který jste uložili v kroku 5.
Doména	Doména pro sandbox integrace.

Spuštění testovaného kódu

Pokud chcete řešení používat se skutečnými zákaznickými daty, musíte změnit z přihlašovacích údajů sandboxu integrace na primární přihlašovací údaje k účtu partnera.

Až budete připraveni použít testovaný kód v primárním partnerském účtu, musíte získat token zabezpečení Microsoft Entra. Tento token zabezpečení je založený na vaší aplikaci v Partnerském centru, klíči a doméně (místo aplikace sandboxu integrace, klíče a domény).

Postupujte podle kroků v ověřování v Partnerském centru a získejte token zabezpečení Microsoft Entra pomocí vašich primárních přihlašovacích údajů v Partnerském centru. (Dříve jste použili tento postup k získání tokenu zabezpečení Microsoft Entra pro váš sandbox integrace.)
Nahraďte token zabezpečení integrace v kódu novým tokenem zabezpečení vašeho primárního partnerského účtu.