為 API 型匯入設定資料來源與 Microsoft 365 組織資料服務之間的連線 (步驟 1/3)

若要開始將來源檔案的資料匯入 Microsoft 365 組織資料服務,全域系統管理員必須先在 Microsoft Entra 系統管理中心建立和註冊應用程式,並在 Microsoft 365 系統管理中心預配連線。 如果您使用憑證來驗證應用程式,資料來源系統管理員必須提供安全性憑證,以協助全域系統管理員註冊其應用程式。

方法如下。

注意事項

如果您是從 Workday 等外部來源傳送資料至 API 型連接器,請改為遵循 下列步驟 。

1. 在 Microsoft Entra 系統管理中心註冊新的應用程式

適用於:Microsoft 365 全域系統管理員

注意事項

如需在 Microsoft Entra 系統管理中心註冊應用程式的詳細資訊,請參閱快速入門:向 Microsoft 身分識別平台註冊應用程式。

  1. 從 Microsoft 系統管理中心的左側滑軌,選取 [ 所有系統管理中心]。 此選項會顯示為清單上的最後一個。

    顯示所有系統管理中心的螢幕擷取畫面。

  2. 選取 Microsoft Entra。

  3. 在左側的 [Entra ID] 底下,選取 [概觀]。

    顯示概觀按鈕的螢幕擷取畫面。

  4. 建立新的應用程式註冊:

    1. 在頂端工具列中,選取 [新增>應用程式註冊]。

      顯示如何新增應用程式註冊的螢幕擷取畫面。

    2. 在產生的畫面上:

      1. 為您的應用程式命名。

      2. 在 [支援的帳戶類型] 底下,保留第一個選項 [ 僅限此組織目錄中的帳戶] ([您的組織] - 單一租用戶) ]。

      3. 在畫面底部,選取 [ 註冊]。

        顯示如何註冊應用程式的螢幕擷取畫面。

    3. 當您回到 [ 概觀 ] 頁面時,請複製 應用程式 (用戶端) 識別碼 和目錄 (租用戶) 識別碼。 請將這些識別碼放在手邊。 您稍後需要提供這些設定。

      螢幕擷取畫面,顯示應用程式用戶端識別碼。

  5. 移除現有的 API 權限:

    1. 在左側,選取 API 權限。

    2. 針對每個列出的 API/權限 名稱,選取 API 右側的省略符號 (...) ,例如 Microsoft Graph。

    3. 選取 [移除權限]。

      顯示如何移除權限的螢幕擷取畫面。

    4. 確認移除。 移除這些項目的權限時,可確保應用程式僅具有所需的權限。

  6. (選擇性) 如果您想要手動新增必要的 API 權限,而非上述步驟 4 中自動新增:

    1. 選取 [新增權限]。 顯示如何新增 API 權限的螢幕擷取畫面。

    2. 選取 我的組織使用的 API。 顯示如何選取我的組織使用的 API 的螢幕擷取畫面。

    3. 搜尋「Microsoft 365 中的組織資料」,然後選取它。 顯示如何在 Microsoft 365 中搜尋組織資料的螢幕擷取畫面。

    4. 選取 應用程式權限。

    5. 在 [權限] 底下,選取 [API 連接器資料寫入器]。

    6. 選取 [新增權限]。

      顯示如何新增 API 權限的螢幕擷取畫面。

    7. 在 [設定的權限] 底下,選取 [授與系統管理員同意]。

  7. 為資料來源系統管理員提供應用程式識別碼和租用戶識別碼。

