共用方式為


SaaS 履行 API 的常見問題

本文說明Microsoft商業市集的數個整合需求,讓 Azure 客戶訂閱 SaaS 供應專案。

探索體驗

發佈 SaaS 供應項目之後,Azure 用戶可以在 Azure Marketplace 中探索它。 您的客戶可以根據產品類型篩選供應專案(SaaS),並探索他們感興趣的 SaaS 服務。

購買體驗

一旦使用者對特定 SaaS 服務感興趣,使用者就可以從 Azure Marketplace 訂閱它。

Azure 使用者訂閱 Azure Marketplace 中的 SaaS 供應專案有何意義?

這表示使用者可以檢視與 SaaS 服務相關聯的使用規定和隱私聲明,並同意根據您、SaaS 供應專案的發行者、Microsoft發票上設定的帳單條款來支付費用。 用戶可以在 Azure 中使用其現有的付款配置檔來支付 SaaS 服務使用量的費用。

這種能力在數種方式中很有説明。 客戶現在可以使用Microsoft雲端平臺作為受信任的來源,在一個地方探索和訂閱,而不需要審查它想要使用的每個獨立軟體廠商 (ISV) 軟體。 此外,客戶可以使用其現有的付款配置檔,而不需要明確支付每個ISV軟體。

使用者是否在訂閱供應項目時自動收費?

訂閱 SaaS 供應專案時,使用者同意透過 Microsoft 平臺支付 SaaS 服務的使用量。 不過,只有在取用供應專案時,才會開始收費。 用戶必須移至您的 SaaS 供應專案,並確認帳戶建立以開始取用供應專案。 然後,您將通知Microsoft開始計費此客戶 SaaS 訂用帳戶。

當使用者訂閱 SaaS 供應專案時,如何收到通知?

訂閱供應項目之後,Azure 使用者可以探索及管理其在 Azure 中的所有供應專案。 根據預設,新訂閱 SaaS 供應專案的狀態會顯示為 布建、履行擱置中。 在此狀態下,系統會提示 Azure 使用者採取設定帳戶的動作,以流覽至 Azure 入口網站 中的 SaaS 訂用帳戶管理體驗。

當使用者選取 [ 設定帳戶] 時,系統會將他們重新導向至 SaaS 服務網站。 發行者在發佈供應項目時設定 URL。 此頁面稱為發行者的登陸頁面。 Azure 用戶會根據其在 Azure 中現有的Microsoft Entra 認證登入 SaaS 登陸頁面。

重要

您必須使用Microsoft Entra ID 登入購買使用者,單一登入 原則所指示的 [SSO]。 mail從 Microsoft Graph API 擷取的使用者資源屬性會提供您Microsoft Entra ID 和 userPrincipalName MSA 案例的連絡資訊。 Microsoft Entra ID 的 「mail」 欄位可能是空的,而且使用者可能沒有記錄電子郵件。 若是如此,建議您偵測到該電子郵件並要求連絡電子郵件。 這是您在客戶上線程式期間或之後取得連絡電子郵件以連絡客戶的唯一機會。

當 Azure 使用者重新導向至登陸頁面時,會將令牌新增至查詢 URL。 此令牌是短期的,且有效期為24小時。 然後,您可以偵測此令牌是否存在,並呼叫 Microsoft API,以取得與令牌相關聯的更多內容。

客戶訂用帳戶流程

如需在 SaaS 供應專案生命週期中處理交易案例的 API 合約詳細資訊,請參閱 SaaS 履行 API

如何知道使用者在 Azure 中訂閱的 SaaS 供應專案?

API 的 Resolve 回應包含與 SaaS 訂用帳戶相關聯的供應專案和方案資訊。

Azure 使用者如何變更與此 Azure 訂用帳戶相關聯的方案?

  • Azure 使用者可以直接在 SaaS 體驗中或透過 Microsoft 平台變更與 SaaS 訂用帳戶相關聯的方案。

  • 您可以在計費週期中隨時完成轉換。 系統會提示您確認任何轉換,這會在認可時生效。

  • 預付方案(每月年度)費率按比例計算。 下一張發票中將會收取最多轉換時間所發出的超額費用。 新的超額將根據新計劃發出。

注意

如果您不想支援特定的轉換路徑,您可以封鎖降級。

下列順序會在 Azure 客戶變更 SaaS 體驗中的方案時擷取流程:

客戶方案變更流程

