Einrichten des API-Zugriffs im Partner Center

Artikel
11/28/2023

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

In diesem Artikel werden die Konten beschrieben, die Sie für die Entwicklung mit dem Partner Center SDK benötigen. In diesem Artikel werden außerdem die Erstellung eines Integration Sandbox-Kontos und das Testen in der Integration Sandbox beschrieben.

Hinweis

Um Zugriff auf APIs zu erhalten, muss Ihr Mandant ein CSP-Mandant sein, und Sie müssen entweder ein indirekter Anbieter oder Direct Bill-Partner sein.

Kontodefinitionen

Um Ihre API-Integration zu integrieren und zu testen, unterstützt Partner Center zwei Arten von Konten:

Primäres Partnerkonto

Mit diesem Konto erstellen Sie echte Aufträge für echte Kunden. Wenn Sie Änderungen oder Transaktionen vornehmen, wenn Sie beim primären Konto angemeldet sind, werden sie entweder über das Partner Center SDK oder die Partner Dashboard-Benutzeroberfläche als offizielle Bestellungen für echte Kunden behandelt. Sie werden in Ihrer Rechnung widerzuspiegeln, und Ihr Unternehmen ist für die Zahlung für sie verantwortlich.

Integration Sandbox-Konto

Dieses Konto wird zum Testen des Codes und die Integration in die Partner Center-APIs verwendet, bevor Sie ihn öffentlich bereitstellen. Änderungen und Transaktionen, die Sie vornehmen, während Sie mit dem Integration Sandbox-Konto angemeldet sind, werden Ihnen in Rechnung gestellt. Der Betrag muss jedoch nicht beglichen werden. Die PDF-Datei der Rechnung hat den Haftungsausschluss: NICHT BEZAHLEN DIES IST EINE SANDBOXRECHNUNG, UND ES IST KEINE AKTION ERFORDERLICH.

Das Integrations-Sandkastenkonto und das primäre Konto agieren unabhängig und geben keine Administratorkonten, Benutzerkonten, Kunden, Bestellungen, Abonnements oder andere Daten frei.

Die Integration Sandbox unterstützt Transaktionen mit einer begrenzten Anzahl von Kunden, Aufträgen, Abonnements, Lizenzen usw.

Nach Richtlinie dienen Integrations-Sandkastenkonten nur zu Integrationstests.

Standardmäßig ist kein Integration Sandbox-Konto vorhanden. Sie müssen selbst ein Konto erstellen, wenn Sie das Partner Center SDK verwenden möchten.

Einrichten Ihrer Konten

In diesem Abschnitt wird beschrieben, wie Sie ein primäres Partnerkonto und ein Integration Sandbox-Konto für das Partner Center SDK einrichten.

Erstellen einer Integrations-Sandbox

Melden Sie sich mit einem globalen Administratorkonto beim Partner Center an, und wählen Sie Einstellungen (Zahnrad) aus.

Hinweis

Zum Erstellen einer Sandbox muss der globale Partneradministrator mit dem onmicrosoft.com in Partner Center angemeldet sein Standard Alias (z. Balias@domain.onmicrosoft.com. ). Die Sandkastenerstellung schlägt fehl, wenn der Benutzer mit seiner benutzerdefinierten Do angemeldet ist Standard.
Wählen Sie "Kontoeinstellungen" und dann "Integrations-Sandbox" aus.

Hinweis

