登録およびインストーラー パッケージ
インストーラー パッケージ は、エージェントを展開するために構築するユニットです。これには、プラットフォーム、デバイスが参加する必要があるタグとグループ、および専用の登録キーがバンドルされているため、インストール コマンドは自己完結型です。パッケージの作成
[管理] → [エージェント レジストリ] → [OS エージェント] で、次のパッケージを作成します。
保存時に、SecureAI
agent:enroll を範囲とする専用の API キーを自動生成し、それをパッケージの登録キーとして保存するため、インストール コマンドには別の認証情報が必要ありません。パッケージを削除すると、そのキーが非アクティブ化されます。
登録グループ (自動固定)
パッケージの 登録グループ はハード ピンです。パッケージに登録するデバイスは、最初の接続時にそのグループにバインドされます。グループのメンバーシップによって、デバイスがどの ポリシー を解決するかが決まります。登録ハンドシェイク
エージェントが最初に実行されるとき、登録キーを使用してPOST /enroll を呼び出し、そのマシン ID、ホスト名、OS、アーキテクチャ、バージョン、フィンガープリント、および機能を送信します。バックエンド:
- デバイスを登録 (または照合) します。
- デバイスごとのトークンを 1 回発行し、後続のすべての呼び出しを認証します。
- ランタイム 構成 (解決されたポリシー、出力設定、ルーティングなど) を返します。
revoked: true が報告され、管理者が再度有効にするまでデバイスは切断されたままになります。
バックエンド URL 解決
エージェントはBACKEND_URL に電話をかけます。サーバー側では、有効な URL は forwarded/request-origin ヘッダーから解決され、SECUREAI_AGENT_URL 環境変数でオーバーライドできます。これはリバース プロキシの背後で役立ちます。