Dela via


Vanliga frågor om API:er för SaaS-uppfyllande

Den här artikeln beskriver flera av integreringskraven för Microsofts kommersiella marknadsplats så att Azure-kunder kan prenumerera på SaaS-erbjudanden.

Identifieringsupplevelse

När ett SaaS-erbjudande har publicerats kan Azure-användare identifiera det på Azure Marketplace. Dina kunder kan filtrera erbjudanden baserat på produkttyp (SaaS) och upptäcka de SaaS-tjänster som de är intresserade av.

Köpupplevelse

När en användare är intresserad av en specifik SaaS-tjänst kan användaren prenumerera på den från Azure Marketplace.

Vad innebär det att en Azure-användare prenumererar på ett SaaS-erbjudande på Azure Marketplace?

Det innebär att en användare kan visa användningsvillkoren och sekretesspolicyn som är associerade med SaaS-tjänsten och godkänna att betala för den enligt de faktureringsvillkor som angetts av dig, utgivaren av SaaS-erbjudandet, på Microsofts faktura. Användare kan använda sin befintliga betalningsprofil i Azure för att betala för SaaS-tjänstens förbrukning.

Den här möjligheten är fördelaktig på flera sätt. Kunder kan nu identifiera och prenumerera på ett ställe med Hjälp av Microsoft Cloud Platform som en betrodd källa, utan att behöva granska alla oberoende programvaruleverantörer (ISV) som de tänker använda. Dessutom kan kunderna använda sin befintliga betalningsprofil utan att uttryckligen behöva betala varje ISV-programvara oberoende av varandra.

Debiteras användaren automatiskt när erbjudandet prenumererar?

När du prenumererar på SaaS-erbjudandet samtycker användaren till att betala för användning av SaaS-tjänsten via Microsoft-plattformen. Avgifterna börjar dock bara när erbjudandet förbrukas. Användaren måste gå till ditt SaaS-erbjudande och bekräfta att kontot har skapats för att börja använda erbjudandet. Sedan meddelar du Microsoft att börja fakturera för den här saaS-kundprenumerationen.

Hur meddelas du när en användare prenumererar på ditt SaaS-erbjudande?

När du har prenumererat på ett erbjudande kan Azure-användaren identifiera och hantera alla sina erbjudanden i Azure. Som standard visas tillståndet för ett nyligen prenumererat SaaS-erbjudande som Etablering, slutförande väntar. I det här tillståndet uppmanas Azure-användaren att använda en åtgärd för att konfigurera konto för att bläddra till sin SaaS-prenumerationshantering i Azure-portalen.

När användaren väljer Konfigurera konto omdirigeras de till SaaS-tjänstens webbplats. Utgivaren konfigurerade URL:en vid tidpunkten för publiceringen av erbjudandet. Den här sidan kallas utgivarens landningssida. Azure-användare loggar in på SaaS-landningssidan baserat på deras befintliga Microsoft Entra-autentiseringsuppgifter i Azure.

Viktigt!

Du måste logga in den köpande användaren med hjälp av Microsoft Entra ID, Jedinstveno prijavljivanje (SSO) enligt principens anvisningar. Egenskapen mail för användarresursen som hämtas från Microsoft Graph API ger dig kontaktinformation för fallet med Microsoft Entra ID och userPrincipalName för MSA. Det är möjligt att fältet "e-post" är tomt för Microsoft Entra-ID och att användaren kanske inte har registrerat något e-postmeddelande. I så fall rekommenderar vi att du identifierar det och ber om ett e-postmeddelande med kontakt. Det här är din enda chans att få ett e-postmeddelande med kontakt för att nå en kund under eller efter kundens ombordstigningsprocess.

När Azure-användaren omdirigeras till landningssidan läggs en token till i fråge-URL:en. Denna token är kortlivad och giltig under en tidsperiod på 24 timmar. Du kan sedan identifiera förekomsten av den här token och anropa Microsoft API för att få mer kontext associerad med token.

Kundprenumerationsflöde

Mer information om API-kontraktet för hantering av transact-scenarier i livscykeln för ett SaaS-erbjudande finns i Api för SaaS-uppfyllande.

Hur känner du till SaaS-erbjudandet som användaren prenumererar på i Azure?

Svaret på API:et Resolve innehåller den erbjudande- och planinformation som är associerad med SaaS-prenumerationen.

Hur kan Azure-användaren ändra den plan som är associerad med den här Azure-prenumerationen?

  • Azure-användaren kan ändra planen som är associerad med SaaS-prenumerationen direkt i SaaS-upplevelsen eller via Microsoft-plattformen.

  • Konverteringar kan göras när som helst under faktureringsperioden. Du uppmanas att bekräfta alla konverteringar som träder i kraft vid bekräftelse.

  • Förbetalda planpriser (månads - eller årspriser) är proportionella. Eventuell överförbrukning som genereras fram till konverteringstiden debiteras i nästa faktura. Nya överförbrukningar genereras baserat på den nya planen.

Kommentar

Du kan blockera nedgraderingar om du inte vill stödja specifika konverteringssökvägar.

