View this page in English?Switch to English
    本文へスキップ
    Gaincontrol

    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 の呼び出しを、信頼境界を出る前にゲートします。

    Zino のアーキテクチャ: コントロールプレーンとデータプレーンPolicy Server は唯一のコントロールプレーン権限として、ワークロードのフリートに ID と署名済みポリシーを提供します。各ワークロードは Zino SDK をインプロセスで実行し、REST、Shell、MCP の呼び出しを、何かが外に出る前に信頼境界でゲートします。エンタープライズ Vault は Policy Server を通じて認証情報を供給し、SDK が呼び出しごとに注入します。エージェントが長期的なトークンを保持することはありません。シークレットを仲介SPIRE ID +署名済み WASM ポリシーSPIRE ID +署名済み WASM ポリシー↑ ハッシュ連鎖の監査↑ ハッシュ連鎖の監査
    エンタープライズ Vault既存のシークレットストア
    Policy Serverコントロールプレーン · 唯一の権限
    ワークロード

    Zino SDK

    インプロセス · サイドカー不要 · 認証情報は注入され、保持されない

    信頼境界
    REST / HTTPここで検査
    Shellここで検査
    MCPここで検査
    ワークロード

    Zino SDK

    インプロセス · サイドカー不要 · 認証情報は注入され、保持されない

    信頼境界
    REST / HTTPここで検査
    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 が引き続き信頼できる唯一の情報源となります。

    認証情報ブローカー · プラットフォーム管理、呼び出しごと

    1. アプリが外向きの呼び出しを行います。アプリが設定した Authorization ヘッダーは取り除かれます。

    2. インターセプターが、(ホスト、パス、メソッド、ツール)にスコープ化された認証情報を取得します。

    3. プラットフォームのトークンが、エージェントごとの 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、構成証明、そして実際の認可レイヤーが本番で稼働しています。

    1. 第0週

      セットアップ

      お客様の環境に Policy Server を設置。トラストルートを発行し、SPIRE Agent を1フリートに展開します。アプリの変更はまだありません。

    2. 第1週

      ID

      パイロット対象エージェントに initialize() を1行。2層の構成証明がエンドツーエンドで機能します。シャドーモードで観測のみ。

    3. 第2週

      ポリシー

      REST、Shell、MCP で捕捉を有効化。許可/拒否を適用し、監査ログをストリーミング。ブロック時に Slack へ通知します。

    4. 第3週

      コールバック

      実行前コールバックを組み込み、アプリ固有のルールを適用。共同での結果報告と、次の2チームへの展開計画を策定します。

    パイロットの前提 · 4週間 · スポンサー1名 · フリート1つ · インフラ改修なし