SharePoint 連接器 V1.0

SharePoint 是一種協作網站建置服務，可用來自訂 Web 內容和建立頁面、網站、文件程式庫和清單。如果您是 SharePoint 使用者，您可以使用 Amazon Kendra為 SharePoint 資料來源編製索引。

注意

SharePoint 連接器 V1.0 / SharePointConfiguration API 已於 2023 年結束。我們建議您遷移至或使用 SharePoint 連接器 V2.0 / TemplateConfiguration API。

如需對Amazon KendraSharePoint 資料來源連接器進行故障診斷，請參閱對資料來源進行故障診斷。

支援的功能

欄位對應
使用者存取控制
包含/排除篩選條件
變更日誌
虛擬私有雲端 (VPC)

先決條件

在您可以使用 Amazon Kendra為 SharePoint 資料來源編製索引之前，請在 SharePoint 和AWS帳戶中進行這些變更。

您必須提供身分驗證憑證，才能安全地存放在AWS Secrets Manager秘密中。

注意

建議定期更新或輪換憑證與機密。僅授予作業所需的最低存取層級，以確保自身安全。我們不建議您在資料來源和連接器版本 1.0 和 2.0 （如適用）之間重複使用登入資料和秘密。

在 SharePoint 中，請確定您有：

記下您要編製索引之 SharePoint 網站的 URL。
對於 SharePoint Online：
- 記下您的基本身分驗證憑證，其中包含具有網站管理員許可的使用者名稱和密碼。
- 選用：產生的 OAuth 2.0 登入資料，其中包含使用者名稱、密碼、用戶端 ID 和用戶端秘密。
- 使用管理員帳號在 Azure 入口網站停用安全預設值。如需在 Azure 入口網站中管理安全預設設定的詳細資訊，請參閱 Microsoft 文件以了解如何啟用/停用安全預設值。
針對 SharePoint Server：
- 記下您的 SharePoint Server 網域名稱 (Active Directory 中的 NetBIOS 名稱）。您可以使用它，以及 SharePoint 基本身分驗證使用者名稱和密碼來連接 SharePoint ServerAmazon Kendra。
注意
如果您使用 SharePoint Server 且需要將存取控制清單 (ACL) 轉換為電子郵件格式，以根據使用者內容進行篩選，請提供 LDAP 伺服器 URL 和 LDAP 搜尋基礎。或者，您可以使用目錄網域覆寫。LDAP 伺服器 URL 是完整的網域名稱和連接埠號碼（例如 ldap：//example.com：389)。LDAP 搜尋基礎是網域控制站 'example' 和 'com'。透過目錄網域覆寫，您可以使用電子郵件網域，而不是使用 LDAP 伺服器 URL 和 LDAP 搜尋基礎。例如，username@example.com 的電子郵件網域是 'example.com'。如果您不關心驗證您的網域，只想使用您的電子郵件網域，則可以使用此覆寫。
已將下列許可新增至您的 SharePoint 帳戶：

針對 SharePoint 清單
- 開啟項目 - 使用伺服器端檔案處理常式檢視文件的來源。
- 檢視應用程式頁面 - 檢視表單、檢視和應用程式頁面。列舉清單。
- 檢視項目 - 檢視清單中的項目和文件程式庫中的文件。
- 檢視版本 - 檢視清單項目或文件的過去版本。
對於 SharePoint 網站
- 瀏覽目錄 - 使用 SharePoint Designer 和 Web DAV 介面列舉網站中的檔案和資料夾。
- 瀏覽使用者資訊 - 檢視有關網站使用者的資訊。
- 列舉許可 - 列舉網站、清單、資料夾、文件或清單項目的許可。
- 開啟 - 開啟網站、清單或資料夾以存取容器內的項目。
- 使用用戶端整合功能 - 使用 SOAP、WebDAV、用戶端物件模型或 SharePoint Designer 介面存取網站。
- 使用遠端界面 - 使用啟動用戶端應用程式的功能。
- 檢視頁面 - 檢視網站上的頁面。
已檢查每個文件在 SharePoint 中以及您計劃用於相同索引的其他資料來源中都是唯一的。您要用於索引的每個資料來源不得包含跨資料來源的相同文件。文件 IDs是索引的全域 ID，且每個索引必須是唯一的。

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

建立Amazon Kendra索引，如果使用 API，會記下索引 ID。
為您的資料來源建立 IAM角色，如果使用 API，會記下IAM角色的 ARN。

注意
如果您變更身分驗證類型和登入資料，則必須更新您的IAM角色以存取正確的AWS Secrets Manager秘密 ID。
將您的 SharePoint 身分驗證登入資料存放在AWS Secrets Manager秘密中，如果使用 API，會記下秘密的 ARN。

注意
建議定期更新或輪換憑證與機密。僅授予作業所需的最低存取層級，以確保自身安全。我們不建議您在資料來源以及連接器 1.0 和 2.0 版（如適用）之間重複使用登入資料和秘密。

如果您沒有現有的IAM角色或秘密，則可以在將 SharePoint 資料來源連線到時，使用主控台建立新的IAM角色和Secrets Manager秘密Amazon Kendra。如果您使用 API，則必須提供現有IAM角色和Secrets Manager秘密的 ARN，以及索引 ID。

連線指示

若要Amazon Kendra連線至 SharePoint 資料來源，您必須提供 SharePoint 登入資料的詳細資訊，Amazon Kendra 才能存取您的資料。如果您尚未為設定 SharePoint，Amazon Kendra請參閱先決條件。

Console

Amazon Kendra連線至 SharePoint

登入 AWS管理主控台並開啟Amazon Kendra主控台。
從左側導覽窗格中，選擇索引，然後從索引清單中選擇您要使用的索引。

注意
您可以選擇在索引設定下設定或編輯使用者存取控制設定。
在入門頁面上，選擇新增資料來源。
在新增資料來源頁面上，選擇 SharePoint 連接器 v1.0，然後選擇新增資料來源。
在指定資料來源詳細資訊頁面上，輸入下列資訊：
1. 在名稱和描述中，針對資料來源名稱 - 輸入資料來源的名稱。您可以包含連字號，但不能包含空格。
2. （選用）描述 — 輸入資料來源的選用描述。
3. 在預設語言 - 選擇語言來篩選索引的文件。除非您另有指定，否則語言預設為英文。文件中繼資料中指定的語言會覆寫選取的語言。
4. 在標籤中，針對新增標籤 - 包含選用標籤，以搜尋和篩選您的資源或追蹤您的AWS成本。
5. 選擇下一步。
在定義存取和安全性頁面上，輸入下列資訊：
1. 對於託管方法 - 在 SharePoint Online 和 SharePoint Server 之間進行選擇。
  1. 針對 SharePoint Online - 輸入 SharePoint 儲存庫特定的網站 URLs。
  2. 對於 SharePoint Server—選擇您的 SharePoint 版本，輸入 SharePoint 儲存庫特定的網站 URLs，然後輸入 SSL 憑證位置的Amazon S3路徑。
2. （僅限 SharePoint 伺服器）針對 Web 代理—輸入內部 SharePoint 執行個體的主機名稱和連接埠號碼。連接埠號碼應為 0 至 65535 的數值。
3. 對於身分驗證 - 根據您的使用案例，在下列選項之間進行選擇：
  1. 對於 SharePoint Online - 在基本身分驗證和 OAuth 2.0 身分驗證之間進行選擇。
  2. 針對 SharePoint Server：選擇無、LDAP 和手動。
4. 對於AWSSecrets Manager秘密 - 選擇現有的秘密或建立新的Secrets Manager秘密，以存放您的 SharePoint 身分驗證登入資料。如果您選擇建立新的秘密，則會AWS開啟Secrets Manager秘密視窗。您必須輸入秘密名稱。字首「AmazonKendra-SharePoint-」會自動新增至您的秘密名稱。
5. 在建立AWSSecrets Manager秘密視窗中輸入下列其他資訊：
  1. 根據您的使用案例，從下列 SharePoint Cloud 身分驗證選項中選擇：
    1. 基本身分驗證 - 將 SharePoint 帳戶使用者名稱輸入為使用者名稱，將 SharePoint 帳戶密碼輸入為密碼。
    2. OAuth 2.0 身分驗證 - 將 SharePoint 帳戶使用者名稱輸入為使用者名稱、將 SharePoint 帳戶密碼輸入為密碼、將自動產生的唯一 SharePoint ID 輸入為用戶端 ID，以及將 SharePoint 和使用的共用秘密字串Amazon Kendra輸入為用戶端秘密。
  2. 根據您的使用案例，從下列 SharePoint Server 身分驗證選項中選擇：
    1. 無 - 輸入您的 SharePoint 帳戶使用者名稱做為使用者名稱、您的 SharePoint 帳戶密碼做為密碼，以及您的伺服器網域名稱。
    2. LDAP — 將 SharePoint 帳戶使用者名稱輸入為使用者名稱、將 SharePoint 帳戶密碼輸入為密碼、LDAP 伺服器端點 （包括通訊協定和連接埠號碼，例如 ldap：//example.com：389)，以及 LDAP 搜尋基礎 （例如，dc=example， dc=com)。
    3. 手動—將您的 SharePoint 帳戶使用者名稱輸入為使用者名稱、您的 SharePoint 帳戶密碼輸入為密碼，以及您的電子郵件網域覆寫 （目錄使用者或群組的電子郵件網域）。
  3. 選擇儲存。
6. Virtual Private Cloud (VPC) — 您還必須新增子網路和 VPC 安全群組。
  
  注意
  如果您使用 SharePoint Server. Amazon VPC是其他 SharePoint 版本的選用版本，則必須使用 VPC。
7. IAMrole - 選擇現有IAM角色或建立新的IAM角色，以存取您的儲存庫登入資料和索引內容。
  
  注意
  IAM用於索引的角色無法用於資料來源。如果您不確定現有角色是否用於索引或常見問答集，請選擇建立新角色以避免錯誤。
8. 選擇下一步。
在設定同步設定頁面上，輸入下列資訊：
1. 使用變更日誌 - 選取以更新索引，而不是同步所有檔案。
2. 編目附件 — 選取以編目附件。
3. 使用本機群組映射 - 選取以確保文件已正確篩選。
4. 其他組態 - 新增規則表達式模式，以包含或排除特定檔案。最多可新增 100 個模式。
5. 在頻率的同步執行排程中 - 與您的資料來源Amazon Kendra同步的頻率。
6. 選擇下一步。
在設定欄位映射頁面上，輸入下列資訊：
1. Amazon Kendra預設欄位映射 - 從您要映射至索引Amazon Kendra的產生預設資料來源欄位中選取。
2. 對於自訂欄位映射 - 新增自訂資料來源欄位，以建立要映射的索引欄位名稱和欄位資料類型。
3. 選擇下一步。
在檢閱和建立頁面上，檢查您輸入的資訊是否正確，然後選取新增資料來源。您也可以選擇從此頁面編輯您的資訊。成功新增資料來源後，您的資料來源將顯示在資料來源頁面上。

API

Amazon Kendra連線至 SharePoint

您必須使用 SharePointConfiguration API 指定下列項目：

SharePoint 版本 - 指定您在設定 SharePoint 時使用的 SharePoint 版本。無論您使用 SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019 或 SharePoint Online，都是如此。
機密 Amazon Resource Name (ARN) — 提供Secrets Manager機密的 Amazon Resource Name (ARN)，其中包含您在 SharePoint 帳戶中建立的身分驗證憑證。機密存放在 JSON 結構中。

對於 SharePoint Online 基本身分驗證，以下是您的秘密中必須具有的最低 JSON 結構：
```
{
    "userName": "user name",
    "password": "password"
}
```
對於 SharePoint Online OAuth 2.0 身分驗證，以下是您的秘密中必須具有的最低 JSON 結構：
```
{
    "userName": "SharePoint account user name"",
    "password": "SharePoint account password",
    "clientId": "SharePoint auto-generated unique client id",
    "clientSecret": "secret string shared byAmazon Kendraand SharePoint to authorize communications"
}
```
對於 SharePoint Server 基本身分驗證，以下是您的秘密中必須具有的最低 JSON 結構：
```
{
    "userName": "user name",
    "password": "password",
    "domain": "server domain name"
}
```
對於 SharePoint Server LDAP 身分驗證 （如果您需要將存取控制清單 (ACL) 轉換為電子郵件格式，以根據使用者內容進行篩選，您可以在秘密中包含 LDAP 伺服器 URL 和 LDAP 搜尋基礎），以下是必須在秘密中的最低 JSON 結構：
```
{
    "userName": "user name",
    "password": "password",
    "domain": "server domain name"
    "ldapServerUrl": "ldap://example.com:389",
    "ldapSearchBase": "dc=example,dc=com"
}
```
對於 SharePoint Server 手動身分驗證，以下是您的秘密中必須具有的最低 JSON 結構：
```
{
    "userName": "user name",
    "password": "password",
    "domain": "server domain name",
    "emailDomainOverride": "example.com"
}
```
IAMrole—指定RoleArn您何時呼叫 CreateDataSource 以提供IAM角色存取Secrets Manager秘密的許可，以及呼叫 SharePoint 連接器所需的公有 APIs 和 Amazon Kendra。如需詳細資訊，請參閱 IAM SharePoint 資料來源的角色。
Amazon VPC- 如果您使用 SharePoint Server，請在資料來源組態VpcConfiguration中指定。請參閱設定 Amazon Kendra以使用 VPC。

您也可以新增下列選用功能：

Web 代理 — 是否透過 Web 代理連線至 SharePoint URLs。您只能將此選項用於 SharePoint Server。
索引清單 - 是否Amazon Kendra應該將附件的內容索引至 SharePoint 清單項目。
變更日誌 - 是否Amazon Kendra應使用 SharePoint 資料來源變更日誌機制來判斷是否必須在索引中更新文件。

注意
如果您不想Amazon Kendra掃描所有文件，請使用變更日誌。如果您的變更日誌很大，掃描 SharePoint 資料來源中的文件所需的時間可能比處理變更日誌Amazon Kendra更短。如果您是第一次將 SharePoint 資料來源與索引同步，則會掃描所有文件。
包含和排除篩選條件 - 您可以指定是否包含或排除特定內容。

注意
大多數資料來源使用規則表達式模式，作為包含或排除的篩選規則，稱為篩選條件。若您設定包含篩選條件，則只有符合該條件的內容會被編列索引。任何不符合包含篩選條件的文件都不會編製索引。如果您指定包含和排除篩選條件，則符合排除篩選條件的文件不會編製索引，即使它們符合包含篩選條件。
欄位映射 - 選擇將 SharePoint 資料來源欄位映射至您的Amazon Kendra索引欄位。如需詳細資訊，請參閱映射資料來源欄位。

注意
需要文件內文欄位或文件內文對等項目， Amazon Kendra才能搜尋您的文件。您必須將資料來源中的文件內文欄位名稱映射至索引欄位名稱 _document_body。所有其他欄位是選用的。
使用者內容篩選和存取控制 —Amazon Kendra 如果您有文件的 ACL，會為您的文件編目存取控制清單 (ACL)。ACL 資訊用於根據使用者或其群組對文件的存取來篩選搜尋結果。如需詳細資訊，請參閱使用者內容篩選。

進一步了解

若要進一步了解如何Amazon Kendra整合 SharePoint 資料來源，請參閱：

開始使用Amazon KendraSharePoint Online 連接器

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Microsoft SharePoint

SharePoint 連接器 V2.0