Microsoft Graph Mail Delegated

事前準備

設定 Microsoft Graph Mail Delegated 整合前，請先完成下列事項：

1. 建立 Microsoft Entra 應用程式。

2. 設定應用程式的 API 權限。

3. 建立用戶端密鑰。

4. 產生更新權杖。

建立 Microsoft Entra 應用程式

如要建立 Microsoft Entra 應用程式，請完成下列步驟：

1. 以使用者管理員或密碼管理員的身分登入 Azure 入口網站。

2. 選取「Microsoft Entra ID」。

3. 依序前往「App registrations」>「New registration」。

4. 輸入應用程式名稱。

5. 選取合適的支援帳戶類型。

6. 使用下列值設定 Redirect URI：

   1. 平台：Web

   2. 重新導向網址：http://localhost

7. 按一下「註冊」。

   本文提供使用單一租戶設定的範例。由於這項整合功能使用 OAuth 2.0 授權碼流程，因此會出現互動式使用者登入流程。因此，在設定過程中必須提供 Redirect URI。

8. 儲存「Application (client) ID」和「Directory (tenant) ID」值，以便設定整合參數。

設定 API 權限

如要設定整合的 API 權限，請完成下列步驟：

1. 在 Azure 入口網站，依序前往 「API Permissions」 > 「Add a permission」。

2. 依序選取「Microsoft Graph 」>「Delegated permissions」。

3. 在「Select Permissions」(選取權限) 部分，選取下列必要權限：

   • Mail.Read
   • Mail.ReadWrite
   • Mail.Send
   • User.Read
   • Directory.Read.All

4. 按一下「Add permissions」。

5. 按一下「Grant admin consent for ORGANIZATION_NAME」。

   畫面顯示「Grant admin consent confirmation」對話方塊時，按一下「Yes」。

建立用戶端密鑰

如要建立用戶端密鑰，請完成下列步驟：

1. 依序前往「Certificates and secrets」(憑證和密鑰) >「New client secret」(新增用戶端密鑰)。

2. 提供用戶端密鑰的說明，並設定到期期限。

3. 按一下「新增」。

4. 儲存用戶端密鑰的值 (而非密鑰 ID)，以便在設定整合時，將其做為「Client Secret Value」(用戶端密鑰值) 參數值使用。用戶端密鑰值只會顯示一次。

產生更新權杖

如要產生更新權杖，請完成下列步驟：

1. 設定整合參數 (Refresh Token 參數除外) 並儲存。

2. 選用：在 Google SecOps 中模擬案件。

3. 執行「Get Authorization」動作。

4. 執行「Generate Token」動作。

5. 設定 Refresh Token 參數。

選用：模擬案件

如要產生更新權杖，請對任一案件執行手動動作。 如果 Google SecOps 執行個體是新的，且沒有任何案件，請模擬案件。

如要在 Google SecOps 中模擬案件，請按照下列步驟操作：

1. 在左側導覽面板中，選取「案件」。

2. 在「Cases」(案件) 頁面中，依序點選「 add Add a Case」(新增案件) >「Simulate Cases」(模擬案件)。

3. 選取任一預設案件，然後按一下「建立」。無論選擇模擬哪種情況，

4. 按一下「模擬」。

   如果您有預設以外的環境，且想使用該環境，請選取正確的環境，然後按一下「Simulate」(模擬)。

5. 在「案件」分頁中，按一下「重新整理」。模擬的案件會顯示在案件清單中。

執行「取得授權」動作

如要手動執行「Get Authorization」(取得授權) 動作，請完成下列步驟：

1. 在「Cases」(案件) 分頁中，選取任一案件或使用模擬案件，開啟「Case View」(案件檢視畫面)。

2. 在「Case View」(案件檢視畫面) 中，按一下 「Manual Action」(手動操作)。

3. 在手動操作的「Search」(搜尋) 欄位中，輸入 Microsoft Graph Mail Delegated。

4. 在 Microsoft Graph Mail Delegated 整合下方的結果中，選取「Get Authorization」(取得授權)。這項動作會傳回授權連結，用於以互動方式登入 Microsoft Entra 應用程式。

5. 點選「Execute」。

6. 執行動作後，前往案件的「案件總覽」。在「Microsoft Graph Mail Delegated_Get Authorization」動作記錄中，按一下「View More」。複製授權連結。

