Zino の仕組み。
Zino を運用するプラットフォームエンジニアとセキュリティエンジニアのための技術リファレンスです。どこで動くのか、何を捕捉するのか、認証情報がどう流れるのか、何と連携するのか、そして4週間のパイロットの内容を説明します。
概要
- 動作場所
- 各ワークロード内で動くインプロセス SDK。サイドカーも、ポリシー評価のためのネットワーク往復もありません。
- ID
- SPIRE が発行するワークロード ID を、2層のアテステーションで検証します。
- ポリシー
- 1つの Policy Server が署名した WASM ポリシーを、OPA スキーマで評価します。
- 捕捉対象
- REST/HTTP、Shell、そして stdio・SSE・HTTP 上の MCP。
- シークレット
- ボールトから仲介し、呼び出しごとに注入します。エージェントは何も保持しません。
- 監査
- すべての判断をハッシュチェーン型ログに記録します。
2つのプレーン:判断するプレーンと、適用するプレーン。
Policy Server は、フリート全体で唯一の署名権限です。Zino SDK は各ワークロードのインプロセスで動作し、サイドカーもポリシー評価のためのネットワーク往復も必要としません。REST、Shell、MCP の呼び出しを、信頼境界を出る前にゲートします。
3つの経路。1つのポリシーインターフェース。
REST、Shell、MCP はそれぞれ異なる方言を話します。Zino は、単一のポリシーエンジンでその3つすべてを捕捉します。
- サーフェス
- REST / HTTPrequests · httpx · aiohttp
- 捕捉する情報
- 外向きのHTTP呼び出しごとに構築される CallContext(メソッド、ホスト、パス、ツール、引数)。
- ポリシーの判断
- 同一の OPA スキーマで再認可します。承認されていないホストへの呼び出しは、送信される前に拒否されます。
- サーフェス
- Shellツール種別を認識
- 捕捉する情報
- 実行種別を HTTP、シェル、MCP に分類し、シェルコマンドはポリシーから直接登録されます。
- ポリシーの判断
- 実行前コールバックが、コマンドの実行前に検査または拒否できます。
- サーフェス
- MCPクライアントセッションをラップ
- 捕捉する情報
- stdio、SSE、HTTP のすべてのトランスポートで、外向きの MCP 呼び出しのツール名、スキーマ、引数。
- ポリシーの判断
- 各呼び出しはエージェントから出る前に認可され、未検証の MCP サーバーへの隙間を塞ぎます。
シークレットを管理するのは、アプリではなく Zino。
トークンは呼び出し時に注入され、設定は保存時に暗号化され、エンタープライズの Vault が引き続き信頼できる唯一の情報源となります。
認証情報ブローカー · プラットフォーム管理、呼び出しごと
アプリが外向きの呼び出しを行います。アプリが設定した Authorization ヘッダーは取り除かれます。
インターセプターが、(ホスト、パス、メソッド、ツール)にスコープ化された認証情報を取得します。
プラットフォームのトークンが、エージェントごとの HKDF 鍵でメモリ内で復号され、注入されます。
エージェントが長期的なAPIトークンを保持することはありません。
エンタープライズ Vault のフロントに立ちます
- HashiCorp Vault
- OpenBao
- AWS Secrets Manager
- Azure Key Vault
- Google Cloud
- CyberArk Conjur
- Thales
- Infisical
フレームワークアダプター
Zino はこれらのエージェントフレームワーク向けのアダプターを提供しています。SDK を1回呼び出すだけで、エージェントにポリシー適用と監査が組み込まれます。
- LangChain
- CrewAI
- AutoGen
- Claude Tool Use
- LlamaIndex
- OpenAI Assistants
- Semantic Kernel
4週間。1つのエージェントフリート。実際に適用されるポリシー。
スポンサー1名、インフラ改修なしの、範囲を限定したパイロットです。終了時には、ID、構成証明、そして実際の認可レイヤーが本番で稼働しています。
第0週
セットアップ
お客様の環境に Policy Server を設置。トラストルートを発行し、SPIRE Agent を1フリートに展開します。アプリの変更はまだありません。
第1週
ID
パイロット対象エージェントに initialize() を1行。2層の構成証明がエンドツーエンドで機能します。シャドーモードで観測のみ。
第2週
ポリシー
REST、Shell、MCP で捕捉を有効化。許可/拒否を適用し、監査ログをストリーミング。ブロック時に Slack へ通知します。
第3週
コールバック
実行前コールバックを組み込み、アプリ固有のルールを適用。共同での結果報告と、次の2チームへの展開計画を策定します。
パイロットの前提 · 4週間 · スポンサー1名 · フリート1つ · インフラ改修なし
