Microsoft Graph Mail を Google SecOps と統合する

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

始める前に

Microsoft Graph Mail 統合を構成する前に、次のことを行います。

  1. Microsoft Entra アプリケーションを作成します。

  2. アプリケーションの API 権限を構成します。

  3. クライアント シークレットを作成します。

Microsoft Entra アプリケーションを作成する

Microsoft Entra アプリを作成するには、次の手順を完了します。

  1. ユーザー管理者またはパスワード管理者として Azure ポータルにログインします。

  2. [Microsoft Entra ID] を選択します。

  3. [App registrations] > [New registration] に移動します。

  4. アプリケーションの名前を入力します。

  5. [Register] をクリックします。

    このドキュメントでは、単一テナントの設定を使用する例を示します。この統合では OAuth 2.0 クライアント認証情報フローが使用されるため、インタラクティブなユーザー ログインは行われません。したがって、Redirect URI は必要ありません。

  6. 統合パラメータを構成するために、アプリケーション（クライアント）ID とディレクトリ（テナント）ID の値を保存します。

API 権限を構成する

統合の API 権限を構成するには、次の手順を完了します。

  1. Azure ポータルで、[API Permissions] > [Add a permission] に移動します。

  2. [Microsoft Graph] > [Application permissions] を選択します。

  3. [権限を選択] セクションで、次の必要な権限を選択します。

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

  4. [権限を追加] をクリックします。

  5. [ORGANIZATION_NAME に管理者の同意を付与] をクリックします。

    [管理者の同意の確認] ダイアログが表示されたら、[はい] をクリックします。

特定のメールボックスへのアプリケーション アクセスを制限する

デフォルトでは、Mail.ReadWrite または Mail.Send アプリケーション権限を持つアプリケーションは、組織内のすべてのメールボックスにアクセスできます。アプリケーションのアクセスを特定のメールボックスのみに制限するには、Microsoft Exchange Online でアプリケーション アクセス ポリシーを構成します。

アプリケーション アクセス ポリシーを構成するには、次の手順を行います。

  1. Exchange Online PowerShell に接続します。

    1. 管理者として PowerShell を開きます。

    2. Exchange Online Management モジュールをインストールします（まだインストールしていない場合）。

      Install-Module -Name ExchangeOnlineManagement

    3. Exchange Online に接続します。

      Connect-ExchangeOnline

  2. アプリケーション ID とターゲット メールボックスを特定します。

    1. Azure AD から Microsoft Graph Mail アプリケーションのクライアント ID（アプリケーション ID）を取得します。

    2. アプリケーションがアクセスするメールボックスのメールアドレスを特定します。管理を容易にするために、Azure AD でメールが有効なセキュリティ グループを作成し、これらのメールボックスをメンバーとして追加します。

  3. アプリケーション アクセス ポリシーを作成します。

    1. New-ApplicationAccessPolicy コマンドレットを使用して、選択したメールボックスへのアクセスを制限するポリシーを作成します。

    2. 省略可: 特定のセキュリティ グループのメールボックスへのアクセスを制限します。

      1. <Your_Application_ID> は、アプリケーションのクライアント ID に置き換えます。

      2. <Security_Group_Email_Address> は、許可されたメールボックスを含むセキュリティ グループのメールアドレスに置き換えます。

      New-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -PolicyScopeGroupId "<Security_Group_Email_Address>" -AccessRight RestrictAccess -Description "SOAR Graph Mail Access Policy"

  4. Test-ApplicationAccessPolicy コマンドレットを使用して、ポリシーの有効性を確認します。

       Test-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -Identity "user_email_to_test@yourdomain.com"

    このコマンドは、適用ポリシーに基づいて、アプリケーションが指定されたメールボックスにアクセスできるかどうかを示します。

注:

  • これらのポリシーを作成するには、Exchange Online の OrganizationManagement 権限または Security Administrator 権限が必要です。

  • 通常、ポリシーの変更は 30 分以内に有効になります。

  • ポリシーを適用すると、アプリケーションは許可されたメールボックスにのみアクセスできます。他のファイルにアクセスしようとすると、Access Denied エラーが返されます。

クライアント シークレットを作成する

クライアント シークレットを作成するには、次の操作を行います。

  1. [証明書とシークレット] > [新しいクライアント シークレット] に移動します。

  2. クライアント シークレットの説明を入力し、有効期限を設定します。

  3. [追加] をクリックします。

  4. クライアント シークレットの値（シークレット ID ではない）を保存して、統合を構成するときに シークレット ID パラメータ値として使用します。クライアント シークレットの値は 1 回しか表示されません。

統合のパラメータ

Microsoft Graph Mail の統合には、次のパラメータが必要です。
パラメータ 説明
Azure AD Endpoint

必須。

統合で使用する Microsoft Entra ID エンドポイント。

値はテナントタイプによって異なる場合があります。

デフォルト値は https://login.microsoftonline.com です。
Microsoft Graph Endpoint

必須。

統合で使用する Microsoft Graph エンドポイント。

値はテナントタイプによって異なる場合があります。

デフォルト値は https://graph.microsoft.com です。
Client ID

必須。

統合で使用する Microsoft Entra アプリケーションのクライアント（アプリケーション）ID。
Secret ID

必須。

統合で使用する Microsoft Entra アプリケーションのクライアント シークレット値。
Tenant

必須。

Microsoft Entra ID（テナント ID）の値。
Default Mailbox

必須。

統合で使用するメールボックス。
Mail Field Source

省略可。

選択すると、統合はユーザーの詳細の mail 属性からメールボックス アドレスを取得します。選択されていない場合、統合は userPrincipalName フィールドからメールボックス アドレスを取得します。

デフォルトでは選択されていません。
Verify SSL

必須。

選択すると、統合は Microsoft Graph サーバーに接続するときに SSL 証明書を検証します。

デフォルトで有効になっています。
Base64 Encoded Private Key

省略可。

S/MIME で暗号化されたメールの復号に使用される Base64 エンコードの秘密鍵。

値を指定する場合は、Base64 Encoded Certificate も指定する必要があります。
Base64 Encoded Certificate

省略可。

S/MIME 暗号化メールの復号に使用される Base64 でエンコードされた証明書。

値を指定する場合は、Base64 Encoded Private Key も指定する必要があります。
Base64 Encoded CA certificate

省略可。

署名検証用の Base64 でエンコードされた信頼できる CA 証明書。

値が指定されていない場合、Bypass S/MIME Signature Verification が有効になっていない限り、受信した署名付きメールの署名検証は失敗します。

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

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

操作

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

ドメインをブロック

[Block Domain] アクションを使用すると、特定のメールドメインをターゲット メールボックスのメッセージ ルールに追加してブロックできます。ルールが存在しない場合は作成されます。

この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

アクションへの入力

Block Domain アクションには、次のパラメータが必要です。

パラメータ 説明
Domains

省略可。

ブロックする送信者ドメインのカンマ区切りのリスト（例: example.com）。このフィールドに手動で入力されたドメインと、エンティティから動的に抽出されたドメインは連携して、両方ともルール条件に追加されます。
Mailboxes

必須。デフォルトは、Default Mailbox です。

