allow、すべての
deny、すべての保留された承認、すべてのシャドウモードの「would-have」がここに着地し、
フィルタ可能で、それを生成したエージェント実行に相関付けられます。
events フィードの読み取りは Developer+ です。各行はツール呼び出しの引数スナップ
ショットのために上限付きの
args_summary フィールドを予約するため、このサーフェスは
Member 可読のもの(設定、ポリシー、discovered tools、
異常フィード)の上に位置します。これらすべてをコンソールから
設定します — これらはセッション認証されたルートで、リレー呼び出しではありません。1. events フィードに何が着地するか
エンジンが実行するすべての評価が記録されます — ブロックだけではありません。allow と
audit は deny と全く同様に行を残すため、フィードは例外ログではなく完全な証跡です。
行の判定は、エージェントが実際に見たものです:
| 判定 | 意味 |
|---|---|
allow / audit | 通された;audit はそれを監視したかったものとしてフラグ。 |
deny | ブロックされた — inbound では firewall_blocked(HTTP 400)、mcp ではツールエラー。 |
sanitize | 呼び出しの引数からマッチした部分文字列をリダクトして転送。 |
pending_approval | 人間のために保留;行は呼び出しがゲートされたことをマーク。 |
observe | ポリシーがマッチしなかった — 観察モードのカバレッジギャップ。 |
audit に格下げ
され、理由には [shadow] would … が前置されるため、フィードは、ライブに切り替える前に
ポリシーが何をブロックしたであろうかを正確に示します。
2. 各イベントが何を記録するか
単一のイベントは非正規化されたスナップショットです — 何かに結合し直さずに決定を再構築 するのに十分です:決定
決定
verdict、surface(inbound / response / mcp / egress)、tool_name、
そして人間向けの reason(「destructive shell command」、「egress to
169.254.169.254 denied」)。マッチしたルールがラベルを持っていた場合、policy_name
と rule_label が発火した正確なルールを名指しします — そのため行はあなたが書いた行に
直接戻って指します。相関キー
相関キー
request_id はイベントをリクエストログに結合します;conversation_id はマルチ
ターンセッションをグループ化します;agent_run_id(step_id / parent_step_id
とともに)はそれを 1 つの完全なエージェント実行とツールを要求した LLM 呼び出しに
結びつけます。これらが、フィードをフラットなリストではなくトレースにするものです —
§4 を参照。来歴
来歴
token_name、model_name、そして呼び出し元の ip — 呼び出しの背後のキー、
モデル、起点。skill_name は呼び出しが帰属可能だったときに所有
スキルを名指しし、quarantine はスキル隔離の保留を
フラグします。引数 & egress
引数 & egress
args_summary は上限付きのツール呼び出し引数スナップショットフィールドです
(このサーフェスが Developer+ である理由)。egress イベントでは、egress_host が
判断されたアウトバウンド宛先を記録します。3. 具体例 1 つ
エージェントがrm -rf /data で shell.exec 呼び出しを発行し、deny ルールがそれを
捕捉し、その 1 つの決定を見たいとします。フィードを判定とツールでフィルタします:
$ORCA_CONSOLE_TOKEN はあなたのセッション / アクセストークンであり、sk-orca-…
リレーキーではありません。/api/workspace/firewall/* ルートはコンソール認証され、
ロールゲートされています;/v1/* トラフィックのみがリレーキーを使います。4. 実行とセッションで相関付ける
すべてのイベントがagent_run_id と conversation_id を運ぶ理由は、呼び出しを孤立
して見るのをやめて、このエージェントがその実行全体で何をしたかを尋ね始められる
ようにするためです:
| フィルタ | 答える問い |
|---|---|
run_id=<run> | 1 つのエージェント実行のすべての判定 — 完全なアクション証跡。 |
session_id=<conv> | マルチターン会話をまたいだすべての判定。 |
verdict=deny,pending_approval | 「何が止められたか保留されたか」ビューを 1 つのクエリで。 |
surface=egress | アウトバウンド宛先の決定のみ — 持ち出しのレンズ。 |
since / until(unix 秒)とページングのための limit / skip も
受け入れます。ロールアップビュー — 実行またはセッションごとに 1 行で、判定ごとの
内訳、個別のツールとモデル、初回/最終観測つき — については、コンソールが
GET /api/workspace/firewall/events/aggregate?group_by=run(または group_by=session)を
読み、エージェントトレースツリーが /trace/by-run を読みます。両方とも、生のフィードと
同様に Developer+ です。
5. 保持と消去
ファイアウォールイベントは独自の保持期間を運びます — 30 日のデフォルトで、 365 日のハード最大にサーバーでクランプされます。各イベントは有効期限とともに 書き込まれ、TTL インデックスによって自動的に期限切れになります;フィード内の何も あなたの保持設定を過ぎて生きません。 消去権リクエストもここにカスケード します:ユーザーの削除は 30 日の猶予期間を開始し、その後彼らの PII がスクラブされ、 彼らのファイアウォールイベントが同じスコープのリクエストログとガードレールマッチと ともにパージされます。次に進む場所
判定
フィード内の各判定が実際に呼び出しに何をしたか。
シャドウモード
強制する前に「would-have」モードでフィードを読む。
ステージ & サーフェス
surface フィールドが名指しする 4 つのサーフェス。ファイアウォールリファレンス
完全なポリシー、ルール、API リファレンス。
