Mimecast

整合版本:9.0

應用實例

  1. 擷取訊息
  2. 執行分類操作 (拒絕/放行/檢舉訊息)

事前準備

如要設定 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 憑證有效。
注意:如有需要,您可以在稍後階段進行變更。設定完成後,即可在應對手冊中使用執行個體。如要進一步瞭解如何設定及支援多個執行個體,請參閱 [支援多個執行個體](/chronicle/docs/soar/respond/integrations-setup/supporting-multiple-instances)。 ## 整合設定細節 1. Google Security Operations 伺服器必須與 Mimecast 伺服器同步。1. 如要瞭解設定所需的所有參數,請參閱下列連結: [https://community.mimecast.com/s/article/Managing-API-Applications-505230018](https://community.mimecast.com/s/article/Managing-API-Applications-505230018) 和 [https://community.mimecast.com/s/article/Mimecast-Data-Centers-and-URLs-61190061](https://community.mimecast.com/s/article/Mimecast-Data-Centers-and-URLs-61190061) ## 動作 ### Ping #### 說明 使用 Google SecOps Marketplace 分頁中整合設定頁面提供的參數,測試與 Mimecast 的連線。 #### 參數 不適用 #### 執行對象 這項動作不會對實體執行。 #### 動作執行結果 ##### 指令碼執行結果
指令碼結果名稱 值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止劇本執行:
如果成功:「Successfully connected to the Mimecast server with the provided connection parameters!」(已使用提供的連線參數成功連線至 Mimecast 伺服器!)