當 Azure 客戶在Microsoft在線商店中變更方案時,下列順序會擷取流程:

客戶在線商店方案變更流程

Azure 使用者如何取消訂閱與 Azure 訂用帳戶相關聯的方案?

Azure 使用者可以直接在 SaaS 體驗中或透過 Microsoft 平臺取消訂閱已購買的 SaaS 供應專案。 一旦使用者取消訂閱,他們就不會再從下一個計費週期收取費用。

當 Azure 客戶取消訂閱 SaaS 體驗中的 SaaS 供應專案時,下列順序會擷取流程:

客戶取消訂閱 SaaS 體驗

下列順序會在 Azure 使用者取消訂閱Microsoft在線商店時擷取流程:

客戶取消訂閱Microsoft的在線商店

管理體驗

ISV 可以管理其客戶的 SaaS 訂用帳戶和變更方案。

若要讓方案成功轉換為相同供應專案內的不同方案,下列所有方案都應該成立;否則,您的變更方案 SaaS 履行 API 呼叫可能無法運作:

  • 目標計劃應為作用中。
  • 客戶區域應支持目標方案。
  • 如果目標方案是私人方案,則客戶租使用者標識碼應該新增至合作夥伴中心的方案,並在嘗試變更方案之前重新發佈。
  • 如果目標方案是私人市集的一部分,則客戶應該允許在私人市集中列出方案,再完成變更方案。
  • 對於EA客戶,如果已啟用 BYOL 設定(這表示他們只能購買免費資源),則目標方案不應該是付費方案。

如何? 為我的 Entra 應用程式建立服務主體嗎?

您的 Entra App Service 主體是您為 SaaS 供應專案建立的 Entra 應用程式註冊實例。 此 App Service 主體必須建立在您在合作夥伴中心技術設定中使用的相同租使用者中。 這些步驟可協助您判斷是否已建立服務主體,如果不是,則如何建立服務主體。

步驟 1:識別應用程式註冊。

  1. 流覽至合作夥伴中心中的每個 SaaS 供應專案。

  2. 瀏覽至其「技術設定頁面」,並記錄「專案應用程式識別碼」的值:

    Microsoft合作夥伴中心技術設定頁面的螢幕快照。

步驟 2:判斷服務主體是否已建立。

選項 1:使用 Azure 入口網站

  1. 流覽至 [Azure 入口網站 應用程式註冊] 頁面,並使用您從合作夥伴中心複製的標識碼尋找應用程式註冊。

    提示

    如果您不是第一個建立應用程式註冊的應用程式,您可能必須切換為「所有應用程式」,而不是「擁有的應用程式」。

    提示

    如果應用程式註冊名稱是使用 SaaS Accelerator 部署腳本建立,則應用程式註冊名稱會以 “AcceleratorReg” 結尾。

  2. 開啟 [應用程式註冊] 頁面。 如果您看到具有應用程式註冊名稱的連結(而不是下一個螢幕快照所示的「建立服務主體」連結),表示您已建立服務主體。

    [應用程式註冊] 頁面的螢幕快照。

選項 2:使用 Azure CLI

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

如果已建立服務主體,您將會取得 accountEnabled true (如下圖所示)。

Azure 命令行介面的螢幕快照,其中已建立服務主體的結果。

在 az ad sp list 中深入瞭解此服務主體清單命令

步驟 3:建立和關聯服務主體

選項 1:使用 Azure 入口網站

  1. 流覽至 [Azure 入口網站 應用程式註冊] 頁面,並使用您從合作夥伴中心複製的標識碼尋找應用程式註冊。

    提示

    如果您不是第一個建立應用程式註冊的應用程式,您可能必須切換為「所有應用程式」,而不是「擁有的應用程式」。

    提示

    如果應用程式註冊名稱是使用 SaaS Accelerator 部署腳本建立,則應用程式註冊名稱會以 “AcceleratorReg” 結尾。

  2. 開啟 [應用程式註冊] 頁面,然後選取 [建立服務主體] 連結(如此螢幕快照所示)。

    [應用程式註冊] 頁面的螢幕快照,其中已指出 [建立服務主體] 連結。

選項 2:使用 Azure CLI

az ad sp create --id <app_id>

如果已建立服務主體,您會看到 accountEnabledtrue (如下圖所示)。

命令行介面的螢幕快照,其中顯示已建立服務主體。

在 az ad sp create 上深入瞭解此服務主體 create 命令