7. 以無痕模式開啟新的瀏覽器視窗，然後貼上產生的授權網址。Azure 登入頁面會隨即開啟。

8. 使用整合時所用的使用者憑證登入。登入後，瀏覽器會將您重新導向至網址列中含有代碼的網址。

   瀏覽器應該會顯示錯誤，因為應用程式會將您重新導向至 http://localhost。

9. 從網址列複製整個網址和存取碼。

執行「產生權杖」動作

如要手動執行「Generate Token」動作，請完成下列步驟：

1. 在「Cases」(案件) 分頁中，選取任一案件或使用模擬案件，開啟「Case View」(案件檢視畫面)。

2. 在「Case View」(案件檢視) 分頁中，按一下 「Manual Action」(手動處置)。

3. 在手動操作的「Search」(搜尋) 欄位中，輸入 Microsoft Graph Mail Delegated。

4. 在 Microsoft Graph Mail Delegated 整合項目下方的結果中，選取「Generate Token」(產生權杖)。

5. 在「Authorization URL」欄位中，貼上執行「Get Authentication」動作後複製的完整網址和存取碼。

6. 點選「Execute」。

7. 執行動作後，請前往案件的「Case Wall」。在「Microsoft Graph Mail Delegated_Generate Token」動作記錄中，按一下「View More」。

8. 複製產生的更新權杖完整值。

設定更新權杖參數

1. 前往 Microsoft Graph Mail Delegated 整合功能的設定對話方塊。

2. 在「Refresh Token」欄位中，輸入您在「Generate Token」動作中取得的更新權杖值。

3. 按一下 [儲存]。

4. 按一下「Test」(測試)，測試設定是否正確，以及整合是否正常運作。

整合參數

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

如有需要，您可以在後續階段進行變更。設定整合執行個體後，即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

封鎖網域

使用「封鎖網域」動作，將特定電子郵件網域新增至目標信箱的郵件規則，即可封鎖這些網域。如果規則不存在，系統會建立規則。

動作輸入內容

封鎖網域動作需要下列參數：

動作輸出內容

「封鎖網域」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「封鎖網域」動作時，收到的 JSON 結果輸出內容：

{
    "status": "Success",
    "mailbox": "user@domain.com",
    "blocked_domain": "malicious-domain.com"
}

輸出訊息

「Block Domain」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「封鎖網域」動作時，指令碼結果輸出的值：

封鎖寄件者

使用「封鎖寄件者」動作，將指定電子郵件寄件者加入目標信箱的郵件規則，即可封鎖這些寄件者。如果規則不存在，系統會建立規則。

動作輸入內容

「封鎖寄件者」動作需要下列參數：

動作輸出內容

「封鎖寄件者」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「封鎖寄件者」動作時，收到的 JSON 結果輸出內容：

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]

輸出訊息

「封鎖寄件者」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「封鎖寄件者」動作時，指令碼結果輸出的值：

刪除電子郵件

您可以使用「Delete Email」動作，從信箱中刪除一或多封電子郵件。這項操作會根據搜尋條件刪除電子郵件。只要具備適當權限，Delete Email 動作就能將電子郵件移至不同信箱。

這項操作是非同步的。視需要調整 Google SecOps 整合式開發環境 (IDE) 中的動作逾時時間。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「刪除電子郵件」動作需要下列參數：

動作輸出內容

下表說明與「Delete Email」(刪除電子郵件) 動作相關聯的輸出類型：

輸出訊息

「刪除電子郵件」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Delete Email」動作時，指令碼結果輸出的值：

刪除收件匣規則

使用「刪除收件匣規則」動作，刪除指定信箱的特定收件匣郵件規則。 這項操作是非同步的。視需要調整 Google SecOps 整合式開發環境 (IDE) 中的動作逾時時間。

動作輸入內容

「刪除收件匣規則」動作需要下列參數：

動作輸出內容

「刪除收件匣規則」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「Delete Inbox Rules」動作時，收到的 JSON 結果輸出內容：

{
    "deleted_rule": [
        "New test cases"
    ],
    "successful_mailboxes": [
        "labops1@siemplifycyarx.onmicrosoft.com"
    ],
    "failed_mailboxes": [
        "user2@example.com",
        "user3@example.com"
    ]
}

輸出訊息

