EmailV2 を Google SecOps と統合する

このドキュメントでは、EmailV2 を Google Security Operations（Google SecOps）と統合する方法について説明します。

ユースケース

EmailV2 統合では、Google SecOps の機能を使用して、次のユースケースをサポートします。

  • フィッシングのトリアージと通知: 外部ユーザーを含む受信者に通知メールを送信するプロセスを自動化し、ユーザーの応答（フィッシングの試行の確認など）を待機する非同期ハンドブックを設定します。

  • インシデント データの拡充と保持: 条件（送信者や件名など）に基づいて関連するメールをメールボックスで検索し、不審なメールの添付ファイルをすべてケースウォールに直接保存して、フォレンジック分析とデータ保持を行います。

  • メールボックスの管理と封じ込め: 悪意のあるメールやトリアージされたメールを受信トレイから検疫フォルダまたはアーカイブ フォルダに自動的に移動します。また、特定のフィルタに一致するメールを完全に削除します（複数のフォルダに存在する既知のマルウェア メールのすべてのコピーを削除するなど）。

  • スレッド形式の返信とコラボレーション: [Send Thread Reply] アクションを使用して、既存のメールスレッド内で即時返信または構造化された返信を送信し、関連するセキュリティ アップデートをすべての関係者に確実に通知します。

始める前に

EmailV2 統合を有効にしてメールサーバーに正常に接続するには、構成されたメールボックスが IMAP/SMTP を使用してサードパーティ アプリケーションにアクセスできるようにする必要があります。

Gmail アカウントまたは Google Workspace アカウントを使用している場合は、アプリ パスワードを使用して認証する必要があります。標準のアカウント パスワードは、 Google サーバーへの IMAP / SMTP 接続には使用できません。

アプリ パスワードを使用するには、次の要件を満たしている必要があります。

  1. 2 段階認証プロセスを有効にする: アプリ パスワードは、 Google アカウントで 2 段階認証プロセスが有効になっている場合にのみ生成できます。詳しくは、2 段階認証プロセスを有効にするをご覧ください。

  2. 16 桁のアプリ パスワードを生成する: 統合用の一意のパスコードを作成します。詳しくは、アプリ パスワードでログインするをご覧ください。

IMAP / SMTP へのネットワーク アクセス

IMAP を使用して受信メールにアクセスして処理し、SMTP を使用して送信メールを送信するには、構成されたアカウント認証情報を使用してネットワークにアクセスする必要があります。

ネットワークの要件

関数 デフォルト ポート 方向 プロトコル
メールサーバー通信 複数の値 送信 IMAP / SMTP

統合のパラメータ

EmailV2 統合には、次のパラメータが必要です。

パラメータ 説明
IMAP - Use SSL

省略可。

選択すると、IMAP サーバーへの接続時に安全な通信（SSL / TLS）が有効になります。

デフォルトで有効になっています。
SMTP - Use Authentication

省略可。

選択すると、SMTP 接続の認証が有効になります。

これは、SMTP サーバーが「オープン リレー」構成ではなく、送信メールの送信に認証情報が必要な場合に必要です。

デフォルトで有効になっています。
Sender's Address

必須。

統合でメッセージの送受信に使用されるメールボックスのメールアドレス。
Sender's Display Name

必須。

統合でメールを送信するときに送信者として表示される名前。
SMTP Server Address

省略可。

メールの送信に使用される SMTP サーバーの DNS ホスト名または IP アドレス（smtp.gmail.com など）。
SMTP Port

省略可。

SMTP サーバーへの接続に使用するポート番号（587、465 など）。
IMAP Server Address

省略可。

受信メールの取得に必要な IMAP サーバーの DNS ホスト名または IP アドレス（imap.gmail.com など）。
IMAP Port

省略可。

IMAP サーバーへの接続に使用するポート番号（993 など）。
Username

必須。

メールサーバーでの認証に必要なユーザー名（通常は完全なメールアドレス）。
Password