Sekvensen nedan samlar in flödet när en Azure-kund ändrar en plan i SaaS-upplevelsen:

Ändringsflöde för kundplan

Sekvensen nedan fångar flödet när en Azure-kund ändrar en plan i Microsofts onlinebutik:

Kundens ändringsflöde för onlinebutiksabonnemang

Hur kan Azure-användaren avbryta prenumerationen på den plan som är associerad med Azure-prenumerationen?

En Azure-användare kan avbryta prenumerationen på ett köpt SaaS-erbjudande antingen direkt i SaaS-upplevelsen eller via Microsoft-plattformen. När användaren har avslutat prenumerationen debiteras de inte längre från nästa faktureringsperiod.

Sekvensen nedan fångar flödet när en Azure-kund avregistrerar sig från SaaS-erbjudandet i SaaS-upplevelsen:

Kunden avregistrerar sig i SaaS-upplevelsen

Sekvensen nedan fångar flödet när Azure-användare avregistrerar prenumerationer i Microsofts onlinebutik:

Kunden avregistrerar sig i Microsofts onlinebutik

Hantera upplevelse

En ISV kan hantera SaaS-prenumerationen för sina kunder och ändra planer.

För att en plan ska kunna konverteras till en annan plan inom samma erbjudande bör allt följande vara sant. Annars kanske dina API-anrop för SaaS-uppfyllande av ändringsplanen inte fungerar:

  • Målplanen ska vara aktiv.
  • Målplanen bör stödjas i kundens region.
  • Om målplanen är en privat plan bör kundens klient-ID läggas till i planen i Partnercenter och publiceras igen innan du försöker genomföra ändringsplanen.
  • Om målplanen är en del av den privata marknadsplatsen bör kunden tillåtalistning av planen på den privata marknadsplatsen innan ändringsplanen är klar.
  • Om BYOL-inställningen är aktiverad för EA-kunder (vilket innebär att de bara kan köpa kostnadsfria resurser) bör målplanen inte vara en betald plan.

Hur skapar jag ett tjänsthuvudnamn för min Entra-app?

Tjänstens huvudnamn för Entra-appen är instansen av din Entra-appregistrering som du skapar för ditt SaaS-erbjudande. Den här apptjänstens huvudnamn måste skapas i samma klientorganisation som du använder i Den tekniska konfigurationen för Partnercenter. De här stegen kan hjälpa dig att avgöra om ett huvudnamn för tjänsten har skapats och om så inte är det, hur du skapar ett.

Steg 1: Identifiera appregistreringen.

  1. Gå till varje SaaS-erbjudande i Partnercenter.

  2. Gå till sidan "Teknisk konfiguration" och registrera värdet för "Entra-program-ID":

    Skärmbild av sidan Teknisk konfiguration i Microsoft PartnerCenter.

Steg 2: Avgör om tjänstens huvudnamn har skapats eller inte.

Alternativ 1: Använda Azure-portalen

  1. Gå till sidan Appregistreringar i Azure-portalen och leta reda på appregistreringen med det ID som du kopierade från Partnercenter.

    Dricks

    Du kan behöva växla till "Alla program" i stället för "Ägda program" om du inte skapade appregistreringen från början.

    Dricks

    Namnet på appregistreringen slutar med "FulfilmentAppReg" om det skapades med hjälp av Distributionsskriptet för SaaS Accelerator.

  2. Öppna sidan Appregistrering. Om du ser länken med appregistreringsnamnet (i stället för länken "Skapa tjänstens huvudnamn" som visas i nästa skärmbild) innebär det att du redan har skapat ett huvudnamn för tjänsten.

    Skärmbild av sidan Appregistrering.

Alternativ 2: Använda Azure CLI

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

Om tjänstens huvudnamn skapas blir accountEnabled du lika sann (som visas i den här bilden).

Skärmbild av Azure-kommandoradsgränssnittet med resultat som skapats av tjänstens huvudnamn.

Läs mer om det här kommandot för tjänstens huvudnamnslista i az ad sp-listan.

Steg 3: Skapa och associera ett huvudnamn för tjänsten

Alternativ 1: Använda Azure-portalen

  1. Gå till sidan Appregistreringar i Azure-portalen och leta reda på appregistreringen med det ID som du kopierade från Partnercenter.

    Dricks

    Du kan behöva växla till "Alla program" i stället för "Ägda program" om du inte skapade appregistreringen från början.

    Dricks

    Namnet på appregistreringen slutar med "FulfilmentAppReg" om det skapades med hjälp av Distributionsskriptet för SaaS Accelerator.

  2. Öppna sidan Appregistrering och välj länken "Skapa tjänstens huvudnamn" (som du ser i den här skärmbilden).

    Skärmbild av sidan Appregistrering med länken Skapa tjänstens huvudnamn framhävd.

Alternativ 2: Använda Azure CLI

az ad sp create --id <app_id>

Om tjänstens huvudnamn skapas visas accountEnabled det som sant (som visas i den här bilden).

Skärmbild av kommandoradsgränssnittet som visar att tjänstens huvudnamn har skapats.

Läs mer om det här kommandot för att skapa tjänstens huvudnamn az ad sp create.