メッセージ ルールが追加されるメールボックス。ユーザー プリンシパル名のカンマ区切りのリストを指定できます。
Rule Name

必須。デフォルトは、Google SecOps - Blocked Domains です。

これらのドメインを追加するメッセージ ルールの名前。ルールが存在する場合は更新されます。
Action

必須。デフォルトは、Select One です。

これらのドメインに対して行うアクション。指定できる値: Select One、Move To Junk、Delete。Move To Junk は迷惑メールを [迷惑メール] フォルダに移動し、Delete は [削除済みアイテム] に転送します。Select One は、ルールが存在する場合に既存のアクションを保持します。
How many mailboxes to process in a single batch

省略可。デフォルトは、20 です。

アクションが 1 つのバッチで処理するメールボックスの数を指定します。

アクションの出力

Block Domain アクションでは、次の出力が提供されます。

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

次の例は、ドメインをブロックアクションを使用した場合に受信する JSON 結果の出力を示しています。

{
    "status": "Success",
    "mailbox": "user@domain.com",
    "blocked_domain": "malicious-domain.com"
}
出力メッセージ

[Block Domain] アクションでは、次の出力メッセージが表示されます。

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

Successfully blocked domain DOMAIN for mailbox MAILBOX.

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

Failed to block domain DOMAIN for mailbox MAILBOX. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

送信者をブロックする

[送信者をブロック] アクションを使用すると、指定したメール送信者をターゲット メールボックスのメッセージ ルールに追加してブロックできます。ルールが存在しない場合は、作成されます。

この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

アクションへの入力

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

パラメータ 説明
Senders

省略可。

ブロックする送信者のメールアドレスのカンマ区切りのリスト。このフィールドに手動で入力された送信者と、エンティティから動的に抽出された送信者が連携し、両方がルール条件に追加されます。
Mailboxes

必須。デフォルトは、Default Mailbox です。

メッセージ ルールが追加されるメールボックス。ユーザー プリンシパル名のカンマ区切りのリストを指定できます。
Rule Name

必須。デフォルトは、Google SecOps - Blocked Senders です。

これらの送信者を追加するメッセージ ルールの名前。ルールが存在する場合は更新されます。
Action

必須。デフォルトは、Select One です。

これらの送信者に対して実行するアクション。指定できる値: Select One、Move To Junk、Delete。Move To Junk は迷惑メールを [迷惑メール] フォルダに移動し、Delete は [削除済みアイテム] に転送します。Select One は、ルールが存在する場合に既存のアクションを保持します。
How many mailboxes to process in a single batch

省略可。デフォルトは、20 です。

アクションが 1 つのバッチで処理するメールボックスの数を指定します。

アクションの出力

Block Sender アクションでは、次の出力が提供されます。

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

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

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]
出力メッセージ

[Block Sender] アクションでは、次の出力メッセージが表示されます。

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

Successfully blocked sender SENDER for mailbox MAILBOX.

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

Failed to block sender SENDER for mailbox MAILBOX. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールを削除する

メールを削除アクションを使用すると、メールボックスから 1 つ以上のメールを削除できます。この操作を行うと、検索条件に一致するメールが削除されます。適切な権限があれば、[メールを削除] アクションでメールを別のメールボックスに移動できます。

この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

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

アクションへの入力

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

パラメータ 説明
Delete In Mailbox

必須。

削除オペレーションを実行するデフォルトのメールボックス。権限が許可されている場合、このアクションは他のメールボックスでも検索できます。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Folder Name

必須。

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Mail IDs

省略可

特定のメール ID を持つメールを検索するフィルタ条件。

このパラメータには、検索するメール ID のカンマ区切りのリストを指定します。

このパラメータが指定されている場合、検索では Subject Filter パラメータと Sender Filter パラメータが無視されます。
Subject Filter

省略可

検索するメールの件名を指定するフィルタ条件。
Sender Filter

省略可

リクエストされたメールの送信者を指定するフィルタ条件。
Timeframe (Minutes)

省略可

メールを検索する期間を分単位で指定するフィルタ条件。
Only Unread

省略可

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

デフォルトでは選択されていません。
How many mailboxes to process in a single batch

省略可

1 つのバッチ（メールサーバーへの単一接続）で処理するメールボックスの数。

デフォルト値は 25 です。

アクションの出力

次の表に、Delete Email アクションに関連付けられた出力タイプを示します。

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

メールを削除アクションでは、次の出力メッセージが表示されます。

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

Successfully deleted emails in the following mailboxes: MAILBOX_NAME: DELETED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

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

Action was not able to find any emails based on the specified search criteria.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

受信トレイのルールを削除する

[Delete Inbox Rules] アクションを使用して、指定されたメールボックスの指定された受信トレイ メッセージ ルールを削除します。 この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

アクションへの入力

[Delete Inbox Rules] アクションには、次のパラメータが必要です。

パラメータ 説明
Mailboxes

必須。デフォルトは、Default Mailbox です。

メッセージ ルールが削除されるメールボックス。ユーザー プリンシパル UPN のカンマ区切りのリストを指定できます。
Rule Name

必須。

削除する受信トレイ メッセージ ルールの正確な名前。
How many mailboxes to process in a single batch

省略可。デフォルトは、25 です。

アクションが 1 つのバッチで処理するメールボックスの数を指定します。何も指定しない場合は、デフォルト値の 25 が使用されます。

アクションの出力

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

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

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

{
    "deleted_rule": [
        "New test cases"
    ],
    "successful_mailboxes": [
        "labops1@siemplifycyarx.onmicrosoft.com"
    ],
    "failed_mailboxes": [
        "user2@example.com",
        "user3@example.com"
    ]
}
出力メッセージ

[Delete Inbox Rules] アクションでは、次の出力メッセージが表示されます。

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

Successfully deleted inbox rule RULE_NAME from mailbox MAILBOX.

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

Failed to delete inbox rule RULE_NAME from mailbox MAILBOX. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールから添付ファイルをダウンロードする

メールから添付ファイルをダウンロードするアクションを使用して、指定された条件に基づいてメールから添付ファイルをダウンロードします。

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

この操作は非同期です。必要に応じて、Google SecOps IDE でスクリプト タイムアウト値を調整します。

このアクションにより、\` forward slash or/backslash characters in the names of the downloaded attachments with the_` のアンダースコア文字が置き換えられます。

アクションへの入力

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

パラメータ 説明
Search In Mailbox

必須。

検索オペレーションが実行されるデフォルトのメールボックス。 権限が許可されている場合、このアクションは他のメールボックスでも検索できます。 このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Folder Name

必須。

検索を実行するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Download Destination

必須。

ダウンロードした添付ファイルを保存するストレージ タイプ。

デフォルトでは、このアクションは添付ファイルを Cloud Storage バケットに保存しようとします。ローカル ファイル システムに添付ファイルを保存することは、フォールバック オプションです。

指定できる値は GCP Bucket と Local File System です。デフォルト値は GCP Bucket です。
Download Path

必須。

添付ファイルをダウンロードするパス。

添付ファイルを Cloud Storage バケットまたはローカル ファイル システムに保存する場合、このアクションでは、/tmp/test などの Unix ライクな形式でダウンロード パスを指定する必要があります。
Mail IDs

