Mimecast

本文說明如何將 Mimecast 與 Google SecOps 整合。

應用實例

  1. 執行訊息擷取
  2. 執行分類動作 (拒絕/放行/回報郵件)

事前準備

繼續操作前，請確認 Mimecast 環境已具備必要的產品授權和管理角色。

必要的 Mimecast 產品和服務

為確保 Mimecast API 2.0 整合功能正常運作，您的 Mimecast 帳戶必須具備下列產品的授權：

Mimecast 角色必要權限

如要設定 Mimecast 整合，您必須先在 Mimecast 管理控制台中建立具有必要權限的 Mimecast 角色。

必要權限如下：

  • Account | Dashboard | Read

  • Account | Monitoring | Held | Edit

  • Archive | Search Logs | Read

  • Archive | View Logs | Read

  • Gateway | Managed Senders | Edit

  • Gateway | Policies | Edit

  • Gateway | Policies | Read

  • Gateway | Tracking | Read

在 Google SecOps 中設定 Mimecast 整合

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

整合參數

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

參數顯示名稱 類型 預設值 為必填項目 說明
API 根層級 字串 https:/<<api root>> 是 Mimecast 執行個體的 API 根目錄。
應用程式 ID 字串 不適用 是 Mimecast 執行個體的應用程式 ID。
應用程式金鑰 密碼 不適用 是 Mimecast 執行個體的應用程式金鑰。
存取金鑰 密碼 不適用 是 Mimecast 執行個體的存取金鑰。
密鑰 密碼 不適用 是 Mimecast 執行個體的密鑰。
驗證 SSL 核取方塊 已勾選 是 如果已啟用，請確認與 Mimecast 伺服器連線的 SSL 憑證有效。

動作

乒乓

說明

在 Google SecOps Content Hub 的整合設定頁面，使用提供的參數測試與 Mimecast 的連線能力。

參數

不適用

執行日期

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

動作執行結果

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

這項動作不應失敗，也不應停止執行自動化動作：
如果成功：「已使用提供的連線參數成功連線至 Mimecast 伺服器！」

如果動作失敗，應停止執行應對手冊：
如果失敗：「無法連線至 Mimecast 伺服器！錯誤為 {0}".format(exception.stacktrace)

 一般

說明

使用 Mimecast 中定義的參數搜尋封存電子郵件。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
要傳回的欄位 CSV

attachmentcount,status,subject,
size,receiveddate,displayfrom,
displayfromaddress,id,displayto,
displaytoaddresslist,smash

 是 指定要傳回的欄位，並以逗號分隔的清單表示。
信箱 CSV 不適用 否 指定要搜尋的信箱清單，並以半形逗號分隔。
寄件者 CSV 不適用 否 指定電子郵件寄件者的電子郵件地址清單，並以半形逗號分隔。
收件者 CSV 不適用 否 指定電子郵件傳送至哪些電子郵件地址，並以半形逗號分隔。
主旨 字串 不適用 否 指定要搜尋的主旨。
時間範圍 DDL

過去 1 小時

可能的值：

過去 1 小時

過去 6 小時

最近 24 小時

上週

上個月

自訂

 是 指定搜尋的時間範圍。如果選取「自訂」，則必須提供「開始時間」。
開始時間 字串 不適用 否 指定搜尋的開始時間。如果「Time Frame」參數選取「Custom」，則必須提供這項參數。格式：ISO 8601
結束時間 字串 不適用 否 指定搜尋的結束時間。格式：ISO 8601。如果未提供任何值，且「Time Frame」參數選取「Custom」，則這個參數會使用目前時間。
要傳回的電子郵件數量上限 整合 50 否 指定要傳回的電子郵件數量。預設值：50。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行應對手冊：
如果資料可用(is_success = true)：「已成功在 Mimecast 中找到符合指定條件的封存電子郵件」。

如果沒有可用資料 (is_success=true)：「在 Mimecast 中找不到符合指定條件的封存電子郵件」



動作應失敗並停止執行自動化動作：
如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行動作『簡易封存搜尋』時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果「開始時間」空白，且「時間範圍」為「自訂」：「執行『簡易封存搜尋』動作時發生錯誤。原因：在「時間範圍」參數中選取「自訂」時，應提供「開始時間」。

