トレース

マシン(設定エディタでは「ワークスペース」)が出すリクエストはすべて — モデルプロバイダーへのエージェントの通信、パッケージのダウンロード、あなたのインフラへの呼び出し — Mac 上の Bromure のプロキシを通ります。トレースペインは、このマシンについてその通信のどこまでを記録するかを、何も記録しないところからリクエストとレスポンスの本体まるごとまでの間で定めます。記録されたものはすべて暗号化されて Mac 上に留まり、トレースインスペクタか bromure-cli trace で辿れます。

トレースペイン。セッショントレースの選択が「AI リクエストの詳細」になっていて、4 つの段階についての説明が添えられている。

トレースの段階が関わるのは、記録される通信だけです。セキュリティ タイムライン — セキュリティのエンジンが何をブロックし、許可し、差し替え、印を付けたか — は、ここで何を選んでいても常に記録されます。セキュリティ概要とタイムラインを参照してください。

セッショントレース

段階記録されるもの
オフ何も。
アクティビティのみリクエストごとにメタデータ 1 件:時刻、ホスト、メソッド、パス、ステータス、サイズ、遅延、トークン差し替えの報告、認証情報の漏洩警告。本体は含みません。
AI リクエストの詳細アクティビティのみの内容すべてに加え、既知のモデルプロバイダーのホスト(Anthropic、OpenAI、Google、Cohere、Mistral、Perplexity、x.ai、Groq、Replicate、HuggingFace)についてはリクエストとレスポンスの本体まるごと。
すべてすべてのホストの本体。ディスクが最も速く埋まります。

新しいマシンはAI リクエストの詳細で記録します(デフォルトのテンプレートから)。エージェントの会話を最初から監査できるようにするためです。段階は、保存すればすぐ実行中のマシンでも変わります。

ヒント: アクティビティのみでも監査の筋道は手に入ります — どのホストに接続したか、認証情報が差し替えられたか漏れたか — プロンプトと返答をディスクに置かずに済みます。

トレースの保存のしかた

メタデータは ~/Library/Application Support/BromureAC/traces/YYYY-MM-DD/<sessionID>.jsonl に、リクエスト 1 件につき JSON 1 行で入ります。本体はその隣、セッションごとのフォルダに、マシンの秘密を守るのと同じキーチェーン内のキーで暗号化されて置かれます。

何かが書かれる前に、機密のヘッダー(Authorization、Proxy-Authorization、Cookie、Set-Cookie、x-amz-security-token、api-key、そして -api-key で終わるすべてのヘッダー)は <redacted> に置き換えられ、差し替えと漏洩の疑いは先頭と末尾の数文字のプレビューだけが記録されます — 本物の秘密がトレースに入ることはありません。

本体はセッションあたり 100 MB が上限(古い本体から消え、メタデータは残ります)、トレースのフォルダ全体は 5 GB が上限(古い日から消えます)です。

警告: AI リクエストの詳細とすべてでは、AI とのやり取りの全文がディスク上にあります — 暗号化されてはいますが、確かにあります。

プライベートモード

プライベートモードのスイッチは、bromure.io の組織に登録された Mac にしか現れません。オンにすると、このマシンのセッションはセッションのメタデータ(ツール、ファイル、コマンド、トークンの使用量)をあなたの組織へ送るのをやめます — 「タイトルバーのインジケータも、管理者のセッション一覧も、このワークスペースからは何も見なくなります」。ローカルのトレースには影響しません。登録されていない Mac では、送るものがないのでスイッチは隠れています。既定:オフ。エンタープライズ — 登録とフリートを参照してください。

サブスクリプショントークンの差し替え

サブスクリプションでサインインしたエージェントが動くとき、プロキシは本物の Claude や Codex のサインイントークンを Mac 上に留め、VM には代替を渡せます — API キーに使うのと同じ差し替えです。このマシンについて一度あなたに尋ねたあと、ペインにはプロバイダーごとの行が出ます:

  • Claude サブスクリプショントークンの差し替え
  • Codex サブスクリプショントークンの差し替え

それぞれ有効(「プロキシは本物の OAuth トークンをこの Mac に留め、VM の中では偽のものを渡しています。」)または拒否と表示され、差し替えを忘れる(次のセッションでもう一度尋ねる)かもう一度尋ねるようにするでリセットできます。そうするとプロキシはまた尋ねます。プロキシが尋ねるまで、これらの行は隠れています。

記録されたものを見る

  • トレースインスペクタ — ウインドウ › トレースインスペクタ…(⇧⌘I)、またはマシンのマシンメニューのトレースを調べる。記録されたやり取りの、絞り込みできる生きた一覧で、差し替えと漏洩のバッジが付きます。捕らえた AI のやり取りは会話として表示されます。
  • コマンドライン — アプリが動いている状態で bromure-cli trace ls、trace summary、trace hostnames、trace leaks、trace clear。

どちらもトレースと監査で扱っています。

セキュリティ履歴(環境設定のみ)

環境設定 › トレース(この Mac 自身の環境設定。マシンの設定やリモートの Mac のものではありません)の Security history で、セキュリティ ウインドウがイベントをどう保持し、どう表示するかを決めます:

  • Keep events for — 7 days、30 days、90 days(既定)、180 days、1 year、Forever。「Events older than this are deleted from this Mac.」変更はすぐに適用されます。
  • Security window opens on — Last hour、過去 24 時間(既定)、Last 7 days、Last 30 days、All history。概要はその期間を数え、タイムラインはその期間で開きます。

設定リファレンス

設定種類既定
セッショントレースオフ / アクティビティのみ / AI リクエストの詳細 / すべて新しいマシンではAI リクエストの詳細
プライベートモードスイッチ(登録済みの Mac のみ)オフ
Claude サブスクリプショントークンの差し替え状態とリセット(最初に尋ねられたあと)非表示
Codex サブスクリプショントークンの差し替え状態とリセット(最初に尋ねられたあと)非表示
Keep events for(環境設定)7 days … Forever90 日
Security window opens on(環境設定)Last hour … All history過去 24 時間

関連する章