Freigeben über


Häufig gestellte Fragen zu SaaS-Fulfillment-APIs

Dieser Artikel beschreibt einige der Integrationsanforderungen für den kommerziellen Microsoft-Marketplace, damit Azure-Kunden SaaS-Angebote abonnieren können.

Ermittlungserfahrung

Nach der Veröffentlichung eines SaaS-Angebots steht dieses für Azure-Benutzer im Azure Marketplace zur Verfügung. Ihre Kunden können Angebote nach Produkttyp (SaaS) filtern und nach für sie interessanten SaaS-Diensten suchen.

Einkaufserfahrung

Wenn sich ein Benutzer für ein bestimmtes SaaS-Angebot interessiert, kann er es über den Azure Marketplace abonnieren.

Was bedeutet es für einen Azure-Benutzer, ein SaaS-Angebot im Azure Marketplace zu abonnieren?

Es bedeutet, dass der Benutzer die für das SaaS-Angebot geltenden Nutzungsbedingungen und Datenschutzbestimmungen einsehen und den von Ihnen als Herausgeber des SaaS-Angebots festgelegten Abrechnungskonditionen zustimmen kann, um es über Microsoft zu erwerben. Benutzer können ihr vorhandenes Zahlungsprofil in Azure verwenden, um für die Nutzung des SaaS-Angebots zu zahlen.

Diese Möglichkeit ist in mehrfacher Hinsicht von Vorteil. Kunden können jetzt microsoft Cloud Platform als vertrauenswürdige Quelle entdecken und abonnieren, ohne jede unabhängige Softwareanbietersoftware (ISV) prüfen zu müssen, die sie verwenden möchte. Außerdem können Kunden ihr vorhandenes Zahlungsprofil nutzen und müssen auf diese Weise nicht jede ISV-Software separat zahlen.

Werden dem Benutzer bei der Anmeldung für das Angebot automatisch Gebühren berechnet?

Beim Abonnieren des SaaS-Angebots erklärt sich der Benutzer damit einverstanden, den Verbrauch des SaaS-Diensts über die Microsoft-Plattform zu bezahlen. Gebühren beginnen jedoch nur, wenn das Angebot verbraucht wird. Der Benutzer muss Ihr SaaS-Angebot aufrufen und die Kontoerstellung bestätigen, um mit der Nutzung des Angebots zu beginnen. Anschließend benachrichtigen Sie Microsoft, die Abrechnung für dieses SaaS-Abonnement des Kunden zu starten.

Wie werden Sie benachrichtigt, wenn ein Benutzer Ihr SaaS-Angebot abonniert?

Nachdem ein Benutzer ein Angebot abonniert hat, kann er die erworbenen Angebote in Azure ausfindig machen und verwalten. Standardmäßig wird der Status eines neu abonnierten SaaS-Angebots mit Bereitstellung, Erfüllung ausstehend angezeigt. In diesem Zustand wird der Azure-Benutzer mit einer Aktion zum Konfigurieren des Kontos aufgefordert, um in der Azure-Portal zu seiner SaaS-Abonnementverwaltungserfahrung zu navigieren.

Wenn der Benutzer "Konto konfigurieren" auswählt, wird er zur SaaS-Dienstwebsite umgeleitet. Der Herausgeber hat die URL zum Zeitpunkt der Angebotsveröffentlichung konfiguriert. Diese Seite wird als Landing Page des Herausgebers bezeichnet. Azure-Benutzer melden sich basierend auf ihren vorhandenen Microsoft Entra-Anmeldeinformationen in Azure bei der SaaS-Startseite an.

Wichtig

Sie müssen sich bei dem kaufden Benutzer mit der Microsoft Entra-ID anmelden, Single Sign-On (SSO) gemäß der Richtlinie. Die mail Eigenschaft für die Aus der Microsoft Graph-API abgerufene Benutzerressource enthält die Kontaktinformationen für den Fall von Microsoft Entra ID und userPrincipalName für MSA. Es ist möglich, dass das Feld "E-Mail" für die Microsoft Entra-ID leer ist und der Benutzer möglicherweise keine E-Mail aufgezeichnet hat. In diesem Falls wird empfohlen, dies zu erkennen und eine Kontakt-E-Mail zu bitten. Dies ist die einzige Möglichkeit, eine Kontakt-E-Mail-Adresse zu erhalten, um einen Kunden während oder nach dem Onboardingvorgang zu erreichen.