Wenn keine Option „Integration Sandbox“ angezeigt wird, verfügen Sie möglicherweise nicht über ein globales Administratorkonto. Möglicherweise verwenden Sie auch ein Integration Sandbox-Konto, und es wurde bereits eine Integration Sandbox eingerichtet.
Geben Sie die Kontaktinformationen für das Integration Sandbox-Administratorkonto ein. Wählen Sie dann Konto erstellen aus. Warten Sie einige Minuten, bis eine Bestätigungsmeldung angezeigt wird, dass das Konto erstellt wurde.
Wenn die Bestätigungsmeldung angezeigt wird, melden Sie sich von Partnerdashboard ab.
Melden Sie sich mit Ihrem neuen Integration Sandbox-Administratorkonto erneut an. Stellen Sie sicher, dass Sie für Ihre Anmeldeinformationen das Format benutzername@domäne zusammen mit dem von Ihnen angegebenen Kennwort verwenden.
Wählen Sie "Konto einrichten" auf der Seite "Integration Sandbox" aus, um die Einrichtung des Sandkastenkontos abzuschließen.

API-Zugriff aktivieren

Nachdem Sie Ihr Konto eingerichtet haben, müssen Sie den API-Zugriff aktivieren, um das Partner Center SDK mit der Integrationssandbox verwenden zu können. Sie müssen den Zugriff auf die API für Ihr Partner Center-Hauptkonto und Ihr Integration Sandbox-Konto separat aktivieren.

Melden Sie sich mit einem globalen Administratorkonto beim Partner Center an, und wählen Sie Einstellungen (Zahnrad) aus.
Wählen Sie "Kontoeinstellungen" und dann "App-Verwaltung" aus.
Wenn Sie noch nicht über eine vorhandene App verfügen, fügen Sie eine neue Web-App hinzu. Wenn Sie über eine vorhandene Web-App verfügen, klicken Sie auf die Schaltfläche Schlüssel hinzufügen.
Kopieren Sie die Registrierungsinformationen der App (vor allem den Schlüssel, wenn Sie eine Web-App erstellen), und speichern Sie sie an einem sicheren Ort.
Melden Sie sich von Partnerdashboard ab.
Melden Sie sich mit Ihrem Sandbox-Konto erneut an. Wiederholen Sie die Schritte 2 bis 5, um den API-Zugriff in der Integration Sandbox zu ermöglichen.

Schreiben und Testen von Code

Sie können Code schreiben und in der Integration Sandbox testen. Sie benötigen die folgenden Informationen, um die Partner Center-Authentifizierung mit der Microsoft Entra-ID einzurichten.

Elementname	Speicherort des Elements
App-ID/Client-ID	Wählen Sie in Einstellungen (Zahnrad) Die Kontoeinstellungen und dann die App-Verwaltung aus. Die App-ID/Client-ID wird als Registrierte Anwendungs-App-ID aufgeführt.
Schlüssel	Wenn Sie im Abschnitt Aktivieren des API-Zugriffs eine Web-App erstellt haben, ist dies der Schlüssel, den Sie in Schritt 5 gespeichert haben.
Domäne	Die Domäne für die Integration Sandbox.

Ausführen von getestetem Code

Wenn Sie Ihre Lösung mit echten Kundendaten verwenden möchten, müssen Sie anstelle der Anmeldeinformationen für die Integration Sandbox die Anmeldeinformationen für Ihr primäres Partnerkonto verwenden.

Wenn Sie bereit sind, Ihren getesteten Code in Ihrem primären Partnerkonto zu verwenden, müssen Sie ein Microsoft Entra-Sicherheitstoken erhalten. Dieses Sicherheitstoken basiert auf Ihrer Partner Center-App, deren Schlüssel und deren Domäne (anstatt auf Ihrer Integration Sandbox-App, deren Schlüssel und deren Domäne).

Führen Sie die Schritte in der Partner Center-Authentifizierung aus, um ein Microsoft Entra-Sicherheitstoken mit Ihren primären Partner Center-Anmeldeinformationen abzurufen. (Sie haben zuvor diese Schritte ausgeführt, um ein Microsoft Entra-Sicherheitstoken für Ihre Integrations-Sandbox abzurufen.)
Ersetzen Sie das Integrationssicherheitstoken in Ihrem Code durch das neue Sicherheitstoken für Ihr primäres Partnerkonto.