Exchange 擴充功能套件

本文說明如何將 Exchange Extension Pack 與 Google Security Operations 整合。

設定整合功能,以便與 Exchange 搭配使用

設定步驟會因整合的郵件伺服器而異。

以下是 Microsoft 365 和地端部署 Exchange (2016 以上版本,不支援更早版本) 的設定操作說明。

設定與 Microsoft 365 整合

這項整合功能會使用 PowerShell 指令碼執行作業。PowerShell 套件必須安裝在 Google Security Operations 伺服器,或使用 Exchange 擴充套件整合功能的 Google SecOps 遠端代理程式。

以下範例說明如何為 CentOS7 設定 PowerShell:

  1. 安裝 PowerShell 套件。

    > curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
    > sudo yum install -y powershell
    
  2. 開啟 PowerShell 直譯器,並安裝 Exchange Online PowerShell V3 和 WSMan 模組:

    > pwsh
    > Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.5.0 -Force -Scope AllUsers
    > Install-Module -Name PSWSMan
    > Install-WSMan
    > exit
    
  3. 前往 https://github.com/jborean93/omi/releases,取得 openssl 1.1 的 libmi.so 和 libpsrpclient.so 檔案。將最新的 glibc-1.1.tar.gz 版本下載至 CentOS 主機。

  4. 解壓縮下載的 tar 封存檔:

    > tar -xzvf glibc-1.1.tar.gz
    
  5. 覆寫 /opt/microsoft/powershell/7 目錄中現有的 libmi.so 和 libpsrpclient.so 檔案。

設定帳戶

在 Exchange 系統管理中心,將要用於整合的帳戶新增至「探索管理」管理員角色。

將權限指派給使用者

將「法規遵循資料管理員」角色指派給使用者。

設定整合功能,以便與地端部署 Exchange 搭配使用

以下操作說明適用於 Exchange 2016,不支援較早版本。

這項整合功能會使用 PowerShell 指令碼執行作業。PowerShell 套件必須安裝在 Google SecOps 伺服器,或使用 Exchange 擴充套件整合的 Google SecOps 遠端代理。

以下範例說明如何為 CentOS7 設定 PowerShell:

  1. 安裝 PowerShell 套件。

    > curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
    > sudo yum install -y powershell
    
  2. 安裝 gssapi 套件。

    必須安裝 gssapi 套件,才能從 Google SecOps Linux 伺服器或遠端代理程式,驗證至透過 PowerShell 工作階段執行 Exchange 的 Windows 伺服器。

    CentOS 7 的 gssapi 安裝範例:

    > sudo yum install -y gssntlmssp
    
  3. 請按照 Microsoft 說明文件中的 Enable-PSRemoting 文件,在執行 Exchange 的 Windows 伺服器上啟用 PowerShell 遠端功能。

  4. 在 Exchange 中啟用基本驗證。

    這項整合功能使用基本驗證,必須在 Exchange 伺服器中明確啟用。

    在 Exchange 中啟用基本驗證

  5. 設定帳戶。

    請將要與整合功能搭配使用的帳戶,新增至 Exchange 系統管理中心 (EAC) 控制台的「探索管理」管理員角色。如要執行郵件流程規則動作,您必須為相關使用者新增傳輸規則角色:

    • 前往 EAC,然後按一下「權限」。
    • 選取並開啟「探索管理」。

    Exchange 系統管理中心

    • 在「Roles」部分,按一下「「新增」圖示 Add」,然後選取「Transport Rules」。

    前往「Transport Rules」(傳輸規則)

    • 依序點選「新增 ->」、「確定」和「儲存」。

    新增傳輸規則

    • 該角色現在會新增至「指派的角色」部分。權限可能需要一些時間才會複製。

    驗證指派的角色

在 Google SecOps 中設定 Exchange Extension Pack 整合

如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」一文。

整合參數

請使用下列參數設定整合:

