Mimecast

整合版本：9.0

應用實例

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

事前準備

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

必要 Mimecast 產品和服務

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

• 帳戶管理
• 資料保留
• Email Security Cloud Gateway
• 政策管理

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 中設定整合功能的詳細操作說明，請參閱「設定整合功能」。

注意： 如要取得所有必要的設定參數 (Application ID、金鑰和 API Root 網址) 相關資訊和指引，請參閱下列 Mimecast 資源：

• 管理 API 應用程式
• API 1.0 至 2.0 遷移指南 (包含 API 基礎網址)

這項整合功能會用到三個沒有公開說明文件的 Mimecast API 端點。這些端點需要 Mimecast 產品授權才能正常運作。

整合參數

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

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

注意： 日後可視需要變更。設定完成後，即可在應對手冊中使用執行個體。如要詳細瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

乒乓

說明

使用 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) 如果「開始時間」為空白，且「時間範圍」為「自訂」：「執行動作『簡單封存搜尋』時發生錯誤。原因：在「時間範圍」參數中選取「自訂」時，應提供「開始時間」。 如果失敗/錯誤有值：執行「簡單封存搜尋」動作時發生錯誤。原因：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) 如果 fail/errors 有值：執行「進階封存搜尋」動作時發生錯誤。原因：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}」的郵件)。 動作應會失敗並停止執行劇本： 如果發生重大錯誤，例如憑證錯誤、無法連線至伺服器等：「Error executing action "Reject Message". 原因：{0}''.format(error.Stacktrace) 如果失敗/錯誤有值：執行「拒絕訊息」動作時發生錯誤。原因：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) 如果失敗/錯誤有值：執行「發布訊息」動作時發生錯誤。原因：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"。 如果失敗/錯誤有值：列印「Error executing action "Report Message"」。原因：fail/errors/message」。 動作應會失敗並停止執行應對手冊： 如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他問題：列印「Error executing action "Report Message"」。原因：{0}''.format(error.Stacktrace)。	一般

封鎖寄件者

說明

在 Mimecast 中封鎖寄件者。

參數

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

執行日期

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

動作執行結果

指令碼執行結果

指令碼結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止劇本執行： 如果回應中沒有「errors」(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 結果	是
Enrichment Table	否
案件總覽表格	否
案件總覽連結	否
案件總覽附件	否

指令碼執行結果

指令碼結果名稱	值選項
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": "[e-mail]"
       },
       "to": {
           "type": "individual_email_address",
           "emailAddress": "[e-mail]"
       },
       "fromType": "individual_email_address",
       "fromValue": "[e-mail]",
       "toType": "individual_email_address",
       "toValue": "[e-mail]",
       "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 專業人員尋求答案。