如果失敗/錯誤有值：執行「簡易封存搜尋」動作時發生錯誤。Reason: fail/errors/message」。

 一般
案件總覽表格

名稱：Results

資料欄：

回覆中的所有鍵

 一般

說明

在 Mimecast 中使用自訂 XML 查詢搜尋封存電子郵件。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
XML 查詢 XML 不適用 是 指定搜尋封存電子郵件時應使用的 XML 查詢。詳情請參閱說明文件。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行應對手冊：
如果資料可用(is_success = true)：「已成功在 Mimecast 中找到符合指定條件的封存電子郵件」。

如果沒有可用資料 (is_success=true)：「No archive emails were found for the provided criteria in Mimecast」。

動作應失敗並停止執行工作手冊：
如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「Error executing action "Advanced Archive Search". Reason: {0}''.format(error.Stacktrace)

如果失敗/錯誤有值：執行「進階封存搜尋」動作時發生錯誤。Reason: fail/errors/message」。

 一般
案件總覽表格

名稱：Results

資料欄：

回覆中的所有鍵

 一般

拒絕郵件

說明

在 Mimecast 中拒絕郵件。 注意：只有狀態為「待處理」的訊息可以拒絕。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
郵件 ID 字串 不適用 是 指定要拒絕的訊息 ID。
注意事項 字串 不適用 否 指定額外附註，說明郵件遭拒的原因。
原因 DLL

請選取一項

可能的值：

請選取一項

不當通訊

機密資訊

違反電子郵件政策

違規內容

 否 請說明拒絕原因。
通知寄件者 核取方塊 已取消勾選 否 如果啟用，系統會通知寄件者郵件遭拒。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行應對手冊：
如果回應中沒有「錯誤」(is_success = true)：「已成功在 Mimecast 拒絕 ID 為『{ID}』的郵件」。

動作應失敗並停止執行應對手冊：
如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『拒絕訊息』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果失敗/錯誤有值：執行「拒絕郵件」動作時發生錯誤。Reason: fail/errors/message」。

 一般

釋出郵件

說明

在 Mimecast 中釋出郵件。 注意：只有狀態為「已擱置」的郵件才能釋出。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
郵件 ID 字串 不適用 是 指定要釋出的郵件 ID。
發布至沙箱 核取方塊 不適用 否 啟用後，系統會將郵件傳送至沙箱。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行自動化動作：
如果回應中沒有「錯誤」(is_success = true)：「已成功在 Mimecast 中釋出 ID 為「{ID}」的郵件」。

動作應失敗並停止執行自動化動作：
如果發生嚴重錯誤，例如憑證錯誤、未連線至伺服器等：「執行『釋出郵件』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果失敗/錯誤有值：執行「釋出郵件」動作時發生錯誤。Reason: fail/errors/message」。

 一般

檢舉訊息 - 已淘汰

在 Mimecast 中檢舉郵件。

動作輸入內容

參數 說明
Message IDs

必填。

指定要檢舉的訊息 ID。
Report as

選填。

指定訊息的報表類型。

可能的值如下：

  • Spam
  • Malware
  • Phishing
Comment

選填。

指定報表註解。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行應對手冊：

  • if data is available (is\_success = true): print "Successfully reported the following messages with ID "{ID}" in Mimecast".
  • 如果失敗/錯誤有值：輸出「執行『回報郵件』動作時發生錯誤。Reason: fail/errors/message」。

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

  • if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Report Message". 原因：{0}''.format(error.Stacktrace)。
 一般

封鎖寄件者

說明

在 Mimecast 中封鎖寄件者。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
寄件者 字串 不適用 是 指定要封鎖的寄件者電子郵件地址。
收件者 字串 不適用 是 指定要封鎖的收件者電子郵件地址。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行 Playbook：
如果回應中沒有「錯誤」(is_success = true)：「已成功在 Mimecast 中為收件者 {recipient} 封鎖寄件者 {sender}」。

動作應失敗並停止執行自動化動作：
如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『封鎖寄件者』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果失敗/錯誤有值：執行「封鎖寄件者」動作時發生錯誤。Reason: fail/errors/message」。

 一般

允許寄件者

說明