動作應會失敗並停止執行應對手冊:
如果未成功:「Failed to connect to the Mimecast server! Error is {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 小時

上週

上個月

自訂

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

執行時間

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

動作執行結果

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

動作不應失敗或停止劇本執行:
如有可用資料 (is_success = true):「Successfully found archive emails for the provided criteria in Mimecast」(已在 Mimecast 中成功找到符合所提供條件的封存電子郵件)。

如果沒有可用資料 (is_success=true):「No archive emails were found for the provided criteria in Mimecast」(Mimecast 中沒有符合所提供條件的封存電子郵件)



動作應會失敗並停止執行劇本:
如果發生重大錯誤,例如認證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Simple Archive Search" (執行「Simple Archive Search」動作時發生錯誤)。原因:{0}''.format(error.Stacktrace)

如果「開始時間」為空白,且「時間範圍」為「自訂」:「執行動作『簡單封存搜尋』時發生錯誤。原因:「時間範圍」參數選取「自訂」時,必須提供「開始時間」。

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

一般
案件總覽表格

名稱:結果

欄:

回應中的所有鍵

一般

說明

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

參數

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

執行時間

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

動作執行結果

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

動作不應失敗或停止劇本執行:
如有可用資料 (is_success = true):「Successfully found archive emails for the provided criteria in Mimecast」(已在 Mimecast 中成功找到符合所提供條件的封存電子郵件)。

如果沒有可用資料 (is_success=true):「No archive emails were found for the provided criteria in Mimecast」(Mimecast 中沒有符合所提供條件的封存電子郵件)。

動作應會失敗並停止執行劇本:
如果發生重大錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Advanced Archive Search". 原因:{0}''.format(error.Stacktrace)

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

一般
案件總覽表格

名稱:結果

欄:

回應中的所有鍵

一般

拒絕郵件

說明

在 Mimecast 中拒絕郵件。 注意:只有狀態為「保留」的訊息可以拒絕。

參數

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

請選取一項

可能的值:

請選取一項

不當溝通

機密資訊

違反電子郵件政策

違規內容

說明拒絕原因。
通知寄件者 核取方塊 已取消勾選 如果啟用這項設定,系統會通知寄件者郵件遭拒。

執行時間

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

動作執行結果

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

動作不應失敗或停止劇本執行:
如果回應中沒有「errors」(is_success = true):「Successfully rejected message with ID "{ID}" in Mimecast」(已在 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):「Successfully released message with ID "{ID}" in Mimecast」(已在 Mimecast 中成功發布 ID 為「{ID}」的郵件)。

動作應失敗並停止劇本執行:
如果發生嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「Error executing action "Release Message". 原因:{0}''.format(error.Stacktrace)

如果失敗/錯誤有值:執行「發布訊息」動作時發生錯誤。Reason: fail/errors/message"。

一般

檢舉訊息

說明

在 Mimecast 中檢舉郵件。 注意:只有狀態為「保留」、「封存」或「退信」的郵件可以檢舉。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
郵件 ID 字串 不適用 指定需要檢舉的訊息 ID。
回報為 DDL

垃圾內容

可能的值:

垃圾內容

惡意軟體

網路詐騙

指定郵件的報表類型。
註解 字串 不適用 指定報表的註解。

執行時間

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

動作執行結果

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

動作不應失敗或停止劇本執行:
如果資料可用 (is_success = true):「Successfully reported the following messages with ID "{ID}" in Mimecast」(已在 Mimecast 中成功回報下列 ID 為「{ID}」的訊息)。

動作應失敗並停止劇本執行:
如果發生重大錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Report Message". 原因:{0}''.format(error.Stacktrace)

如果 fail/errors 有值:執行「回報訊息」動作時發生錯誤。原因:fail/errors/message」。

一般

封鎖寄件者

說明

在 Mimecast 中封鎖寄件者。

參數

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

執行時間

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

動作執行結果

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

動作不應失敗或停止劇本執行:
如果回應中沒有「錯誤」(is_success = true):「Successfully blocked sender {sender} for recipient {recipient} in Mimecast」(已在 Mimecast 中成功封鎖寄件者「{sender}」,收件者為「{recipient}」)。

動作應會失敗並停止執行劇本:
如果發生重大錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Block Sender". 原因:{0}''.format(error.Stacktrace)

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

一般

允許寄件者

說明

在 Mimecast 中允許寄件者。

參數

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

執行時間

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

動作執行結果

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

動作不應失敗,也不應停止劇本執行:
如果回應中沒有「errors」(is_success = true):「Successfully permitted sender {sender} for recipient {recipient} in Mimecast」(已在 Mimecast 中成功允許寄件者「{sender}」傳送郵件給收件者「{recipient}」)。

動作應會失敗並停止執行劇本:
如果發生重大錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Permit Sender"」。原因:{0}''.format(error.Stacktrace)

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

一般

建立封鎖寄件者政策

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

執行時間

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

參數

參數顯示名稱 類型 預設值 浮水印 為必填項目 說明
回應 DDL 不適用 不適用 提供與所建立政策相關聯的回覆類型。
說明 字串 不適用 不適用 政策說明。
擷取的資料 DDL 不適用 不適用 定義要從何處擷取寄件者和收件者的資訊。
寄件者 字串 不適用 不適用 訊息必須來自特定對象,才會遭到封鎖。只有在「寄件者類型」為「電子郵件網域」、「電子郵件地址」或「郵件標頭顯示名稱」時,才需要提供這項資訊。如果選取不同的「來源類型」值,系統會忽略這個參數。
寄件者類型 DDL 不適用 不適用 政策的傳送者類型。
收件者 字串 不適用 不適用 應將訊息傳送給誰,才能封鎖訊息。如果「收件者類型」為下列其中一項,則必須提供此欄位:電子郵件網域、電子郵件地址、郵件標頭顯示名稱。如果選取其他「收件者類型」值,系統會忽略這個參數。
收件者類型 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".

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

如果發生嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:請列印「Error executing action "{action name}"」。原因:{0}''.format(error.Stacktrace)

如果失敗/錯誤有值:執行動作「{動作名稱}」時發生錯誤。原因:fail/errors/message」。

連接器

Mimecast - Message Tracking Connector

說明

從 Mimecast 的「Message Tracking」(郵件追蹤) 分頁中提取郵件相關資訊。 注意:白名單適用於「queueDetailStatus/bounceType」參數。

在 Google SecOps 中設定 Mimecast - Message Tracking Connector

如需在 Google SecOps 中設定連接器的詳細操作說明,請參閱設定連接器

連接器參數

請使用下列參數設定連接器:

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

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

如果找不到環境欄位,環境就是預設環境。

環境規則運算式模式 字串 .*

要對「環境欄位名稱」欄位中的值執行的 regex 模式。

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

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

如果 regex 模式為空值或空白,或環境值為空值,最終環境結果就是預設環境。

指令碼逾時 (秒) 整數值 180 執行目前指令碼的 Python 程序逾時限制。
API 根層級 字串 https:/<<api root>> Mimecast 執行個體的 API 根目錄。
應用程式 ID 字串 不適用 Mimecast 執行個體的應用程式 ID。
應用程式金鑰 密碼 不適用 Mimecast 執行個體的應用程式金鑰。
存取金鑰 密碼 不適用 Mimecast 執行個體的存取金鑰。
密鑰 密碼 不適用 Mimecast 執行個體的密鑰。
網域 CSV 不適用 以半形逗號分隔的網域清單,用於查詢訊息。
最低擷取風險 字串 不適用

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

微不足道、低、中、高。

如未提供任何內容,連接器會擷取所有訊息。

狀態篩選器 CSV 待審核

以半形逗號分隔的郵件狀態篩選器清單。可能的值: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 專業人員尋求答案。