> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/endpoint-privilege-manager/user-guides/enable-file-inventory.md).
# ファイルインベントリの有効化
### 概要
Keeperエンドポイント特権マネージャー (EPM) は、マシンコレクション内のエンドポイントにインストールされた実行可能ファイルの詳細インベントリを収集できます。このインベントリにより、管理者は正確で的を絞ったポリシーを作成するためのデータを得られます。例えば、特定の古いバージョンのPowerShellをブロックしつつ、新しい承認済みバージョンを許可する、といった運用が可能になります。
{% hint style="info" icon="comment-question" %}
**なぜファイルインベントリを収集するのか?** EPMのポリシーは、広いワイルドカードではなく、特定のファイルパス、バージョン、ハッシュを対象にしたときに最も効果を発揮します。ファイルインベントリは、それらの詳細を把握するための仕組みです。インベントリがなければ、\_想定している\_インストール内容に対してポリシーを書くことになり、インベントリがあれば、\_実際に\_インストールされている内容に対してポリシーを書けます。
{% endhint %}
### **macOSでのアンインストール**
macOSからKeeperエージェントをアンインストールするには、デプロイパッケージとともにダウンロードされるインストールスクリプトに含まれるアンインストールスクリプトを実行します。
### ファイルインベントリの仕組み
エンドポイントでファイルインベントリが有効になると、エージェントはファイルシステムをスキャンし、実行可能ファイル (パス、メタデータ、バージョン情報) をカタログ化します。そのデータはKeeperへアップロードされ、ポリシービルダーで利用できる**Applicationsコレクション**に反映されます。
Applicationsコレクションには、ワイルドカードや一般的なパス変数 (例: {system32}、{programFiles}) があらかじめ登録されています。ファイルインベントリは、実際のエンドポイントから得た解決済みデータでこのコレクションを充実させます。
{% hint style="info" icon="lightbulb-exclamation-on" %}
**重要:** 特定バージョンのアプリケーションを対象とするポリシーを作成する場合、そのバージョンがファイルインベントリの対象に含まれる少なくとも1台のマシンにインストールされている必要があり、Applicationsコレクションに表示されるまで待つ必要があります。
{% endhint %}
### ファイルインベントリがデフォルトで無効な理由
ファイルインベントリは、以下の2つの理由により**デフォルトで無効**です。
1. **パスのばらつき:** ファイルパスはマシンごとに異なります。EPMのポリシーエンジンは、フリート全体でポリシーが機能するよう、パス変数とワイルドカードを使うよう設計されています。ベースラインのビルドイメージと変数マッピングを定義する前にフルファイルインベントリを有効にすると、ポリシーに適さないパスが大量に登録される可能性があります。
2. **リソースコスト:** フルファイルシステムスキャンはリソースを大量に消費する操作です。大規模環境では特に、すべてのエンドポイントでデフォルト実行すると不要な負荷が生じます。管理者は意図的かつ選択的に有効化すべきです。
### ファイルインベントリの有効化
ファイルインベントリはkeeperInventoryFullプラグイン設定で制御されます。有効にするには、そのプラグイン構成で `enabled` を `true` に設定するSettingsUpdateポリシーを適用する必要があります。
#### 手順1: SettingsUpdateポリシーの作成
以下のJSONを出発点として使用します。Keeperダッシュボードの新しいSettingsUpdateポリシーにコピーし、`"enabled": false` を `"enabled": true` に変更します。
```json
{
"id": "KeeperFullInventory",
"name": "Full File Inventory Job",
"description": "Collects full file system inventory with incremental storage and diff generation.",
"version": "1.1.0",
"pluginType": "Executable",
"supportedPlatforms": ["Windows", "Linux", "macOS"],
"dependencies": [],
"requiredPermissions": ["MQTTSubscribe", "MQTTPublish"],
"debugExecutablePath": "../../../../../Jobs/InventoryFull/bin/Debug/net8.0/KeeperInventoryFull.exe",
"executablePath": "../Jobs/bin/InventoryFull/KeeperInventoryFull.exe",
"Subscription": {
"Topic": "KeeperFullInventory",
"Qos": 2,
"CleanSession": true
},
"metadata": {
"category": "Inventory",
"mqttRole": ["subscriber", "publisher"],
"mqttTopics": {
"publish": ["KeeperApi", "KeeperLogger"],
"subscribe": ["KeeperFullInventory"]
}
},
"enabled": true,
"startupPriority": 0,
"autoStart": false,
"executionContext": "Service",
"requiresMonitoring": false,
"modifiedAt": "2026-01-29T23:22:04Z"
}
```
{% hint style="info" icon="pencil-line" %}
**注:** `modifiedAt` タイムスタンプの更新は不要です。内部のバージョン追跡に使用され、ポリシー評価には影響しません。
{% endhint %}
#### 手順2: ポリシーをコレクションに割り当て
インベントリを収集したいマシンコレクションにポリシーを割り当てます。ポリシーがそれらのエンドポイントに同期されると、エージェントは file-inventory.json で定義されたスケジュール (以下参照) に従ってファイルインベントリデータの収集を開始します。
### ファイルインベントリジョブ (file-inventory.json)
インベントリスケジュールは FileInventory ジョブで制御されます。デフォルトでは、このジョブは以下のスケジュールで動作します。
* **エージェント起動時**に1回実行
* 定期スケジュールで**5日ごと** (7,200分) に再実行
環境に合わせてこのジョブを変更できます。例えば、リソースへの影響を減らすために間隔を延長する、起動時トリガーを無効にしてスケジュール実行のみにする、など。
```json
{
"id": "68112CE4-A2A8-4243-83C9-90BF8D2188A0",
"name": "FileInventory",
"description": "Run file inventory",
"enabled": false,
"asUser": false,
"priority": 0,
"schedule": {
"intervalMinutes": 7200
},
"events": [
{
"eventType": "Startup"
}
],
"tasks": [
{
"id": "run-file-inventory",
"name": "Run File Inventory",
"command": "KeeperInventoryFull",
"debugExecutablePath": "../../../../Jobs/InventoryFull/bin/Debug/net8.0/KeeperInventoryFull",
"executablePath": "Jobs/bin/InventoryFull/KeeperInventoryFull.exe",
"arguments": "",
"expectedExitCode": 0,
"scriptType": "Auto"
}
],
"mqttTopics": {
"allowedPublications": ["KeeperLogger", "KeeperApi"],
"allowedSubscriptions": []
},
"osFilter": {
"windows": true,
"linux": true,
"macOS": true
}
}
```
{% hint style="info" icon="comment-question" %}
**ヒント:** ジョブJSONの `enabled` フィールドは、ジョブがアクティブかどうかを制御します。これは keeperInventoryFull プラグイン設定とは別です。インベントリ収集を実行するには、両方を `true` に設定する必要があります。
{% endhint %}
### プラットフォーム対応
ファイルインベントリ収集は3プラットフォームすべてで利用できます。
| プラットフォーム | 対応 |
| -------- | --- |
| Windows | ✅ 可 |
| macOS | ✅ 可 |
| Linux | ✅ 可 |
### リソース上の考慮事項
ファイルインベントリは**リソースを大量に消費する**操作です。フルスキャンはシステム上のすべてのファイルパスを読み取り、結果をKeeperへアップロードします。スキャン中は、エージェントの通常の定常状態と比べてCPUおよびメモリ使用量が上昇します。
**推奨事項**
* **選択的にインベントリを有効化:** ファイルインベントリは参照用コンピューター、ゴールデンイメージマシン、または専用テストエンドポイントに限定してください。大規模フリートのすべてのワークステーションで実行する必要はほとんどなく、大きなオーバーヘッドが生じます。
* **参照マシンを使用:** OSごと、部門ごと、ロールごとに1台など、標準ビルドを代表するマシンを選びます。それらのマシンからのインベントリで、ユーザーが実際に使用するアプリケーションをカバーできます。
* **必要な場合のみスコープを拡大:** 特定のアプリケーションバージョンがApplicationsコレクションにない場合、そのバージョンがインストールされているマシンを対象インベントリコレクションに追加し、インベントリを収集した後、スコープから外します。
* **スケジュールを調整:** デフォルトの5日間隔は妥当な基準です。安定した環境では、週次または月次に延長できる場合があります。
{% hint style="info" icon="down-to-dotted-line" %}
**要点:** ファイルインベントリはネットワークスキャンと同様に、正確に、スケジュールを組み、実際に必要な範囲に限定して扱ってください。常にすべての場所で実行する必要はありません。
{% endhint %}
### インベントリ実行後の動作
エンドポイントでファイルインベントリが完了すると、以下の処理が行われます。
1. 収集したファイルデータはエージェントの統合ストレージにローカル保存されます。
2. MQTT経由でKeeperApiトピックへ通知が公開されます。
3. KeeperAPIがインベントリデータをKeeperクラウドバックエンドへアップロードします。
4. Keeperダッシュボードの**Applicationsコレクション**が、検出された実行可能ファイルで更新されます。
5. 特定のファイルパス、ハッシュ、バージョンを参照するポリシーが、それらのエントリを正確に対象にできるようになります。
### ポリシーでのインベントリデータの利用
ファイルインベントリで充実したApplicationsコレクションは、きめ細かいポリシーターゲティングの基盤です。可能になる操作の例は以下のとおりです。
* **特定バージョンのアプリケーションを拒否:** 例: powershell.exe バージョン 5.1.17763.x をブロックし、7.x を許可
* **既知の正常なインストーラーの昇格を許可:** ファイル名だけでなく、正確なファイルハッシュで対象指定
* **「Living off the land」バイナリの検出と制御:** インベントリにより、エンドポイント上に存在するネイティブOSツール (例: wmic、certutil、mshta) が明らかになり、正確なコマンドラインまたはファイルアクセスポリシーが可能になります
{% hint style="info" %}
**関連ポリシー:** [タイプ](/keeperpam/jp/endpoint-privilege-manager/policies/policy-types.md)、[例](/keeperpam/jp/endpoint-privilege-manager/policies/policy-examples.md)、[パス変数](/keeperpam/jp/endpoint-privilege-manager/policies/path-variables.md)、[ワイルドカード](/keeperpam/jp/endpoint-privilege-manager/policies/wildcards.md)
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.keeper.io/keeperpam/jp/endpoint-privilege-manager/user-guides/enable-file-inventory.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.