必須。

メールサーバーでの認証に必要なパスワード。

Gmail または Google Workspace アカウントの場合は、 Googleアカウントのセキュリティ設定で生成された 16 桁のアプリ パスワードを入力する必要があります。

Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

メールを削除する

[メールを削除] アクションを使用して、指定した検索条件に一致するメールをメールボックスから削除します。このアクションを使用すると、最初に一致したメールを削除するか、一致するすべてのメールを削除できます。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

メールを削除アクションには、次のパラメータが必要です。

パラメータ 説明
Folder Name

必須。

アクションによってメールを検索するメールボックス フォルダのカンマ区切りのリスト。
Message IDs

省略可。

検索して削除する特定のメッセージ ID のカンマ区切りのリスト。

指定すると、このリストは Subject Filter、Sender Filter、Recipient Filter をオーバーライドします。
Subject Filter

省略可。

一致するメールの検索を絞り込むために使用される件名。
Sender Filter

省略可。

一致するメールの検索に使用される送信者のアドレス。
Recipient Filter

省略可。

一致するメールの検索に使用される受信者のアドレス。
Days Back

省略可。

削除するメールを検索する期間（日数）。

対象の期間は日単位で計算されます。

0 の値を使用すると、検索対象が当日に受信したメールのみに制限されます。

デフォルト値は 0 です。
Delete all matching emails

省略可。

選択すると、指定した条件に一致するすべてのメールが削除されます。選択しない場合は、最初に一致したメールのみが削除されます。

デフォルトでは無効にされています。

アクションの出力

[Delete Email] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Delete Email アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "deleted_emails": {
        "email_1_deleted": {
            "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
            "deleted_from_folder": "Inbox",
            "subject": "Suspicious Login Alert - Deleted",
            "sender": "noreply@system.com",
            "timestamp": "2025-11-20T14:30:00Z"
        },
        "email_2_deleted": {
            "message_id": "<u1v2w3x4y5z6a7b8c9d0e1f2g3h4i5j6k7l8m9n0@mail.example.com>",
            "deleted_from_folder": "Spam",
            "subject": "Phishing Offer",
            "sender": "scam@badsite.net",
            "timestamp": "2025-11-15T09:15:00Z"
        }
    }
}
出力メッセージ

Delete Email アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

NUMBER_OF_DELETED_EMAILS email(s) were deleted successfully

Failed to find emails for deletion!

 アクションが成功しました。

Error deleting emails ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、メールを削除アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

DownloadEmailAttachments

メールの添付ファイルをダウンロードアクションを使用して、特定のメールから添付ファイルを取得し、Google SecOps サーバーの指定されたパスに保存します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

メールの添付ファイルをダウンロードアクションには、次のパラメータが必要です。

パラメータ 説明
Folder Name

必須。

アクションによってメールを検索するメールボックス フォルダのカンマ区切りのリスト。

デフォルト値は Inbox です。
Download Path

必須。

ダウンロードした添付ファイルが保存される Google SecOps サーバー上のパス。
Message IDs

省略可。

アタッチメントをダウンロードするメッセージ ID のカンマ区切りのリスト。
Subject filter

省略可。

メールの検索を絞り込むために使用される件名。

アクションの出力

メールの添付ファイルをダウンロードアクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

メールの添付ファイルをダウンロードするアクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Downloaded NUMBER_OF_ATTACHMENTS attachments. ATTACHMENT_PATHS

 アクションが成功しました。

failed to download email attachments, the error is: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Download Email Attachments] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
attachments_local_paths 保存された添付ファイルへのカンマ区切りのフルパスの文字列。

メールを転送する

[メールを転送] アクションを使用すると、元のメールの一意のメッセージ ID を指定して、以前のスレッド コンテンツを含む既存のメールを新しい受信者に送信できます。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

メールを転送アクションには、次のパラメータが必要です。

パラメータ 説明
Folder Name

必須。

