> 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/custom-tooling/jobs-and-plugins/custom-plugin-guide/plugin-examples.md).

# プラグインの例

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

本セクションでは、Keeperエンドポイント特権マネージャーのプラグイン連携でよくあるシナリオを、すぐに使えるJSONテンプレートとしてまとめています。各サブページでは1シナリオずつ、デプロイ可能なJSONと、例の要点・利用場面を説明しています。

各テンプレートはファイル内の説明だけで意図がわかるようになっています。各ファイルの `description` フィールドは `SCENARIO:` で始まるため、ファイル全体を読まなくてもテンプレートの目的を把握できます。本番へデプロイする前に、プレースホルダのパス、ID、トピック名を実際の値に置き換えてください。

## プラグインの例 <a href="#plugin-examples-1" id="plugin-examples-1"></a>

プラグインファイルはエージェント上の `Plugins/{id}.json` に配置します。以下では、プラグイン登録と通信でよく使うパターンを取り上げます。

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="289.3333740234375">例</th><th>内容</th></tr></thead><tbody><tr><td><a href="/pages/9MndVFnACH4JSwNgOdPV">最小構成のプラグイン (Windows)</a></td><td>Windows上の最もシンプルな有効な管理プラグイン。<code>autoStart</code>、主たるMQTT <code>Subscription</code>、KeeperLoggerへの出力。Windows向けテンプレートの出発点として利用可能</td></tr><tr><td><a href="/pages/UwGVpiLHEZV0QBER3Fcy">最小構成のプラグイン (macOS)</a></td><td>同じ最小構成をmacOS向けに合わせた例。バイナリの正しいパスとプラットフォーム向けの設定</td></tr><tr><td><a href="/pages/A5iLIuAUfdJuj6FCJnsv">最小構成のプラグイン (Linux)</a></td><td>同じ最小構成をLinux向けに合わせた例。バイナリの正しいパスとプラットフォーム向けの設定</td></tr><tr><td><a href="/pages/tCd3lrh6pf46QlYQtUgN">MQTT経由のコマンド/レスポンス付きプラグイン</a></td><td>コマンド/レスポンスのトピックパターン (<code>Commands/+</code>、<code>Responses/+</code>、<code>Status</code>) の例。MQTTで指示を受け取り応答するケース向け</td></tr><tr><td><a href="/pages/qrVAsZOAHs3kNYvspR8q">手動起動のプラグイン</a></td><td><code>autoStart: false</code> を指定した登録。エージェント起動時の自動起動なし。オンデマンドまたは条件付き起動向け</td></tr></tbody></table>

## 始める前に <a href="#before-you-begin" id="before-you-begin"></a>

* いずれの例をデプロイする前に、[カスタムプラグインガイド](/keeperpam/jp/endpoint-privilege-manager/custom-tooling/jobs-and-plugins/custom-plugin-guide.md)をご参照ください。バイナリの配置、署名要件、MQTTトピックの権限モデルを把握したうえでデプロイしてください。
* より多くのフィールドが記入されたWindows向けジョブのサンプルが必要な場合は、親のカスタムツールバンドル内の `secrets-scanner-sample-job.json` をご参照ください。
* エンドポイントへ配布する前に、ジョブJSONは `POST /api/Jobs/validate` で検証できます。


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.keeper.io/keeperpam/jp/endpoint-privilege-manager/custom-tooling/jobs-and-plugins/custom-plugin-guide/plugin-examples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.