Sdílet prostřednictvím


Běžné dotazy k rozhraním API pro plnění SaaS

Tento článek popisuje několik požadavků na integraci komerčního marketplace Microsoftu, které zákazníkům Azure umožní přihlásit se k odběru nabídek SaaS.

Prostředí zjišťování

Jakmile je nabídka SaaS publikovaná, můžou ji uživatelé Azure objevit na Azure Marketplace. Vaši zákazníci můžou filtrovat nabídky na základě typu produktu (SaaS) a zjišťovat služby SaaS, které mají zájem.

Prostředí nákupu

Jakmile se uživatel zajímá o konkrétní službu SaaS, uživatel se k ní může přihlásit z Azure Marketplace.

Co znamená, že se uživatel Azure přihlásí k odběru nabídky SaaS na Azure Marketplace?

To znamená, že uživatel může zobrazit podmínky použití a prohlášení o zásadách ochrany osobních údajů spojené se službou SaaS a odsouhlasit, že za něj platíte podle fakturačních podmínek, které vám na faktuře Microsoftu nastavil vydavatel nabídky SaaS. Uživatelé můžou pomocí svého stávajícího platebního profilu v Azure platit za spotřebu služeb SaaS.

Tato schopnost je užitečná několika způsoby. Zákazníci teď můžou zjišťovat a odebírat na jednom místě pomocí cloudové platformy Microsoftu jako důvěryhodného zdroje, aniž by museli používat každý nezávislý software dodavatele softwaru (ISV), který hodlá použít. Zákazníci také můžou používat svůj stávající platební profil, aniž by museli explicitně platit každý software nezávislého výrobce softwaru.

Účtuje se uživateli automaticky, když se nabídka přihlásí k odběru?

Při přihlášení k odběru nabídky SaaS se uživatel zavazuje platit za spotřebu služby SaaS prostřednictvím platformy Microsoft. Poplatky se ale spustí jenom v případě, že se nabídka spotřebuje. Uživatel musí přejít na vaši nabídku SaaS a potvrdit vytvoření účtu, aby nabídku začal využívat. Pak microsoftu oznámíte, že začnete s fakturací pro toto předplatné SaaS zákazníka.

Jak se zobrazí upozornění, když se uživatel přihlásí k odběru vaší nabídky SaaS?

Po přihlášení k odběru nabídky může uživatel Azure vyhledat a spravovat všechny své nabídky v Azure. Ve výchozím nastavení se stav nově odebírané nabídky SaaS zobrazuje jako zřizování a čeká na vyřízení. V tomto stavu se uživateli Azure zobrazí výzva k provedení akce Konfigurace účtu, aby mohl na webu Azure Portal přejít do prostředí správy předplatného SaaS.

Když uživatel vybere Konfigurovat účet, přesměruje se na web služby SaaS. Vydavatel nakonfiguroval adresu URL v době publikování nabídky. Tato stránka se označuje jako cílová stránka vydavatele. Uživatelé Azure se přihlásí k cílové stránce SaaS na základě svých stávajících přihlašovacích údajů Microsoft Entra v Azure.

Důležité

Musíte se přihlásit k uživateli nákupu pomocí Microsoft Entra ID, Jednotné přihlašování (SSO) podle zásad. mail Vlastnost prostředku uživatele načteného z rozhraní Microsoft Graph API vám poskytne kontaktní informace pro případ ID Microsoft Entra a userPrincipalName msa. Je možné, že pole "mail" je prázdné pro Microsoft Entra ID a uživatel nemusí mít e-mail zaznamenaný. Pokud ano, doporučujeme vám to zjistit a požádat o kontaktní e-mail. Toto je vaše jediná šance, že dostanete kontaktní e-mail pro kontaktování zákazníka během procesu onboardingu zákazníka nebo po tomto procesu.

Když se uživatel Azure přesměruje na cílovou stránku, přidá se do adresy URL dotazu token. Tento token je krátkodobý a platný po dobu 24 hodin. Pak můžete zjistit přítomnost tohoto tokenu a volat rozhraní Microsoft API, abyste získali další kontext přidružený k tokenu.

Tok předplatného zákazníka

Další informace o kontraktu rozhraní API pro zpracování transakčních scénářů v životním cyklu nabídky SaaS najdete v tématu Rozhraní API pro plnění SaaS.

Jak znáte nabídku SaaS, ke které se uživatel přihlásí k odběru v Azure?

Odpověď na Resolve rozhraní API zahrnuje informace o nabídce a plánu přidružené k předplatnému SaaS.

Jak může uživatel Azure změnit plán přidružený k tomuto předplatnému Azure?

  • Uživatel Azure může plán přidružený k předplatnému SaaS změnit přímo v prostředí SaaS nebo prostřednictvím platformy Microsoft.

  • Převody je možné provádět kdykoliv v fakturačním období. Zobrazí se výzva k potvrzení jakéhokoli převodu, který se stane efektivním po potvrzení.

  • Předplacené tarify (měsíční nebo roční) sazby jsou poměrné. Veškeré nadlimitní využití vygenerované až do doby převodu se budou účtovat na další faktuře. Nové nadlimitní využití se vygenerují na základě nového plánu.

Poznámka:

Downgrady můžete blokovat, pokud nechcete podporovat konkrétní cesty převodu.