「刪除收件匣規則」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「刪除收件匣規則」動作時，指令碼結果輸出的值：

下載電子郵件附件

使用「Download Attachments From Email」動作，根據提供的條件從電子郵件下載附件。

這項動作不會在 Google SecOps 實體上執行。

這項操作是非同步的。如有需要，請在 Google SecOps IDE 中調整指令碼逾時值。

這項動作會取代 \` forward slash or/backslash characters in the names of the downloaded attachments with the_` 底線字元。

動作輸入內容

「Download Attachments From Email」(從電子郵件下載附件) 動作需要下列參數：

動作輸出內容

「Download Attachments From Email」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「Download Attachments From Email」動作時，收到的 JSON 結果輸出內容：

[
    {
        "attachment_name": "name1.png",
        "downloaded_path": "file_path/name1.png"
    },
    {
        "attachment_name": "name2.png",
        "downloaded_path": "file_path/name2.png"
    }
]

輸出訊息

「Download Attachments From Email」(下載電子郵件附件) 動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Download Attachments From Email」動作時，指令碼結果輸出的值：

從附加的 EML 擷取資料

使用「Extract Data From Attached EML」動作，從電子郵件 EML 附件中擷取資料，並在動作結果中傳回。這項動作支援 .eml、.msg 和 .ics 檔案格式。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Extract Data From Attached EML」動作需要下列參數：

{ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}
    

動作輸出內容

「Extract Data From Attached EML」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「Extract Data From Attached EML」動作時，收到的 JSON 結果輸出內容：

[
    {
        "type": "EML",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.eml"
    },
    {
        "type": "MSG",
        "subject": "examplesubject",
        "from": "user@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>examplehtml</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.msg"
    },
    {
        "type": "ICS",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.ics"
    }
]

輸出訊息

「Extract Data From Attached EML」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Extract Data From Attached EML」動作時，指令碼結果輸出的值：

轉寄電子郵件

使用「轉寄電子郵件」動作，轉寄包含先前討論串的電子郵件。只要具備適當權限，這項動作就能從與整合設定中指定的信箱不同的信箱傳送電子郵件。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「轉寄電子郵件」動作需要下列參數：

動作輸出內容

下表說明與「Forward Email」(轉寄電子郵件) 動作相關聯的輸出類型：

輸出訊息

「轉寄電子郵件」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Forward Email」(轉寄電子郵件) 動作時，指令碼結果輸出的值：

產生權杖

使用「Generate Token」(產生權杖) 動作，為採用委派驗證的整合設定取得更新權杖。使用您在取得授權動作中收到的授權網址。

這項動作不會在 Google SecOps 實體上執行。

首次產生更新權杖後，建議您設定並啟用更新權杖續約工作，讓工作自動續約並保持更新權杖有效。

動作輸入內容

「Generate Token」動作需要下列參數：

動作輸出內容

「Generate Token」動作會提供下列輸出內容：

輸出訊息

「Generate Token」動作可能會傳回下列輸出訊息：

指令碼執行結果

下表列出使用「Generate Token」(產生權杖) 動作時，指令碼結果輸出的值：

可取得授權作業

使用「Get Authorization」動作，取得委派驗證存取碼的連結。複製整個連結，並在「Generate Token」(產生權杖) 動作中使用，即可取得更新權杖。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

無

動作輸出內容

「Get Authorization」動作會提供下列輸出內容：

輸出訊息

「Get Authorization」動作可能會傳回下列輸出訊息：

指令碼執行結果

下表列出使用「Get Authorization」動作時，指令碼結果輸出的值：

取得信箱帳戶的「不在辦公室」設定

使用「Get Mailbox Account Out Of Facility Settings」動作，擷取所提供 Google SecOps User 實體的信箱帳戶不在辦公室 (OOF) 設定。

「Get Mailbox Account Out Of Facility Settings」動作會使用 Microsoft Graph API 的 Beta 版。

這項動作會在 Google SecOps User 實體上執行。

動作輸入內容

無

動作輸出內容

「Get Mailbox Account Out Of Facility Settings」動作會提供下列輸出內容：

JSON 結果

以下範例顯示使用「Get Mailbox Account Out Of Facility Settings」動作時，收到的 JSON 結果輸出內容：

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
   "id": "ID",
   "availability": "Offline",
   "activity": "Offline",
   "statusMessage": null,
   "outOfOfficeSettings": {
       "message": "\n\nOut Of Facility111\n",
       "isOutOfOffice": true
   }
}

