ルールアクションは、Workload Protection (ランタイムセキュリティ) ルールを検知の枠を超えて拡張します。ルールがイベントに一致すると、Agent は 1 つ以上のアクションを実行して、イベントをエンリッチし、脅威に対応するか、複数のステップを用いた検知ロジックを構築できます。

アクションは、Agent ポリシーファイル (.policy) のルールの actions フィールドで定義されます。

すべてのアクションは Agent 上の Agent ポリシーファイル (YAML) で構成できますが、ルールの作成時に UI から log、coredump、および network_filter をセットアップすることはできません。 Datadog で Agent ルールを作成する際、 hash、kill (自動応答)、および set アクションを構成できます。Security シグナルから、 kill または network_filter を使用して、標的となった脅威に手動で適用できます。
アクション目的プラットフォーム強制適用が必要
set他のルールで使用するために状態を変数に保存するLinux、Windowsいいえ
killプロセスを終了するLinux、Windowsはい
hashファイルのハッシュを計算するLinuxいいえ
logAgent ログにメッセージを書き込むLinux、Windowsいいえ
coredumpフォレンジック状態 (プロセス、マウント、dentry) をキャプチャするLinuxいいえ
network_filterBPF フィルターに一致するネットワークトラフィックを監視またはドロップするLinuxはい

構文

各ルールでは、YAML リストとして複数のアクションを定義できます。各リスト項目には、必ず 1 つのアクションタイプを含める必要があります。

rules:
  - id: my_rule
    expression: exec.file.name == "suspicious_binary"
    actions:
      - set:
          name: flagged_process
          value: true
          ttl: 5m
      - kill:
          signal: SIGKILL
          scope: process

アクションフィルター

すべてのアクションは、オプションの filter フィールドをサポートしています。これは、アクション実行時に評価される SECL 式です。アクションは、ルール式とアクションフィルターの両方が一致した場合にのみ実行されます。

フィールド必須デフォルト説明
filterいいえなし (ルールが一致するたびにアクションが実行されます)アクション実行時に評価される SECL 式。
rules:
  - id: kill_container_process
    expression: exec.file.name == "malware"
    actions:
      - filter: process.container.id != ""
        kill:
          signal: SIGTERM
          scope: container

set: 変数を保存する

set を使用して、同じポリシー内のルール間で永続する状態を保存します。定義された変数は、そのポリシー内の他のどのルールからでも参照できます。

使用方法

変数は、Agent ルール作成における最も強力な機能の 1 つです。これらは、単一の SECL 式だけでは表現できない、ステップを用いたステートフルな検知を構築するために不可欠です。

  • あるルールでコンテキストを記録し、その変数を参照する後続のルールを一致させることで、ポリシー内のルールを連鎖させます。
  • プロセス名、パス、または DNS アクティビティのローリングリストを構築します。

パラメーター

フィールド必須デフォルト説明
nameはい—変数名。式内では ${name} または ${scope.name} として参照されます。
valuevalue、field、または expressionのいずれか —静的な値 (文字列、整数、ブール値、または配列)。
fieldvalue、field、または expressionのいずれか —トリガーイベントから値をコピーします (例: process.file.name)。
expressionvalue、field、または expressionのいずれか —結果が保存される SECL 式。型を推論できない場合は default_value が必要です。
default_valueなし—expression を使用する場合のデフォルト。value の型と一致する必要があります。
scopeなしグローバル (スコーププレフィックスなし)process、container、または cgroup。変数名の前にプレフィックスを付けます (例: process.my_var)。
scope_fieldなしトリガープロセス PIDカスタムスコープキー (process スコープのみ)。
appendなしfalse上書きせずに、リスト変数に追加します。
sizeなし100 (appendが true の場合)appendが true の場合の最大リスト長。
ttlなし有効期限なし存続期間 (例: 10s、5m)。変数はこの期間後に期限切れになります。
inheritedなしfalse変数は子プロセスに継承されます (processスコープのみ)。
privateなしfalse変数はセキュリティイベントで公開されません。

例

ブールフラグを設定します。

rules:
  - id: flag_suspicious_exec
    expression: exec.file.path in ["/tmp/evil"]
    actions:
      - set:
          name: suspicious
          value: true
          ttl: 10m
  - id: detect_follow_up
    expression: open.file.path == "/etc/shadow" && ${suspicious}