元のメールが保存されているメールボックス フォルダ。

  • 複数のフォルダを確認する場合は、カンマ区切りのリストを指定します。
  • フォルダ名は IMAP フォルダと完全に一致している必要があります。
  • フォルダ名にスペースが含まれている場合は、二重引用符で囲む必要があります。

デフォルト値は Inbox です。
Message ID of the email to forward

必須。

アクションが転送する既存のメールの一意の message_id。
Recipients

必須。

新しい受信者のメインのメールアドレスのカンマ区切りのリスト。
CC

省略可。

CC フィールドに含めるメールアドレスのカンマ区切りのリスト。
BCC

省略可。

BCC フィールドに含めるメールアドレスのカンマ区切りのリスト。
Subject

必須。

転送メールの件名。
Content

省略可。

転送メールに含める追加の本文コンテンツ。
Return message id for the forwarded email

省略可。

選択すると、アクションによって、新しく転送されたメールの一意のメッセージ ID が JSON の結果で返されます。

デフォルトでは無効にされています。
Attachment Paths

省略可。

追加の添付ファイルのサーバー上のファイルパスのカンマ区切りリスト。

アクションの出力

メールを転送アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、メールを転送アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
   "Date"
   "message_id"
   "Recipient"
}
出力メッセージ

メールを転送するアクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Email was forwarded successfully.

Mail was forwarded successfully. Mail message ID is: MESSAGE_ID

 アクションが成功しました。

Failed to forward the email! The Error is ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Forward Email] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

メールをフォルダに移動する

[Move Email to Folder] アクションを使用して、指定した移行元フォルダからメールボックス内の別の移行先フォルダにメールを転送します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Move Email to Folder] アクションには、次のパラメータが必要です。

パラメータ 説明
Source Folder Name

必須。

メールの移動元となるフォルダの名前。
Destination Folder Name

必須。

メールの移動先フォルダの名前。
Message IDs

省略可。

検索して移動する特定のメッセージ ID のカンマ区切りのリスト。

指定されている場合、このリストは Subject Filter をオーバーライドします。
Subject Filter

省略可。

一致するメールの検索を絞り込むために使用される件名。
Only Unread

省略可。

選択すると、未読メールのみが検索結果に表示されます。

デフォルトでは無効にされています。

アクションの出力

[Move Email to Folder] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Move Email to Folder アクションを使用した場合に受信される JSON 結果の出力です。

{
    "emails": {
        "email_1": {
            "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1@mail.example.com>",
            "received": "Mon, 24 Nov 2025 10:00:00 +0000",
            "sender": "security-alert@example.com",
            "recipients": "user@example.com",
            "subject": "Phishing Alert: Urgent Action Required",
            "plaintext_body": "Original alert content...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Quarantine"
        },
        "email_2": {
            "message_id": "<a5b6c7d8e9f01g2h3i4j5k6l7m8n9o0p1q2r3s4t@mail.example.com>",
            "received": "Sun, 23 Nov 2025 14:30:00 +0000",
            "sender": "noreply@system.com",
            "recipients": "user@example.com",
            "subject": "System Update Notification",
            "plaintext_body": "System update successful...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Archive"
        }
    }
}
出力メッセージ

メールをフォルダに移動アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

NUMBER_OF_MOVED_EMAILS mails were successfully moved from SOURCE_FOLDER～ DESTINATION_FOLDER

No mails were found matching the search criteria!

 アクションが成功しました。

Error search emails: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Move Email to Folder] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

Ping

Ping アクションを使用して、Email V2 への接続をテストします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

Ping アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

Ping アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully connected to the email server server with the provided connection parameters!

 アクションが成功しました。

Failed to connect to the IMAP server! Error is ERROR_REASON

Failed to connect to the SMTP server! Error is ERROR_REASON

SMTP (or IMAP) configuration is needed to execute action. Please configure STMP (or IMAP) on integration configuration page in Content Hub.

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