輸出訊息

「Get Mailbox Account Out Of Facility Settings」動作可能會傳回下列輸出訊息：

指令碼執行結果

下表列出使用「Get Mailbox Account Out Of Facility Settings」動作時，指令碼結果輸出的值：

清單規則

使用「List Rules」動作，透過 Microsoft Graph API 列出特定信箱的所有郵件規則。

動作輸入內容

List Rules 動作需要下列參數：

動作輸出內容

「List Rules」(列出規則) 動作會提供下列輸出內容：

案件總覽表格

「List Rules」動作會在案件牆表格中提供執行詳細資料。

JSON 結果

以下範例說明使用「List Rules」動作時，收到的 JSON 結果輸出內容：

[
  {
    "mailbox": "user@example.com",
    "rules": [
      {
        "id": "AAMkAD...",
        "displayName": "Google SecOps - Blocked Senders",
        "sequence": 1,
        "isEnabled": true
      }
    ]
  }
]

輸出訊息

「List Rules」(列出規則) 動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「List Rules」(列出規則) 動作時，指令碼結果輸出的值：

將電子郵件標示為垃圾郵件

使用「將電子郵件標示為垃圾郵件」動作，將指定信箱中的電子郵件標示為垃圾郵件。這項操作會將電子郵件寄件者加入封鎖的寄件者清單，並將郵件移至「垃圾郵件」資料夾。

「將電子郵件標示為垃圾郵件」動作會使用 Beta 版 Microsoft Graph API。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「將電子郵件標示為垃圾郵件」動作需要下列參數：

動作輸出內容

「將電子郵件標示為垃圾郵件」動作會提供下列輸出內容：

輸出訊息

「將電子郵件標示為垃圾郵件」動作可能會傳回下列輸出訊息：

指令碼執行結果

下表列出使用「將電子郵件標示為垃圾郵件」動作時，指令碼結果輸出的值：

將電子郵件標示為非垃圾郵件

使用「將電子郵件標示為非垃圾郵件」動作，將特定信箱中的電子郵件標示為非垃圾郵件。這項操作會將寄件者從封鎖清單中移除，並將郵件移至「收件匣」資料夾。

「將電子郵件標示為非垃圾郵件」動作會使用 Beta 版 Microsoft Graph API。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「將電子郵件標示為非垃圾郵件」動作需要下列參數：

動作輸出內容

「將電子郵件標示為非垃圾郵件」動作會提供下列輸出內容：

輸出訊息

「將電子郵件標示為非垃圾郵件」動作可能會傳回下列輸出訊息：

指令碼執行結果

下表列出使用「將電子郵件標示為非垃圾郵件」動作時，指令碼結果輸出的值：

將電子郵件移至資料夾

使用「Move Email To Folder」動作，將一或多封電子郵件從來源電子郵件資料夾移至信箱中的其他資料夾。只要具備適當權限，這項動作就能將電子郵件移至其他信箱，不限於整合設定中提供的信箱。

這項操作是非同步的。視需要調整 Google SecOps 整合式開發環境 (IDE) 中的動作逾時時間。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

如要設定「Move Email To Folder」動作，請使用下列參數：

動作輸出內容

下表說明與「Move Email To Folder」(將電子郵件移至資料夾) 動作相關聯的輸出類型：

輸出訊息

「Move Email To Folder」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Move Email To Folder」(將電子郵件移至資料夾) 動作時，指令碼結果輸出的值：

乒乓

使用 Ping 動作，測試與 Microsoft Graph 郵件服務的連線。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

無

動作輸出內容

下表說明與 Ping 動作相關聯的輸出類型：

輸出訊息

Ping 動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用 Ping 動作時，指令碼結果輸出的值：

執行 Microsoft 搜尋查詢

使用「執行 Microsoft 搜尋查詢」動作，透過 Microsoft 搜尋引擎執行搜尋。搜尋時會使用您指定的建構基本或進階查詢。如要進一步瞭解 Microsoft Search，請參閱「Overview of the Microsoft Search API in Microsoft Graph」(Microsoft Graph 中的 Microsoft Search API 總覽)。