參數顯示名稱 類型 預設值 為必填項目 說明
Exchange 地端部署伺服器位址 字串 x.x.x.x 否 要連線的郵件伺服器位址 (主機名稱或 IP)。
Exchange Office 365 法規遵循 URI 字串 https://ps.compliance.protection.outlook.com/powershell-liveid/ 否

用於執行法規遵循作業的 Microsoft 365 安全性與法規遵循中心 PowerShell URI。

詳情請參閱「連線至安全性與法規遵循 PowerShell」文件。

Exchange Office365 Online PowerShell URI 字串 https://outlook.office365.com/powershell-liveid 否

用於執行 Microsoft 365 管理作業的 Microsoft 365 Online Powershell URI。

詳情請參閱「連線至安全性與法規遵循 PowerShell」文件。

網域 字串 example.com 否 在郵件伺服器上驗證的網域。
使用者名稱 字串 使用者 否

用於郵件伺服器驗證的使用者名稱。

如果是 Microsoft 365,請提供使用者郵件地址做為使用者名稱。

密碼 密碼 不適用 否 用於驗證郵件伺服器的密碼。
是否為 Exchange 地端部署? 核取方塊 已取消勾選 否 指定目標郵件伺服器是否為 Exchange 地端部署。
是否為 Office 365 (Exchange Online)? 核取方塊 已取消勾選 否 指定目標郵件伺服器是否為 Microsoft 365 (Exchange Online)。

動作

說明

刪除法規遵循搜尋,以及任何相關聯的擷取結果或清除電子郵件工作。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
法規遵循搜尋名稱 字串 不適用 是

要刪除的法規遵循搜尋名稱。

名稱不得包含特殊字元。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
N/A
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果動作成功,系統會刪除法規遵循搜尋和動作 (is_success=true):「動作已成功執行,法規遵循搜尋和任何相關聯的擷取結果或清除電子郵件工作已刪除。」

動作應失敗並停止執行應對手冊:

如果目標是 Exchange on-premises 或 Microsoft 365,但 Google SecOps 伺服器未安裝 PowerShell:「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果目標是 Exchange on-premises,但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件:「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「無法執行動作!錯誤為 {0}".format(exception.stacktrace)

一般

擷取法規遵循搜尋結果

說明

擷取已完成法規遵循搜尋的結果。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
法規遵循搜尋名稱 字串 不適用 是

法規遵循搜尋的名稱。

名稱不得包含特殊字元。

要傳回的電子郵件數量上限 整數 不適用 否 指定動作可傳回的電子郵件數量。
是否要在動作完成後移除法規遵循搜尋? 核取方塊 已勾選 否 指定動作完成後,是否應從 Exchange 伺服器移除搜尋動作,以及任何相關的擷取或清除工作。
要建立案件總覽輸出資料表嗎? 核取方塊 已勾選 否

指定動作是否應建立案件總覽輸出表格。

如果「Max Emails To Return」參數設為較大的數字,建議取消勾選這個選項,提高動作執行效能。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
[
  {
    "Location": "test@example.com",
    "Sender": "James Bond",
    "Subject": "search test",
    "Type": "Email",
    "Size": "61772",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG192bc965-18c9-4c06-8834-2cxxxxxxxxxx.eml",
    "Name": "test"
  },
  {
    "Location": "test@example.com",
    "Sender": "James Bond",
    "Subject": "search test 2",
    "Type": "Email",
    "Size": "60881",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG9eefda9c-b1b5-46f0-8a54-bdxxxxxxxxxx.eml",
    "Name": "test"
  }
]
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果動作成功,且已建立法規遵循動作 (is_success=true):「動作已成功執行,且已建立擷取法規遵循搜尋結果的工作」

動作完成後: "Results for the Compliance Search {0} were successfully fetched".format(compliance search name)

如果動作無法根據提供的名稱找到法規遵循搜尋 (is_success=false):「Action was not able to find compliance search {0}」.format(compliance_search_name)