在 Mimecast 中允許寄件者。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
寄件者 字串 不適用 是 指定要允許的寄件者電子郵件地址。
收件者 字串 不適用 是 指定要允許的收件者電子郵件地址。

執行日期

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

動作執行結果

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

動作不應失敗，也不應停止執行自動化動作：
如果回應中沒有「errors」(is_success = true)：「已成功在 Mimecast 中為收件者 {recipient} 允許寄件者 {sender}」。

動作應失敗並停止執行應對手冊：
如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『允許寄件者』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果失敗/錯誤有值：執行「允許寄件者」動作時發生錯誤。Reason: fail/errors/message」。

 一般

建立封鎖寄件者政策

在 Mimecast 中建立「封鎖寄件者」政策。

執行日期

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

參數

參數顯示名稱 類型 預設值 浮水印 為必填項目 說明
回應 DDL 不適用 不適用 否 提供要與所建立政策建立關聯的回應類型。
說明 字串 不適用 不適用 是 政策說明。
擷取的資料 DDL 不適用 不適用 定義寄件者和收件者資訊的擷取來源。
寄件者 字串 不適用 不適用 否 要封鎖的郵件寄件者。只有在「寄件者類型」為下列其中一項時，才需要提供：電子郵件網域、電子郵件地址、標頭顯示名稱。如果選取其他「From Type」值，系統會忽略這個參數。
寄件者類型 DDL 不適用 不適用 否 政策的寄件者類型。
收件者 字串 不適用 不適用 否 郵件傳送對象，符合條件的郵件會遭到封鎖。只有在「收件者類型」為下列其中一項時，才需要提供：電子郵件網域、電子郵件地址、標頭顯示名稱。如果選取其他「Recipient Type」值，系統會忽略這個參數。
收件者類型 DDL 不適用 不適用 否 政策的收件者類型。
註解 字串 不適用 不適用 否 政策註解。
雙向 布林值 不適用 不適用 否 如果啟用，系統會以雙向方式定義政策。
已強制執行 布林值 不適用 不適用 否 如果啟用，系統會強制執行政策。
開始時間 字串 不適用 不適用 否 政策的開始時間。如未提供，開始時間會設為永久。必須採用 ISO 8601 格式。範例：2025-03-07T16:03:00Z
結束時間 字串 不適用 不適用 否 政策的結束時間。如未提供任何值，結束時間會設為永久。必須採用 ISO 8601 格式。範例：2025-03-07T16:03:00Z

動作執行結果

類型 可用
指令碼執行結果 是
JSON 結果 是
充實資料表 否
案件總覽表格 否
案件總覽連結 否
案件總覽附件 否
指令碼執行結果
指令碼執行結果名稱 值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
   "option": "block_sender",
   "id": "eNo1jr0OgjAYAN-lqw79QKyYOCCSiCJGqSCjlmqQn2ILNmp8d3Fwv8vdGynOOsnzDE3RSsP4ZTT0tPUMO3DL1pK-LrFZzzfJ9XJTrC78yPZgcc7CW1QdSLuUo11Mfc2rpIsfxlxQHFsDFXKPdkeq10ym7uJeDIKLA6Z66T1NUklI4c3QEDWizNnzVzYnBthDxDrViopLJjLe77iHyAEgjkmgpx9cqlzUaAp_kz4b7vc2YDzCny9vYUEo",
   "policy": {
       "description": "Description",
       "fromPart": "both",
       "from": {
           "type": "individual_email_address",
           "emailAddress": "example@exampl.com"
       },
       "to": {
           "type": "individual_email_address",
           "emailAddress": "exampleto@exampl.com"
       },
       "fromType": "individual_email_address",
       "fromValue": "example@exampl.com",
       "toType": "individual_email_address",
       "toValue": "exampleto@exampl.com",
       "fromEternal": true,
       "toEternal": true,
       "fromDate": "1900-01-01T00:00:00+0000",
       "toDate": "2100-01-01T23:59:59+0000",
       "override": false,
       "bidirectional": false,
       "conditions": {},
       "enabled": true,
       "enforced": true,
       "createTime": "2025-03-27T12:51:46+0000",
       "lastUpdated": "2025-03-27T12:51:46+0000"
   }
}
案件總覽
結果類型 值/說明 類型 (實體 \ 一般)
輸出訊息*

