在合作夥伴中心設定 API 存取

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

本文將說明針對合作夥伴中心 SDK 進行開發所需的帳戶。本文也會說明如何建立整合沙箱帳戶，並在整合沙箱中進行測試。

注意

若要存取 API，您的租用戶必須是 CSP 租用戶，且您必須是 CSP Indirect Provider 或 CSP Direct Bill Partner。

帳戶定義

為了協助您整合和測試 API 整合，合作夥伴中心支援兩種帳戶：

此帳戶可讓您建立真實客戶的實際訂單。如果您在登入主要帳戶時進行任何變更或交易，請使用合作夥伴中心 SDK 或合作夥伴儀錶板 UI，它們將會被視為實際客戶的正式訂單。它們會反映在您的發票中，而您的公司負責支付發票費用。

此帳戶會用來測試程式碼，以及其與合作夥伴中心 API 的整合，然後再進行廣泛部署。登入整合沙箱帳戶時所進行的變更和交易，將會出現在您的發票中，不過，您不需要支付發票金額。發票 pdf 會有「請勿付款」的免責聲明。這是沙箱發票，不需要採取任何動作。

整合沙箱帳戶和主要帳戶會獨立運作，而且不會共用系統管理員帳戶、使用者帳戶、客戶、訂單、訂用帳戶或其他資料。

整合沙箱支援數量有限的客戶、訂單、訂用帳戶和授權等等的交易。

根據原則，整合沙箱帳戶僅供整合測試之用。

但預設中沒有整合沙箱帳戶。如果您打算使用合作夥伴中心 SDK，您必須自行建立一個整合沙箱帳戶。

本節將說明如何設定主要合作夥伴帳戶，以及合作夥伴中心 SDK 的整合沙箱帳戶。

使用全域系統管理員帳戶登入合作夥伴中心，然後選取 [設定（齒輪）。

注意

建立沙箱需要合作夥伴全域管理員使用其 onmicrosoft.com 網域別名登入合作夥伴中心（例如， alias@domain.onmicrosoft.com。如果使用者使用其自定義網域登入，沙箱建立將會失敗。
選取 [帳戶設定]，然後選取 [整合沙盒]。

注意

如果您沒有看到 [整合沙箱] 選項，可能是您沒有全域管理員帳戶。也有可能是您正在使用整合沙箱帳戶，而且已設定整合沙箱。
輸入整合沙箱管理帳戶的連絡人資訊。然後，選擇 [建立帳戶]。等候幾分鐘的時間，直到出現確認已建立帳戶的確認訊息。
查看確認訊息之後，請登出合作夥伴儀表板。
使用新的整合沙箱管理帳戶重新登入。請務必使用認證格式 username@domain ，以及您指定的密碼。
選擇 [整合沙盒] 頁面上的 [設定帳戶]，以完成沙盒帳戶設定。

帳戶設定好之後，您必須先啟用 API 存取，才能搭配使用合作夥伴中心 SDK 與整合沙箱。您必須針對主要夥伴帳戶和整合沙箱帳戶，分別啟用 API 的存取權。

您可以在整合沙箱中撰寫程式碼和測試程式碼。您需要下列資訊，才能使用 Microsoft Entra ID 設定合作夥伴中心驗證。

項目名稱	項目位置
應用程式識別碼/用戶端識別碼	從設定（齒輪），選取 [帳戶設定]，然後選取 [應用程式管理]。應用程式識別碼/用戶端識別碼會列為 [已註冊應用程式的應用程式識別碼]。
索引鍵	如果您已在啟用 API 存取一節中建立 Web 應用程式，這就是您在步驟 5 儲存的金鑰。
網域	整合沙箱的網域。

若要搭配實際的客戶資料來使用解決方案，您必須將整合沙箱認證變更為主要合作夥伴帳戶認證。

當您準備好在主要合作夥伴帳戶中使用測試過的程式碼時，您必須取得 Microsoft Entra 安全性令牌。此安全性令牌是以您的合作夥伴中心應用程式、金鑰和網域為基礎（而不是整合沙盒應用程式、金鑰和網域）。

請遵循合作夥伴中心驗證中的步驟，使用您的主要合作夥伴中心認證取得 Microsoft Entra 安全性令牌。（您先前已遵循這些步驟來取得整合沙盒的 Microsoft Entra 安全性令牌。
將程式碼中的整合安全性權杖取代為主要合作夥伴帳戶的新安全性權杖。