Takumi Agent の仕組み
このページでは、Takumi Agent が Mac デバイス上で Takumi Guard を動かす仕組みとして、リクエストの経路、Takumi Agent インストールパッケージの構成要素、設計、デバイスが自身の状態を判定する方法を説明します。
本ページに記載している挙動は現時点のものです。変更する場合はリリースノートで予告しますが、セキュリティ上の緊急対応などにより、予告なく変更する場合があります。
リクエストの経路
Mac デバイス上のツールが送信したリクエストの経路を、次の図に示します。
コンテナイメージの取得も同じ経路をたどりますが、Guard が行うのは取得の判定のみです。イメージ自体は、利用者自身の認証情報でレジストリから取得されます。
構成要素
Takumi Agent のパッケージをインストールすることで、下記の要素がデバイスに追加されます。
- デバイスの状態を表示し、ほかの要素を有効化するメニューバーのアプリ
- 対象レジストリへの接続を捕捉する macOS のシステム拡張
- Takumi Guard に判定を問い合わせてその結果を中継するバックグラウンドサービス
バックグラウンドサービスは、Mac デバイスの起動時、ユーザーがログインする前に起動します。そのため、保護はユーザーのセッションに依存しません。
設計の原則
Takumi Agent の設計は、次の原則に従います。
- 扱うのはレジストリの通信のみ。それ以外の接続はそのまま通し、復号することはない
- デバイスはセキュリティ上の判断をしない。ブロックリストとポリシーは Takumi Guard 側で管理され、アプリを更新しなくても保護は最新に保たれる
- フェイルクローズ。Guard に到達できない場合、捕捉したリクエストは公開レジストリに流さずに拒否する
- デバイスごとの認証局。レジストリの通信を読むため、エージェントはデバイス上で認証局を生成する。秘密鍵は Mac デバイスの外に出ることがなく、対象レジストリの通信にのみ使われる
- エグレスロック。ネットワークフィルタが対象レジストリへの直接の接続をブロックし、Takumi Guard を迂回できないようにする
デバイスの認証局
デバイスの認証局はインストール時に Mac デバイス上で生成され、その秘密鍵が Mac デバイスの外に出ることはありません。macOS がこの認証局を信頼するには管理者の直接の承認が必要なため、インストーラーが代わりに行うことはできません(クイックスタートのステップ 5を参照)。信頼されるまで、捕捉対象となるパッケージのダウンロード通信はブロックされます。独自の証明書ストアを持つツールは、Takumi Agent のトラストバンドルを参照し、証明書を読み込みます(Takumi Agent を使った開発を参照)。アンインストール時には秘密鍵が削除され、証明書もシステムキーチェーンから削除されます(アンインストールを参照)。