Freigeben über

Verwalten des SaaS-Abonnementlebenszyklus

  • Artikel

Der kommerzielle Marketplace verwaltet den gesamten Lebenszyklus eines SaaS-Abonnements nach dem Kauf durch den Endbenutzer. Es verwendet die Startseite, Die Erfüllungs-APIs, Operations-APIs und den Webhook als Mechanismus, um die tatsächliche SaaS-Abonnementaktivierung, Nutzung, Updates und Stornierung zu fördern. Die Rechnung des Endbenutzers basiert auf dem Status des SaaS-Abonnements, das Microsoft verwaltet.

Status eines SaaS-Abonnements

Das folgende Diagramm zeigt die Zustände eines SaaS-Abonnements und die entsprechenden Aktionen.

Diagramm mit dem Lebenszyklus von Software als Dienstabonnement auf dem Marketplace.

Gekauft, aber noch nicht aktiviert (PendingFulfillmentStart)

Nachdem ein Endbenutzer oder Cloud-Lösungsanbieter (CSP) ein SaaS-Angebot auf dem kommerziellen Marketplace erworben hat, wird der Herausgeber über den Kauf benachrichtigt. Der Herausgeber kann dann ein neues SaaS-Konto auf der Herausgeberseite für den Endbenutzer erstellen und konfigurieren.

Damit die Kontoerstellung erfolgt:

  1. Der Kunde wählt die Schaltfläche Konto jetzt konfigurieren aus, die nach dem erfolgreichen Kauf in Microsoft AppSource oder dem Azure-Portal für ein SaaS-Angebot verfügbar ist. Alternativ kann der Kunde die Schaltfläche Jetzt konfigurieren in der E-Mail verwenden, die er kurz nach dem Kauf erhalten wird.
  2. Microsoft benachrichtigt den Partner dann über den Kauf, indem er die Url der Startseite mit dem Tokenparameter (dem Kaufidentifikationstoken vom kommerziellen Marketplace) auf der neuen Browserregisterkarte öffnet.

Ein Beispiel für einen solchen Anruf ist https://contoso.com/signup?token=<blob>, die Zielseiten-URL für dieses SaaS-Angebot im Partner Center ist jedoch als https://contoso.com/signupkonfiguriert. Dieses Token stellt dem Herausgeber eine ID bereit, die den SaaS-Kauf und den Kunden eindeutig identifiziert.

Trinkgeld