視實體範圍而定，您可能需要設定額外權限，才能執行「Run Microsoft Search Query」搜尋查詢動作。如要進一步瞭解特定實體類型所需的權限，請參閱「使用 Microsoft Search API 查詢資料」。如要進一步瞭解如何設定整合功能的權限，請參閱「設定 API 權限」。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Run Microsoft Search Query」(執行 Microsoft 搜尋查詢) 動作需要下列參數：

動作輸出內容

「Run Microsoft Search Query」動作會提供下列輸出內容：

輸出訊息

「Run Microsoft Search Query」(執行 Microsoft 搜尋查詢) 動作可能會傳回下列輸出訊息：

指令碼執行結果

下表列出使用「執行 Microsoft 搜尋查詢」動作時，指令碼結果輸出的值：

移除封鎖網域

使用「移除封鎖網域」動作，從目標信箱的郵件規則中移除指定的電子郵件網域。如果規則變成空白，就會遭到刪除。

動作輸入內容

「Remove Block Domain」動作需要下列參數：

動作輸出內容

「Remove Block Domain」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「Remove Block Domain」動作時，收到的 JSON 結果輸出內容：

[
  {
    "Entity": "example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "user@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]

輸出訊息

「Remove Block Domain」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Remove Block Domain」動作時，指令碼結果輸出的值：

移除封鎖寄件者

使用「移除封鎖寄件者」動作，從目標信箱的郵件規則中移除指定電子郵件寄件者。如果規則變成空白，就會遭到刪除。

動作輸入內容

「Remove Block Sender」動作需要下列參數：

動作輸出內容

「Remove Block Sender」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「移除封鎖寄件者」動作時，收到的 JSON 結果輸出內容：

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]

輸出訊息

「Remove Block Sender」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Remove Block Sender」動作時，指令碼結果輸出的值：

將電子郵件儲存至案件

使用「Save Email To The Case」動作，將電子郵件或電子郵件附件儲存至 Google SecOps 案件牆。只要具備適當權限，這項動作就能儲存其他信箱的電子郵件，不限於整合設定中提供的信箱。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Save Email To The Case」動作需要下列參數：

動作輸出內容

下表說明與「Save Email To The Case」動作相關聯的輸出類型：

案件總覽附件

下列附件與「Save Email To The Case」動作相關聯：

• EMAIL_SUBJECT.eml：如果動作會儲存電子郵件。

• 如果動作會儲存附件，附件名稱會包含副檔名 (如有)。

JSON 結果

以下範例說明使用「Save Email To The Case」動作時，收到的 JSON 結果輸出內容：

