ANTIGRAVITY LABEN
記事一覧/Tips & 活用術
Tips & 活用術/2026-06-22上級

保存するエージェントログから秘密を消す — 投入前のリダクション層を設計する

無人で走るエージェントのログを残し始めると、いつかトークンやAPIキーが平文で記録されます。ローテートしても、流出したログは消えません。書き込みの直前で秘密を確実に落とすリダクション層を、正規表現だけに頼らず既知の秘密を登録して消す方式まで含めて、動くPython実装と運用の所感つきで設計します。

Antigravity258ログ設計秘密情報セキュリティ9本番運用15

プレミアム記事

無人で走らせているエージェントのログを、後から眺めていたときのことです。ある行に、外部 API のトークンがそのまま残っていました。エラーのリトライ時に、リクエスト全体をデバッグ目的で書き出していた——ただそれだけの設定が、平文の秘密をディスクに刻んでいました。

ログは消せます。けれども、すでに別の場所へ転送されたログや、バックアップに取り込まれたログは、こちらの手の届かないところへ広がっています。トークンをローテートすれば被害は止められますが、ログそのものが汚染された事実は消えません。だから対処は、流出してからではなく、書き込む手前で済ませておく必要があります。

ここで設計するのは、ログを書く直前に必ず通す「リダクション層」です。Antigravity 2.0 のエージェントは、ツール呼び出しやモデルへの入出力をそのまま記録すると役に立ちますが、その素直さが秘密も一緒に運んでしまいます。記録の便利さを保ったまま、秘密だけを落とす一点を作ります。

ログは「いつか誰かに見られる」前提で書く

最初に置いておきたいのは、運用上の前提です。ログは、書いた本人だけが読むものではありません。

転送先の監視サービス、共有のストレージ、エラー集約ツール、そして将来の自分。ログは思っているより遠くまで旅をします。「自分しか見ないから」という想定は、無人運用では特に崩れやすいものです。だからこそ、ログに秘密を「最初から入れない」ことを設計の前提に据えます。

入れてしまってから消すのではなく、入る経路を一つに絞って、そこで確実に落とす。発想としては、許可リストで権限を一点に集めるのと同じ形になります。

何が漏れるのか — 秘密の出どころを並べる

落とす対象を決めるには、どこから秘密が混ざるかを先に把握しておくと迷いません。

出どころ混ざりやすい秘密典型的な記録経路
外部APIへのリクエストBearerトークン, APIキーリトライ時のリクエスト全文ダンプ
環境変数の出力シークレット, 接続文字列起動時の設定ダンプ・例外のローカル変数
モデルへの入出力貼り付けた認証情報プロンプト・ツール引数の記録
スタックトレースURLに埋まったトークン例外メッセージのそのままの記録

縦に出どころ、横に「何が」「どう」記録されるかを並べました。狙って書いていなくても、例外処理やリトライの「全部出す」挙動が秘密を運ぶのが厄介なところです。攻撃ではなく、親切な設計がそのまま穴になります。

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
エージェントの実行ログに秘密が混入する出どころを整理し、ログ書き込みの直前で一度だけ通すリダクション層の置き場所を、設計の理由つきで示します
正規表現だけでは取りこぼす問題に対し、起動時に環境変数やシークレットストアの実値を「登録」して確実にマスクする方式を、そのまま使えるPython実装で提供します
消しすぎると障害調査ができなくなるジレンマに対し、部分マスクと安定ハッシュを使い分ける指針を、個人開発で無人運用を続けてきた実体験から共有します
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

Tips & 活用術2026-03-20
Antigravity 実践テクニック集【後編】— マルチエージェント・本番開発・収益化の上級テクニック
Antigravity Lab のプレミアム記事から厳選した上級テクニックの後編。マルチエージェント・オーケストレーション、本番品質アプリ開発(SwiftUI・Android・Edge AI)、SaaS収益化パイプラインをコード付きで解説。
Tips & 活用術2026-06-21
長く走ったエージェントが何をしたかを遡る — 会話内検索を起点にしたレビュー術
Antigravity v2.1.4 で加わった会話ビュー内の検索を、長時間エージェントのレビューの起点として使う方法を整理します。検索語の選び方、見るべき分岐点、背景エージェントのログ突き合わせまで、実際の手順を具体的にまとめました。
Tips & 活用術2026-06-14
Antigravity の /btw で「ついでの質問」を本筋から切り離す
Antigravity 2.1.4 の /btw スラッシュコマンドで脇質問を使い捨てサブエージェントに逃がし、メインエージェントの文脈を汚さずに長いタスクを完走する運用メモです。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →