Freigeben über

Einrichten des API-Zugriffs im Partner Center

anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung

In diesem Artikel werden die Konten beschrieben, die Sie für das Partner Center SDK entwickeln müssen. In diesem Artikel wird auch erläutert, wie Sie ein Integrations-Sandkastenkonto erstellen und in der Integrations-Sandbox testen.

Von Bedeutung

Ab dem 1. April 2026 erzwingen alle App+User-Nutzung von Partner Center-APIs die Verwendung von MFA.

Um auf diese Anforderung vorbereitet zu sein, werden ab Oktober 2025 die APIs nach dem MFA-Token suchen und eine Bestätigung über dessen Anwesenheit in der Antwort bereitstellen. Weitere Informationen finden Sie unter Validierung der API-Aufrufe sind in die MFA integriert.

Hinweis

Um Zugriff auf APIs zu erhalten, muss Ihr Mandant ein Cloud Solution Provider (CSP)-Mandant sein, und Sie müssen entweder ein indirekter Anbieter oder ein Direktrechnungspartner sein.

Grundlegendes zu den 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 Bestellungen 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 sind in Ihrer Rechnung widerspiegelt, und Ihr Unternehmen ist dafür verantwortlich, sie zu bezahlen.

Integrationssandboxkonto

Dieses Konto dient zum Testen ihres Codes und seiner Integration mit den Partner Center-APIs, bevor Sie ihn allgemein bereitstellen. Änderungen und Transaktionen, die Sie vornehmen, wenn Sie beim Integrations-Sandkastenkonto angemeldet sind, werden in Ihrer Rechnung angezeigt, aber Sie müssen den Rechnungsbetrag nicht bezahlen. Das PDF der Rechnung enthält einen Haftungsausschluss: "NICHT ZAHLEN." DIES IST EINE SANDBOXRECHNUNG, UND ES IST KEINE AKTION ERFORDERLICH.“

  • Das Integrations-Sandkastenkonto und das primäre Konto agieren unabhängig. Sie teilen keine Administratorkonten, Benutzerkonten, Kunden, Bestellungen, Abonnements oder andere Daten.
  • Die Integrations-Sandbox unterstützt Transaktionen mit einer begrenzten Anzahl von Kunden, Bestellungen, Abonnements, Lizenzen usw.
  • Die Sandbox-Konten für die Integration dienen ausschließlich zu Integrationszwecken gemäß Richtlinie.
  • Standardmäßig ist kein Integrations-Sandkastenkonto vorhanden. Sie müssen eine selbst 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 Integrations-Sandkastenkonto für das Partner Center SDK einrichten.

Erstellen einer Integrations-Sandbox

Führen Sie zum Erstellen einer Integrations-Sandbox die Schritte in Erstellen eines Cloud Solution Provider (CSP)-Integrations-Sandkastenkontosaus.

API-Zugriff aktivieren

Nachdem Ihr Konto eingerichtet wurde, müssen Sie den API-Zugriff aktivieren, bevor Sie das Partner Center SDK mit der Integrations-Sandbox verwenden können. Sie müssen den Zugriff auf die API sowohl für Ihr primäres Partnerkonto als auch für Ihr Integrations-Sandbox-Konto separat aktivieren.

  1. Melden Sie sich mit einem globalen Administratorkonto bei Partner Center an, und wählen Sie dann Einstellungen (Zahnradsymbol) aus.
  2. Wählen Sie Kontoeinstellungenund App-Verwaltungaus.
  3. Wenn Sie noch keine App haben, fügen Sie eine neue Web-App hinzu. Wenn Sie über eine Web-App verfügen, wählen Sie die Schaltfläche Schlüssel hinzufügen aus.
  4. Kopieren Sie die App-Registrierungsinformationen, insbesondere den Key, wenn Sie eine Web-App erstellen, und speichern Sie sie an einem sicheren Ort.
  5. Melden Sie sich vom Partner-Dashboard ab.
  6. Melden Sie sich mit Ihrem Integrations-Sandkastenkonto wieder an. Wiederholen Sie die Schritte 2 bis 5, um den API-Zugriff in der Integrations-Sandbox zu aktivieren.

Schreiben und Testen von Code

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

  • App-ID/Client-ID: Aufgelistet als App-ID der registrierten Anwendung innerhalb von Einstellungen (Zahnradsymbol) >Kontoeinstellungen>App-Verwaltung.
  • Schlüssel: Wenn Sie im vorherigen Abschnitt eine neue Web-App erstellt haben, verwenden Sie diesen Schlüssel.
  • Domain: Dient der Integrations-Sandbox.

Ausführen von getesteten Code

Um Ihre Lösung mit echten Kundendaten zu verwenden, müssen Sie von Ihren Integrations-Sandbox-Anmeldeinformationen zu Ihren primären Partnerkontoanmeldeinformationen wechseln.

Wenn Sie bereit sind, Ihren getesteten Code in Ihrem primären Partnerkonto zu verwenden, benötigen Sie ein Microsoft Entra-Sicherheitstoken. Dieses Sicherheitstoken basiert auf Ihrem Partner Center App, Schlüssel und Domäne (anstelle Ihrer Integrations-Sandbox App, Schlüssel und Domäne).

  1. Führen Sie die Schritte unter 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.)
  2. Ersetzen Sie das Integrationssicherheitstoken in Ihrem Code durch das neue Sicherheitstoken für Ihr primäres Partnerkonto.

Verwandte Inhalte

  • Last updated on