macOS に Workstation Agent をインストールする

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

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

最初に検疫属性を削除する

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

開始する前に

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

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

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

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

ダウンロードページから macOS 版 Workstation Agent をダウンロードします。

Mac のプロセッサに合ったビルド (Intel (x86_64) または Apple Silicon (arm64)) を選択します。
Gatekeeper にブロックされないように、ダウンロードしたインストーラーから検疫属性を削除します。
```
xattr -d com.apple.quarantine <file>
```
<file> を、ダウンロードしたパッケージ (例: ~/Downloads/<file-name>.pkg) に置き換えます。ブラウザーでダウンロードしてインストールするすべてのマシンでこの手順を繰り返します。
パッケージ (.pkg) を開き、macOS インストーラーの指示に従います。
パッケージがインストールするプレースホルダー /Library/OpenLMAgent/agent-authorization.json に認証ファイルを上書きコピーします。
エージェントを接続するの説明に従って、エージェントを再起動します。
エージェントを確認するの説明に従って、エージェントを確認します。

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

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

OpenLM Workstation Agent パッケージの macOS インストーラーのようこそ画面 macOS インストーラーのようこそ画面。

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

インストールが正常に完了したことを示す macOS インストーラーの概要画面 インストーラーがインストールの成功を確認します。

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

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

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 の下にサーバーアドレスを設定します。

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

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

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 の履歴収集は警告なしに失敗します。他のブラウザーは影響を受けません。

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

macOS のプライバシー設定の画面収録リストで OpenLM Workstation Agent がオンになっている状態 画面収録でオンにしたエージェント。

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

macOS のプライバシー設定のフルディスクアクセスリストで OpenLM Workstation Agent がオンになっている状態 フルディスクアクセスでオンにしたエージェント。

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

エージェントを確認する

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

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

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

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

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

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

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

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

ユーザーは Workstation Agent からパーソナルダッシュボードを開きます。パッケージは OpenLM Agent アプリを アプリケーション フォルダーにコピーします。ダッシュボードを開くには、Launchpad や Spotlight などから OpenLM Agent を開きます。

ダッシュボードは既定のブラウザーで開きます。ユーザーは、パーソナルダッシュボードの前提条件の説明に従って、Identity のアカウントでサインインします。ダッシュボードが開かない場合は、パーソナルダッシュボードが開かないのはなぜですか？を参照してください。

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

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

sudo sh /Library/OpenLMAgent/uninstall.sh

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

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

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 のトラブルシューティングを参照してください。

次のステップ

エージェントは、OpenLM Platform が監視を指示したアプリケーションを報告します。監視するアプリケーションを選択するには、Navigation を開き、Agents、Process Manager の順に選択して、Process Manager の説明に従って、ライセンスを管理するアプリケーションのプロセスを追加します。

その後、Directory Synchronization Agent (DSA) のインストールに進み、ディレクトリからユーザーとグループのデータを同期してください。

ドキュメントチームは、大規模言語モデルを使ってこのページを下書きすることがあります。公開前に、テクニカルライターがすべてのページをレビューし、製品と照らし合わせて検証します。最終的な判断は人間が行います。

開始する前に​

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

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

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

必要な権限を付与する​

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

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

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

既知の制限事項​