# コレクション

## コレクションの概要 <a href="#collections-overview" id="collections-overview"></a>

エージェントがエンドポイントに展開されると、検出が開始されます。検出の過程で、リソースコレクションが自動的に構築されます。コレクションは以下のタイプに分類されます。

* アプリケーション
* マシン
* ユーザー
* オペレーティングシステム

コレクションは、ユーザー、マシン、アプリケーション、ディレクトリまでを対象に、適用範囲を柔軟に設定できます。高度なフィルターとパス解決により、管理者は組織の構成や運用に合わせてコレクションを定義でき、ポリシーを広く適用する場合から対象を絞って適用する場合までカバーできます。

<figure><img src="/files/2ULlpyD0qcdjI8gVro6l" alt=""><figcaption><p>コレクション</p></figcaption></figure>

## カスタムコレクション <a href="#custom-collections" id="custom-collections"></a>

管理者は、**アプリケーション**、**マシン**、**ユーザー**の各タイプで独自のカスタムコレクションを作成することも可能です。

## コレクションの作成 <a href="#creating-a-collection" id="creating-a-collection"></a>

**\[新しいコレクション]** をクリックすると、新しいコレクションを作成し、属性を割り当てることができます。以下のようなコレクションを作成できます。

* Developers: ソフトウェアエンジニアを含むユーザーコレクション
* Web Servers: ウェブサーバーのみを含むマシンコレクション
* Developer Tools: GitHub.exeやVisual Studio Codeなどを含むアプリケーションコレクション

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FocLb9wVE57JlqaB1LAiG%2FScreenshot%202025-05-23%20at%2010.12.38%E2%80%AFAM.png?alt=media&#x26;token=d85de7fd-e8d5-48e2-b81c-75a3c3981ad2" alt=""><figcaption><p>新しいコレクションの作成</p></figcaption></figure>

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FuqKqVbY2FgzxQMmtareU%2FEdit%20Collection.png?alt=media&#x26;token=b74bbc60-8fd6-4edd-9593-6c6a65bcccae" alt=""><figcaption><p>カスタムコレクション</p></figcaption></figure>

新規にプロビジョニングされた環境には、初期構成を早めるベースラインとして、ワイルドカード指定のアプリケーションエントリがあらかじめ含まれることがあります。一般的なユーザーおよびシステムのパスをすぐにコレクションの対象に含められるため、オンボーディングですべてのディレクトリ構造を手入力しなくても、管理者はポリシーの適用先を調整できます。

{% hint style="info" %}
コレクションに別種類のリソースを混在させることはできません。たとえば、ユーザーグループのコレクションにマシンリソースは含められません。
{% endhint %}

## アプリケーションコレクション <a href="#application-collections" id="application-collections"></a>

アプリケーションコレクションは、エンドポイント群で検出されたすべての実行ファイルを表します。アプリケーションは任意のカスタムコレクションにまとめることができます。

各アプリケーションオブジェクトには以下の情報が含まれます。

* プロダクト名
* プロダクトバージョン
* ファイルバージョン
* ファイルハッシュ
* 発行元証明書

<figure><img src="/files/Tp2EH92htF56LfyHellY" alt=""><figcaption></figcaption></figure>

### カスタムアプリケーションリソース <a href="#custom-application-resources" id="custom-application-resources"></a>

特定の実行ファイルなど、管理者が定義するカスタムアプリケーションリソースも追加可能です。**\[アイテムをコレクションに追加]** をクリックし、**\[リソースを手動で定義する]** を選んで情報を入力します。

<figure><img src="/files/wAV91ektrQJ9bY8y3CCS" alt=""><figcaption><p>カスタムアプリケーションリソース</p></figcaption></figure>

### ワイルドカードとパス変数 <a href="#wildcard--path-variables" id="wildcard--path-variables"></a>

ワイルドカードのパス変数を使うと、ユーザー環境やシステム環境に合わせたポリシー適用範囲の指定がしやすくなります。パス変数を使えば、ユーザーごと／コンピューターごとにディレクトリが動的に解決されるアプリケーションコレクションを定義でき、エンドポイントごとに別エントリを用意する手間を減らせます。

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FT7eYPsvvkJ369eZhzZC2%2Fimage.png?alt=media&#x26;token=a090d8c7-9119-41d7-a3b5-b9839e54a2b1" alt=""><figcaption></figcaption></figure>