如果動作因其他非重大錯誤而失敗 (is_success=false):「動作因錯誤而無法順利完成。錯誤資訊:{0}".format(error.stacktrace)

動作應失敗並停止執行應對手冊:

如果目標是 Exchange on-prem 或 Microsoft 365,但 Google SecOps 伺服器未安裝 PowerShell:「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果目標是 Exchange on-prem,但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件:「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「無法執行動作!錯誤為 {0}".format(exception.stacktrace)

一般
資料表

表格標題:法規遵循搜尋動作結果

表格欄:

  • 接收時間
  • 寄件者
  • 收件者
  • 主旨
一般

乒乓

說明

在 Google SecOps Content Hub 頁面的整合設定頁面,使用提供的參數測試與 Exchange 或 Microsoft 365 伺服器的連線。

參數

不適用

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
N/A
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果成功:「已成功使用提供的連線參數連線至 Exchange 或 Microsoft 365 伺服器!」

動作應失敗並停止執行應對手冊:

如果未勾選任何核取方塊 (Microsoft 365/Exchange 地端部署):「請指定要連線的郵件伺服器類型:Exchange 地端部署或 Microsoft 365」

如果兩個核取方塊都勾選 (Microsoft 365/Exchange 內部部署):「一次只能支援一種郵件伺服器類型。請指定要連線的郵件伺服器類型:Exchange 地端部署或 Microsoft 365

如果目標是 Exchange on-prem 或 Microsoft 365,但 Google SecOps 伺服器未安裝 PowerShell:「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果目標是 Exchange on-prem,但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件:「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「無法執行動作!錯誤為 {0}".format(exception.stacktrace)

一般

清除法規遵循搜尋結果

說明

清除法規遵循搜尋找到的電子郵件。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
法規遵循搜尋名稱 字串 不適用 是

法規遵循搜尋的名稱。

名稱不得包含特殊字元。

要對已刪除的電子郵件執行 HardDelete 嗎? 核取方塊 已取消勾選 否

指定是否應執行 HardDelete。

這個選項僅適用於 Microsoft 365,會將電子郵件標示為從信箱永久移除。

是否要在動作完成後移除法規遵循搜尋? 核取方塊 已勾選 否 指定動作完成後,是否應從 Exchange 伺服器移除搜尋動作,以及任何相關的擷取或清除工作。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
{
  "Item count": "5",
  "Purge Type": "SoftDelete"
}
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果動作成功且已建立法規遵循動作 (is_success=true):「動作已成功執行,且已建立工作,可清除透過法規遵循搜尋找到的電子郵件」

動作完成後:「Results for the Compliance Search {0} were successfully purged」.format(compliance search name)

如果動作無法根據提供的名稱找到法規遵循搜尋 (is_success=false):「Action was not able to find compliance search {0}」.format(compliance_search_name)

如果動作未傳回任何結果:「法規遵循搜尋『{0}』未傳回任何結果。請更新搜尋結果,或編輯法規遵循搜尋查詢,然後再次執行搜尋。".format(compliance search name)

動作應失敗並停止執行應對手冊:

如果目標是 Exchange on-premises 或 Microsoft 365,但 Google SecOps 伺服器未安裝 PowerShell:「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果目標是 Exchange on-premises,但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件:「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「無法執行動作!錯誤為 {0}".format(exception.stacktrace)

一般

說明

根據提供的搜尋條件執行 Exchange 法規遵循搜尋。如果勾選「擷取法規遵循搜尋結果」核取方塊,這項動作會傳回搜尋結果,與「擷取法規遵循搜尋結果」動作類似。

Exchange 法規遵循搜尋功能提供快速機制,可搜尋多個信箱,最適合擁有 1,000 個以上信箱的大型組織。

