---
title: macOS に Workstation Agent をインストールする
description: macOS に OpenLM Platform 用の Workstation Agent を 1 台の Mac または MDM でフリート全体にインストールし、認証ファイルで接続して、プライバシーの権限を付与します。
product: OpenLM Platform
---

Mac からアプリケーションの使用状況を収集するには、各 Mac に Workstation Agent をインストールし、認証ファイルで OpenLM Platform に接続します。パッケージは 1 台の Mac にインストールすることも、MDM でフリート全体に配布することもできます。

Workstation Agent は、macOS 10.15 (Catalina) 以降の Intel (x86_64) および Apple Silicon (arm64) の Mac で動作します。エージェントは自己完結型のバイナリであるため、.NET ランタイムを別途インストールする必要はありません。

:::warning[最初に検疫属性を削除する]

macOS 版 Workstation Agent は Apple による公証 (notarization) を受けていないため、Gatekeeper がダウンロードしたインストーラーをブロックします。インストーラーをダウンロードしたら、開く前に、1 台の Mac にインストールする手順の手順 2 の説明に従って検疫属性を削除してください。

:::

## 開始する前に

次の前提条件を確認します。

- Mac が macOS 10.15 (Catalina) 以降を実行し、[システム要件](https://www.openlm.com/documentation/ja/cloud/deployment-operations/system-requirements/?component=workstation-agent)を満たしている。
- 管理者 (`sudo`) 権限がある。インストーラーは `/Library/OpenLMAgent/` に書き込みます。
- Mac から OpenLM Platform のアドレスの Agents Hub ポート (デフォルトは `443`、SSL 有効) への送信アクセスがある。エージェントは WebSocket 経由で接続します。
- エージェント用の認証ファイルがある。[コンポーネントの認証](https://www.openlm.com/documentation/ja/cloud/getting-started/authorize-components)の説明に従って、**Identity** でクライアントの種類 **Agent** を選択して生成します。Identity はファイルに `agent-authorization.json` という名前を付けます。

## 1 台の Mac にインストールする

1 台の Mac に Workstation Agent をインストールするには、次の手順を実行します。

1. [ダウンロードページ](https://www.openlm.com/downloads/)から macOS 版 Workstation Agent をダウンロードします。

   Mac のプロセッサに合ったビルド (Intel (x86_64) または Apple Silicon (arm64)) を選択します。
2. Gatekeeper にブロックされないように、ダウンロードしたインストーラーから検疫属性を削除します。

   ```bash
   xattr -d com.apple.quarantine <file>
   ```

   `<file>` を、ダウンロードしたパッケージ (例: `~/Downloads/<file-name>.pkg`) に置き換えます。ブラウザーでダウンロードしてインストールするすべてのマシンでこの手順を繰り返します。
3. パッケージ (`.pkg`) を開き、macOS インストーラーの指示に従います。
4. パッケージがインストールするプレースホルダー `/Library/OpenLMAgent/agent-authorization.json` に認証ファイルを上書きコピーします。
5. [エージェントを接続する](#エージェントを接続する)の説明に従って、エージェントを再起動します。
6. [エージェントを確認する](#エージェントを確認する)の説明に従って、エージェントを確認します。

インストーラーはファイルを `/Library/OpenLMAgent/` にコピーし、バイナリに署名し、ユーザーのサインイン時にエージェントを自動的に起動する LaunchAgent を登録します。

インストーラーはようこそ画面で開きます。

*macOS インストーラーのようこそ画面。*

最後に、インストーラーがインストールの成功を確認します。

*インストーラーがインストールの成功を確認します。*

## MDM でフリート全体にインストールする

パッケージを MDM 経由で配布し、root コンテキストで macOS のインストーラーコマンドを実行します。

```bash
sudo installer -pkg <file-name>.pkg -target /
```

`<file-name>` をパッケージ名に置き換えます。パッケージ識別子は `com.openlm.agent` です。インストールは画面表示なしで実行され、署名、権限、アップグレード時の設定バックアップ、LaunchAgent の有効化は、バンドルされたスクリプトが処理します。

一部の MDM プラットフォームでは、無人インストールに署名済みかつ公証済みのパッケージが必要です。ビルドはアドホック署名のみで公証されていないため、フリートに展開する前に MDM の Gatekeeper ポリシーに照らして検証してください。

## エージェントを接続する

エージェントは、認証ファイルを `/Library/OpenLMAgent/agent-authorization.json` から、設定を `/Library/OpenLMAgent/settings.json` から読み取ります。クラウドの OpenLM Platform の場合、接続先のアドレスも認証ファイルから取得します。セルフホストの OpenLM Platform の場合は、`settings.json` の `agentsHub` の下にサーバーアドレスを設定します。

```json
{
  "agentsHub": {
    "address": "<your-openlm-server-host>",
    "port": 443,
    "useSSL": true
  }
}
```

`settings.json` を編集した後や認証ファイルを置き換えた後は、変更を反映させるためにエージェントを再起動します。

```bash
launchctl kickstart -k "gui/$(id -u)/com.openlm.agent"
```

アップグレード時、インストーラーは `settings.json` と `agent-authorization.json` を保持するため、設定はパッケージの更新後も維持されます。

次のオプション設定がよく使われます。

- `process.trackingMs`: プロセス監視の間隔 (ミリ秒単位、デフォルトは `30000`)。
- `webmonitor.useWebMonitor`: ブラウザーアクティビティの監視をオンにします (デフォルトは `true`)。
- `process.autoPromptScreenRecording`: 起動時に画面収録の権限を求めるプロンプトを表示します (デフォルトは `false`)。
- `logging.minimumLevel`: ログの詳細度。例: `Information` または `Debug` (デフォルトは `Information`)。

## 必要な権限を付与する

エージェントには、macOS の 2 つのプライバシー権限が必要です。データ収集が機能するように、これらを付与してください。

- **画面収録 (Screen Recording)**: ウィンドウタイトルの追跡に必要です。**システム設定**を開き、**プライバシーとセキュリティ**、**画面収録** の順に選択して、**OpenLM Workstation Agent** をオンにします。その後、エージェントを再起動します。
- **フルディスクアクセス (Full Disk Access)**: Safari の閲覧履歴の読み取りに必要です。**システム設定**を開き、**プライバシーとセキュリティ**、**フルディスクアクセス** の順に選択して、`OpenLM.Agent.macOS` バイナリをオンにします。これがないと、Safari の履歴収集は警告なしに失敗します。他のブラウザーは影響を受けません。

画面収録リストでエージェントがオンになっています。

*画面収録でオンにしたエージェント。*

フルディスクアクセスリストでエージェントがオンになっています。

*フルディスクアクセスでオンにしたエージェント。*

フリートのマシンでは、MDM 経由で配布する PPPC (プライバシー設定ポリシー制御) 構成プロファイルを使用して、これらの権限を事前承認できます。ビルドはアドホック署名であるため、PPPC プロファイルでエージェントを確実に事前承認できない場合があり、ユーザーに引き続きプロンプトが表示されることがあります。確実な方法として、マシンごとに 1 回手動で権限を付与する運用を計画してください。

## エージェントを確認する

エージェントのプロセスが実行されていることを確認します。

```bash
launchctl print "gui/$(id -u)/com.openlm.agent"
pgrep -x "OpenLM.Agent.macOS"
```

`running` 状態と、空でない `pgrep` の結果で、エージェントが稼働していることを確認できます。

エージェントが OpenLM Platform にレポートしていることを確認します。

- **Agent Activity** で **Refresh** アイコンを選択し、ワークステーションがオンラインとして表示されることを確認します。
- 監視対象のアプリケーションが実行されている場合は、**Process Manager**、**Active Processes** の順に選択してセッションが表示されることを確認します。

接続が成功し、権限の警告がないことを、ユーザーごとのログで確認します。

```bash
tail -n 100 /Library/OpenLMAgent/logs/$(whoami)/<latest-log-file>
```

## パーソナルダッシュボードを開く

ユーザーは Workstation Agent から[パーソナルダッシュボード](https://www.openlm.com/documentation/ja/cloud/users/personal-dashboard/)を開きます。パッケージは **OpenLM Agent** アプリを **アプリケーション** フォルダーにコピーします。ダッシュボードを開くには、Launchpad や Spotlight などから **OpenLM Agent** を開きます。

ダッシュボードは既定のブラウザーで開きます。ユーザーは、[パーソナルダッシュボードの前提条件](https://www.openlm.com/documentation/ja/cloud/users/personal-dashboard/#はじめに)の説明に従って、Identity のアカウントでサインインします。ダッシュボードが開かない場合は、[パーソナルダッシュボードが開かないのはなぜですか？](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#パーソナルダッシュボードが開かないのはなぜですか)を参照してください。

## エージェントをアンインストールする

管理者権限でバンドルされたアンインストーラーを実行します。

```bash
sudo sh /Library/OpenLMAgent/uninstall.sh
```

アンインストーラーは、エージェントを停止し、LaunchAgent と `/Applications/OpenLM Agent.app` のコピーを削除し、`/Library/OpenLMAgent/` をログを含めて削除します。

アンインストーラーは、付与したプライバシー権限をリセットしません。これらを削除するには、次を実行します。

```bash
tccutil reset ScreenCapture com.openlm.agent
tccutil reset SystemPolicyAllFiles com.openlm.agent
```

## 既知の制限事項

macOS ビルドには次の制限があります。

- macOS ビルドはアドホック署名であり、公証されていません。Gatekeeper がブラウザーでダウンロードしたインストーラーに対して警告を表示することがあり、PPPC プロファイルで権限を確実に事前承認できない場合があります。手動での権限付与を計画してください。
- Safari の履歴収集にはフルディスクアクセスが必要です。これがないと、Safari の履歴は警告なしにスキップされます。他のブラウザーは影響を受けません。
- エージェントは LaunchAgent としてインストールされるため、ユーザーがサインインしている間のみ動作します。これは仕様です。ウィンドウタイトルやユーザーごとのブラウザー履歴を追跡するために、ユーザーの GUI セッションが必要だからです。
- アンインストールしても、プライバシー権限はリセットされません。必要に応じて手動でリセットしてください。

エージェントが起動しない、Agent Activity に表示されない、ウィンドウタイトルや Safari の履歴が収集されない場合は、[Workstation Agent のトラブルシューティング](https://www.openlm.com/documentation/ja/cloud/getting-started/install-workstation-agent/troubleshooting#macos-でエージェントが起動しないのはなぜですか)を参照してください。

:::info[次のステップ]
エージェントは、OpenLM Platform が監視を指示したアプリケーションを報告します。監視するアプリケーションを選択するには、**Navigation** を開き、**Agents**、**Process Manager** の順に選択して、[Process Manager](https://www.openlm.com/documentation/ja/cloud/automations/process-manager/) の説明に従って、ライセンスを管理するアプリケーションのプロセスを追加します。

その後、[Directory Synchronization Agent (DSA) のインストール](https://www.openlm.com/documentation/ja/cloud/getting-started/install-dsa)に進み、ディレクトリからユーザーとグループのデータを同期してください。
:::