轉介 API 驗證

適用於:合作夥伴中心

本文摘要說明如何設定使用者帳戶來產生使用者和應用程式令牌,以存取轉介 API。 如需深入瞭解,請參閱 合作夥伴 API 驗證

必要條件

Note

Microsoft 透過引入基於 Microsoft Entra 的 MFA 認證,強化 CSP 合作夥伴及控制面板供應商(CPV)的安全防護,以整合合作夥伴中心 API 整合。 欲了解更多資訊,請參閱 啟用安全應用模型 - 合作夥伴應用程式開發者。

此案例支援使用應用程式加上使用者的認證來進行驗證。 如需新驗證架構的概觀和詳細資料,請參閱 安全應用程式模型架構,其中涵蓋原則和最佳做法,讓 Marketplace 應用程式在安全性受損時具有可持續性和健全性。

產生新的使用者名稱/密碼或用戶端識別碼

若要產生新的使用者名稱/密碼或用戶端識別碼(Microsoft Entra ID),請使用下列步驟。

步驟 1:建立具有推薦角色的合作夥伴中心帳戶

  1. 使用系統管理員帳戶登入Partner Center,然後選取設定 (齒輪圖示)。

    顯示前往帳戶設定頁面步驟的圖表。

  2. 選取 [ 使用者管理],然後選取 [ 新增使用者 ] 按鈕。 從彈出式對話方塊中選取 建立新使用者,然後繼續。

    顯示建立新合作夥伴中心使用者帳戶步驟的圖表。

  3. 輸入使用者的 FirstName、LastNameUserName,以及選擇性的密碼復原電子郵件。

  4. 轉介角色:在同一頁面上,向下瀏覽並指派適當的轉介專屬合作夥伴角色 - 轉介管理員轉介使用者

    • 轉介管理員可以為所有相關合作夥伴據點建立、更新及檢視轉介資料。
    • 轉介使用者 只能檢視其轉介團隊中包含該使用者的轉介資料。

    顯示將轉介角色指派給合作夥伴中心使用者帳戶之步驟的圖表。

  5. 完成所有使用者詳細數據和角色指派之後,請選取 [ 儲存] 按鈕。 成功時,您會看到新的使用者名稱(用戶電子郵件或 upn)和產生的暫時密碼。

  6. 若要重設密碼並啟用您的帳戶,請複製這些登入資訊,然後登入 合作夥伴中心

步驟 2:設定用戶端應用程式 (Microsoft Entra ID)

  1. 使用系統管理員帳戶登入 Azure 入口網站

  2. 搜尋 「應用程式註冊」,然後選取 [+ 新增註冊] 按鈕。

  3. 輸入應用程式名稱(例如 合作夥伴中心存取應用程式),以及支援的帳戶類型為「單一租使用者」(或根據您的需求選擇)。

  4. 選取 註冊 按鈕,然後等待系統建立新的應用程式註冊項目。

  5. 應用程式註冊完成後,請找出用戶端識別碼,並建立用戶端密鑰,如下方示範所示:

    顯示用戶端識別碼和用戶端密碼選項的圖表。

    接下來,您必須將 API 許可權或委派 (Microsoft Partner) 新增至此用戶端應用程式,才能讓它產生合作夥伴中心 API 令牌。

  6. 選取 管理>API 權限,然後選取 +新增權限 按鈕。 在側邊面板中,選取 我的組織使用的 API 分頁。

    顯示如何將 API 權限新增到用戶端應用程式的圖表。

  7. 搜尋 API「Microsoft Partner」,然後選取應用程式(用戶端)識別碼開頭為 4990c* 的 API。 勾選 user_impersonation 核取方塊,然後選取 新增權限 按鈕。

    顯示如何將 Microsoft Partner API 權限新增至用戶端應用程式的示意圖。

    提示

    如果用「Microsoft Partner」搜尋找不到 4990c* 應用程式,試著用「Microsoft Dev Center」搜尋,或直接用完整的應用程式 ID 搜尋。

  8. 最後,用戶必須取得已新增許可權的管理員同意。 若要授與同意,系統管理員必須使用自己的帳戶登入,並流覽至應用程式。

    顯示如何取得 API 權限的系統管理員同意的圖表。