DNS クエリをローリングリストに収集します。

rules:
  - id: collect_dns_queries
    expression: dns.question.name != ""
    actions:
      - set:
          name: queried_domains
          field: dns.question.name
          append: true
          size: 10
          ttl: 10s
          scope: process

相関ルールを作成します。

privateを使用して内部状態を Security イベントから除外します。また、scope_field を使用して、イベントをトリガーしたプロセス以外のプロセスに変数をバインドします (例: cgroup_writeイベントのターゲット)。

rules:
  - id: init_correlation_key
    expression: cgroup_write.file.path != "" && ${process.correlation_key} == ""
    actions:
      - set:
          name: correlation_key
          default_value: ""
          expression: '"attack_${builtins.uuid4}"'
          scope: process
          scope_field: cgroup_write.pid
          inherited: true
          private: true
  - id: detect_correlated_file_access
    expression: open.file.path == "/etc/shadow" && ${process.correlation_key} != ""

式から値を計算します。 expression と default_value を使用して変数型を定義し、計算結果を保存します。

rules:
  - id: record_exec_context
    expression: exec.file.path in ["/tmp/evil"]
    actions:
      - set:
          name: exec_context
          default_value: ""
          expression: '"cmd_${process.pid}_${exec.file.name}"'
          scope: process
          ttl: 5m

kill: プロセスを終了する

kill を使用して、悪意のあるアクティビティを積極的に停止します。Agent は、ターゲットのプロセス、コンテナ、または cgroup に POSIX シグナルを送信します。

Datadog での構成

Agent ポリシーファイルで kill アクションを定義することに加え、Datadog でプロセス終了を構成できます。

  • 自動: このセクションで説明されているように、ポリシー内の Agent ルールに kill アクションを追加するか、自動応答を使用します。
  • 手動: Security シグナルから、シグナルサイドパネルの Respond の下にあるコンテナまたはプロセスの強制終了を使用します。

どちらのアプローチも、デフォルトで有効になっている Agent 強制適用が必要です。強制適用と応答アクションの概要については、脅威への対応を参照してください。

使用方法

  • 実行時にクリプトマイニング、リバースシェル、または既知のマルウェアをブロックします。
  • プロセスを正常に停止する (SIGTERM) か、強制終了します (SIGKILL)。

要件

  • Agent 構成 (runtime_security_config.enforcement.enabled) で強制適用を有効にする必要があります。高度な構成を参照してください。
  • 強制適用がグローバルに無効になっている場合、終了アクションはポリシーの読み込み時に拒否されます。
  • サポートされているシグナルには、SIGKILL、SIGTERM、SIGHUP、SIGINT、およびその他の標準的な POSIX シグナル名が含まれます。

パラメーター

フィールド必須デフォルト説明
signalはい—シグナル名 (例: SIGKILL、SIGTERM)。
scopeいいえprocessprocess、container、または cgroup。どのプロセスがシグナルを受信するかを決定します。
disable_container_disarmerいいえfalse自動コンテナ解除セーフガードを無効にします。
disable_executable_disarmerいいえfalse自動実行ファイル無効化セーフガードを無効にします。

セーフガード

Agent には、自動応答中の暴走した kill ループを防ぐための無効化機能が含まれています。設定された期間内に同じコンテナまたは実行ファイルに対して過剰な kill アクションが実行された場合、その期間が終了するまで、そのターゲットに対する後続の kill は抑制されます。

特定のバイナリも、runtime_security_config.enforcement.exclude_binaries を通じて強制適用から除外できます。

例

rules:
  - id: block_ping_process
    expression: >-
      exec.file.name == "ping"
    actions:
      - kill:
          signal: SIGKILL
          scope: process

Kill アクションレポート

kill アクションが実行されると、Agent はトリガーとなった Agent イベントに agent.rule_actions でアクションレポートを添付します。これは個別のカスタムイベントではなく、レポートはルールに一致した Security イベントとともにシリアル化されます。SIGKILL の場合、Agent はターゲットプロセスが終了するまでイベントの送信を遅延させ、タイミングフィールドが正確になるようにする場合があります。