省略可

特定のメール ID を持つメールを検索するフィルタ条件。

このパラメータには、検索するメール ID のカンマ区切りのリストを指定します。

このパラメータが指定されている場合、検索では Subject Filter パラメータと Sender Filter パラメータが無視されます。
Subject Filter

省略可

検索するメールの件名を指定するフィルタ条件。

このフィルタは contains ロジックを使用します。
Sender Filter

省略可

リクエストされたメールの送信者を指定するフィルタ条件。

このフィルタは equals ロジックを使用します。
Download Attachments From EML

省略可

選択すると、EML ファイルから添付ファイルがダウンロードされます。

デフォルトでは選択されていません。
Download attachments to unique path?

省略可

選択すると、以前にダウンロードした添付ファイルが上書きされないように、Download Path パラメータ フィールドで指定された一意のパスに添付ファイルがダウンロードされます。

デフォルトでは選択されていません。
How many mailboxes to process in a single batch

省略可

1 つのバッチ（メールサーバーへの単一接続）で処理するメールボックスの数。

デフォルト値は 25 です。

アクションの出力

Download Attachments From Email アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
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"
    }
]
出力メッセージ

メールから添付ファイルをダウンロードアクションでは、次の出力メッセージが表示されます。

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

Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS.

Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS.

In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.

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

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOXES

Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX。

Error executing action. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

添付された EML からデータを抽出する

添付された EML からデータを抽出するアクションを使用して、メールの EML 添付ファイルからデータを取得し、アクションの結果として返します。このアクションは、.eml、.msg、.ics のファイル形式をサポートしています。

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

アクションへの入力

Extract Data From Attached EML アクションには、次のパラメータが必要です。

パラメータ 説明
Search In Mailbox

必須。

検索オペレーションが実行されるデフォルトのメールボックス。 権限が許可されている場合、このアクションは他のメールボックスでも検索できます。 このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Folder Name

省略可

検索を実行するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Mail IDs

必須。

特定のメール ID を持つメールを検索するフィルタ条件。

このパラメータには、検索するメール ID のカンマ区切りのリストを指定します。
Regex Map JSON

省略可

添付されたメールファイルに適用する正規表現を含む JSON 定義。アクション JSON の結果に追加の Key-Value を生成します。このパラメータ値の例は次のとおりです。

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

アクションの出力

Extract Data From Attached EML アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
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 アクションでは、次の出力メッセージが表示されます。

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

Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS

Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST

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

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOX_LIST

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールを転送する

[メールを転送] アクションを使用して、以前のスレッドを含むメールを転送します。適切な権限があれば、このアクションは、統合構成で指定されたメールボックスとは異なるメールボックスからメールを送信できます。

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

アクションへの入力

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

パラメータ 説明
Send From

必須。

権限が許可されている場合に、メールの送信元となるメールアドレス（省略可）。

デフォルトでは、メールは統合構成で指定されたデフォルトのメールボックスから送信されます。
Folder Name

省略可

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Mail ID

必須。

転送するメールの ID。
Subject

必須。

メールの件名。
Send to

必須。

メール受信者のメールアドレスのカンマ区切りのリスト（user1@example.com, user2@example.com など）。
CC

省略可

メールの CC 欄に追加するメールアドレスのカンマ区切りのリスト。

形式は Send to パラメータと同じです。
BCC

省略可

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

形式は Send to パラメータと同じです。
Attachments Paths

省略可

サーバーに保存されている添付ファイルのパスのカンマ区切りのリスト（例: /FILE_DIRECTORY/file.pdf、/FILE_DIRECTORY/image.jpg）。
Mail content

必須。

メールの本文。

アクションの出力

次の表に、メールを転送アクションに関連付けられた出力タイプを示します。

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

メールを転送アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Email with message ID MAIL_ID was forwarded successfully. アクションが成功しました。

Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールボックス アカウントの施設外設定を取得する

[Get Mailbox Account Out Of Facility Settings] アクションを使用して、指定された Google SecOps User エンティティのメールボックス アカウントの施設外（OOF）設定を取得します。

Get Mailbox Account Out Of Facility Settings アクションは、Microsoft Graph API のベータ版を使用します。

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

アクションへの入力

なし

アクションの出力

[Get Mailbox Account Out Of Facility Settings] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
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 アクションは、次の出力メッセージを返すことができます。

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

Successfully returned OOF settings for ENTITY_ID.

Failed to find the following usernames in Office 365 service: USERNAME_LIST.

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

Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON

Action wasn't able to find OOF settings for ENTITY_ID.

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

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

次の表に、Get Mailbox Account Out Of Facility Settings アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

ルールを一覧表示する

List Rules アクションを使用すると、Microsoft Graph API を使用して、特定のメールボックスのすべてのメッセージ ルールを一覧表示できます。

アクションへの入力

List Rules アクションには、次のパラメータが必要です。

パラメータ 説明
Mailboxes

必須。デフォルトは、Default Mailbox です。

ルールを一覧表示するメールボックス。ユーザー プリンシパル名のカンマ区切りのリストを指定できます。
Rule Name

省略可。

ルールの表示名でフィルタします。
Limit

省略可。デフォルトは、20 です。

メールボックスごとに返すルールの数を制限します。

アクションの出力

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

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

[List Rules] アクションは、ケースウォール テーブルに実行の詳細を表示します。

JSON の結果

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

[
  {
    "mailbox": "user@example.com",
    "rules": [
      {
        "id": "AAMkAD...",
        "displayName": "Google SecOps - Blocked Senders",
        "sequence": 1,
        "isEnabled": true
      }
    ]
  }
]
出力メッセージ

List Rules アクションでは、次の出力メッセージが表示されます。

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

Successfully fetched NUMBER_OF_RULES rules for mailbox MAILBOX.

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

Failed to fetch rules for mailbox MAILBOX. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールを迷惑メールとしてマークする

[メールを迷惑メールとしてマーク] アクションを使用して、指定したメールボックス内のメールを迷惑メールとしてマークします。この操作により、メールの送信者がブロックされた送信者のリストに追加され、メッセージが [迷惑メール] フォルダに移動されます。

[メールを迷惑メールとしてマークする] アクションでは、Microsoft Graph API のベータ版が使用されます。

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

アクションへの入力

Mark Email as Junk アクションには、次のパラメータが必要です。

パラメータ 説明
Search In Mailbox

必須。

メールを検索するメールボックス。

デフォルトでは、このアクションは、統合構成で指定したデフォルトのメールボックスでメールを検索しようとします。他のメールボックスで検索を実行するには、アクションに適切な権限を構成します。

このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Folder Name

必須。

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。

デフォルト値は Inbox です。
Mail IDs

必須。

迷惑メールとしてマークするメールの ID または internetMessageId 値。

このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

アクションの出力

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

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

Mark Email as Junk アクションは、次の出力メッセージを返すことがあります。

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

Successfully marked the email as junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

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

Error executing action "Mark Email as Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

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

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

次の表に、[メールを迷惑メールとしてマークする] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

メールを迷惑メールではないとマークする

