Często zadawane pytania dotyczące interfejsów API realizacji SaaS

W tym artykule opisano kilka wymagań dotyczących integracji dla komercyjnej platformy handlowej firmy Microsoft, aby umożliwić klientom platformy Azure subskrybowanie ofert SaaS.

Środowisko odnajdywania

Po opublikowaniu oferty SaaS użytkownicy platformy Azure mogą ją odnajdywać w witrynie Azure Marketplace. Klienci mogą filtrować oferty na podstawie typu produktu (SaaS) i odnajdywać interesujące ich usługi SaaS.

Środowisko zakupu

Gdy użytkownik jest zainteresowany określoną usługą SaaS, może zasubskrybować go z witryny Azure Marketplace.

Co to oznacza, że użytkownik platformy Azure subskrybuje ofertę SaaS w witrynie Azure Marketplace?

Oznacza to, że użytkownik może wyświetlać warunki użytkowania i zasady zachowania poufności informacji skojarzone z usługą SaaS i zgadzać się na płacenie za nie zgodnie z warunkami rozliczeniowymi określonymi przez Ciebie, wydawcą oferty SaaS na fakturze firmy Microsoft. Użytkownicy mogą płacić za użycie usługi SaaS przy użyciu istniejącego profilu płatności na platformie Azure.

Ta zdolność jest korzystna na kilka sposobów. Klienci mogą teraz odnajdywać i subskrybować w jednym miejscu przy użyciu platformy Microsoft Cloud Platform jako zaufanego źródła, bez konieczności sprawdzania każdego niezależnego oprogramowania dostawcy oprogramowania, którego zamierza używać. Ponadto klienci mogą korzystać z istniejącego profilu płatności bez konieczności jawnego płacenia każdego oprogramowania niezależnego dostawcy oprogramowania.

Czy użytkownik jest naliczany automatycznie po zasubskrybowaniu oferty?

Gdy subskrybuje ofertę SaaS, użytkownik zgadza się zapłacić za użycie usługi SaaS za pośrednictwem platformy Microsoft. Jednak opłaty zaczynają się tylko wtedy, gdy oferta jest zużywana. Użytkownik musi przejść do oferty SaaS i potwierdzić tworzenie konta, aby rozpocząć korzystanie z oferty. Następnie powiadomisz firmę Microsoft o rozpoczęciu rozliczeń dla tej subskrypcji SaaS klienta.

Jak otrzymasz powiadomienie, gdy użytkownik subskrybuje ofertę SaaS?

Po zasubskrybowaniu oferty użytkownik platformy Azure może odnajdywać wszystkie oferty na platformie Azure i zarządzać nimi. Domyślnie stan nowo subskrybowanej oferty SaaS jest wyświetlany jako Aprowizowanie, oczekiwanie na realizację. W tym stanie użytkownik platformy Azure jest monitowany o wykonanie akcji Konfigurowania konta, aby przejść do środowiska zarządzania subskrypcjami SaaS w witrynie Azure Portal.

Gdy użytkownik wybierze pozycję Konfiguruj konto, nastąpi przekierowanie do witryny internetowej usługi SaaS. Wydawca skonfigurował adres URL w momencie publikowania oferty. Ta strona jest nazywana stroną docelową wydawcy. Użytkownicy platformy Azure logują się do strony docelowej SaaS na podstawie istniejących poświadczeń firmy Microsoft Entra na platformie Azure.

Ważne

Musisz zalogować się do kupującego użytkownika przy użyciu identyfikatora Microsoft Entra ID, Logowanie jednokrotne (SSO) zgodnie z zasadami. Właściwość mail zasobu użytkownika pobranego z interfejsu API programu Microsoft Graph udostępnia informacje kontaktowe dotyczące przypadku identyfikatora Entra firmy Microsoft i userPrincipalName usługi MSA. Możliwe, że pole "mail" jest puste dla identyfikatora Microsoft Entra ID, a użytkownik może nie mieć zarejestrowanej wiadomości e-mail. Jeśli tak, zalecamy wykrycie tego i prośbę o kontaktową wiadomość e-mail. Jest to jedyna szansa, aby skontaktować się z klientem w trakcie lub po zakończeniu procesu dołączania klienta.