{
    "id": "ID",
    "createdDateTime": "2024-02-16T14:10:34Z",
    "eml_info": "example_info",
    "lastModifiedDateTime": "2024-02-16T14:10:41Z",
    "changeKey": "cxsdjjh",
    "categories": [],
    "receivedDateTime": "2024-02-16T14:10:35Z",
    "sentDateTime": "2024-02-16T14:09:36Z",
    "hasAttachments": true,
    "internetMessageId": "INTERNET_MESSAGE_ID",
    "subject": "all attachments",
    "bodyPreview": "all the attachments",
    "importance": "normal",
    "parentFolderId": "PARENT_FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "example-index",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com/",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "<html><head>example-html</head></html>"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

輸出訊息

在案件總覽中，「Save Email To The Case」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Save Email To The Case」動作時，指令碼結果輸出的值：

搜尋電子郵件

使用「搜尋電子郵件」動作，根據提供的搜尋條件在預設信箱中執行電子郵件搜尋。只要具備適當權限，這項動作就能在其他信箱中執行搜尋。

這項操作是非同步的。視需要調整 Google SecOps IDE 中的動作逾時時間。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「搜尋電子郵件」動作需要下列參數：

動作輸出內容

「搜尋電子郵件」動作會提供下列輸出內容：

案件總覽表格

「搜尋電子郵件」動作可產生下表：

表格標題：Matching Mails

欄：

• 郵件 ID
• Subject
• Sender
• 接收端
• Received Date

指令碼執行結果

下表列出使用「搜尋電子郵件」動作時，指令碼結果輸出的值：

動作輸出訊息

「搜尋電子郵件」動作會提供下列輸出訊息：

傳送電子郵件

使用「傳送電子郵件」動作，從特定信箱傳送電子郵件給任意收件者清單。

這項動作可以傳送純文字或 HTML 格式的電子郵件。只要具備適當權限，這項動作就能從整合設定指定以外的信箱傳送電子郵件。

這項動作不會在 Google SecOps 實體上執行。

S/MIME 設定快速參考

請參考下表，根據外寄電子郵件的安全等級，決定要設定哪些 S/MIME 參數：

將憑證檔案轉換為 Base64

如要將憑證和私密金鑰檔案編碼為動作參數的單行 Base64 字串，請執行下列指令：

Linux 和 macOS：

base64 -w 0 sender_cert.crt
base64 -w 0 sender_key.key

Windows PowerShell：

[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\certificate.crt"))
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\private_key.key"))

動作輸入內容

「傳送電子郵件」動作需要下列參數：

動作輸出內容

下表說明與「傳送電子郵件」動作相關聯的輸出類型：

輸出訊息

「傳送電子郵件」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Send Email」(傳送電子郵件) 動作時，指令碼結果輸出的值：

傳送電子郵件 HTML

使用「Send Email HTML」動作，透過 Google SecOps HTML 範本，從特定信箱傳送電子郵件給任意收件者清單。只要具備適當權限，這項動作就能從預設信箱以外的信箱傳送電子郵件。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Send Email HTML」(傳送電子郵件 HTML) 動作需要下列參數：

動作輸出內容

「Send Email HTML」(傳送電子郵件 HTML) 動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「Send Email HTML」動作時，收到的 JSON 結果輸出內容：

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "example-key",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "outlook.com",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "ID",
    "conversationId": "ID",
    "conversationIndex": "INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

輸出訊息

在案件牆上，「Send Email HTML」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「傳送電子郵件 HTML」動作時，指令碼結果輸出的值：

傳送討論串回覆

使用「Send Thread Reply」動作，傳送訊息做為電子郵件討論串的回覆。只要具備適當權限，這項動作就能從整合設定指定以外的信箱傳送電子郵件。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Send Thread Reply」動作需要下列參數：

動作輸出內容

下表說明與「傳送討論串回覆」動作相關聯的輸出類型：

JSON 結果

以下範例顯示使用「Send Thread Reply」動作時，收到的 JSON 結果輸出內容：

  {
    "id": "yyyy",
    "createdDateTime": "2024-02-02T10:57:18Z",
    "lastModifiedDateTime": "2024-02-02T10:57:23Z",
    "changeKey": "dsf+oAAQLaPjk",
    "categories": [],
    "receivedDateTime": "2024-02-02T10:57:20Z",
    "sentDateTime": "2024-02-02T10:57:19Z",
    "hasAttachments": true,
    "internetMessageId": "sdfhsjdfhjsdjfd",
    "subject": "RE: reply checking",
    "bodyPreview": "Reply check kr",
    "importance": "normal",
    "parentFolderId": "id",
    "conversationId": "id",
    "conversationIndex": "sdghfjfke",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": "Reply check kr"
    },
    "sender": {
      "emailAddress": {
        "name": "aff",
        "address": "ddxsm@a.com"
      }
    },
    "from": {
      "emailAddress": {
        "name": "fasf",
        "address": "ddxsm@a.com"
      }
    },
    "toRecipients": [
      {
        "emailAddress": {
          "name": "wf",
          "address": "ddxsm@a.com"
        }
      }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
      "contentType": "html",
      "content": "Reply check"
    },
    "flag": {
      "flagStatus": "notFlagged"
    }
  }

輸出訊息

「傳送討論串回覆」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「傳送討論串回覆」動作時，指令碼結果輸出的值：

傳送投票電子郵件

使用「傳送投票電子郵件」動作，傳送含有預先定義回答選項的電子郵件。這項動作會使用 Google SecOps HTML 範本設定電子郵件格式。只要具備適當權限，Send Vote Email 動作就能從預設信箱以外的信箱傳送電子郵件。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Send Vote Email」動作需要下列參數：

動作輸出內容

「Send Vote Email」動作會提供下列輸出內容：

JSON 結果

以下範例說明使用「Send Vote Email」動作時，收到的 JSON 結果輸出內容：

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "KEY",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "<example-message-ID>",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "CONVERSATION_INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

輸出訊息

在案件總覽中，「傳送投票電子郵件」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Send Vote Email」動作時，指令碼結果輸出的值：

等待使用者傳送電子郵件

使用「等待使用者傳送電子郵件」動作，根據透過「傳送電子郵件」動作傳送的電子郵件，等待使用者回覆。

這項操作是非同步的。視需要調整 Google SecOps IDE 中的動作逾時時間。如果將逾時時間設為 0 或留空，系統會使用環境設定中設定的預設逾時時間。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「等待使用者傳送電子郵件」動作需要下列參數：

動作輸出內容

「Wait For Email From User」動作會提供下列輸出內容：

案件總覽附件

下列案件牆附件與「等待使用者電子郵件」動作相關聯：

類型：實體

附件內容：標題、檔案名稱 (包含副檔名，如有)、fileContent。

• 標題：RECIPIENT_EMAIL 回覆附件。
• 檔案名稱：ATTACHMENT_FILENAME + FILE_EXTENSION
• fileContent: CONTENT_OF_THE_ATTACHED_FILE

案件總覽表格

「Wait For Email From User」動作可產生下表：

表格標題：Matching Mails

欄：

• 郵件 ID
• Received Date
• Sender
• 收件者
• Subject

指令碼執行結果

下表列出使用「等待使用者傳送電子郵件」動作時，指令碼結果輸出的值：

動作輸出訊息

「等待使用者傳送電子郵件」動作會提供下列輸出訊息：

等待投票電子郵件結果

使用「Wait For Vote Email Results」動作，根據使用「Send Vote Email」動作傳送的投票電子郵件，等待使用者回覆。

這項操作是非同步的。視需要調整 Google SecOps IDE 中的動作逾時時間。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Wait For Vote Email Results」動作需要下列參數：

動作輸出內容

「Wait For Vote Email Results」動作會提供下列輸出內容：

案件總覽附件

下列案件總覽附件與「Wait For Vote Email Results」(等待投票電子郵件結果) 動作相關聯：

類型：實體

附件內容：標題、檔案名稱 (包含副檔名，如有)、fileContent。

• 標題：RECIPIENT_EMAIL 回覆附件。
• 檔案名稱：ATTACHMENT_FILENAME + FILE_EXTENSION
• fileContent: CONTENT_OF_THE_ATTACHED_FILE

案件總覽表格

在案件總覽中，「Wait For Email Results」(等待電子郵件結果) 動作會產生下列資料表：

表格標題：Matching Mails

欄：

• 郵件 ID
• Received Date
• Sender
• 收件者
• Subject

JSON 結果

以下範例說明使用「Wait For Vote Email Results」動作時，收到的 JSON 結果輸出內容：

{
    "Responses": [
        {
            "recipient": "user@example.com",
            "vote": "Approve"
        }
    ]
}

輸出訊息

「Wait For Vote Email Results」動作會提供下列輸出訊息：

指令碼執行結果

下表說明使用「Wait For Vote Email Results」動作時，指令碼結果輸出的值：

連接器

如要進一步瞭解如何在 Google SecOps 中設定連接器，請參閱「擷取資料 (連接器)」。

Microsoft Graph Mail 委派連接器

使用 Microsoft Graph Mail Delegated 連接器，從 Microsoft Graph 郵件服務擷取電子郵件。

Microsoft Graph Mail Delegated 連接器在 Microsoft 365 中使用委派驗證，且使用者必須透過互動式登入，才能連線至 Microsoft 365。

使用動態清單，透過規則運算式篩選電子郵件內文和主旨部分中的指定值。根據預設，連接器會使用規則運算式篩除電子郵件中的網址。

連接器使用條件

如要使用 Microsoft Graph Mail Delegated 連接器，您必須設定整合參數，並產生更新權杖。

連接器輸入

連接器規則

連接器支援 Proxy。

工作

如要在 Google SecOps 中設定工作，請完成下列步驟：

1. 在左側導覽面板中，依序選取「Response」>「Job Scheduler」。
2. 在「Jobs」(工作) 分頁中，按一下「 add Create New Job」(建立新工作)。
3. 從清單中選取所需工作，然後按一下「儲存」。
4. 繼續設定工作。

更新權杖續約工作

使用更新權杖更新工作，定期更新整合的更新權杖。

根據預設，更新權杖每 90 天會到期。建議您將這項工作設為每 7 或 14 天自動執行一次，確保更新權杖保持在最新狀態。

工作輸入內容

更新權杖續約工作需要下列參數：

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