メールの添付ファイルをケースに保存する

[Save Email Attachments to Case] アクションを使用して、メールボックス内の特定のメールから添付ファイルを取得し、現在のケースのケースウォールに直接自動的に保存します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Save Email Attachments to Case アクションには、次のパラメータが必要です。

パラメータ 説明
Folder Name

必須。

アクションによってメールを検索するメールボックス フォルダのカンマ区切りのリスト。
Message ID

省略可。

添付ファイルをダウンロードするメールの一意のメッセージ ID。
Attachment To Save

省略可。

保存する添付ファイルの具体的な名前。

値を指定しない場合、アクションはメールのすべての添付ファイルをケースウォールに保存します。

アクションの出力

Save Email Attachments to Case アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Save Email Attachments to Case アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "saved_attachments_from_email": {
        "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
        "subject": "Email with Malicious Attachment",
        "sender": "external@suspicious.com",
        "attachments_saved": [
            {
                "file_name": "Invoice_Q3_2025.pdf",
                "file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
                "saved_to_case_wall": "True"
            },
            {
                "file_name": "Report_Data.docx",
                "file_hash_md5": "b3e0c1a9f8d7c6b5a4e3d2c1b0a9f8e7",
                "saved_to_case_wall": "True"
            }
        ]
    }
}
出力メッセージ

[Save Email Attachments to Case] アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully saved the following attachments from the email MESSAGE_ID: MESSAGE_INFO

 アクションが成功しました。

Failed to save the email attachments to the case, the error is: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Save Email Attachments to Case アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

メールを検索

メールを検索アクションを使用すると、さまざまなフィルタ条件を使用して、構成済みのメールボックス内の特定のメールを検索できます。

このアクションは、一致するメッセージの詳細を JSON ファイルで取得します。このファイルは、後続の自動分析または手動分析に使用できます。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

メールを検索アクションには、次のパラメータが必要です。

パラメータ 説明
Folder Name

必須。

アクションによってメールを検索するメールボックス フォルダのカンマ区切りのリスト。

デフォルト値は Inbox です。
Subject Filter

省略可。

一致するメールの検索を絞り込むために使用される件名。
Sender Filter

省略可。

一致するメールの検索に使用される送信者のアドレス。
Recipient Filter

省略可。

一致するメールの検索に使用される受信者のアドレス。
Time frame (minutes)

必須。

メールを検索する期間（分単位）。

デフォルト値は 60 です。
Only Unread

省略可。

選択すると、未読メールのみが検索されます。

デフォルトで無効
Max Emails To Return

必須。

アクションが結果として返すメールの最大数。

デフォルト値は 100 です。

アクションの出力

Search Email アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Search Email アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "emails": {
        "email_1": {
            "message id": "<CAJP=A_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Mon, 26 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user1@example.com,user2@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "pdfdocument.pdf",
            "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        },
        "email_2": {
            "message id": "<WEAA=D_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Wen, 21 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user3@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "photo.jpg",        "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
            "attachmment_2": "word_document.docx",
            "attachment_2_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        }
    }
}
出力メッセージ

Search Email アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Search found NUMBER_OF_FOUND_EMAILS emails based on the provided search criteria

Search didn't found any matching emails

 アクションが成功しました。

Search didn't completed successfully due to error: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、メールを検索アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

メールを送信する

[Send Email] アクションを使用して、構成されたメールボックスから複数の受信者にメールを送信します。

このアクションは、必要に応じてメッセージ ID を返します。この ID は、ユーザーのメールを待機アクションで使用して、ユーザーの返信を追跡し、ハンドブックの実行を制御できます。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[メールを送信] アクションには、次のパラメータが必要です。

パラメータ 説明
Recipients

必須。

メインの受信者のメールアドレス。

複数のアドレスを指定する場合は、カンマで区切る必要があります。
CC

省略可。

カーボンコピー（CC）フィールドに含めるメールアドレス。

複数のアドレスを指定する場合は、カンマで区切る必要があります。
Bcc

省略可。

ブラインド カーボンコピー（Bcc）フィールドに含めるメールアドレス。

複数のアドレスを指定する場合は、カンマで区切る必要があります。
Subject

必須。

メール メッセージの件名。
Content

必須。

メール メッセージの本文。
Return message id for the sent email

省略可。

選択すると、アクションによって JSON の結果に一意のメッセージ ID が返されます。

この ID は、ユーザーのメールを待機アクションで返信を追跡するために使用できます。

デフォルトでは無効にされています。
Attachments Paths

省略可。

添付ファイルのサーバー上の絶対ファイルパスのカンマ区切りのリスト。

アクションの出力

[Send Email] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、メールを送信アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1-10013525-100078757@example.com>"
}
出力メッセージ