[メールを迷惑メールでないとマークする] アクションを使用して、特定のメールボックスでメールを迷惑メールでないとマークします。この操作を行うと、送信者がブロックされた送信者のリストから削除され、メールが [受信トレイ] フォルダに移動します。

[メールを迷惑メールでないとしてマークする] アクションでは、Microsoft Graph API のベータ版が使用されます。

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

アクションへの入力

メールを迷惑メールでないとしてマークアクションには、次のパラメータが必要です。

パラメータ 説明
Search In Mailbox

必須。

メールを検索するメールボックス。

デフォルトでは、このアクションは、統合構成で指定したデフォルトのメールボックスでメールを検索しようとします。他のメールボックスで検索を実行するには、アクションに適切な権限を構成します。

このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Folder Name

必須。

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Mail IDs

必須。

迷惑メールとしてマークするメールの ID または internetMessageId 値。

このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

アクションの出力

[Mark Email as Not Junk] アクションの出力は次のとおりです。

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

メールを迷惑メールでないとしてマークするアクションは、次の出力メッセージを返すことができます。

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

Successfully marked the email as not junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

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

Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

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

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

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

スクリプトの結果名 値
is_success True または False

メールをフォルダに移動

Move Email To Folder アクションを使用して、1 つ以上のメールをソースメール フォルダからメールボックス内の別のフォルダに移動します。適切な権限があれば、このアクションにより、統合構成で指定されたメールボックスとは異なるメールボックスにメールを移動できます。

この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

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

アクションへの入力

[Move Email To Folder] アクションを構成するには、次のパラメータを使用します。

パラメータ 説明
Move In Mailbox

必須。

移動オペレーションが実行されるデフォルトのメールボックス。 権限が許可されている場合、このアクションは他のメールボックスも検索できます。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Source Folder Name

必須。

メールの移動元のフォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Destination Folder Name

必須。

メールの移動先フォルダ。

パラメータ値は Inbox/folder_name/subfolder_name の形式で指定します。このパラメータでは大文字と小文字が区別されません。
Mail IDs

省略可

特定のメール ID を持つメールを検索するフィルタ条件。

このパラメータには、検索するメール ID のカンマ区切りのリストを指定します。

このパラメータが指定されている場合、検索では Subject Filter パラメータと Sender Filter パラメータが無視されます。
Subject Filter

省略可

検索するメールの件名を指定するフィルタ条件。

このフィルタは contains ロジックを使用します。
Sender Filter

省略可

リクエストされたメールの送信者を指定するフィルタ条件。

このフィルタは equals ロジックを使用します。
Timeframe (Minutes)

省略可

メールを検索する期間を分単位で指定するフィルタ条件。
Only Unread

省略可

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

デフォルトでは選択されていません。
How many mailboxes to process in a single batch

省略可

1 つのバッチ（メールサーバーへの単一接続）で処理するメールボックスの数。

デフォルト値は 25 です。

アクションの出力

次の表に、Move Email To Folder アクションに関連付けられた出力タイプを示します。

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

[Move Email To Folder] アクションでは、次の出力メッセージが表示されます。

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

Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

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

Action was not able to find any emails based on the specified search criteria.

Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

Ping

[Ping] アクションを使用して、Microsoft Graph メールサービスへの接続をテストします。

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

アクションへの入力

なし

アクションの出力

次の表に、Ping アクションに関連付けられた出力タイプを示します。

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

Ping アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully connected to the Microsoft Graph mail service with the provided connection parameters! アクションが成功しました。
Failed to connect to the Microsoft Graph mail service! Error is ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

ドメインのブロックを解除

[Remove Block Domain] アクションを使用すると、指定したメールドメインをターゲット メールボックスのメッセージ ルールから削除できます。ルールが空になると、ルールは削除されます。

この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

アクションへの入力

Remove Block Domain アクションには、次のパラメータが必要です。

パラメータ 説明
Domains

省略可。

削除する送信者ドメインのカンマ区切りのリスト（例: example.com）。このフィールドに手動で入力されたドメインと、エンティティから動的に抽出されたドメインは連携して動作し、どちらもルール条件から削除されます。
Mailboxes

必須。デフォルトは、Default Mailbox です。

メッセージ ルールが存在するメールボックス。ユーザー プリンシパル名のカンマ区切りのリストを指定できます。
Rule Name

必須。デフォルトは、Google SecOps - Blocked Domains です。

これらのドメインを削除するメッセージ ルールの名前。
How many mailboxes to process in a single batch

省略可。デフォルトは、20 です。

アクションが 1 つのバッチで処理するメールボックスの数を指定します。

アクションの出力

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

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

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

[
  {
    "Entity": "example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "user@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]
出力メッセージ

[Remove Block Domain] アクションでは、次の出力メッセージが表示されます。

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

Successfully removed domain DOMAIN from the blocked senders list for mailbox MAILBOX.

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

Failed to remove domain DOMAIN from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

送信者のブロックを解除

[Remove Block Sender] アクションを使用して、指定したメール送信者をターゲット メールボックスのメールルールから削除します。ルールが空になると、ルールは削除されます。

この操作は非同期です。必要に応じて、Google SecOps 統合開発環境（IDE）でアクション タイムアウトを調整します。

アクションへの入力

Remove Block Sender アクションには、次のパラメータが必要です。

パラメータ 説明
Senders

省略可。

削除する送信者のメールアドレスのカンマ区切りのリスト。このフィールドに手動で入力された送信者と、エンティティから動的に抽出された送信者は連携して動作し、どちらもルールの条件から削除されます。
Mailboxes

必須。デフォルトは、Default Mailbox です。

メッセージ ルールが存在するメールボックス。ユーザー プリンシパル名のカンマ区切りのリストを指定できます。
Rule Name

必須。デフォルトは、Google SecOps - Blocked Senders です。

これらの送信者を削除するメッセージ ルールの名前。
How many mailboxes to process in a single batch

省略可。デフォルトは、20 です。

アクションが 1 つのバッチで処理するメールボックスの数を指定します。

アクションの出力

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

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

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

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]
出力メッセージ

[Remove Block Sender] アクションでは、次の出力メッセージが表示されます。

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

Successfully removed sender SENDER from the blocked senders list for mailbox MAILBOX.

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

Failed to remove sender SENDER from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールをケースに保存する

[Save Email To The Case] アクションを使用して、メールまたはメールの添付ファイルを Google SecOps のケースウォールに保存します。適切な権限があれば、このアクションにより、統合構成で指定されたメールボックス以外のメールボックスからメールを保存できます。

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

アクションへの入力

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

パラメータ 説明
Search In Mailbox

必須。

検索オペレーションが実行されるデフォルトのメールボックス。 権限が許可されている場合、アクションは他のメールボックスでも検索できます。
Folder Name

省略可

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。
Mail ID

必須。

検索するメール ID のカンマ区切りのリスト。

メールを送信アクションを使用してメールを送信した場合は、パラメータ値を {SendEmail.JSONResult|id} または {SendEmail.JSONResult|internetMessageId} プレースホルダに設定します。
Save Only Email Attachments

省略可

選択すると、指定したメールの添付ファイルのみが保存されます。