動作不應失敗或停止執行應對手冊：


If no "errors" in the response (is_success = true): print "Successfully created a block sender policy in Mimecast".

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

if fatal error, like wrong credentials, no connection to server, other:print "Error executing action "{action name}". 原因：{0}''.format(error.Stacktrace)

如果失敗/錯誤有值：執行「{action name}」動作時發生錯誤。Reason: fail/errors/message」。

連接器

Mimecast - 郵件追蹤連接器

說明

從 Mimecast 的「Message Tracking」分頁提取郵件相關資訊。 注意：許可清單適用於「queueDetailStatus/bounceType」參數。

在 Google SecOps 中設定 Mimecast - Message Tracking 連接器

如要瞭解如何在 Google SecOps 中設定連接器，請參閱「設定連接器」一文。

連接器參數

使用下列參數設定連接器：

參數顯示名稱 類型 預設值 為必填項目 說明
產品欄位名稱 字串 產品名稱 是 輸入來源欄位名稱，擷取產品欄位名稱。
事件欄位名稱 字串 event_type 是 輸入來源欄位名稱，擷取事件欄位名稱。
環境欄位名稱 字串 "" 否

說明儲存環境名稱的欄位名稱。

如果找不到環境欄位，則環境為預設環境。
環境規則運算式模式 字串 .* 否

要對「環境欄位名稱」欄位中的值執行的規則運算式模式。

預設值為 .*，可擷取所有值並傳回未變更的值。

用於允許使用者透過規則運算式邏輯操控環境欄位。

如果規則運算式模式為空值或空白，或環境值為空值，則最終環境結果為預設環境。
指令碼逾時 (秒) 整數值 180 是 執行目前指令碼的 Python 程序逾時限制。
API 根層級 字串 https:/<<api root>> 是 Mimecast 執行個體的 API 根目錄。
應用程式 ID 字串 不適用 是 Mimecast 執行個體的應用程式 ID。
應用程式金鑰 密碼 不適用 是 Mimecast 執行個體的應用程式金鑰。
存取金鑰 密碼 不適用 是 Mimecast 執行個體的存取金鑰。
密鑰 密碼 不適用 是 Mimecast 執行個體的密鑰。
網域 CSV 不適用 是 以半形逗號分隔的網域清單，用於查詢郵件。
擷取風險最低 字串 不適用 否

用於擷取訊息的最低風險。可能的值包括：

可忽略、低、中、高。

如未提供，連接器會擷取所有訊息。
狀態篩選器 CSV held

以半形逗號分隔的訊息狀態篩選器清單。可能的值：delivery、held、accepted、bounced、deferred、rejected、archived。

如未提供，連接器會擷取所有訊息。
路徑篩選器 CSV 不適用

以半形逗號分隔的訊息路徑篩選器。可能的值：internal、outbound、inbound。

如未提供，連接器會擷取所有訊息。
佇列原因篩選器 CSV 不適用

以半形逗號分隔的佇列原因清單，用於篩選訊息。如未提供任何值，系統會忽略這項篩選條件。
安全擷取訊息 核取方塊 啟用後，即使沒有風險相關資訊，連接器也會擷取訊息。根據這些訊息產生的 Google SecOps 警告，優先順序會設為「資訊」。
往回查看時數上限 整數 1 否 要擷取訊息的時間範圍 (以小時為單位)。預設為 1 小時。上限：30 天。
要傳回的訊息數量上限 整數 100 否 每次連接器疊代要處理的訊息數量。預設值：100。
將許可清單當做黑名單使用 核取方塊 已勾選 是 如果啟用，許可清單會當做黑名單使用。
驗證 SSL 核取方塊 已勾選 是 如果已啟用，請確認與 Mimecast 伺服器連線的 SSL 憑證有效。
Proxy 伺服器位址 字串 不適用 否 要使用的 Proxy 伺服器位址。
Proxy 使用者名稱 字串 不適用 否 用於驗證的 Proxy 使用者名稱。
Proxy 密碼 密碼 不適用 否 用於驗證的 Proxy 密碼。

連接器規則

Proxy 支援

連接器支援 Proxy。

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