Wenn der Azure-Benutzer auf die Landing Page umgeleitet wird, wird der Abfrage-URL ein Token hinzugefügt. Es handelt sich hierbei um ein kurzlebiges Token mit einer Gültigkeitsdauer von 24 Stunden. Sie können anschließend das Vorhandensein dieses Tokens ermitteln und die Microsoft-API aufrufen, um weitere mit dem Token verknüpfte Kontextinformationen abzurufen.

Ablauf für Kundenabonnement

Weitere Informationen zur Abwicklung von Transaktionen im Lebenszyklus eines SaaS-Angebots finden Sie unter SaaS-Fulfillment-API.

Woher wissen Sie, welches SaaS-Angebot der Benutzer in Azure abonniert?

Die Antwort der Resolve-API enthält die Angebots- und Planinformationen, die dem SaaS-Abonnement zugeordnet sind.

Wie kann der Azure-Benutzer den Plan ändern, der diesem Azure-Abonnement zugeordnet ist?

  • Der Azure-Benutzer kann den mit dem SaaS-Abonnement verbundenen Plan direkt in der SaaS-Benutzeroberfläche selbst oder über die Microsoft-Plattform ändern.

  • Konvertierungen können zu einem beliebigen Zeitpunkt im Abrechnungszeitraum durchgeführt werden. Sie werden aufgefordert, jede Konvertierung zu bestätigen, die bei der Bestätigung wirksam wird.

  • Im Voraus bezahlte Tarife (monatlich oder jährlich) werden pro Bewertung bewertet. Alle bis zum Zeitpunkt der Konvertierung ermittelten Überschreitungen werden in der nächsten Rechnung abgerechnet. Neue Überschreitungen werden auf Grundlage des neuen Plans in Rechnung gestellt.

Hinweis

Sie können Downgrades blockieren, wenn Sie bestimmte Konvertierungspfade nicht unterstützen möchten.

Die folgende Sequenz zeigt den Ablauf, wenn ein Azure-Kunde den Plan über die SaaS-Benutzeroberfläche ändert:

Ablauf einer Planänderung durch den Kunden

Die folgende Sequenz zeigt den Ablauf, wenn der Azure-Kunde seinen Plan in einem Onlineshop von Microsoft ändert:

Ablauf für das Ändern eines Plans durch einen Kunden im Onlineshop

Wie kann der Azure-Benutzer den mit dem Azure-Abonnement verbundenen Plan kündigen?

Ein Azure-Benutzer kann das erworbene SaaS-Angebotsabonnement entweder direkt in der SaaS-Benutzeroberfläche oder über die Microsoft-Plattform kündigen. Sobald sich der Benutzer abmeldet, wird er nicht mehr ab dem nächsten Abrechnungszeitraum in Rechnung gestellt.

Die folgende Sequenz zeigt den Ablauf, wenn ein Azure-Kunde das SaaS-Angebot in der SaaS-Benutzeroberfläche kündigt:

Kündigung des Abonnements über die SaaS-Benutzeroberfläche

Die folgende Sequenz zeigt den Ablauf, wenn der Azure-Benutzer das Abonnement im Onlineshop von Microsoft kündigt:

Kündigung des Abonnements durch einen Kunden in einem Onlineshop von Microsoft

Verwalten der Benutzeroberfläche

Ein ISV kann das SaaS-Abonnement seines Kunden verwalten und Pläne ändern.

Damit ein Plan erfolgreich in einen anderen Plan innerhalb desselben Angebots umgewandelt werden kann, sollte folgendes erfüllt sein; andernfalls funktioniert Ihr Änderungsplan bei SaaS-Erfüllungs-API-Aufrufen möglicherweise nicht:

  • Der Zielplan sollte aktiv sein.
  • Der Zielplan sollte in der Region des Kunden unterstützt werden.
  • Wenn der Zielplan ein privater Plan ist, sollte die Mandanten-ID des Kunden dem Plan im Partner Center hinzugefügt und erneut veröffentlicht werden, bevor er den Änderungsplan versucht.
  • Wenn der Zielplan Teil des privaten Marketplace ist, sollte der Kunde den Plan auf dem privaten Marketplace zulassen, bevor der Änderungsplan durchgeführt wird.
  • Wenn die BYOL-Einstellung für EA-Kunden aktiviert ist (d. h. sie können nur kostenlose Ressourcen erwerben), sollte der Zielplan kein kostenpflichtiger Plan sein.