フィールド説明
type常に kill
signalPOSIX シグナルが送信されました (例: SIGKILL、SIGTERM)
scopeprocess、container、または cgroup
status実行結果: performed、partially_performed、error、kill_queued、kill_aborted、rule_disarmed、または rule_dismantled
disarmer_typeKill をブロックまたは変更したセーフガード: container または executable (該当する場合)
created_atターゲットプロセスが作成された時刻
detected_atルールが一致した時刻
killed_atシグナルが送信された時刻 (該当する場合)
exited_atターゲットプロセスが終了した時刻 (該当する場合)
ttrプロセス作成から終了までの経過時間

ルールの一致後に kill アクションが実行された回数をカウントするには、タグ rule_id:<rule_id> および action_name:kill を指定して datadog.runtime_security_config.rules.action_performed メトリクスを使用します。

network_filter: ネットワークトラフィックの監視またはブロック

network_filter を使用して、侵害されたプロセスまたは cgroup の BPF フィルター式に一致するパケットをドロップします。これはホストレベルでのネットワーク分離です。

Datadog での構成

Agent ポリシーファイルで network_filter アクションを定義することに加え、Datadog で侵害されたワークロードを分離できます。

  • 自動: このセクションで説明されているように、ポリシー内の Agent ルールに network_filter アクションを追加します。ルールが一致すると、Agent は一致するトラフィックを自動的にドロップします。
  • 手動: セキュリティシグナルから、シグナルサイドパネルの Respond の下にある Network isolation を使用します。

使用するタイミング

  • 悪意のあるプロセスを検出した後に C2 通信を遮断します。
  • 侵害されたコンテナからの DNS トラフィックまたは特定のポートのトラフィックをブロックします。

要件

  • 強制適用を有効にする必要があります。
  • Agent 設定で raw_packet イベントタイプを有効にする必要があります。
  • Linux のみ (eBPF ベースのパケットフィルタリング)。

パラメーター

フィールド必須デフォルト説明
filterはい—BPF フィルター式 (例: port 53、tcp port 80)。
policyいいえallowdrop または allow。drop のみがパケットのドロップを強制します。
scopeいいえprocessprocess または cgroup。

例

rules:
  - id: block_malicious_container_network
    expression: exec.container.id == "046f6a38c8b404a78fb9be56672d554ed5a326f4c568ffb137e16cf3e7e6be43"
    actions:
      - network_filter:
          filter: "dst net 10.0.0.0/8 or dst net 172.16.0.0/12 or dst net 192.168.0.0/16 or dst net 169.254.0.0/16 or dst net 127.0.0.0/8"
          policy: drop
          scope: cgroup

生のパケットアクションとメトリクス

生のパケットアクションイベント

カーネルがアクティブなフィルターに一致するパケットをドロップすると、Agent は rawpacket_action カスタムイベント (@agent.rule_id:rawpacket_action) を発行できます。Agent はドロップされたすべてのパケットに対してイベントを送信できないため、これらのイベントはドロップ量が多い場合にはレート制限されます。イベントペイロードには以下が含まれます。

フィールド説明
packet.droppedtrue (ドロップされたパケット用)
packet.layersデコードされたネットワークレイヤー (Ethernet、IP、TCP/UDP など)
packet.tls利用可能な場合の TLS コンテキスト
networkドロップされたパケットのネットワークコンテキスト (デバイス、ソース、宛先)

メトリクス

ドロップ数を確実に追跡するには、datadog.runtime_security_config.network.raw_packet.dropped メトリクスを使用します。

hash: ファイルハッシュを計算する

トリガーイベントで参照されるファイルの暗号化ハッシュでイベントをエンリッチするには、hash を使用します。これは、脅威インテリジェンスの照合やフォレンジック分析に役立ちます。

使用するタイミング

  • バイナリが削除または変更される前に、実行時にハッシュ化します。
  • 書き込み用に開かれたファイルをハッシュ化し、既知のマルウェアシグネチャと関連付けます。

パラメーター

フィールド必須デフォルト説明
fieldいいえexec.file (exec ルールの場合); open.file (open ルールの場合)ハッシュ化するファイルイベントフィールド (例: exec.file、open.file)。他のイベントタイプで必須です。
max_file_sizeいいえ5242880 (5 MB)、runtime_security_config.hash_resolver.max_file_sizeハッシュ化する最大ファイルサイズ (バイト) から。これより大きいファイルはスキップされます。