デフォルトでは選択されていません。
Attachment To Save

省略可

Save Only Email Attachments パラメータが選択されている場合、このパラメータで指定された添付ファイルのみが保存されます。

このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
Base64 Encode

省略可

選択すると、アクションはメールファイルを base64 形式にエンコードします。

デフォルトでは選択されていません。

アクションの出力

次の表に、Save Email To The Case アクションに関連付けられた出力タイプを示します。

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

次の添付ファイルは、[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] アクションにより、次の出力メッセージが表示されます。

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

Email successfully saved!

Successfully saved the following attachments: ATTACHMENTS_LIST

The following attachments were not found in email with mail id: EMAIL_ID: ATTACHMENTS_LIST

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

Mailbox MAILBOX_NAME was not found.

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX_NAME

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールを検索する

[Search Emails] アクションを使用して、指定された検索条件に基づいてデフォルトのメールボックスでメール検索を実行します。適切な権限があれば、このアクションで他のメールボックスを検索できます。

この操作は非同期です。必要に応じて、Google SecOps IDE でアクション タイムアウトを調整します。

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

アクションへの入力

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

パラメータ 説明
Search In Mailbox 必須

検索オペレーションが実行されるデフォルトのメールボックス。権限が許可されている場合、このアクションは他のメールボックスも検索できます。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

多数のメールボックスに対して複雑な検索を行う場合は、Exchange Extension Pack の統合を使用します。
Folder Name 省略可

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。

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

検索するメールの件名を指定するフィルタ条件。このフィルタは contains ロジックを使用します。
Sender Filter Optional

リクエストされたメールの送信者を指定するフィルタ条件。このフィルタは equals ロジックを使用します。
Recipient Filter Optional

リクエストされたメールの受信者を指定するフィルタ条件。
Timeframe (minutes) Optional

メールを検索する期間を分単位で指定するフィルタ条件。
Start Time Optional

メール検索の開始時間を ISO 8601 形式で指定します。このパラメータは Timeframe (minutes) よりも優先されます。
End Time Optional

メール検索の終了時間を ISO 8601 形式で指定します。指定されておらず、Start Time が有効な場合、このパラメータは現在の時刻を使用します。
Body Regex Filter Optional

メールの本文内で検索する正規表現パターンを指定します。
Message IDs Optional

検索するメッセージ ID のカンマ区切りのリスト。注: このフィルタは他のフィルタよりも優先されます。
Max Emails To Return Optional

アクションで返されるメールの数。値を設定しない場合は、API のデフォルト値が使用されます。デフォルトは、10 です。
Only Unread Optional

選択すると、未読メールのみが検索されます。デフォルトでは選択されていません。
Select All Fields For Return Optional

選択すると、取得したメールのすべての使用可能なフィールドが返されます。デフォルトでは選択されていません。
How many mailboxes to process in a single batch Optional

1 つのバッチ（メールサーバーへの 1 つの接続）で処理するメールボックスの数。デフォルトは、25 です。
Search in all mailboxes Optional

選択すると、アクセス可能なすべてのメールボックスが検索されます。デフォルトでは選択されていません。
Limit the Amount of Information Returned in the JSON Result Optional

選択すると、アクションによって返される情報の量が、主要なメール フィールドのみに制限されます。デフォルトでは選択されていません。
Disable the Action JSON Result Optional

選択すると、アクションは JSON の結果を返しません。デフォルトでは選択されていません。

アクションの出力

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

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

メールを検索アクションでは、次のテーブルを生成できます。

テーブルのタイトル: Matching Mails

列:

  • メール ID
  • 件名
  • 送信者
  • レシーバー
  • Received Date（受領日）
スクリプトの結果

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

スクリプトの結果名 値
is_success true または false
アクション出力メッセージ

Search Emails アクションでは、次の出力メッセージが表示されます。

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

Successfully found emails in the following mailboxes: MAILBOX: FOUND_EMAILS_NUMBER

Mailbox MAILBOX was not found.

Action was not able to find any emails based on the specified search criteria.

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

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, the error is: ERROR_REASON

 アクションが失敗しました。サーバー、入力パラメータ、または認証情報への接続を確認してください。

メールを送信する

[メールを送信] アクションを使用して、特定のメールボックスから任意の受信者リストにメールを送信します。

このアクションでは、書式なしテキストまたは HTML 形式のメールを送信できます。適切な権限があれば、統合構成で指定されたメールボックスとは異なるメールボックスからメールを送信できます。

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

S/MIME 設定のクイック リファレンス

送信メールのセキュリティ レベルに基づいて構成する S/MIME パラメータを決定するには、次のリファレンスを使用します。

希望するメールの種類 Base64 Encoded Certificate Base64 Encoded Private Key Base64 Encoded Recipient Certificate
標準メール（S/MIME なし） 空白のままにする 空白のままにする 空白のままにする
デジタル署名済み 必須 必須 空白のままにする
暗号化 空白のままにする 空白のままにする 必須
署名と暗号化 必須 必須 必須

証明書ファイルを Base64 に変換する

証明書ファイルと秘密鍵ファイルを アクション パラメータの 1 行の 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 From

必須。

権限で許可されている場合にメールを送信するメールアドレス（省略可）。

デフォルトでは、このアクションは統合構成で指定されたデフォルトのメールボックスからメールを送信します。
Subject

必須。

メールの件名。
Send to

必須。

メール受信者のメールアドレスのカンマ区切りのリスト（user1@example.com, user2@example.com など）。
CC

省略可

メールの CC 欄に追加するメールアドレスのカンマ区切りのリスト。

形式は Send to パラメータと同じです。
BCC

省略可

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

形式は Send to パラメータと同じです。
Attachments Paths

省略可

サーバーに保存されている添付ファイルのパスのカンマ区切りのリスト（例: /FILE_DIRECTORY/file.pdf、/FILE_DIRECTORY/image.jpg）。
Attachments Location

必須。

添付ファイルが保存される場所。

デフォルトでは、このアクションは Cloud Storage バケットから添付ファイルをアップロードしようとします。

有効な値は GCP Bucket または Local File System です。デフォルト値は GCP Bucket です。
Mail Content Type

省略可

メール コンテンツのタイプ。

値は次のいずれかになります。

  • Text
  • HTML

デフォルト値は Text です。
Mail Content

必須。

メールの本文。
Reply-To Recipients

省略可

Reply-To ヘッダーで使用する受信者のカンマ区切りのリスト。

Reply-To ヘッダーを使用すると、返信メールを [From] フィールドの送信者のアドレスではなく、指定したメールアドレスにリダイレクトできます。
Base64 Encoded Certificate

省略可

送信者の Base64 エンコードされた X.509 公開証明書（.cer、.crt、.pem）（1 行形式）。S/MIME デジタル署名に使用されます。

指定する場合は、Base64 Encoded Private Key も指定する必要があります。
Base64 Encoded Private Key

省略可

送信者の Base64 でエンコードされた秘密鍵（.key、.pem）（1 行形式）。S/MIME デジタル署名に使用されます。

Base64 Encoded Certificate が指定されている場合は必須です。
Base64 Encoded Recipient Certificate