Gdy użytkownik platformy Azure zostanie przekierowany do strony docelowej, token zostanie dodany do adresu URL zapytania. Ten token jest krótkotrwały i ważny przez czas trwania 24 godzin. Następnie można wykryć obecność tego tokenu i wywołać interfejs API firmy Microsoft, aby uzyskać więcej kontekstu skojarzonego z tokenem.

Przepływ subskrypcji klienta

Aby uzyskać więcej informacji na temat kontraktu interfejsu API do obsługi scenariuszy transakcji w cyklu życia oferty SaaS, zobacz Interfejs API realizacji SaaS.

Jak znać ofertę SaaS, do której użytkownik subskrybuje platformę Azure?

Odpowiedź na Resolve interfejs API zawiera informacje o ofercie i planie skojarzone z subskrypcją SaaS.

Jak użytkownik platformy Azure może zmienić plan skojarzony z tą subskrypcją platformy Azure?

  • Użytkownik platformy Azure może zmienić plan skojarzony z subskrypcją SaaS bezpośrednio w środowisku SaaS lub za pośrednictwem platformy Microsoft.

  • Konwersje można wykonać w dowolnym momencie w cyklu rozliczeniowym. Zostanie wyświetlony monit o potwierdzenie każdej konwersji, która stanie się skuteczna po potwierdzeniu.

  • Stawki przedpłacone (miesięczne lub roczne) są proporcjonalnie oceniane. Wszelkie nadwyżki emitowane do czasu konwersji będą naliczane na następnej fakturze. Nowe nadwyżki będą emitowane na podstawie nowego planu.

Uwaga

Możesz zablokować obniżenie poziomu, jeśli nie chcesz obsługiwać określonych ścieżek konwersji.

Poniższa sekwencja przechwytuje przepływ, gdy klient platformy Azure zmieni plan w środowisku SaaS:

Przepływ zmian planu klienta

Poniższa sekwencja przechwytuje przepływ, gdy klient platformy Azure zmieni plan w sklepie online firmy Microsoft:

Przepływ zmian planu sklepu online klienta

Jak użytkownik platformy Azure może anulować subskrypcję planu skojarzonego z subskrypcją platformy Azure?

Użytkownik platformy Azure może anulować subskrypcję zakupionej oferty SaaS bezpośrednio w środowisku SaaS lub za pośrednictwem platformy Microsoft. Po anulowaniu subskrypcji przez użytkownika opłaty nie będą już naliczane od następnego cyklu rozliczeniowego.

Poniższa sekwencja przechwytuje przepływ, gdy klient platformy Azure anuluje subskrypcję oferty SaaS w środowisku SaaS:

Klient anuluje subskrypcję środowiska SaaS

Poniższa sekwencja przechwytuje przepływ, gdy użytkownik platformy Azure anuluje subskrypcję w sklepie online firmy Microsoft:

Klient anuluje subskrypcję w sklepie online firmy Microsoft

Zarządzanie środowiskiem

Niezależnego dostawcy oprogramowania może zarządzać subskrypcją SaaS swoich klientów i planami zmian.

Aby plan pomyślnie przekonwertować na inny plan w ramach tej samej oferty, wszystkie poniższe elementy powinny mieć wartość true; W przeciwnym razie wywołania interfejsu API realizacji SaaS planu zmian mogą nie działać:

  • Plan docelowy powinien być aktywny.
  • Plan docelowy powinien być obsługiwany w regionie klienta.
  • Jeśli plan docelowy jest planem prywatnym, identyfikator dzierżawy klienta powinien zostać dodany do planu w Centrum partnerskim i ponownie opublikowany przed podjęciem próby zmiany planu.
  • Jeśli plan docelowy jest częścią prywatnej platformy handlowej, klient powinien zezwolić na listę planu na prywatnej platformie handlowej przed wykonaniem planu zmiany.
  • W przypadku klientów z umową EA, jeśli ustawienie BYOL jest włączone (co oznacza, że mogą kupować tylko bezpłatne zasoby), plan docelowy nie powinien być planem płatnym.

