デバイスの管理
このページでは、組織の管理者が操作できる機能について説明します。Takumi Agent の管理コンソールからは、次の操作が可能です。
- 登録キーの発行・失効
- 各デバイスで保護対象となるエコシステムの設定
- エージェントの更新
- デバイスのデコミッション
- 診断情報、改ざんの痕跡の確認
いずれの機能も、左のナビゲーションバーの Endpoint から操作します。
このページの操作にはすべて、オーナー または Takumi 管理者 のロールが必要です(ロールと権限を参照)。
登録キーの発行・失効
登録キーは、Mac デバイスを組織のデバイスとして登録するために必要です。Endpoint → 登録キー から、組織内で発行された登録キーの一覧を確認できます。
発行方法の詳細についてはクイックスタートを参照してください。
各登録キーにはラベル、最大アクティベーション数、有効期間が設定されます。いずれも管理コンソールから確認できますが、登録キーの値そのものが表示されるのは、発行直後の一度きりです。
登録キーを失効させる場合は、登録キーの詳細画面下部にある 失効 をクリックしてください。失効後は、その登録キーによる新規デバイスの登録が拒否されます。
登録キーを失効しても、その登録キーで既に組織に登録されたデバイスの紐付けには影響しません。
特定のデバイスの組織への登録を無効化するには、デバイスのデコミッションが必要です。
登録キーの発行モーダル内の 機能 では、発行するキーで組織に紐付けられるデバイスについて、保護対象とするエコシステムを次の中から個別に指定できます。
- npm インストール保護
- PyPI インストール保護
- RubyGems インストール保護
- Go モジュールインストール保護
- Composer インストール保護
- コンテナイメージ保護
すべてのエコシステムを選択した状態で登録キーを発行した場合、保護機能は制限されず、今後 Takumi Guard に追加されるエコシステムも自動で保護対象となります。保護範囲は管理コンソールの 設定タブから組織全体に適用することが可能で、組織全体で保護が無効化されているエコシステムは、登録キーの設定画面にて 組織による制限 と表示されます。この状態の登録キーはキー・デバイス単体の設定を通して有効化された場合でも、組織全体で有効化されるまで効果はありません。
登録キーの保護機能設定は登録キーの発行後であっても変更が可能です。発行後に登録キーの保護機能設定を変更した場合、当該登録キーにより登録されたデバイスにも自動で変更が反映されます。デバイスを再登録する必要はありません。
デバイスごとの保護対象エコシステム
デバイス上でエコシステムが保護対象となるのは、次の 3 つの条件が満たされてい るものです。
- 組織設定:Endpoint → 設定 → 保護機能 にて、エコシステムのトグルが有効化されている
- 登録キー:デバイスの登録に使ったキーの設定にてエコシステムのトグルが有効化されている(設定方法は前述のとおり)
- デバイス単位の上書き(設定した場合のみ):管理コンソールにてデバイスの詳細を開き、保護 セクションの このデバイス個別に上書き… をクリックし、オーバーライドを適用 で確定する。これにより、保護機能セクションにてオーバーライド のバッジが表示され、組織および登録キーの設定をオーバーライドされる。オーバーライドを解除 で元の設定に戻る。
保護機能がオフになっている場合、デバイスの 保護 セクションに、3 つの設定のうちどれによってオフになっているかが表示されます。エグレスロック(対象レジストリへの直接の接続をブロックするネットワークフィルタ)も同じ設定に従い、デバイスで 1 つでもエコシステムが保護対象であれば、エグレスロックが必要になります。一部のエコシステムがオフのデバイスも保護されているものとして扱われ、管理コンソールには 保護中(ポリシーにより N 件無効) と表示されます(デバイスの状態を参照)。