如果勾選「Fetch Compliance Search Results?」(擷取法規遵循搜尋結果?) 核取方塊,最多會顯示 200 個元素,但實際搜尋結果可能會顯示更多發現項目。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
法規遵循搜尋名稱 字串 不適用 是

法規遵循搜尋的名稱。

名稱不得包含特殊字元。

主旨篩選器 字串 不適用 否 篩選條件,指定要搜尋電子郵件的主旨。
寄件者篩選器 字串 不適用 否 篩選條件,指定所需電子郵件的寄件者。
收件者篩選器 字串 不適用 否 篩選條件,指定應接收所需電子郵件的收件者。
運算子 DDL 且 是 用於根據上述條件建構查詢的運算子。
時間範圍 (小時) 字串 不適用 否 搜尋電子郵件的時間範圍間隔 (以小時為單位)。
搜尋電子郵件的位置 字串 不適用 是

搜尋電子郵件的位置,可以是下列其中一項:

  • 以半形逗號分隔的信箱清單
  • 通訊群組或啟用郵件功能的安全性群組
  • 全部:適用於組織中的所有信箱
要擷取法規遵循搜尋結果嗎? 核取方塊 已取消勾選 否

指定動作是否應立即擷取法規遵循搜尋結果。

最多顯示 200 個元素,但實際搜尋結果可能更多。

要傳回的電子郵件數量上限 整數 不適用 否 指定動作可傳回的電子郵件數量。
要建立案件總覽輸出資料表嗎? 核取方塊 已勾選 否

指定動作是否應建立案件總覽輸出表格。

如果「要傳回的電子郵件數量上限」參數設為較大的數字,建議取消勾選這個選項,提高動作效能。

進階查詢 字串 不適用 否

請提供要執行法規遵循搜尋的查詢,而非主旨、寄件者或收件者篩選器。

詳情請參閱關鍵字查詢語言 (KQL) 語法參考資料和 Exchange 搜尋索引的郵件屬性文件。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
{
  "Name": "test",
  "RunBy": "James Bond",
  "JobEndTime": "2021-03-18T12:42:49.92",
  "Status": "Completed"
}
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果動作成功且已建立法規遵循 (is_success=true):「動作已成功執行,且已建立法規遵循搜尋」

動作完成搜尋後: "Compliance Search {0} successfully completed".format(compliance search name)

如果勾選擷取法規遵循搜尋結果的核取方塊:「Results for the Compliance Search {0} were successfully fetched」.format(compliance search name)

如果已勾選擷取法規遵循搜尋結果的核取方塊,但動作未傳回任何結果:「法規遵循搜尋『{0}』未傳回任何結果。請更新搜尋結果,或編輯法規遵循搜尋查詢,然後再次執行搜尋。".format(compliance search name)

動作應失敗並停止執行應對手冊:

如果目標是 Exchange on-prem 或 Microsoft 365,但 Google SecOps 伺服器未安裝 PowerShell:「Failed to execute action because powershell is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果目標是 Exchange on-prem,但 Google SecOps 伺服器未安裝 gssntlmssp OS 套件:「Failed to execute action because gssntlmssp package is not installed on Google SecOps server! 請參閱設定操作說明,瞭解如何安裝 PowerShell。錯誤為 {0}".format(exception.stacktrace)

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「無法執行動作!錯誤為 {0}".format(exception.stacktrace)

一般

將網域新增至 Exchange-Siemplify 郵件流程規則

說明

這項動作會將網域清單做為參數,並建立新規則,篩選 Exchange Server 中的網域。您可以使用規則參數,在參數中修改要採取的動作。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
網域 字串 不適用 否 以半形逗號分隔的清單,指定要新增至規則的網域。
將網域新增至 DDL Siemplify - Domains List - Permanently Delete 是

指定要新增網域的規則。

如果規則不存在,系統會在缺少規則的位置建立規則。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "already_available": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果成功 (規則已更新,輸入內容正確):「已將下列輸入內容新增至對應規則:
網域:
successfull_domains