省略可

受信者の Base64 エンコードの公開証明書（.cer、.crt、.pem）（1 行形式）。メールの暗号化に使用されます。

アクションの出力

次の表に、Send Email アクションに関連付けられた出力タイプを示します。

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

Send Email アクションでは、次の出力メッセージが表示されます。

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

Email was sent successfully.

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

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

メールの HTML を送信する

Send Email HTML アクションを使用して、Google SecOps HTML テンプレートを使用するメールを特定のメールボックスから任意の受信者リストに送信します。適切な権限があれば、このアクションはデフォルト以外のメールボックスからメールを送信できます。

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

アクションへの入力

Send Email HTML アクションには、次のパラメータが必要です。

パラメータ 説明
Send From

必須。

権限で許可されている場合にメールを送信するメールアドレス（省略可）。

デフォルトでは、このアクションは統合構成で指定されたデフォルトのメールボックスからメールを送信します。
Subject

必須。

メールの件名。
Send to

必須。

メール受信者のメールアドレスのカンマ区切りのリスト（user1@example.com, user2@example.com など）。
CC

省略可

メールの CC 欄に追加するメールアドレスのカンマ区切りのリスト。

形式は Send to パラメータと同じです。
BCC

省略可

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

形式は Send to パラメータと同じです。
Attachments Paths

省略可

提供するアタッチメントのフルパス（/FILE_DIRECTORY/file.pdf、/FILE_DIRECTORY/image.jpg など）。

複数の値をカンマ区切りの文字列で指定できます。
Email HTML Template

必須。

使用する HTML テンプレートのタイプ。

指定できる値は Email HTML Template と Dynamically generated list of available templates です。

デフォルト値は Email HTML Template です。
Mail Content

必須。

メールの本文。
Reply-To Recipients

省略可

Reply-To ヘッダーで使用する受信者のカンマ区切りのリスト。

[Reply-To] ヘッダーを使用して、[From] フィールドに記載されている送信者のアドレスではなく、特定のメールアドレスに返信メールをリダイレクトします。
Attachment Location

必須。

添付ファイルが保存される場所。

デフォルトでは、このアクションは Cloud Storage バケットから添付ファイルをアップロードしようとします。

有効な値は GCP Bucket または Local File System です。デフォルト値は GCP Bucket です。

アクションの出力

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

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
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] アクションにより、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Email was sent successfully. アクションが成功しました。

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

スレッド返信を送信する

[スレッドの返信を送信] アクションを使用して、メールスレッドへの返信としてメッセージを送信します。適切な権限があれば、このアクションは、統合構成で指定されたメールボックス以外のメールボックスからメールを送信できます。

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

アクションへの入力

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

パラメータ 説明
Send From

必須。

権限で許可されている場合にメールを送信するメールアドレス（省略可）。

デフォルトでは、このアクションは統合構成で指定されたデフォルトのメールボックスからメールを送信します。
Mail ID

必須。

検索するメール ID。
Folder Name

省略可

メールを検索するメールボックス フォルダ。サブフォルダを指定するには、/ スラッシュ（Inbox/Subfolder など）を使用します。

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

省略可

サーバーに保存されている添付ファイルのパスのカンマ区切りのリスト（例: /FILE_DIRECTORY/file.pdf、/FILE_DIRECTORY/image.jpg）。
Mail Content

必須。

メールの本文。
Reply All

省略可

選択すると、アクションによって元のメールに関連するすべての受信者に全員に返信されます。

デフォルトでは選択されていません。

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

省略可

返信の送信先となるメールのカンマ区切りのリスト。

値を指定せず、[Reply All] チェックボックスをオフにすると、アクションによって元のメールの送信者にのみ返信が送信されます。

Reply All チェックボックスがオンになっている場合、アクションはこのパラメータを無視します。
Attachments Location

必須。

添付ファイルが保存される場所。

デフォルトでは、このアクションは Cloud Storage バケットから添付ファイルをアップロードしようとします。

有効な値は GCP Bucket または Local File System です。デフォルト値は GCP Bucket です。
Message Timezone

省略可。

返信ヘッダーの元のメール送信日に使用されるタイムゾーン（UTC、America/New_York、Europe/London など）。指定された値が無効な場合は、デフォルト値が使用されます。

デフォルト値は UTC です。

アクションの出力

次の表に、Send Thread Reply アクションに関連付けられた出力タイプを示します。

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

次の例は、スレッド返信を送信アクションを使用した場合に受信される 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"
    }
  }
出力メッセージ

[Send Thread Reply] アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully sent reply to the mail with ID: EMAIL_ID アクションが成功しました。
Error executing action "Send Thread Reply". Reason: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.

操作を実行できませんでした。

Reply To パラメータの値を確認します。

Error executing action "Send Thread Reply" because the provided mail id EMAIL_ID was not found.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

投票メールを送信

[投票メールを送信] アクションを使用して、事前定義された回答オプションを含むメールを送信します。このアクションでは、Google SecOps HTML テンプレートを使用してメールの形式を設定します。適切な権限があれば、[Send Vote Email] アクションで、デフォルト以外のメールボックスからメールを送信できます。

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

アクションへの入力

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

パラメータ 説明
Send From

必須。

権限で許可されている場合にメールを送信するメールアドレス（省略可）。

デフォルトでは、このアクションは統合構成で指定されたデフォルトのメールボックスからメールを送信します。
Subject

必須。

メールの件名。
Send to

必須。

メール受信者のメールアドレスのカンマ区切りのリスト（user1@example.com, user2@example.com など）。
CC

省略可

メールの CC 欄に追加するメールアドレスのカンマ区切りのリスト。

形式は Send to パラメータと同じです。
BCC

省略可

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

形式は Send to パラメータと同じです。
Attachments Paths

省略可

提供するアタッチメントのフルパス（/FILE_DIRECTORY/file.pdf、/FILE_DIRECTORY/image.jpg など）。

複数の値をカンマ区切りの文字列で指定できます。
Email HTML Template

必須。

使用する HTML テンプレートのタイプ。

指定できる値は Email HTML Template と Dynamically generated list of available templates です。

デフォルト値は Email HTML Template です。
Reply-To Recipients

省略可

Reply-To ヘッダーで使用する受信者のカンマ区切りのリスト。

Reply-To ヘッダーを使用すると、返信メールを From フィールドに指定された送信者のアドレスではなく、指定したメールアドレスにリダイレクトできます。
Structure of voting options

必須。

受信者に送信する投票の構造。

有効な値は、Yes/No または Approve/Reject です。デフォルト値は Yes/No です。
Attachment Location

必須。

添付ファイルが保存される場所。

デフォルトでは、このアクションは Cloud Storage バケットから添付ファイルをアップロードしようとします。

有効な値は GCP Bucket または Local File System です。デフォルト値は GCP Bucket です。

アクションの出力

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

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
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] アクションにより、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Email was sent successfully. アクションが成功しました。

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

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

[ユーザーのメールを待機] アクションを使用して、[メールを送信] アクションを使用して送信されたメールに対するユーザーの応答を待ちます。