使用できるパス変数は以下のとおりです。

* `{desktop}` – 現在のユーザーのデスクトップ
* `{usr}` – ユーザーのホームディレクトリ
* `{system32}` – WindowsのSystem32ディレクトリ

各変数は、評価時に対応するディレクトリへ解決されます。これらの変数を使うと、エンドポイント構成が異なっていてもアプリケーションコレクションを効率よく扱え、適用の挙動も揃えやすくなります。

```
// Wildcard Examples
C:\Users\john\Desktop\*
{usr}\*\Downloads\*
{system32}\*.exe
{usr}\*\AppData\Local\Programs\MyApp\MyApp.exe
```

## マシンコレクション <a href="#machine-collections" id="machine-collections"></a>

マシンコレクションは、エンドポイントのOS情報を表し、以下の属性が含まれます。

* マシン名または識別子
* OSの種類
* OSのバージョン

マシンはエージェントによる検出プロセスを通じて、自動的に集約・分類されます。

{% hint style="info" %}
デプロイメントコレクションも、「マシン」コレクション配下の利用できるサブコレクションとして自動的に追加されます。
{% endhint %}

<figure><img src="/files/jg2z2K656IjPPKtW6bPu" alt=""><figcaption><p>マシンとデプロイメントのコレクション</p></figcaption></figure>

<figure><img src="/files/WGPv6Xm4XPGm5a0mHz2Q" alt=""><figcaption><p>個々のマシンリソース</p></figcaption></figure>

## オペレーティングシステムコレクション <a href="#operating-system-collections" id="operating-system-collections"></a>

OSリソースはエージェントにより自動検出され、ポリシー適用の対象コレクションとして利用できます。含まれる属性は次のとおりです。

* OS名
* OSバージョン

## ユーザーコレクション <a href="#user-collections" id="user-collections"></a>

Keeperエージェントは、エンドポイント群に存在するすべてのローカルユーザーおよびグループを検出し、「ユーザー」コレクションにまとめます。「ユーザー」コレクションの中には、「ユーザーグループ」や「すべてのアカウント」などのサブコレクションが含まれており、これらは読み取り専用です。

<figure><img src="/files/vjcYhqGobVX8dcXCUZcD" alt=""><figcaption><p>ユーザーコレクション</p></figcaption></figure>

<figure><img src="/files/ptwY0bKAFxTwkQPZAA8o" alt=""><figcaption><p>ユーザーリソース</p></figcaption></figure>

<figure><img src="/files/7GHfc8HEzMqG3lQ8zFcV" alt=""><figcaption><p>ユーザーグループリソース</p></figcaption></figure>

## ポリシーの適用 <a href="#applying-policies" id="applying-policies"></a>

検出によってコレクションが揃うと、デバイスコレクションやデプロイメントコレクションにポリシーを適用できます。詳細は[ポリシー](/keeperpam/jp/endpoint-privilege-manager/policies.md)をご参照ください。

## コマンダーを使用した自動化処理 <a href="#automation-with-commander" id="automation-with-commander"></a>

Keeperコマンダーでは、コマンドラインインターフェイス、サービスモードの[REST API](/keeperpam/jp/commander-cli/service-mode-rest-api.md)やPython SDKを使ってコレクションを自動化できます。[エンドポイント特権マネージャーのコマンド](/keeperpam/jp/commander-cli/command-reference/endpoint-privilege-manager-commands.md)の詳細をご参照ください。

### コレクション <a href="#collections-1" id="collections-1"></a>

`pedm collection` コマンドでコレクションを管理します。

```
My Vault> pedm collection -h
pedm command [--options]

Command     Description
----------  ----------------------------------
list        List PEDM collections
view        Show PEDM collection details
add         Creates PEDM collection
update      Update PEDM collections
delete      Delete PEDM collections
connect     Link agent, policy, resource to PEDM collections
disconnect  Unlink agent, policy, resource from PEDM collections
```

エージェントを展開し、コレクションを設定した後は、[ポリシー](/keeperpam/jp/endpoint-privilege-manager/policies.md)の適用に進みます。


---

# Agent Instructions: 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/collections.md?ask=<question>
```

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.