Send Email アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Mail sent successfully.

Mail sent successfully. Mail message ID is: MESSAGE_ID

 アクションが成功しました。

Execution Failed: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、メールを送信アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

スレッド返信を送信する

[スレッドの返信を送信] アクションを使用して、元のメッセージ ID を使用して既存のメールスレッド内で返信として新しいメッセージを送信します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Send Thread Reply] アクションには、次のパラメータが必要です。

パラメータ 説明
Message ID

必須。

返信の送信先となるメッセージの一意の ID。
Folder Name

必須。

アクションによって元のメールを検索するメールボックス フォルダのカンマ区切りのリスト。

フォルダ名は IMAP フォルダと完全に一致している必要があります。名前にスペースが含まれている場合は、二重引用符で囲む必要があります（例: "[Gmail]/All Mail"）。

デフォルト値は Inbox です。
Content

必須。

返信メッセージの本文。
Attachment Paths

省略可。

返信に含める添付ファイルのサーバー上のファイルパスのカンマ区切りのリスト。
Reply All

省略可。

選択すると、元のメールスレッドのすべての受信者に返信が送信されます。

このパラメータは Reply To よりも優先されます。

デフォルトで有効になっています。
Reply To

省略可。

返信を受信する特定のメールアドレスのカンマ区切りのリスト。

Reply All が無効で、値が指定されていない場合、返信は元のメールの送信者にのみ送信されます。

アクションの出力

[Send Thread Reply] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Send Thread Reply アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "message_id": "<162556278608.14165.480701790user@example>",
    "recipients": "test@example.com"
}
出力メッセージ

Send Thread Reply アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully sent reply to the message with ID MESSAGE_ID in Exchange.

 アクションが成功しました。

Error executing action "Send Thread Reply". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、スレッドの返信を送信アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

ユーザーからのメールを待つ

[ユーザーからのメールを待つ] アクションを使用して、ハンドブックの実行を一時停止し、[メールを送信] アクションで以前に送信されたメッセージへの返信をメールボックスでモニタリングします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

ユーザーからのメールを待機アクションには、次のパラメータが必要です。

パラメータ 説明
Email Message_id

必須。

アクションが返信を追跡する送信済みメールの一意のメッセージ ID。

[メールを送信] アクションを使用してメッセージが送信された場合は、プレースホルダとして SendEmail.JSONResult.message_id を選択してください。
Email Date

必須。

元のメールが送信された日時を示すタイムスタンプ。このアクションでは、この値を使用して返信ウィンドウを計算します。

メール送信アクションを使用してメッセージが送信された場合は、プレースホルダ SendEmail.JSONResult.email_date を使用します。
Email Recipients

必須。

アクションが返信を待機する受信者のメールアドレスのカンマ区切りのリスト。

[メールを送信] アクションを使用してメッセージが送信された場合は、プレースホルダ SendEmail.JSONResult.email_date を使用します。
Wait stage timeout (minutes)

省略可。

アクションが返信を待機する時間（分単位）。この時間を経過すると、待機ステージはタイムアウトとしてマークされます。