Následující posloupnost zachycuje tok, když zákazník Azure změní plán v prostředí SaaS:

Tok změn plánu zákazníka

Následující posloupnost zachycuje tok, když zákazník Azure změní plán v online obchodě Microsoftu:

Tok změn plánu online obchodu zákazníka

Jak se může uživatel Azure odhlásit z plánu přidruženého k předplatnému Azure?

Uživatel Azure se může odhlásit od zakoupené nabídky SaaS buď přímo v prostředí SaaS, nebo prostřednictvím platformy Microsoft. Jakmile se uživatel odhlásí, už se mu nebude účtovat z dalšího fakturačního období.

Následující posloupnost zachycuje tok, když zákazník Azure zruší odběr nabídky SaaS v prostředí SaaS:

Zákazník se odhlásí v prostředí SaaS.

Následující posloupnost zachycuje tok, když se uživatel Azure odhlásí v online obchodě Microsoftu:

Zákazník se odhlásí v online obchodě Microsoftu.

Správa prostředí

IsV může spravovat předplatné SaaS zákazníka a měnit plány.

Aby byl plán úspěšně převeden na jiný plán v rámci stejné nabídky, mělo by být splněno všechny následující skutečnosti; Jinak nemusí volání rozhraní API pro plnění SaaS plánu změn fungovat:

  • Cílový plán by měl být aktivní.
  • Cílový plán by se měl podporovat v oblasti zákazníka.
  • Pokud je cílovým plánem soukromý plán, měl by se ID tenanta zákazníka přidat do plánu v Partnerském centru a před pokusem o změnu plán znovu publikovat.
  • Pokud je cílový plán součástí privátního marketplace, měl by zákazník plán před provedením změn povolit na svém privátním marketplace.
  • Pokud je pro zákazníky se smlouvou ENTERPRISE povolené nastavení BYOL (což znamená, že můžou nakupovat jenom bezplatné prostředky), neměl by cílový plán být placeným plánem.

Návody pro aplikaci Entra vytvořit instanční objekt?

Instanční objekt aplikace Entra je instance vaší registrace aplikace Entra, kterou vytvoříte pro vaši nabídku SaaS. Tento instanční objekt aplikace musí být vytvořen ve stejném tenantovi, který používáte v technické konfiguraci Partnerského centra. Tyto kroky vám můžou pomoct určit, jestli je vytvořený instanční objekt, a pokud ne, jak ho vytvořit.

Krok 1: Identifikace registrace aplikace

  1. Přejděte na každou nabídku SaaS v Partnerském centru.

  2. Přejděte na jeho stránku Technické konfigurace a poznamenejte si hodnotu ID aplikace Entra:

    Snímek obrazovky se stránkou Technické konfigurace v Partnerském centru Microsoftu

Krok 2: Zjistěte, jestli je instanční objekt vytvořen nebo ne.

Možnost 1: Použití webu Azure Portal

  1. Přejděte na stránku Registrace aplikací na webu Azure Portal a vyhledejte registraci aplikace s ID, které jste zkopírovali z Partnerského centra.

    Tip

    Možná budete muset místo "Vlastněné aplikace" přepnout na "Všechny aplikace", pokud jste nebyli tím, kdo vytváří registraci aplikace na prvním místě.

    Tip

    Název registrace aplikace končí na FulfillmentAppReg, pokud byl vytvořen pomocí skriptu nasazení SaaS Accelerator.

  2. Otevřete stránku Registrace aplikace. Pokud se zobrazí odkaz s názvem registrace aplikace (místo odkazu Vytvořit instanční objekt, jak je znázorněno na dalším snímku obrazovky), znamená to, že už máte vytvořený instanční objekt.

    Snímek obrazovky se stránkou Registrace aplikace

Možnost 2: Použití Azure CLI

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

Pokud se vytvoří instanční objekt, získáte accountEnabled hodnotu true (jak je znázorněno na tomto obrázku).

Snímek obrazovky s rozhraním příkazového řádku Azure s vytvořenými výsledky instančního objektu

Další informace o tomto příkazu Seznam instančních objektů najdete v příkazu az ad sp list.

Krok 3: Vytvoření a přidružení instančního objektu

Možnost 1: Použití webu Azure Portal

  1. Přejděte na stránku Registrace aplikací na webu Azure Portal a vyhledejte registraci aplikace s ID, které jste zkopírovali z Partnerského centra.

    Tip

    Možná budete muset místo "Vlastněné aplikace" přepnout na "Všechny aplikace", pokud jste nebyli tím, kdo vytváří registraci aplikace na prvním místě.

    Tip

    Název registrace aplikace končí na FulfillmentAppReg, pokud byl vytvořen pomocí skriptu nasazení SaaS Accelerator.

  2. Otevřete stránku Registrace aplikace a vyberte odkaz Vytvořit instanční objekt (jak je znázorněno na tomto snímku obrazovky).

    Snímek obrazovky se stránkou Registrace aplikace s odkazem Vytvořit instanční objekt

Možnost 2: Použití Azure CLI

az ad sp create --id <app_id>

Pokud se vytvoří instanční objekt, zobrazí accountEnabled se hodnota true (jak je znázorněno na tomto obrázku).

Snímek obrazovky s rozhraním příkazového řádku zobrazující vytvoření instančního objektu

Další informace o tomto příkazu create instančního objektu najdete v příkazu az ad sp create.