この操作は非同期です。必要に応じて、Google SecOps IDE でアクション タイムアウトを調整します。タイムアウトを 0 に設定するか、空のままにすると、環境設定で構成されたデフォルトのタイムアウトが使用されます。

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

アクションへの入力

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

パラメータ 説明
Mail ID 必須

アクションが待機するメールの ID または internetMessageId。メールを送信アクションを使用してメールを送信した場合は、パラメータ値を {SendEmail.JSONResult|id} または {SendEmail.JSONResult|internetMessageId} プレースホルダに設定します。
Mail Date Optional

アクションが待機するメールの送信タイムスタンプ。[メールを送信] アクションを使用してメッセージが送信された場合は、プレースホルダとして {SendEmail.JSONResult|sentDateTime} フィールドまたは {SendEmail.JSONResult|createdDateTime} フィールドを選択します。
Mail Recipients Optional

アクションが応答を待機する受信者のメールアドレスのカンマ区切りのリスト。[メールを送信] アクションを使用してメッセージが送信された場合は、プレースホルダとして {SendEmail.JSONResult|toRecipients} フィールドを選択します。
How long to wait for recipient reply (minutes) Optional

タイムアウトとマークするまでに、ユーザーの返信を待機する時間（分単位）。デフォルトは、10080 です。
Wait for All Recipients to Reply? Optional

選択すると、アクションはタイムアウトに達するか、最初の返信を処理するまで、すべての受信者からの応答を待機します。デフォルトでは選択されていません。
Wait Stage Exclude pattern Optional

待機ステージから特定の返信を除外する正規表現。このパラメータは、メールの件名と本文の両方で機能します。たとえば、Out of Office.* 正規表現を構成すると、アクションは自動不在メッセージを受信者の返信と見なさず、実際のユーザーの返信を待ちます。
Folder to Check for Reply Optional

受信者の返信を検索するメールボックスのメールフォルダ。検索は、質問を含むメールの送信元であるメールボックスで実行されます。/ スラッシュ（例: Inbox/Subfolder）を使用したネストされたサブフォルダをサポートします。このパラメータでは大文字と小文字が区別されます。デフォルトは Inbox です。
Fetch Response Attachments Optional

選択すると、受信者の返信に添付ファイルが含まれている場合、アクションは返信を取得し、アクション結果の添付ファイルとして追加します。デフォルトでは選択されていません。
Limit the Amount of Information Returned in the JSON Result Optional

選択すると、アクションによって返される情報の量が、主要なメール フィールドのみに制限されます。デフォルトで選択されます。
Disable the Action JSON Result Optional

選択すると、アクションは JSON の結果を返しません。デフォルトでは選択されていません。

アクションの出力

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

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