已更新規則:
Rules_updated_names_list

如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的電子郵件地址無效):「無法將下列輸入內容新增至規則:」+
Unsuccessful_email_addresses

動作應失敗並停止執行應對手冊:

如果系統回報錯誤:「Error performing "Add Domains to Exchange-Siemplify Mail Flow Rules" action : {0}」。format(exception.stacktrace)

一般

將寄件者新增至 Exchange-Siemplify 郵件流程規則

說明

這項動作會取得電子郵件地址清單做為參數,或使用電子郵件規則運算式 (如未提供參數) 處理使用者實體,並可建立新規則,篩選 Exchange Server 的寄件者。您可以使用規則參數,在參數中修改動作。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
電子郵件地址 字串 不適用 否

指定要新增至規則的電子郵件地址,並以半形逗號分隔。

如未提供參數,動作會與使用者實體搭配運作。

要新增寄件者的規則 DDL Siemplify - Senders List - Permanently Delete 是

指定要將寄件者加入哪項規則。

如果規則不存在,系統會在缺少規則的位置建立規則。

是否也應將寄件者的網域新增至對應的網域清單規則? 核取方塊 已取消勾選 否 指定動作是否應自動擷取所提供電子郵件地址的網域,並將這些網域新增至對應的網域規則 (網域的規則動作相同)。

執行日期

如果電子郵件規則運算式有效,且未提供參數,這項動作會對使用者實體生效。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
{
  "success": [
    "test1@example.com",
    "test2@example.com"
  ],
  "already_available": [
    "test3@example.com"
  ],
  "invalid": [
    "invalid"
  ]
}
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果成功 (規則已相應更新,輸入內容正確):「已將下列輸入內容新增至對應規則:
電子郵件地址:」+
Successful_email_addresses+
「網域:」+
successfull_domains+

"Rules updated:"+
rules_updated_names_list

如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的電子郵件無效):「無法將下列輸入內容新增至規則:」+
Unsuccessful_email_addresses

動作應失敗並停止執行應對手冊:

如果系統回報錯誤: "Error performing "Add Senders to Exchange-Siemplify Mail Flow Rule" action : {0}".format(exception.stacktrace)

一般

刪除 Exchange-Siemplify 郵件流程規則

說明

這項動作會取得規則名稱做為參數,並刪除該規則。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
要刪除的規則名稱 DDL

Siemplify - Senders List - Permanently Delete

可能的值:

  • Siemplify - Senders List - Permanently Delete
  • Siemplify - Domains List - Permanently Delete
  • 所有可用的 Exchange-Siemplify 郵件流程規則
是 指定要完全刪除的規則名稱。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
N/A
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

成功刪除規則:「已成功刪除下列規則:」succesful_rule_names

如果在 Exchange 中找不到規則:「無法刪除下列規則:"+unseccessful_rule_names+",因為在 Exchange 中找不到這些規則。請確認您選擇的規則名稱適當,然後再試一次。」

如果在 Exchange 中找不到規則:「無法刪除任何提供的規則名稱,因為在 Exchange 中找不到這些名稱。請確認您選擇的規則名稱適當,然後再試一次。」

動作應失敗並停止執行應對手冊:

如果系統回報錯誤: "Error performing "Delete Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

列出 Exchange-Siemplify 郵件流程規則

說明

這項動作會取得規則名稱做為參數,並列出該規則。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
要列出的規則名稱 DDL

Siemplify - Senders List - Permanently Delete

可能的值:

  • Siemplify - Senders List - Permanently Delete
  • Siemplify - Domains List - Permanently Delete
  • 所有可用的 Exchange-Siemplify 郵件流程規則