サポートされているアルゴリズム

ハッシュは Agent のハッシュリゾルバーによって計算され、Agent の構成に応じて MD5、SHA1、SHA256、および SSDEEP が含まれる場合があります。結果はファイルイベントの *.hashes フィールドに表示されます (例: exec.file.hashes)。使用するアルゴリズムを変更するには、system-probe.yaml の runtime_security_config.hash_resolver.hash_algorithms を更新するか、DD_RUNTIME_SECURITY_CONFIG_HASH_RESOLVER_HASH_ALGORITHMS を設定します。すべてのハッシュリゾルバーパラメーターについては、Workload Protection Agent の構成を参照してください。

例

rules:
  - id: hash_dropped_binary
    expression: exec.file.path startswith "/tmp/" && exec.file.name not in ["systemd"]
    actions:
      - hash:
          field: exec.file
          max_file_size: 10485760  # 10 MB

log: Agent ログに書き込む

ルールがトリガーされたときに、Runtime Security Agent ログに構造化メッセージを出力するには、log を使用します。これは、完全なセキュリティシグナルを生成せずに、カスタムルールのデバッグやルールのトリガーの監査を行う場合に役立ちます。

使用方法

  • 開発中のルールロジックのデバッグ。

パラメーター

フィールド必須デフォルト説明
levelはい—ログレベル: debug、info、warning、または error。
messageいいえRule <rule_id> triggeredカスタムメッセージ。

例

rules:
  - id: log_sensitive_file_access
    expression: open.file.path startswith "/etc/"
    actions:
      - log:
          level: warning
          message: "Suspicious file access detected on sensitive path"

coredump: フォレンジック状態のキャプチャ

ルールが一致した時点で Agent の内部状態のスナップショットを取得するには、coredump を使用します。ダンプは (無効にされていない限り) gzip 圧縮され、Security イベントに添付されます。

使用方法

  • 主にデバッグ目的で使用されます。
  • トリガーイベントとともに、プロセスツリー、マウントテーブル、dentry キャッシュ状態などの内部コンテキストキャッシュをキャプチャします。

プラットフォーム

Linux のみ。

パラメーター

process、mount、または dentry のいずれか 1 つを true に設定する必要があります。

フィールド必須デフォルト説明
process少なくとも 1 つfalseプロセスリゾルバーのスナップショットを含めます。
mount少なくとも 1 つfalseマウントリゾルバーのスナップショットを含めます。
dentry少なくとも 1 つfalsedentry リゾルバーのスナップショットを含めます。
no_compressionいいえfalse (gzip 圧縮が有効)ダンプペイロードの gzip 圧縮を無効にします。

例

rules:
  - id: capture_forensic_state
    expression: exec.file.path startswith "/tmp/" && process.container.id != ""
    actions:
      - coredump:
          process: true
          mount: true
          dentry: true
          no_compression: false

アクションの組み合わせ

1 つのルールで複数のアクションを連結できます。ルールが一致すると、リストの順序で実行されます。

rules:
  - id: detect_and_respond
    expression: exec.file.path == "/tmp/payload"
    actions:
      - set:
          name: payload_seen
          value: true
      - hash:
          field: exec.file
      - log:
          level: info
          message: "Payload executed, hashing and killing"
      - kill:
          signal: SIGKILL
          scope: process

一般的なパターン:

パターンアクション
検出 → エンリッチ → アラートhash のみ (シグナルは自動的に送信されます)
検出 → 応答kill または network_filter
マルチステップ検出set ルール A 内、参照 ${var} ルール B 内
カスタムルールのデバッグlog

プラットフォームの概要

アクションLinuxWindows
set✅✅
kill✅✅
hash✅❌
log✅✅
coredump✅❌
network_filter✅❌

検証ルール

Agent はポリシーの読み込み時にアクションを検証します。

  • リスト項目ごとに 1 つのアクションタイプ: set と kill は同じアクションブロック内に含めることはできません。
  • 必須フィールド: 例: kill.signal、log.level、network_filter.filter。
  • 強制ゲート: kill と network_filter は強制が有効になっている必要があります。
  • イベントタイプの互換性: network_filter には raw_packet イベントタイプが必要です。hash.field はルールのイベントタイプと互換性がある必要があります。