View a markdown version of this page

Microsoft SharePoint - Amazon Bedrock
支援的功能使用案例和必要的許可身分驗證方法先決條件如何設定 SharePoint 資料來源

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Microsoft SharePoint

Microsoft SharePoint 是一種協作式以 Web 為基礎服務，可用於文件、網頁、網站、清單等。您可以連接 SharePoint Online 執行個體做為受管知識庫的資料來源，以從一或多個 SharePoint 網站爬取檔案和頁面。

支援的功能

  • 從多個 SharePoint 網站爬取檔案和頁面

  • 自動偵測常見文件欄位 （例如標題、作者，以及建立或修改的日期）

  • 使用項目路徑和日期範圍包含內容篩選條件

  • 新增、更新和刪除內容的增量內容同步

  • Microsoft Entra ID 僅限應用程式和 OAuth 2.0 身分驗證

  • 文件層級存取控制 (ACLs)，使用 Microsoft Entra ID 僅應用程式身分驗證

使用案例和必要的許可

連接器所需的 Microsoft 許可取決於您的使用案例。除非您的使用案例為其呼叫，否則您不必授予廣泛的租用戶通用存取 — 連接器支援最低權限組態，這些組態只會限制對所選網站的存取。兩個選項決定您指派的許可：

  • 要抓取的網站 — 僅將存取權授予您明確選擇的網站 (Sites.Selected最低權限選項），或授予租用戶中的所有 SharePoint 網站 (所有網站)。

  • 是否啟用文件層級存取控制 (ACLs) — 決定資料來源是否依每個使用者的 SharePoint 許可篩選查詢結果。ACL 爬取需要額外的 Microsoft Graph 和 SharePoint 許可。

這些選擇會合併為四個常用案例。以下許可適用於建議的 Microsoft Entra ID 僅限應用程式身分驗證方法；僅授予針對您的使用案例列出的許可。連接器會驗證兩個 Microsoft 資源：Microsoft Graph （列舉網站，以及針對 ACLs 解析使用者和群組） 和 SharePoint REST API （讀取網站內容，以及針對 ACLs 的項目層級許可）。如需完整的設定程序，請參閱 設定 SharePoint 的 Microsoft Entra ID 僅限應用程式身分驗證。

選取使用案例的索引標籤，以查看要指派的確切 Microsoft Graph 和 SharePoint 許可。

Sites.Selected, no ACLs

當您只想抓取您選擇的特定網站，而不依每位使用者的 SharePoint 許可篩選查詢結果時，請使用此選項。這是最低權限組態。

Sites.Selected，僅限內容
API 權限 用途
Microsoft Graph Sites.Selected 僅存取您明確授予的網站 (Microsoft Graph)。
SharePoint Sites.Selected 僅存取您明確授予的網站 (SharePoint REST)。為每個網站授予 read角色。
Sites.Selected, with ACLs

當您只想抓取您選擇的特定網站，並依每位使用者的 SharePoint 許可篩選查詢結果時，請使用此選項。

Sites.Selected，具有 ACLs
API 權限 用途
Microsoft Graph Sites.Selected 僅存取您明確授予的網站 (Microsoft Graph)。
Microsoft Graph User.Read.All 解決文件層級 ACLs的使用者。
Microsoft Graph GroupMember.Read.All 解決文件層級 ACLs群組成員資格。
SharePoint Sites.Selected 僅存取您明確授予的網站。授予每個網站fullcontrol的角色 （讀取 ACLs的項目層級許可時需要）。
All sites, no ACLs

當您想要抓取租用戶中的所有 SharePoint 網站，而不依每個使用者的 SharePoint 許可篩選查詢結果時，請使用此選項。

所有網站，僅限內容
API 權限 用途
Microsoft Graph Sites.Read.All 列舉和讀取所有 SharePoint 網站。
SharePoint Sites.Read.All 透過 SharePoint REST API 讀取網站內容。
All sites, with ACLs

當您想要抓取租用戶中的所有 SharePoint 網站，並依每個使用者的 SharePoint 許可篩選查詢結果時，請使用此選項。

具有 ACLs 的所有網站
API 權限 用途
Microsoft Graph Sites.Read.All 列舉和讀取所有 SharePoint 網站。
Microsoft Graph User.Read.All 解決文件層級 ACLs的使用者。
Microsoft Graph GroupMember.Read.All 解決文件層級 ACLs群組成員資格。
SharePoint Sites.FullControl.All 讀取 ACL 爬取的項目層級許可，並在查詢時驗證存取權。 Sites.Read.All 不足以進行此檢查。
注意

Sites.FullControl.All 授予租用戶中每個網站的廣泛存取權。如果您的組織需要最低權限，請使用 Sites.Selected並授予每個站台的存取權。如需每個站台的授予步驟，請參閱 設定 SharePoint 的 Microsoft Entra ID 僅限應用程式身分驗證。

身分驗證方法

SharePoint 資料來源支援兩種身分驗證方法。在開始之前選擇一個，因為它會決定您建立的登入資料，以及您是否可以使用文件層級的存取控制。我們建議對新資料來源進行 Microsoft Entra ID 僅限應用程式身分驗證。

SharePoint 身分驗證方法
Method 如何進行身分驗證 使用情況 設定
Microsoft Entra ID 僅限應用程式 (ENTRA_ID_APP_ONLY) — 建議 Microsoft Entra 應用程式會使用憑證進行身分驗證。沒有使用者登入資料，也沒有互動式登入。 大多數資料來源，以及任何使用文件層級存取控制的資料來源。 設定 Entra ID 僅限應用程式身分驗證
OAuth 2.0 (OAUTH2_APP) 應用程式用戶端 ID 和秘密，以及 Microsoft 365 使用者帳戶的使用者名稱和密碼，該帳戶可存取您要抓取的網站 （資源擁有者密碼登入資料，或 ROPC，流程）。 只有在您無法使用 Microsoft Entra ID 僅限應用程式身分驗證時使用 。帳戶不得要求 MFA 或條件式存取。文件層級存取控制不支援。 設定 OAuth 2.0 身分驗證
重要

OAUTH2_APP 方法使用使用者名稱和密碼登入，因此無法完成多重要素驗證 (MFA) 挑戰或滿足需要的條件式存取政策。如果帳戶強制執行 MFA 或條件式存取，身分驗證會失敗，且資料來源無法同步。除非您有使用 的特定原因，否則請使用 Microsoft Entra ID 僅限應用程式身分驗證OAUTH2_APP。

先決條件

在 Microsoft SharePoint 中，請確定您：

  • 請注意您要抓取的 SharePoint URLs。每個 URL 都是爬蟲進入點，必須以 開頭https://並指向網站、團隊網站或個人網站，路徑必須以 /sites/、 或 開頭/teams/，/personal/後面接著網站名稱 （例如 https://yourdomain.sharepoint.com/sites/mysite)。同時支援標準*.sharepoint.com網域和自訂 （虛設） 網域。在每個網站中，連接器會編目檔案和頁面；您可以在連接資料來源時，使用項目路徑篩選條件將編目縮小到特定項目。

  • 複製您的 Microsoft 365 租用戶 ID。您可以在 Microsoft Entra 入口網站的「屬性」中找到您的租用戶 ID。如需詳細資訊，請參閱 Microsoft Learn 網站上的尋找您的 Microsoft 365 租用戶 ID。

在您的帳戶中 AWS ，請確定您：

如何設定 SharePoint 資料來源

設定 SharePoint 資料來源包含下列步驟：

  1. 設定身分驗證。請遵循所選方法的頁面，以註冊 Microsoft Entra 應用程式、設定許可，並將您的登入資料存放在 AWS： 設定 SharePoint 的 Microsoft Entra ID 僅限應用程式身分驗證或 設定 SharePoint 的 OAuth 2.0 身分驗證。

  2. 連接資料來源。使用 AWS Management Console 或 API 在知識庫中建立 SharePoint 資料來源。請參閱 連接 SharePoint 資料來源。

  3. （選用） 啟用文件層級存取控制。依每位使用者的 SharePoint 許可篩選查詢結果。請參閱 文件層級存取控制。

如果您在設定或同步期間遇到問題，請參閱 對 SharePoint 資料來源進行故障診斷。