是 指定要列出的規則名稱。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
[
  {
    "Priority": 0,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIs received from 'test@example1.com' or 'test@example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": null,
    "Identity": "Siemplify - Senders List - Permanently Delete",
    "Name": "Siemplify - Senders List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Senders List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": [
      "test@example1.com",
      "test@example2.com"
    ],
    "Guid": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "ImmutableId": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "WhenChanged": "/Date(1621952909000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  },
  {
    "Priority": 1,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIncludes these words in the sender's address: 'example1.com' or 'example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromAddressContainsPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": [
      "example1.com",
      "example2.com"
    ],
    "Identity": "Siemplify - Domains List - Permanently Delete",
    "Name": "Siemplify - Domains List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Domains List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": null,
    "Guid": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "ImmutableId": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "WhenChanged": "/Date(1621952960000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  }
]
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

成功找到規則:「Successfully listed the following rules :」succesful_rule_names

如果在 Exchange 中找不到規則:「無法列出下列規則:」+unseccessful_rule_names+「,因為在 Exchange 中找不到這些規則。請確認您選擇的規則名稱適當,然後再試一次。」

如果 Exchange 中找不到任何規則:「無法列出任何提供的規則名稱,因為在 Exchange 中找不到這些名稱。請確認您選擇的規則名稱適當,然後再試一次。」

動作應失敗並停止執行應對手冊:

如果回報錯誤: "Error performing "List Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)

一般

從 Exchange-Siemplify 郵件流程規則中移除網域

說明

這項動作會將網域清單做為參數,並從現有規則中移除提供的網域。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
網域 字串 不適用 否

請以半形逗號分隔的清單,指定要從規則中移除的網域。

如未提供參數,動作會與實體搭配運作。

要移除網域的規則 DDL Siemplify - Domains List - Permanently Delete 是

指定要從哪項規則中移除網域。

如果規則不存在,則不會執行任何動作。

從所有可用規則中移除網域 核取方塊 已取消勾選 否 指定動作是否應在所有 Google SecOps Mail Flow 規則中,尋找提供的網域。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "didn't_exist": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果成功 (規則已相應更新,輸入內容正確):「已從對應規則中移除下列輸入內容:」
網域:
successfull_domains

已更新規則:
Rules_updated_names_list

動作應失敗並停止執行應對手冊:

如果系統回報錯誤:「Error performing "Remove Domains from Exchange-Siemplify Mail Flow Rules" action : {0}」。format(exception.stacktrace)

一般

從 Exchange-Siemplify 郵件流程規則中移除寄件者

說明

這項動作會取得寄件者清單做為參數,或對使用者實體執行 (如未提供參數),並可從現有規則中移除提供的寄件者。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
寄件者 字串 不適用 否

請列出要從規則中移除的寄件者,並以逗號分隔的清單表示。

如未提供參數,動作會與實體搭配運作。

要移除寄件者的規則 DDL Siemplify 寄件者清單 - 永久刪除 是

指定要從哪項規則中移除寄件者。

如果規則不存在,則不會執行任何動作。

是否也要從對應的網域清單規則中移除寄件者的網域? 核取方塊 已取消勾選 否 指定動作是否應自動擷取所提供電子郵件地址的網域,並從對應的網域規則中移除這些網域 (網域的相同規則動作)。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 值選項 範例
is_success True/False is_success:False
JSON 結果
{
  "success": [
    "test1@example.com",
    "test2@example.com"
  ],
  "didn't_exist": [
    "test3@example.com"
  ],
  "invalid": [
    "invalid"
  ]
}
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果成功 (規則已相應更新,輸入內容正確):訊息:「已從對應規則中移除下列輸入內容:」
寄件者:
successfull_senders

已更新規則:
rules_updated_names_list

如果至少有一項輸入內容不正確 (參數中的電子郵件地址無效、實體名稱中的電子郵件無效):「無法將下列輸入內容新增至規則:」+
Unsuccessful_email_addresses

動作應失敗並停止執行應對手冊:

如果系統回報錯誤:「Error performing "Remove Senders from Exchange-Siemplify Mail Flow Rules" action : {0}」。format(exception.stacktrace)

一般

還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。