> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 登録およびインストーラー パッケージ

> SecureAI OS Agent インストーラー パッケージ、登録キー、デバイス トークンの仕組み

# 登録およびインストーラー パッケージ

**インストーラー パッケージ** は、エージェントを展開するために構築するユニットです。これには、プラットフォーム、デバイスが参加する必要があるタグとグループ、および専用の登録キーがバンドルされているため、インストール コマンドは自己完結型です。

## パッケージの作成

**\[管理] → \[エージェント レジストリ] → \[OS エージェント]** で、次のパッケージを作成します。

| フィールド          | 説明                                                          |
| -------------- | ----------------------------------------------------------- |
| **名前/説明**      | パッケージを特定します (例: 「エンジニアリング ラップトップ」)。                         |
| **プラットフォーム**   | Windows / Linux / macOS。                                    |
| **パッケージの種類**   | `standalone`。                                               |
| **エンドポイント タグ** | このパッケージに登録されたデバイスに適用されるラベル。                                 |
| **登録グループ**     | 最初の登録時にデバイスが固定される [グループ](/ja/en/agent/policies-and-groups)。 |

保存時に、SecureAI **`agent:enroll`** を範囲とする専用の API キーを自動生成し、それをパッケージの登録キーとして保存するため、インストール コマンドには別の認証情報が必要ありません。パッケージを削除すると、そのキーが非アクティブ化されます。

## 登録グループ (自動固定)

パッケージの **登録グループ** はハード ピンです。パッケージに登録するデバイスは、最初の接続時にそのグループにバインドされます。グループのメンバーシップによって、デバイスがどの [ポリシー](/ja/en/agent/policies-and-groups) を解決するかが決まります。

## 登録ハンドシェイク

エージェントが最初に実行されるとき、登録キーを使用して `POST /enroll` を呼び出し、そのマシン ID、ホスト名、OS、アーキテクチャ、バージョン、フィンガープリント、および機能を送信します。バックエンド:

1. デバイスを登録 (または照合) します。
2. **デバイスごとのトークン**を 1 回発行し、後続のすべての呼び出しを認証します。
3. ランタイム **構成** (解決されたポリシー、出力設定、ルーティングなど) を返します。

デバイスごとのトークンは **登録ごとにローテーション**します。 **取り消された**デバイスは再登録できません。登録応答では `revoked: true` が報告され、管理者が再度有効にするまでデバイスは切断されたままになります。

## バックエンド URL 解決

エージェントは `BACKEND_URL` に電話をかけます。サーバー側では、有効な URL は forwarded/request-origin ヘッダーから解決され、`SECUREAI_AGENT_URL` 環境変数でオーバーライドできます。これはリバース プロキシの背後で役立ちます。

## 登録されたデバイスの管理

\[OS エージェント] タブから、デバイスごとに、コマンドの送信、**取り消し** / **再有効化**、削除、グループの割り当て、所有者ユーザーのリンク/リンク解除を行うことができます。一括操作がサポートされています。コマンド配信は、ハートビート キュー フォールバックを備えた WebSocket チャネル経由で行われます (デバイスがオフラインの間にキューに入れられたコマンドは、次のハートビートで 1 時間の TTL で配信されます)。

## 関連

・[エージェントのインストール](/ja/ja/agent/installation)

* [ポリシーとグループ](/ja/ja/agent/policies-and-groups)
* [自己更新と改ざん防止](/ja/en/agent/quarantine-and-fleet-ops#self-update--anti-tamper)