Fügen Sie das Nummernzeichenzeichen (#) nicht in die URL der Zielseite ein. Andernfalls können Kunden nicht auf Ihre Startseite zugreifen. Der Herausgeber hat 30 Tage Zeit, um die Ressource aufzulösen, wenn der Status PendingFulfillmentStartist. Andernfalls wird das Objekt ungültig. Da der Abrechnungszyklus nicht initiiert wurde und der jeweilige Kauf nicht in Rechnung gestellt wird, ändert sich der Status dann in Gekündigte. Der Kunde wird dem Kauf nicht in Rechnung gestellt.

Wichtig

Die URL der Zielseite muss täglich, jeden Tag und bereit für den Empfang neuer Anrufe von Microsoft sein. Wenn die Startseite nicht verfügbar ist, können sich Kunden nicht für den SaaS-Dienst registrieren und damit beginnen, sie zu verwenden.

Als Nächstes muss der Herausgeber das -Token zurück an Microsoft übergeben, indem er die SaaS Resolve APIaufruft und das Token als Wert des x-ms-marketplace-token header Parameters eingibt. Als Ergebnis des Resolve-API-Aufrufs wird das Token gegen Details zum SaaS-Kauf ausgetauscht, z. B. die eindeutige ID des Kaufs, die erworbene Angebots-ID und die gekaufte Plan-ID.

Auf der Startseite sollte der Kunde über microsoft Entra Single Sign-On (SSO) beim neuen oder vorhandenen SaaS-Konto angemeldet sein.

Anmerkung

Der Herausgeber wird erst über den SaaS-Kauf benachrichtigt, wenn der Kunde den Konfigurationsprozess von Microsoft aus initiiert.

Der Herausgeber sollte SSO implementieren, um die von Microsoft für diesen Fluss erforderliche Benutzererfahrung bereitzustellen. Stellen Sie sicher, dass Sie die Mehrinstanzenanwendung Microsoft Entra verwenden und sowohl Geschäfts- als auch Schul- und Unikonten oder persönliche Microsoft-Konten beim Konfigurieren von SSO zulassen. Diese Anforderung gilt nur für die Zielseite, für Benutzer, die an den SaaS-Dienst umgeleitet werden, wenn sie bereits mit Microsoft-Anmeldeinformationen angemeldet sind. SSO ist für alle Anmeldungen beim SaaS-Dienst nicht erforderlich.

Anmerkung

Wenn SSO erfordert, dass ein Administrator eine Berechtigung für eine App erteilen muss, muss die Beschreibung des Angebots im Partner Center offenlegen, dass der Zugriff auf Administratorebene erforderlich ist. Diese Offenlegung besteht darin, Kommerzielle Marketplace-Zertifizierungsrichtlinieneinzuhalten.

Nach der Anmeldung sollte der Kunde die SaaS-Konfiguration auf der Herausgeberseite abschließen. Anschließend muss der Herausgeber die Activate Subscription API aufrufen, um ein Signal an Azure Marketplace zu senden, dass die Bereitstellung des SaaS-Kontos abgeschlossen ist. Diese Aktion startet den Abrechnungszyklus des Kunden. Wenn der Aufruf der Activate-Abonnement-API nicht erfolgreich ist, wird der Kunde dem Kauf nicht in Rechnung gestellt.

Diagramm mit den A P-Aufrufen für ein Bereitstellungsszenario.

Sowohl der Käufer als auch der Rechnungskontobesitzer erhalten eine E-Mail, die sie zum Konfigurieren des Kontos anfordert.

Anmerkung

Publisher hat 30 Tage Zeit, um die Ressource aufzulösen, wenn der Status PendingFulfillmentStartist. Andernfalls wird das Objekt ungültig, da der Abrechnungszyklus nicht initiiert wurde und der jeweilige Kauf nicht in Rechnung gestellt wird. Der Status ändert sich in Gekündigte. Der Kunde wird dem Kauf nicht in Rechnung gestellt.

Aktiv (abonniert)

Active (Subscribed) ist der stetige Zustand eines bereitgestellten SaaS-Abonnements. Nachdem die microsoft-Seite verarbeitet wurde, wird die Aktivieren der Abonnement-API Aufrufs das SaaS-Abonnement als abonniertmarkiert. Der Kunde kann nun den SaaS-Dienst auf der Seite des Herausgebers nutzen und wird abgerechnet.

Wenn ein SaaS-Abonnement bereits aktiv ist, kann der Kunde SaaS-Erfahrung verwalten aus dem Azure-Portal oder microsoft 365 Admin Center auswählen. Diese Aktion bewirkt auch, dass Microsoft die Zielseiten-URL mit dem Token Parameter aufrufen wird, wie im Activate-Fluss. Der Herausgeber sollte zwischen neuen Käufen und der Verwaltung vorhandener SaaS-Konten unterscheiden und diesen URL-Aufruf der Zielseite entsprechend behandeln.

Eine Aktivierungsbenachrichtigungs-E-Mail wird sowohl an den Käufer als auch an den Besitzer des Abrechnungskontos gesendet.

Wird aktualisiert (abonniert)

Diese Aktion bedeutet, dass ein Update auf ein vorhandenes aktives SaaS-Abonnement sowohl von Microsoft als auch vom Herausgeber verarbeitet wird. Updates werden initiiert von:

  • Der Kunde vom kommerziellen Marktplatz.
  • Der CSP vom kommerziellen Markt.
  • Der Kunde von der SaaS-Website des Herausgebers (aber nicht für CSP-getätigte Einkäufe).

Für ein SaaS-Abonnement stehen zwei Arten von Updates zur Verfügung:

  • Aktualisieren Sie den Plan, wenn der Kunde einen anderen Plan für das Abonnement auswäht.
  • Aktualisieren Sie die Menge, wenn der Kunde die Anzahl der erworbenen Lizenzen für das Abonnement ändert.

Es kann nur ein aktives Abonnement aktualisiert werden. Während das Abonnement aktualisiert wird, bleibt der Status auf der Microsoft-Seite aktiv.

Update vom kommerziellen Marketplace initiiert

In diesem Fluss ändert der Kunde den Abonnementplan oder die Anzahl der Lizenzen aus dem Azure-Portal oder microsoft 365 Admin Center.

  1. Nachdem ein Update eingegeben wurde, ruft Microsoft die Webhook-URL des Herausgebers auf, die im Feld Verbindungswebhook feld auf der Seite Technische Konfiguration Seite im Partner Center konfiguriert ist, mit einem geeigneten Wert für Aktion und anderen relevanten Parametern.
  2. Die Herausgeberseite sollte die erforderlichen Änderungen am SaaS-Dienst vornehmen und Microsoft benachrichtigen, wenn sie den Updatestatus der Vorgangs-APIaufrufen.
  3. Wenn der Patch mit Status fehlschlägt, wird der Updatevorgang nicht auf der Microsoft-Seite abgeschlossen. Das SaaS-Abonnement behält den vorhandenen Plan und die Anzahl der Lizenzen bei.

Anmerkung

Der Herausgeber sollte PATCH aufrufen , um den Status der Vorgangs-API mit einer Fehler-/Erfolgsantwort innerhalb eines 10-Sekunden-Zeitfensters nach Erhalt der Webhook-Benachrichtigung zu aktualisieren. Wenn PATCH of operation status nicht innerhalb von 10 Sekunden empfangen wird, wird der Änderungsplan automatisch als Successgepatcht.

Die Sequenz der API-Aufrufe für ein Updateszenario, das vom kommerziellen Marketplace initiiert wird, wird im folgenden Diagramm gezeigt.

Diagramm mit dem A P-Aufruf für ein marketplace-initiiertes Update.

Vom Herausgeber initiierte Aktualisierung

In diesem Fluss ändert der Kunde den Abonnementplan oder die Anzahl der lizenzen, die vom SaaS-Dienst selbst erworben wurden.

  1. Bevor die angeforderte Änderung auf der Herausgeberseite vorgenommen wird, muss der Herausgebercode die Change Plan API oder die Change Quantity API oder beides aufrufen.
  2. Microsoft wendet die Änderung auf das Abonnement an, und benachrichtigen Sie den Herausgeber dann über Connection Webhook, die gleiche Änderung anzuwenden.
  3. Nur dann sollte der Herausgeber die erforderliche Änderung am SaaS-Abonnement vornehmen und Microsoft benachrichtigen, wenn die Änderung erfolgt, indem Updatestatus der Vorgangs-APIaufgerufen wird.

Die Sequenz der API-Aufrufe für ein Updateszenario, das von der Herausgeberseite initiiert wird, wird im folgenden Diagramm gezeigt.

Diagramm mit dem A P-Aufruf eines herausgeberseitigen Updates.

Eine Benachrichtigungs-E-Mail, die angibt, dass eine Planänderung sowohl an den Käufer als auch an den Rechnungskontobesitzer gesendet wird.

Eine Benachrichtigungs-E-Mail, die angibt, dass eine Änderung der Menge sowohl an den Käufer als auch an den Rechnungskontobesitzer gesendet wird.

Suspended (Suspended)

Dieser Zustand gibt an, dass die Zahlung eines Kunden für den SaaS-Dienst nicht empfangen wurde. Microsoft benachrichtigt den Herausgeber dieser Änderung im SaaS-Abonnementstatus. Die Benachrichtigung erfolgt über einen Aufruf von Webhook, wobei die Aktion Parameter auf Suspendedfestgelegt ist.

Der Herausgeber kann änderungen am SaaS-Dienst auf der Herausgeberseite vornehmen oder nicht. Es wird empfohlen, dass der Herausgeber diese Informationen dem ausgesetzten Kunden zur Verfügung stellt und beschränkt oder den Zugriff des Kunden auf den SaaS-Dienst blockiert. Es gibt eine Wahrscheinlichkeit, dass die Zahlung nicht jemals empfangen wird.

Anmerkung

Microsoft gibt dem Kunden eine 30-tägige Nachfrist, bevor das Abonnement automatisch storniert wird. Nachdem die 30-Tage-Nachfrist abgelaufen ist, empfängt der Webhook eine Unsubscribe Aktion.

Wenn sich ein Abonnement im Status "Suspended" befindet:

  • Der Partner oder ISV muss das SaaS-Konto in einem wiederherstellbaren Zustand beibehalten, sodass die vollständige Funktionalität ohne Datenverlust oder Einstellungen wiederhergestellt werden kann.
  • Der Partner oder der ISV sollte erwarten, dass das Abonnement wieder zurückgesetzt wird, wenn die Zahlung während der Nachfrist empfangen wird, oder eine Anforderung zur Debereitstellung des Abonnements am Ende der Nachfrist. Der Webhook-Mechanismus sendet beide Anforderungen.

Der Abonnementstatus wird in angehaltenen auf der Microsoft-Seite geändert, bevor der Herausgeber eine Aktion ausführt. Nur aktive Abonnements können ausgesetzt werden.

Eine Benachrichtigungs-E-Mail, die angibt, dass die Änderung des Status in angehaltene sowohl an den Käufer als auch an den Besitzer des Abrechnungskontos gesendet wird.

Nach einer Aussetzungsfrist von 30 Tagen wird eine E-Mail zur Kündigung nach der Aussetzung sowohl an den Käufer als auch an den Rechnungskontobesitzer gesendet.

Neu eingestellt (angehaltene)

Diese Aktion gibt an, dass das Zahlungsmittel des Kunden erneut gültig ist. Für das SaaS-Abonnement wurde eine Zahlung getätigt, und das Abonnement wird wieder eingestellt. In diesem Fall:

  1. Microsoft ruft Webhook mit einer Aktion auf, Parameter auf den wert Wiederstated festgelegt ist.
  2. Der Herausgeber stellt sicher, dass das Abonnement wieder auf der Herausgeberseite voll funktionsfähig ist.
  3. Der Reinstate-Prozess ist erfolgreich und der Kunde wird erneut für das SaaS-Abonnement in Rechnung gestellt.

Es kann nur ein ausgesetztes Abonnement wieder eingestellt werden. Das ausgesetzte SaaS-Abonnement verbleibt in einem Status "Suspended", während es wieder eingestellt wird. Nach Abschluss dieses Vorgangs wird der Status des Abonnements Active.

Eine E-Mail wird sowohl an den Käufer als auch an den Rechnungsbesitzer gesendet, nachdem der Übergang vom Status "Angehalten" in den zustand "wieder eingestellt" erfolgt.

Erneuert (abonnierte)

Microsoft verlängert das SaaS-Abonnement automatisch am Ende der Abonnementlaufzeit eines Monats oder eines Jahres. Die Standardeinstellung für die Einstellung "autorenewal" ist "true" für alle SaaS-Abonnements. Aktive SaaS-Abonnements werden weiterhin mit regelmäßigen Abständen verlängert. Microsoft stellt nur Inform-Webhook-Benachrichtigungen für Verlängerungsereignisse bereit. Ein Kunde kann die automatische Verlängerung für ein SaaS-Abonnement über das Microsoft 365 Admin Portal deaktivieren. In diesem Fall wird das SaaS-Abonnement automatisch am Ende der aktuellen Abrechnungsdauer storniert. Kunden können das SaaS-Abonnement jederzeit kündigen.

Nur aktive Abonnements werden automatisch verlängert. Abonnements bleiben während des Verlängerungsprozesses aktiv, und wenn die automatische Verlängerung erfolgreich ist. Nach der Verlängerung werden die Anfangs- und Enddaten des Abonnementtermins auf die Datumsangaben des neuen Zeitraums aktualisiert.

Wenn ein Autorenewal aufgrund eines Zahlungsproblems fehlschlägt, wird das Abonnement Ausgesetzt und der Herausgeber benachrichtigt.

Erinnerungs-E-Mails zur Verlängerung werden sowohl an den Käufer als auch an den Besitzer des Abrechnungskontos gesendet, 30 Tage vor dem Jährlichen/Mehrjährigen Verlängerungsdatum.

Abgebrochen (gekündigte)

Abonnements erreichen diesen Status, nachdem eine explizite Kunden- oder CSP-Aktion ausgeführt wurde, um das Abonnement zu kündigen. Sie kündigen ein Abonnement von der Herausgeberwebsite, dem Azure-Portal oder dem Microsoft 365 Admin Center. Ein Abonnement wird auch implizit storniert, da das Ergebnis einer Nichtzahlung von Fälligkeiten und nach der Ausgesetzt Zustand für 30 Tage.

Nachdem der Herausgeber einen Abbruch-Webhook-Anruf erhalten hat, sollte er Kundendaten für die Wiederherstellung auf Anforderung mindestens sieben Tage aufbewahren. Nur dann können Kundendaten gelöscht werden.

Ein SaaS-Abonnement kann jederzeit in seinem Lebenszyklus storniert werden. Nachdem ein Abonnement gekündigt wurde, kann es nicht erneut aktiviert werden.

Stornierungs-E-Mails werden sowohl an den Käufer als auch an den Besitzer des Abrechnungskontos gesendet.

Verwandte Inhalte

Videolernprogramme