◉ANTIGRAVITY LABEN
記事一覧/Agents & Manager
◈ Agents & Manager/2026-07-12上級

書き込みより怖いのは到達先だった — エージェントの外向き通信を許可ホストだけに絞る

エージェントに実作業を委ねるとき、私が一番警戒しているのはファイルの書き換えではなく、どこへ通信するかです。到達先を deny-by-default で絞る小さなゲートの実装と、21晩の無人運用で拾った通信の内訳をまとめました。

Antigravity377エージェント73権限設計11ネットワーク個人開発102

✦ プレミアム記事

ある朝、前夜のスケジュール実行のログを追っていて、見慣れないホスト名で手が止まりました。依存パッケージの postinstall が、私の知らない集計エンドポイントへ静かに ping を投げていたのです。エージェント自身が悪さをしたわけではありません。エージェントに任せた npm install の、そのまた先が外へ出ていっただけです。

統一パーミッションでファイルの書き込みには承認をかけていました。けれど「どこへ通信するか」には、何の関門も置いていなかった。個人開発でエージェントを無人で回すようになってから、私が一番の急所だと感じているのはここです。書き換えられるものは差分を見れば戻せます。けれど一度外へ出ていったリクエストは、戻せません。

書き込み権限ばかり見ていた

エージェントに実作業を委ねるという話をするとき、議論はたいてい「何を変更させるか」に向かいます。ファイルを消す、コミットする、デプロイする。どれも承認ダイアログで止められますし、統一パーミッションはその一元管理をきれいにしてくれました。

けれど委譲の怖さの半分は「何に到達できるか」の側にあります。エージェントが走らせるビルド、テスト、パッケージインストール、ツール呼び出しは、どれも外向きの通信を伴います。その通信先は、承認ダイアログには出てきません。具体的には次のような通信が、私の環境では黙って通り抜けていました。

通信の出どころ到達先の例承認ダイアログに出るか
依存パッケージの postinstallベンダーの集計ビーコン出ない
ツールが同梱するテレメトリ解析サービスの収集口出ない
エージェントが書いた検証スクリプト任意の外部 API出ない
課金エンドポイントへの実呼び出し広告・ストア・決済系 API出ない

私が守りたかったのは、最後の行です。iOS/Android のアプリを個人で運用していると、エージェントの手元にはAdMob などの広告配信やストアの管理 API を叩ける鍵が、環境変数として置かれている場面があります。夜間の自動処理でその鍵を使ってほしい一方、想定外のホストへその鍵が向かうのだけは避けたい。境界を引く場所は、書き込みではなく到達先だと考え直しました。

到達先を deny-by-default で絞る

方針はひとつです。エージェント配下の通信を、すべて手元のゲートに通す。そのゲートは「許可リストに載っているホストだけ」を通し、それ以外は既定で拒否する。deny-by-default にするのがこの設計の肝で、allow-list を書き忘れたホストは通らない、という方向に倒します。逆(既定で許可し、危ないものだけ塞ぐ)にすると、知らないうちに増えた到達先を永遠に追いかけることになります。

実装の勘所は、TLS を割らないことです。中身を復号して覗く必要はありません。私が知りたいのは「どのホストに繋ごうとしたか」だけで、それは HTTPS の CONNECT 要求のホスト名を見れば分かります。中身には触れないので、正規の通信のプライバシーも保てます。

✦

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

この記事の続きを読む

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

この記事で得られること
✦CONNECT を許可ホストだけ通す、80行の deny-by-default 送信ゲート(動くコード)
✦プロジェクトごとに allowlist を空から育てる手順と、拒否ログの読み方
✦21晩の無人実行で計測した拒否41件・想定外9ホストの内訳と、TLS を割らない設計のトレードオフ
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

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

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

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

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

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

関連記事

◈ Agents & Manager2026-07-29
agent.md の綴り誤りが権限を広げていた — frontmatter を厳格に検証する lint を書く
agent.md の frontmatter は綴りを間違えてもエラーになりません。既定値へ静かに落ちた結果、意図と逆の権限が適用されていた実例と、権限キーだけを厳しく検証する lint の実装・実測を記録しました。
◈ Agents & Manager2026-04-27
Antigravity を個人開発の「夜のもう1人」として迎え入れる運用モデル
Antigravity のエージェントを、個人開発者にとっての「夜のもう1人」として運用するための設計指針。タスクの渡し方・境界線の引き方・朝の3点確認をスクリプトにする方法まで、実際に運用して整えてきた手順を書き残します。
◈ Agents & Manager2026-09-24
無人実行のエージェントが設定ファイルを書き換えたら戻す、小さな番人スクリプトの組み方
読み取り専用にしたはずの枠をエージェント自身が設定ファイルごと広げてしまう、という報告を読んで、夜間の無人実行を外側から包む番人を組みました。実行前後の指紋比較・退避と復元・打ち切り時間の3点を、動くコードでお伝えします。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます