本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Microsoft Exchange
Microsoft Exchange 是用於傳訊、會議和檔案共用的企業協作工具。如果您是 Microsoft Exchange 使用者,您可以使用 Amazon Kendra為 Microsoft Exchange 資料來源編製索引。
您可以使用 Amazon Kendra主控台和 TemplateConfiguration API Amazon Kendra連線到 Microsoft Exchange 資料來源。
如需對 Amazon KendraMicrosoft Exchange 資料來源連接器進行故障診斷,請參閱 對資料來源進行故障診斷。
支援的功能
-
欄位對應
-
使用者存取控制
-
包含/排除篩選條件
-
完整和增量內容同步
-
虛擬私有雲端 (VPC)
先決條件
在您可以使用 Amazon Kendra為 Microsoft Exchange 資料來源編製索引之前,請在 Microsoft Exchange 和帳戶中進行這些變更AWS。
在 Microsoft Exchange 中,請確定您有:
-
在 Office 365 中建立 Microsoft Exchange 帳戶。
-
記下您的 Microsoft 365 租用戶 ID。您可以在 Azure Active Directory 入口網站的 屬性或 OAuth 應用程式中找到租用戶 ID。
-
在 Azure 入口網站中設定 OAuth 應用程式,並記下用戶端 ID 和用戶端秘密或用戶端登入資料。如需詳細資訊,請參閱 Microsoft 教學課程和註冊應用程式範例。
當您在 Azure 入口網站中建立或註冊應用程式時,秘密 ID 代表實際的秘密值。建立秘密和應用程式時,您必須立即記下或儲存實際的秘密值。您可以在 Azure 入口網站中選取應用程式的名稱,然後導覽至憑證和秘密上的選單選項,以存取您的秘密。
您可以在 Azure 入口網站中選取應用程式的名稱,然後導覽至概觀頁面,以存取您的用戶端 ID。應用程式 (用戶端) ID 是用戶端 ID。
建議定期更新或輪換憑證與機密。僅授予作業所需的最低存取層級,以確保自身安全。我們不建議您在資料來源以及連接器 1.0 和 2.0 版 (如適用) 之間重複使用登入資料和秘密。
-
已為連接器應用程式新增下列許可:
| Microsoft Graph |
Office 365 Exchange Online |
-
Mail.Read (應用程式)
-
Mail.ReadBasic (應用程式)
-
Mail.ReadBasic.All (應用程式)
-
Calendars.Read (應用程式)
-
User.Read.All (應用程式)
-
Contacts.Read (應用程式)
-
Notes.Read.All (應用程式)
-
Directory.Read.All (應用程式)
-
EWS.AccessAsUser.All (已委派)
|
full_access_as_app (應用程式) |
-
已檢查每個文件在 Microsoft Exchange 和您計劃用於相同索引的其他資料來源中都是唯一的。您要用於索引的每個資料來源不得包含跨資料來源的相同文件。文件 IDs是索引的全域 ID,且每個索引必須是唯一的。
在您的 中AWS 帳戶,請確定您有:
-
建立Amazon Kendra索引,如果使用 API, 會記下索引 ID。
-
為您的資料來源建立 IAM角色,如果使用 API, 會記下IAM角色的 ARN。
如果您變更身分驗證類型和登入資料,則必須更新您的IAM角色以存取正確的AWS Secrets Manager秘密 ID。
-
將您的 Microsoft Exchange 身分驗證登入資料存放在AWS Secrets Manager秘密中,如果使用 API, 會記下秘密的 ARN。
建議定期更新或輪換憑證與機密。僅授予作業所需的最低存取層級,以確保自身安全。我們不建議您在資料來源和連接器版本 1.0 和 2.0 (如適用) 之間重複使用登入資料和秘密。
如果您沒有現有的IAM角色或秘密,則可以在將 Microsoft Exchange 資料來源連線到 時,使用 主控台建立新的IAM角色和Secrets Manager秘密Amazon Kendra。如果您使用的是 API,則必須提供現有IAM角色和Secrets Manager秘密的 ARN,以及索引 ID。
連線指示
若要Amazon Kendra連線至 Microsoft Exchange 資料來源,您必須提供 Microsoft Exchange 資料來源的必要詳細資訊,以便 Amazon Kendra可以存取您的資料。如果您尚未為 設定 Microsoft ExchangeAmazon Kendra,請參閱 先決條件。
- Console
-
Amazon Kendra連線至 Microsoft Exchange
-
登入 AWS 管理主控台並開啟 Amazon Kendra主控台。
-
從左側導覽窗格中,選擇索引,然後從索引清單中選擇您要使用的索引。
您可以選擇在索引設定下設定或編輯使用者存取控制設定。
-
在入門頁面上,選擇新增資料來源。
-
在新增資料來源頁面上,選擇 Microsoft Exchange 連接器,然後選擇新增連接器。如果使用版本 2 (如適用),請選擇具有 "V2.0" 標籤的 Microsoft Exchange 連接器。
-
在指定資料來源詳細資訊頁面上,輸入下列資訊:
-
在名稱和描述中,針對資料來源名稱 - 輸入資料來源的名稱。您可以包含連字號,但不能包含空格。
-
(選用) 描述 — 輸入資料來源的選用描述。
-
在預設語言 - 選擇語言來篩選索引的文件。除非您另有指定,否則語言預設為英文。文件中繼資料中指定的語言會覆寫選取的語言。
-
在標籤中,針對新增標籤 - 包含選用標籤,以搜尋和篩選您的資源或追蹤您的AWS成本。
-
選擇下一步。
-
在定義存取和安全性頁面上,輸入下列資訊:
-
租用戶 ID - 輸入您的 Microsoft 365 租用戶 ID。您可以在 Azure Active Directory 入口網站的 屬性或 OAuth 應用程式中找到租用戶 ID。
-
授權:如果您有 ACL 並想要將其用於存取控制,請開啟或關閉文件的存取控制清單 (ACL) 資訊。ACL 指定使用者可以和群組存取哪些文件。ACL 資訊用於根據使用者或其群組對文件的存取來篩選搜尋結果。如需詳細資訊,請參閱使用者內容篩選。
-
AWS Secrets Managersecret - 選擇現有的秘密或建立新的Secrets Manager秘密,以存放您的 Microsoft Exchange 身分驗證登入資料。如果您選擇建立新的秘密,則會AWS Secrets Manager開啟秘密視窗。
-
在建立AWSSecrets Manager秘密視窗中輸入下列資訊:
-
機密名稱 - 輸入您的機密名稱。字首 'AmazonKendra-Microsoft Exchange
-
對於用戶端 ID,用戶端秘密 - 在 Azure 入口網站中輸入在 Microsoft Exchange 中設定的身分驗證憑證。
-
儲存並新增您的秘密。
-
Virtual Private Cloud (VPC) — 您可以選擇使用 VPC。若是如此,您必須新增子網路和 VPC 安全群組。
-
IAMrole - 選擇現有IAM角色或建立新的IAM角色,以存取您的儲存庫登入資料和索引內容。
IAM用於索引的 角色無法用於資料來源。如果您不確定現有角色是否用於索引或常見問答集,請選擇建立新角色以避免錯誤。
-
選擇下一步。
-
在設定同步設定頁面上,輸入下列資訊:
-
使用者 IDs - 如果您想要依特定電子郵件篩選內容,請提供使用者電子郵件。
-
其他組態 - 指定您要編目的內容類型。
-
實體類型 - 您可以選擇編目行事曆、OneNotes 或聯絡人內容。
-
行事曆爬取 - 輸入開始和結束日期,在特定日期之間爬取內容。
-
包含電子郵件 - 輸入「收件人」、「寄件人」和電子郵件主旨行,以篩選您要抓取的特定電子郵件。
-
共用資料夾存取 - 選擇啟用存取控制清單的編目,以控制 Microsoft Exchange 資料來源的存取控制。
-
網域的 Regex - 新增規則表達式模式,以包含或排除特定電子郵件網域。
-
Regex 模式 - 新增規則表達式模式,以包含或排除特定檔案。
-
同步模式 - 選擇您希望在資料來源內容變更時更新索引的方式。當您Amazon Kendra第一次使用 同步資料來源時,預設會爬取所有內容並編製索引。如果初始同步失敗,即使您未選擇完全同步做為同步模式選項,仍必須執行資料的完整同步。
-
完全同步:新編製所有內容的索引,每次資料來源與索引同步時取代現有的內容。
-
新的、修改過的同步:每次資料來源與索引同步時,僅索引新的和修改的內容。Amazon Kendra 可以使用資料來源的機制來追蹤內容變更,以及自上次同步以來變更的索引內容。
-
新的、已修改、已刪除的同步:每次資料來源與您的索引同步時,僅索引新的、已修改和已刪除的內容。 Amazon Kendra可以使用資料來源的機制來追蹤自上次同步以來變更的內容和索引內容。
-
在同步執行排程中,針對頻率 - 選擇同步資料來源內容和更新索引的頻率。
-
選擇下一步。
-
在設定欄位映射頁面上,輸入下列資訊:
-
預設資料來源欄位 - 從您要映射到索引Amazon Kendra的產生預設資料來源欄位中選取 。
Amazon KendraMicrosoft Exchange 資料來源連接器不支援自訂欄位映射。
-
選擇下一步。
-
在檢閱和建立頁面上,檢查您輸入的資訊是否正確,然後選取新增資料來源。您也可以選擇從此頁面編輯您的資訊。成功新增資料來源後,您的資料來源將顯示在資料來源頁面上。
- API
-
Amazon Kendra連線至 Microsoft Exchange
您必須使用 TemplateConfiguration API 指定資料來源結構描述的 JSON。您必須提供下列資訊:
-
資料來源 - 當您使用 TemplateConfiguration JSON 結構描述MSEXCHANGE時,指定資料來源類型。當您呼叫 CreateDataSource API TEMPLATE時,也請將資料來源指定為 。
-
租用戶 ID - 您可以在 Azure Active Directory 入口網站的 屬性或 OAuth 應用程式中找到租用戶 ID。
-
同步模式 - 指定 Amazon Kendra如何在資料來源內容變更時更新索引。當您第一次使用 Amazon Kendra同步資料來源時,預設會爬取所有內容並編製索引。如果初始同步失敗,即使您未選擇完全同步做為同步模式選項,仍必須執行資料的完整同步。您可以選擇:
-
FORCED_FULL_CRAWL 以新編製所有內容的索引,每次資料來源與索引同步時都會取代現有的內容。
-
FULL_CRAWL 每次資料來源與索引同步時, 只會編製新內容、修改內容和已刪除內容的索引。Amazon Kendra 可以使用資料來源的機制來追蹤自上次同步以來變更的內容變更和索引內容。
-
CHANGE_LOG 每次資料來源與索引同步時, 只會編製新內容和修改內容的索引。Amazon Kendra 可以使用資料來源的機制來追蹤自上次同步以來變更的內容變更和索引內容。
-
Secret Amazon Resource Name (ARN) — 提供秘密的 Amazon Resource Name (ARN)Secrets Manager,其中包含您 Microsoft Exchange 帳戶的身分驗證憑證。秘密會以下列金鑰存放在 JSON 結構中:
{
"clientId": "client ID",
"clientSecret": "client secret"
}
-
IAMrole—指定RoleArn您何時呼叫 CreateDataSource 以提供IAM角色存取Secrets Manager秘密的許可,以及呼叫 Microsoft Exchange 連接器所需的公有 APIs 和 Amazon Kendra。如需詳細資訊,請參閱 IAMMicrosoft Exchange 資料來源的角色。
您也可以新增下列選用功能:
-
Virtual Private Cloud (VPC)—指定您呼叫 VpcConfiguration的時間CreateDataSource。如需詳細資訊,請參閱設定 Amazon Kendra 以使用 Amazon VPC。
-
包含和排除篩選條件 - 指定是否包含或排除特定內容。
大多數資料來源使用規則表達式模式,作為包含或排除的篩選規則,稱為篩選條件。若您設定包含篩選條件,則只有符合該條件的內容會被編列索引。任何不符合包含篩選條件的文件都不會編製索引。如果您指定包含和排除篩選條件,則符合排除篩選條件的文件不會編製索引,即使它們符合包含篩選條件。
-
存取控制清單 (ACL) — 如果您有 ACL 並想要將其用於存取控制,請指定是否要為文件編目 ACL 資訊。ACL 指定使用者可以和群組存取哪些文件。ACL 資訊用於根據使用者或其群組對文件的存取來篩選搜尋結果。如需詳細資訊,請參閱使用者內容篩選。
-
欄位映射 - 選擇將 Microsoft Exchange 資料來源欄位映射至您的Amazon Kendra索引欄位。如需詳細資訊,請參閱映射資料來源欄位。
需要文件內文欄位或文件內文對等項目, Amazon Kendra才能搜尋您的文件。您必須將資料來源中的文件內文欄位名稱映射至索引欄位名稱 _document_body。所有其他欄位是選用的。
如需要設定的其他重要 JSON 金鑰清單,請參閱 Microsoft Exchange 範本結構描述。
進一步了解
若要進一步了解Amazon Kendra如何與您的 Microsoft Exchange 資料來源整合,請參閱:
備註