Jak mogę utworzyć jednostkę usługi dla mojej aplikacji Entra?

Jednostka usługi Aplikacji Entra to wystąpienie rejestracji aplikacji Entra utworzonej dla oferty SaaS. Ta jednostka usługi app Service musi zostać utworzona w tej samej dzierżawie, która jest używana w konfiguracji technicznej Centrum partnerskiego. Te kroki mogą pomóc w ustaleniu, czy jednostka usługi została utworzona, a jeśli nie, to jak ją utworzyć.

Krok 1. Identyfikowanie rejestracji aplikacji.

  1. Przejdź do każdej oferty SaaS w Centrum partnerskim.

  2. Przejdź do strony "Strona konfiguracji technicznej" i zarejestruj wartość "Identyfikator aplikacji Entra":

    Zrzut ekranu przedstawiający stronę konfiguracji technicznej Centrum partnerskiego firmy Microsoft.

Krok 2. Określenie, czy jednostka usługi została utworzona, czy nie.

Opcja 1. Korzystanie z witryny Azure Portal

  1. Przejdź do strony Rejestracje aplikacji w witrynie Azure Portal i znajdź rejestrację aplikacji przy użyciu identyfikatora skopiowanego z Centrum partnerskiego.

    Napiwek

    Może być konieczne przełączenie się na "Wszystkie aplikacje" zamiast "Aplikacje należące" w przypadku, gdy nie utworzono rejestracji aplikacji w pierwszej kolejności.

    Napiwek

    Nazwa rejestracji aplikacji kończy się ciągiem "FulfillmentAppReg", jeśli został utworzony przy użyciu skryptu wdrażania akceleratora SaaS.

  2. Otwórz stronę Rejestracja aplikacji. Jeśli zostanie wyświetlony link z nazwą rejestracji aplikacji (zamiast linku "Utwórz jednostkę usługi", jak pokazano na następnym zrzucie ekranu), oznacza to, że masz już utworzoną jednostkę usługi.

    Zrzut ekranu przedstawiający stronę Rejestracja aplikacji.

Opcja 2. Korzystanie z interfejsu wiersza polecenia platformy Azure

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

Jeśli jednostka usługi zostanie utworzona, otrzymasz accountEnabled wartość true (jak pokazano na tej ilustracji).

Zrzut ekranu przedstawiający interfejs wiersza polecenia platformy Azure z utworzoną jednostką usługi.

Dowiedz się więcej o tym poleceniu listy jednostki usługi na stronie az ad sp list.

Krok 3. Tworzenie i kojarzenie jednostki usługi

Opcja 1. Korzystanie z witryny Azure Portal

  1. Przejdź do strony Rejestracje aplikacji w witrynie Azure Portal i znajdź rejestrację aplikacji przy użyciu identyfikatora skopiowanego z Centrum partnerskiego.

    Napiwek

    Może być konieczne przełączenie się na "Wszystkie aplikacje" zamiast "Aplikacje należące" w przypadku, gdy nie utworzono rejestracji aplikacji w pierwszej kolejności.

    Napiwek

    Nazwa rejestracji aplikacji kończy się ciągiem "FulfillmentAppReg", jeśli został utworzony przy użyciu skryptu wdrażania akceleratora SaaS.

  2. Otwórz stronę Rejestracja aplikacji i wybierz link "Utwórz jednostkę usługi" (jak pokazano na tym zrzucie ekranu).

    Zrzut ekranu przedstawiający stronę Rejestracja aplikacji z wywołanym linkiem Tworzenie jednostki usługi.

Opcja 2. Korzystanie z interfejsu wiersza polecenia platformy Azure

az ad sp create --id <app_id>

Jeśli jednostka usługi zostanie utworzona, zobaczysz accountEnabled wartość true (jak pokazano na tej ilustracji).

Zrzut ekranu przedstawiający interfejs wiersza polecenia przedstawiający tworzenie jednostki usługi.

Dowiedz się więcej o tym poleceniu tworzenia jednostki usługi na stronie az ad sp create.