デフォルト値は 1440 です。
Wait for all recipients to reply?

省略可。

選択すると、ハンドブックはすべての受信者からの応答を待ってから続行します。選択しない場合は、最初の返信を受信した後に続行します。

デフォルトで有効になっています。
Wait stage exclude pattern

省略可。

特定の返信（不在時の自動返信など）を有効な返信と見なさないようにするために使用される正規表現パターン。
Folder to check for reply

省略可。

アクションによってユーザーの返信を検索するメールボックス フォルダのカンマ区切りのリスト。

このパラメータでは大文字と小文字が区別されます。

デフォルト値は Inbox です。
Fetch Response Attachments

省略可。

選択すると、受信者の返信に含まれる添付ファイルが、アクション結果の添付ファイルとして保存されます。

デフォルトでは無効にされています。

アクションの出力

[ユーザーからのメールを待つ] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、ユーザーからのメールを待機するアクションを使用した場合に受信される JSON 結果の出力です。

{
    "Responses":
    {[
     "user1@example.com": "Approved",
     "user2@example.com": "",
     "user3@example.com": ""
     ]}
}
スクリプトの結果

次の表に、[ユーザーのメールを待機] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

コネクタ

Google SecOps でコネクタを構成する方法については、データを取り込む（コネクタ）をご覧ください。

一般的な IMAP メールコネクタ

汎用 IMAP メールコネクタを使用して、IMAP メールに定期的に接続し、指定したメールボックスに新しいメールがないか確認します。コネクタは、新しいメールを準リアルタイムで処理し、Google SecOps プラットフォーム内でコンテキスト化されたアラートとケースに変換します。

既知の問題と制限事項

  1. Outlook の添付ファイル（.eml）: 重要なヘッダーが欠落している場合、コネクタは Microsoft Outlook によって .eml 形式に変換された添付ファイルを処理しないことがあります。Google SecOps は、メールのアラートを作成しますが、添付ファイルに基づくイベントは作成しません。次のログは、この問題を示しています。

    Error Code 1: Encountered an email object with missing headers. Please
visit documentation portal for more details.

  2. ファイル名がない: メールのヘッダーにファイル名がない添付メールファイルを処理する場合、コネクタは一意のプレースホルダ ファイル名 Undefined_{UUID}.eml を割り当てます。これにより、添付ファイルが Google SecOps でイベントとして表示されます。

メールケースの転送

Google SecOps は、メールサーバーと通信してメールを検索して取り込み、プラットフォームに転送して、セキュリティ通知として準リアルタイムで翻訳とコンテキスト化を行います。

コネクタ ルール

  • コネクタは SSL / TLS を使用して、メールサーバーとの暗号化された通信を確保します。
  • コネクタは、IMAP トラフィックと IMAPS トラフィックの両方でプロキシを使用したメールサーバーへの接続をサポートしています。
  • このコネクタを使用すると、複数のメールボックス フォルダにわたってメールを検索できます。Folder パラメータには、フォルダ名の大文字と小文字を区別したカンマ区切りのリストを指定します。
  • コネクタは Unicode エンコードをサポートしているため、英語以外の言語で送信されたメールを処理できます。

コネクタの入力

汎用 IMAP メールコネクタには、次のパラメータが必要です。

パラメータ 説明
Default Environment

省略可。

取り込まれたアラートが割り当てられる環境の名前。
Run Every

省略可。

コネクタが新しいメールをチェックする頻度。

デフォルト値は 00:00:10:00（10 分）です。
Product Field Name

必須。

商品名が保存されるフィールドの名前。

商品名は主にマッピングに影響します。コネクタのマッピング プロセスを合理化して改善するため、デフォルト値はコードから参照されるフォールバック値に解決されます。このパラメータに無効な入力があると、デフォルトでフォールバック値に解決されます。

デフォルト値は Product Name です。
Event Field Name

必須。

イベント名（サブタイプ）を決定するフィールドの名前。