次のケースウォールのアタッチメントは、[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（受領日）
  • 送信者
  • 受信者
  • 件名
スクリプトの結果

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

スクリプトの結果名 値
is_success true または false
アクション出力メッセージ

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

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

Found the user EMAIL_RECIPIENT reply: USER_REPLY

Timeout getting reply from user: EMAIL_RECIPIENT.

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

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

 アクションが失敗しました。サーバー、入力パラメータ、または認証情報への接続を確認してください。

投票メールの結果を待つ

[投票メールの結果を待つ] アクションを使用して、[投票メールを送信] アクションを使用して送信された投票メールに対するユーザーの応答を待ちます。

この操作は非同期です。必要に応じて、Google SecOps IDE でアクション タイムアウトを調整します。

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

アクションへの入力

Wait For Vote Email Results アクションには、次のパラメータが必要です。

パラメータ 説明
Vote Mail Sent From

必須。

[Send Vote Email] アクションでメールを送信したメールボックス。

デフォルト値は、統合構成で指定したメールボックスです。

必要に応じて、投票メールが別のメールボックスから送信される場合は、このパラメータに別の値を設定できます。
Mail ID

必須。

メールの ID。

Send Vote Email アクションを使用してメールを送信する場合は、パラメータ値を SendVoteEmail.JSONResult|id または SendEmail.JSONResult|internetMessageId プレースホルダに設定します。

メール ID を返すには、メールを検索アクションを使用します。
Wait for All Recipients To Reply?

省略可

選択すると、アクションはタイムアウトに達するか、最初の返信を処理するまで、すべての受信者からの応答を待機します。

デフォルトで有効になっています。
Wait Stage Exclude Pattern

省略可

待機ステージから特定の返信を除外する正規表現。

このパラメータはメールの本文で機能します。

例: このアクションでは、不在時の自動返信メッセージは受信者の返信とは見なされず、実際のユーザーの返信を待ちます。
Folder To Check For Reply

省略可

ユーザーの返信を検索するメールボックスのメールフォルダ。検索は、質問を含むメールが送信されたメールボックスで実行されます。

このパラメータは、複数のフォルダでユーザー レスポンスを確認するため、カンマ区切りのフォルダのリストを受け入れます。

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

デフォルト値は Inbox です。
Folder To Check For Sent Mail

省略可

送信済みメールを検索するメールボックス フォルダ。 質問を記載したメールを送信したメールボックスです。

このパラメータは、複数のフォルダでユーザーの応答を確認する際に、カンマ区切りのフォルダのリストを受け入れます。

このパラメータでは大文字と小文字が区別されます。 サブフォルダを指定するには、Inbox/Subfolder のように / スラッシュを使用します。

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

省略可

選択すると、受信者の返信に添付ファイルが含まれている場合、アクションは返信を取得し、ケースウォールに添付ファイルとして追加します。

デフォルトでは選択されていません。

アクションの出力

Wait For Vote Email Results アクションは、次の出力を提供します。

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

次の Case Wall のアタッチメントは、Wait For Vote Email Results アクションに関連付けられています。

タイプ: エンティティ

添付ファイルの内容: タイトル、ファイル名（拡張子がある場合はそれを含む）、fileContent。

  • タイトル: RECIPIENT_EMAIL 返信の添付ファイル。
  • ファイル名: ATTACHMENT_FILENAME + FILE_EXTENSION
  • fileContent: CONTENT_OF_THE_ATTACHED_FILE
ケースウォール テーブル

Case Wall で、[Wait For Email Results] アクションにより次のテーブルが生成されます。

テーブルのタイトル: Matching Mails

列:

  • メール ID
  • Received Date（受領日）
  • 送信者
  • 受信者
  • 件名
JSON の結果

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

{
    "Responses": [
        {
            "recipient": "user@example.com",
            "vote": "Approve"
        }
    ]
}
出力メッセージ

[Wait For Vote Email Results] アクションでは、次の出力メッセージが表示されます。

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

Found the user EMAIL_RECIPIENT reply: USER_REPLY.

Exceeded timeout to get a reply from user: EMAIL_RECIPIENT.

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

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

操作を実行できませんでした。

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

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

スクリプトの結果名 値
is_success True または False

コネクタ

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

Microsoft Graph Mail コネクタ

Microsoft Graph Mail Connector を使用して、Microsoft Graph メールサービスからメールを取得します。

動的リストを使用して、正規表現を使用してメールの本文と件名から指定された値をフィルタします。デフォルトでは、コネクタは正規表現を使用してメールから URL をフィルタします。

コネクタの入力

Microsoft Graph Mail Delegated Connector には、次のパラメータが必要です。
パラメータ 説明
Product Field Name

必須。

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

デフォルト値は device_product です。

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

必須。

イベント名（サブタイプ）を特定するために使用されるフィールド名。

デフォルト値は event_name です。
Environment Field Name

省略可

環境名が保存されるフィールドの名前。

環境フィールドが見つからない場合、環境は "" に設定されます。
Environment Regex Pattern

省略可

Environment Field Name フィールドで見つかった値に対して実行する正規表現パターン。このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。

デフォルト値 .* を使用して、必要な未加工の Environment Field Name 値を取得します。

正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果は "" になります。
Email Exclude Pattern

省略可

迷惑メールやニュースなど、特定のメールを読み込みから除外する正規表現。

このパラメータは、メールの件名と本文の両方で機能します。
PythonProcessTimeout

必須。

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

デフォルト値は 300 です。
Azure AD Endpoint

必須。

統合で使用する Microsoft Entra エンドポイント。

デフォルト値は https://login.microsoftonline.com です。
Microsoft Graph Endpoint

必須。

統合で使用する Microsoft Graph エンドポイント。

デフォルト値は https://graph.microsoft.com です。
Mail Address

必須。

コネクタで使用するメールアドレス。
Client ID

必須。

Microsoft Entra アプリケーションのアプリケーション（クライアント）ID。
Secret ID

必須。

Microsoft Entra アプリケーションのクライアント シークレット値。
Tenant (Directory) ID

必須。

Microsoft Entra ID（テナント ID）の値。
Folder to check for emails

必須。

メールを検索するメールフォルダ。このパラメータは、複数のフォルダでユーザー レスポンスを検索するために、カンマ区切りのフォルダのリストを受け入れます。サブフォルダを指定するには、Inbox/Subfolder のように / スラッシュを使用します。

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

デフォルト値は Inbox です。
Offset Time In Hours

必須。

最初のコネクタのイテレーションでメールを取得するまでの時間数。このパラメータは、コネクタを初めて有効にした後の最初のコネクタの反復処理に適用されます。コネクタは、最新のコネクタ イテレーションのタイムスタンプが期限切れになったときに、このパラメータをフォールバック値として使用できます。

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

必須。

コネクタのイテレーションごとに取得するメールの数。

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

省略可

選択すると、コネクタは未読メールからのみケースを作成します。

デフォルトでは選択されていません。
Mark Emails as Read

省略可

選択すると、コネクタは取り込み後にメールを既読としてマークします。

デフォルトでは選択されていません。
Disable Overflow

省略可

選択すると、コネクタは Google SecOps のオーバーフロー メカニズムを無視します。

デフォルトでは選択されていません。
Verify SSL

必須。

選択すると、統合は Microsoft Graph への接続時に SSL 証明書を検証します。

デフォルトで有効になっています。
Original Received Mail Prefix

省略可

監視対象メールボックスで受信した元のメールから抽出されたイベントキー（to、from、subject など）に追加するプレフィックス。

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

省略可

監視対象のメールボックスで受信した添付ファイルから抽出されたイベントキー（to、from、subject など）に追加するプレフィックス。

デフォルト値は attach です。
Create a Separate Google Secops Alert per Attached Mail File

省略可

選択すると、コネクタは複数のアラートを作成し、添付されたメールファイルごとに 1 つのアラートを作成します。

この動作は、複数のメールファイルが添付されたメールを処理し、添付されたメールファイルからエンティティを作成するように Google SecOps イベント マッピングを設定する場合に便利です。

デフォルトでは選択されていません。
Attach Original EML

省略可

選択すると、コネクタは元のメールを EML ファイルとしてケース情報に添付します。

デフォルトでは選択されていません。
Headers to add to events

省略可

Google SecOps イベントに追加するメールのヘッダーのカンマ区切りの文字列（DKIM-Siganture、Received、From など）。

ヘッダーの完全一致を構成することも、このパラメータ値を正規表現として設定することもできます。

コネクタは、構成された値を internetMessageHeaders リストからフィルタし、Google SecOps イベントに追加します。

コネクタがイベントにヘッダーを追加しないようにするには、パラメータ値を None に設定します。

デフォルトでは、コネクタは使用可能なすべてのヘッダーを追加します。
Case Name Template

省略可

カスタムケース名。

このパラメータを構成すると、コネクタは custom_case_name という新しいキーを Google SecOps SOAR イベントに追加します。

プレースホルダは [name of the field] の形式で指定できます。

例: Phishing - [event_mailbox]。

プレースホルダの場合、コネクタは最初の Google SecOps SOAR イベントを使用します。コネクタは、文字列値を含むキーのみを処理します。
Alert Name Template

省略可

カスタム アラート名。

プレースホルダは [name of the field] の形式で指定できます。

例: Phishing - [event_mailbox]。

プレースホルダの場合、コネクタは最初の Google SecOps SOAR イベントを使用します。コネクタは、文字列値を含むキーのみを処理します。値を指定しないか、無効なテンプレートを指定すると、コネクタはデフォルトのアラート名を使用します。
Proxy Server Address

省略可

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

省略可

認証に使用するプロキシのユーザー名。
Proxy Password

省略可

認証に使用するプロキシ パスワード。
Mail Field Source

省略可

選択すると、統合はユーザーの詳細の mail 属性からメールボックス アドレスを取得します。選択されていない場合、統合は userPrincipalName フィールドからメールボックス アドレスを取得します。

デフォルトでは選択されていません。
Extract URLs from HTML Email Part

省略可

選択すると、コネクタはメールの HTML 本文から URL を抽出します。 これにより、コネクタは複雑な URL を抽出できますが、メールの書式なしテキスト部分から URL を抽出することはできません。

抽出された URL は、urls_from_html_part イベント フィールドで使用できます。

デフォルトで有効になっています。
Event Fields to Exclude

省略可

イベント作成から除外するイベント フィールドのカンマ区切りのリスト（field1,field2 など）。
Exclude Attachments

省略可

選択すると、コネクタはメールの添付ファイルを取り込んだり、ケースに追加したりしません。
Bypass S/MIME Signature Verification

省略可

選択すると、コネクタは、署名検証に Base64 でエンコードされた CA 証明書を必要とせずに、S/MIME 署名付きメールを取り込みます。メール本文、ヘッダー、添付ファイルが直接抽出されます。
Base64 Encoded Private Key

省略可

受信した S/MIME 暗号化メールの復号に使用される Base64 エンコード秘密鍵。

指定する場合は、Base64 Encoded Certificate も指定する必要があります。
Base64 Encoded Certificate

省略可

受信した S/MIME 暗号化メールの復号に使用される Base64 エンコード証明書。

指定する場合は、Base64 Encoded Private Key も指定する必要があります。
Base64 Encoded CA certificate

省略可

受信した S/MIME メールのデジタル署名を検証するための、Base64 でエンコードされた信頼できる CA 証明書。

CA 証明書が指定されていない場合、Bypass S/MIME Signature Verification が有効になっていない限り、受信した署名付きメールの署名検証は失敗します。

コネクタルール

コネクタはプロキシをサポートしています。

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