2. 如果使用憑證) ,請產生安全性憑證 (

適用於:組織資料來源系統管理員或 HRIS 來源系統管理員

請按照 以下指示建立憑證。 然後,將產生的憑證傳送給全域管理員。

3. 在 Microsoft Entra 系統管理中心之應用程式註冊中設定安全性憑證、秘密或同盟認證

適用於:Microsoft 365 全域系統管理員

僅使用下列三個選項的其中一個。

首先,瀏覽回您在 Microsoft Entra 系統管理中心中的應用程式註冊。 在左側的 Entra ID 下找到您的應用程序註冊。

顯示如何在 Microsoft Entra 系統管理中心找到應用程式註冊的螢幕擷取畫面。

使用憑證

  1. 在Microsoft Entra 系統管理中心的應用程式註冊中,在左側的 [管理] 底下,選取 [憑證 & 秘密]。

  2. 選取 [憑證],然後選取 [ 上傳憑證]。 顯示如何上傳憑證的螢幕擷取畫面。

  3. 上傳資料來源系統管理員提供給您的憑證,並新增 描述。 選取 新增。

    顯示如何上傳憑證並為其新增說明的螢幕擷取畫面。

使用用戶端密碼

  1. 在Microsoft Entra 系統管理中心的應用程式註冊中,在左側的 [管理] 底下,選取 [憑證 & 秘密]。

  2. 選取 [ 用戶端密碼],然後選取 [ 新增用戶端密碼]。

    顯示如何建立新用戶端密碼的螢幕擷取畫面。

  3. 輸入密碼的描述並設定到期日。 然後選取 [新增]。

    顯示如何輸入用戶端密碼描述的螢幕擷取畫面。

  4. 在 [憑證 & 密碼 ] 頁面上,選取複製圖示,將密碼複製到剪貼簿。 安全地儲存,以便日後設定匯入時使用。

    顯示如何複製用戶端密碼的螢幕擷取畫面。

使用同盟認證

您可以使用工作負載身分識別同盟來設定使用者指派的受控身分識別或 Microsoft Entra ID 中的應用程式註冊,以信任來自外部身分識別提供者的權杖。 這消除了手動管理憑證或密碼的維護負擔。

  1. 在Microsoft Entra 系統管理中心的應用程式註冊中,在左側的 [管理] 底下,選取 [憑證 & 秘密]。

  2. 選取 [ 同盟認證],然後選取 [ 新增認證]。

    顯示如何新增同盟認證的螢幕擷取畫面。

  3. 使用 此處的資源設定認證。

4.在 Microsoft 365 系統管理中心設定匯入

適用於:Microsoft 365 全域系統管理員或組織資料來源系統管理員

  1. 從 [Microsoft 365 組織資料服務] 頁面上的 [資料連線] 頁面開始匯入, ([首頁>設定>移轉] Microsoft[365 組織資料服務>資料連線]) 匯入>。

  2. 如果這是您第一次匯入資料) ,請選取 [ 開始 使用 (];如果您已經) 匯入資料,請選取 [ 新增匯入 (]。

  3. 在 [選取連線類型 ] 頁面上,選取 [啟動 API 型設定]。

  4. 選取您要共用資料的應用程式和服務。 根據預設,所有公用保留屬性都會在 Microsoft 365 和 Viva 應用程式和服務之間共用。 使用此頁面來選取要共用應用程式特定和自訂資料的應用程式。 您隨時可以在 [設定] 中變更選取項目。 深入了解。

  5. 準備 和設定 面板會列出完成連線的其餘步驟。 其中一些步驟,例如建立應用程式 ID,已使用上述流程完成。 您必須準備標頭 .csv 檔案,以將匯入的屬性對應至要與您共用資料的 App。 如果您還沒有此檔案的範本,請選取 [ 下載範本 ] 以開始使用。

  6. 在 [ 設定 API 型連線 ] 頁面上,選取 [ 應用程式識別碼],輸入連線名稱和應用程式註冊中的應用程式識別碼,然後選取 [ 立即佈建]。 第一次佈建連接器時,全域系統管理員必須完成此步驟。 佈建之後,系統會自動指派 API 連接器資料寫入器角色,您可以在 Microsoft Entra 系統管理中心看到它。

    • 如果您想要在將擷取的資料提供給下游應用程式之前,先檢閱所擷取資料品質的詳細資料,請選取 [開啟資料暫存]。 Learn how.
  7. 在 匯入屬性對應的標題 頁面上,上傳您在上一個步驟中建立的屬性對應 .csv 檔案。

    • 請確定 .csv 標頭檔中的標頭與您的 .csv 資料檔相符。 如果 .csv 標頭檔案中的欄位多於 .csv 資料檔案中的欄位,反之亦然,匯入處理將會失敗。
  8. 將您的保留屬性對應至匯入的資料。 這表示您會將 .csv 檔案中的屬性與與您共用資料之 App 的對應屬性進行比對。 任何與保留屬性 不 相符的匯入屬性都會做為自訂屬性,且無法重新命名。 深入了解。 若要自動對應資料欄位並跳過手動對應,請在 .csv 資料欄位標題中使用帶有 “Microsoft_” 前綴的保留屬性名稱,例如 Microsoft_PersonEmail。 查看保留屬性名稱的完整清單。

  9. 檢視用於所有 Microsoft 365 應用程式和服務的全域屬性。 這些是從您匯入的資料中提取的屬性,由所有符合條件的應用程式自動使用。 在頁面底部,選取 [下一步]。

  10. 在最後一頁,檢閱連線的所有詳細資料、應用程式和屬性對應。 如果一切正常,請選取 [連線]。

注意事項

如果您設定從來源系統定期匯出,您的資料將根據 Viva 和 Microsoft 365 服務需求進行驗證。 如果您尚未設定定期匯出,將會設定連接器,但資料不會提取到系統中進行驗證。 相反地,您會在 Microsoft 365 系統管理中心的資料連線索引標籤上看到「等候連線」狀態。 選取該連線表示資料來源系統管理員尚未設定定期匯出。 系統會提示您與他們聯繫以開始該過程。

您的組織資料會根據搭配 Viva 和 Microsoft 365 服務使用的需求進行驗證。 驗證需要幾個小時;不過,完整的資料上傳最多可能需要 3 天的時間,才能在設定檔存放區中使用。 您可以在系統管理中心的 [組織資料] 頁面上檢查驗證狀態。 驗證完成後,您會看到一則訊息,指出您的資料正由 Viva 和 Microsoft 365 使用和管理。 驗證完成後,組織資料就會提供給您選取的應用程式和服務。