デフォルト値は event_name_mail_type です。
Additional headers to extract from emails

省略可。

コネクタの処理中にメール メッセージから抽出されるカスタム ヘッダー フィールドのカンマ区切りのリスト。
Script Timeout (Seconds)

必須。

現在のスクリプトを実行する Python プロセスのタイムアウト上限（秒単位）。

デフォルト値は 60 です。
IMAP Server Address

必須。

接続先の IMAP サーバーの IP アドレスまたは DNS ホスト名。

デフォルト値は imap.gmail.com です。
IMAP Port

必須。

IMAP サーバーへの接続に使用するポート番号。

デフォルト値は 993 です。
Username

必須。

コネクタがメールを pull するメールボックスのユーザー名。

デフォルト値は username です。
Password

必須。

メールの pull に使用するメールボックスのパスワード。

デフォルト値は 1 です。
Folder to check for emails

必須。

コネクタがメールを検索するメールボックス フォルダのカンマ区切りのリスト。

このパラメータでは大文字と小文字が区別されます。

デフォルト値は Inbox です。
Server Time Zone

省略可。

メールサーバーで構成されているタイムゾーン。

デフォルト値は UTC です。
Environment Regex Pattern

省略可。

イベント フィールド データを操作して環境名を抽出するために使用される正規表現パターン。
IMAP USE SSL

省略可。

選択すると、コネクタは SSL / TLS を使用してメールサーバーへの安全な IMAP 接続を確立します。

デフォルトで有効になっています。
Unread Emails Only

省略可。

このオプションを選択すると、コネクタは未読メールのみを取得します。

デフォルトで有効になっています。
Mark Emails as Read

省略可。

選択すると、コネクタによって正常に取得されたメールは既読としてマークされます。

デフォルトで有効になっています。
Attach Original EML

省略可。

選択すると、元のメッセージが .eml ファイルとして作成されたアラートに添付されます。

デフォルトでは無効にされています。
Regex expressions to handle forwarded emails

省略可。

転送されたメールから元の件名、送信者、受信者のフィールドを抽出する正規表現パターンを含む JSON 1 行文字列。
Exclusion Body Regex

省略可。

本文の内容がパターンに一致する場合にメールをインジェストから除外するために使用される正規表現パターン（([N|n]ewsletter)|([O|o]ut of office) など）。
Exclusion Subject Regex

省略可。

件名がパターン（([N|n]ewsletter)|([O|o]ut of office) など）に一致する場合に、メールをインジェストから除外するために使用される正規表現パターン。
Offset Time In Days

必須。

コネクタがメールを取得する最大日数（最大期間）。

この値は、最初の実行時やコネクタのタイムスタンプが期限切れになった場合のフォールバックとしても機能し、無効な期間のアラートが取り込まれるようにします。

デフォルト値は 5 です。
Max Emails Per Cycle

必須。

コネクタが 1 回のポーリング サイクルで処理するメールの最大数。

デフォルト値は 10 です。
Proxy Server Address

省略可。

使用するプロキシ サーバーのアドレス。
Proxy Username

省略可。

プロキシ サーバー認証のユーザー名。
Proxy Password

省略可。

プロキシ サーバー認証のパスワード。
Create a Separate Siemplify Alert per Attached Mail File?

省略可。

選択すると、コネクタは、メッセージ内で見つかった添付メールファイルごとに個別のアラートを作成します。

これは、添付されたメールファイルからエンティティを作成するようにイベント マッピングが設定されている場合に便利です。

デフォルトでは無効にされています。
Original Received Mail Prefix

省略可。

監視対象メールボックスで受信した元のメールから抽出されたキー（宛先、差出人、件名など）に追加されるプレフィックス（orig など）。

デフォルト値は orig です。
Attached Mail File Prefix

省略可。

メール内で見つかった添付メールファイルから抽出されたキー（宛先、差出人、件名など）に追加されるプレフィックス（attach など）。

デフォルト値は attach です。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。