Gewusst wie einen Dienstprinzipal für meine Entra-App erstellen?

Ihr Entra App Service Principal ist die Instanz Ihrer Entra-App-Registrierung, die Sie für Ihr SaaS-Angebot erstellen. Dieser App-Dienstprinzipal muss im selben Mandanten erstellt werden, den Sie in der technischen Konfiguration des Partner Center verwenden. Anhand dieser Schritte können Sie ermitteln, ob ein Dienstprinzipal erstellt wird, und wenn nicht, wie Sie einen erstellen.

Schritt 1: Identifizieren der App-Registrierung.

  1. Navigieren Sie zu jedem SaaS-Angebot im Partner Center.

  2. Navigieren Sie zur "Technische Konfigurationsseite", und notieren Sie den Wert für die "Entra-Anwendungs-ID":

    Screenshot der Technischen Konfigurationsseite von Microsoft Partner Center.

Schritt 2: Ermitteln, ob der Dienstprinzipal erstellt wird oder nicht.

Option 1: Verwenden des Azure-Portal

  1. Navigieren Sie zur Seite Azure-Portal App-Registrierungen, und suchen Sie die App-Registrierung mit der ID, die Sie aus Partner Center kopiert haben.

    Tipp

    Möglicherweise müssen Sie zu "Alle Anwendungen" anstelle von "Eigene Anwendungen" wechseln, falls Sie nicht die erste App-Registrierung erstellt haben.

    Tipp

    Der Name der App-Registrierung endet mit "FulfillmentAppReg", wenn er mit dem SaaS Accelerator-Bereitstellungsskript erstellt wurde.

  2. Öffnen Sie die Seite "App-Registrierung". Falls der Link mit dem App-Registrierungsnamen angezeigt wird (anstelle des Links "Dienstprinzipal erstellen", wie im nächsten Screenshot gezeigt), bedeutet dies, dass Sie bereits einen Dienstprinzipal erstellt haben.

    Screenshot der Seite

Option 2: Verwenden der Azure CLI

az ad sp list --filter "appId eq '<Your-App-ID>'"

Wenn der Dienstprinzipal erstellt wird, erhalten accountEnabled Sie " true " (wie in dieser Abbildung dargestellt).

Screenshot der Azure-Befehlszeilenschnittstelle mit vom Dienstprinzipal erstellten Ergebnissen.

Weitere Informationen zu diesem Dienstprinzipallistenbefehl finden Sie in der az ad sp-Liste.

Schritt 3: Erstellen und Zuordnen eines Dienstprinzipals

Option 1: Verwenden des Azure-Portal

  1. Navigieren Sie zur Seite Azure-Portal App-Registrierungen, und suchen Sie die App-Registrierung mit der ID, die Sie aus Partner Center kopiert haben.

    Tipp

    Möglicherweise müssen Sie zu "Alle Anwendungen" anstelle von "Eigene Anwendungen" wechseln, falls Sie nicht die erste App-Registrierung erstellt haben.

    Tipp

    Der Name der App-Registrierung endet mit "FulfillmentAppReg", wenn er mit dem SaaS Accelerator-Bereitstellungsskript erstellt wurde.

  2. Öffnen Sie die Seite "App-Registrierung", und wählen Sie den Link "Dienstprinzipal erstellen" aus (wie in diesem Screenshot gezeigt).

    Screenshot der Seite

Option 2: Verwenden der Azure CLI

az ad sp create --id <app_id>

Wenn der Dienstprinzipal erstellt wird, wird accountEnabled " true " angezeigt (wie in dieser Abbildung dargestellt).

Screenshot der Befehlszeilenschnittstelle, die zeigt, dass der Dienstprinzipal erstellt wird.

Erfahren Sie mehr über diesen Dienstprinzipal-Befehl zum Erstellen von Diensten bei az ad sp create.