> ## 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.

# エージェントのインストール

> Windows、Linux、macOS エンドポイントに SecureAI OS エージェントをインストールする

# エージェントのインストール

SecureAI OS エージェントは、**\[管理] → \[エージェント レジストリ] → \[OS エージェント]** で構築した **インストーラー パッケージ**からインストールされます。このパッケージは、**バックエンド URL** とスコープ付き **登録キー**という 2 つの値を含む、すぐに実行できるコマンド (Windows) またはスクリプト (Linux/macOS) を生成します。完全なパッケージ ビルダーと登録の仕組みについては、[登録とインストーラー パッケージ](/ja/en/agent/enrollment-and-packages) を参照してください。

## Windows (MSI)

Windows は **コード署名された MSI** を使用します。 MSI はダウンロード時に変更されないため、その Authenticode 署名は有効なままになります。構成は、ファイルに組み込まれるのではなく、インストール時に `msiexec` コマンド ラインで渡されます。

```powershell theme={null}
msiexec /i "secureai-agent.msi" /qb BACKEND_URL=https://{customer.name}.hiperai.ai ENROLL_KEY=sk-...
```

| プロパティ         | 説明                                       |
| ------------- | ---------------------------------------- |
| `BACKEND_URL` | SecureAI バックエンドの起点 (エンドポイントはここをホームとします)。 |
| `ENROLL_KEY`  | インストーラー パッケージのスコープ付き `agent:enroll` キー。  |

インストーラー パネルには、値が事前に入力された正確なコマンドが表示されます。これを直接コピーします。

<Tip>
  **大規模な導入**

  既存の MDM/RMM (Intune、GPO、SCCM など) を介して同じ `msiexec` コマンドをプッシュします。 URL とキーはコマンド ライン プロパティであるため、1 つの署名付き MSI がすべてのテナントとグループに対して機能します。
</Tip>

## Linux / macOS (スクリプト)

インストーラー パッケージから自己完結型のシェル スクリプトをダウンロードして実行します。スクリプトは適切な `.deb`/`.pkg` を取得し、エージェント構成 (例: Linux の `/etc/secureai-agent.toml`、macOS の LaunchAgent plist) を書き込みます。

```bash theme={null}
sudo ./secureai-agent-install.sh
```

バックエンド URL と登録キーは、パッケージ用に生成されたスクリプトにすでに埋め込まれています。

## 最初の実行時に何が起こるか

最初の起動時にエージェントは**登録**します。エージェントは登録キーを提示し、デバイスを登録し、デバイスごとのトークンとその実行時設定を受け取ります。次に、ハートビートを開始し、解決された [ポリシー](/ja/en/agent/policies-and-groups) を適用します。バックエンド URL の解決方法やデバイス トークンのローテーション方法などの詳細については、[登録とインストーラー パッケージ](/ja/ja/agent/enrollment-and-packages) を参照してください。

## 関連

* [登録およびインストーラーパッケージ](/ja/ja/agent/enrollment-and-packages)
* [ポリシーとグループ](/ja/ja/agent/policies-and-groups)
* [エンドポイントエージェント概要](/ja/ja/agent/overview)