# 統合のJSONテンプレート

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

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

## ジョブの例 <a href="#job-examples" id="job-examples"></a>

ジョブファイルはエージェント上の `Jobs/{id}.json` に配置します。以下では、サポート対象の各OSで一般的なトリガーとスケジュールのパターンを取り上げます。

<table><thead><tr><th width="218">例</th><th>内容</th></tr></thead><tbody><tr><td><a href="/pages/3qJlWMRubpxOi9P6Sme5">ジョブ: 最小構成 (Windows)</a></td><td>Windows上の最もシンプルな有効なジョブ。インターバルスケジュール、サービスタスクの実行、KeeperLoggerへの出力。Windows向けテンプレートの出発点として利用可能</td></tr><tr><td><a href="/pages/zjFH6Uvkrczivgaty4wg">ジョブ: 最小構成 (macOS)</a></td><td>同じ最小構成をmacOS向けに合わせた例。バイナリの正しいパスと <code>osFilter</code> の設定例</td></tr><tr><td><a href="/pages/swlJycvPqjHv0RP98oKs">ジョブ: 最小構成 (Linux)</a></td><td>同じ最小構成をLinux向けに合わせた例。バイナリの正しいパスと <code>osFilter</code> の設定例</td></tr><tr><td><a href="/pages/mHk6QDn5Nw1UGj13UGZe">スケジュールと起動時実行のジョブ</a></td><td>起動直後に1回実行したうえで、一定間隔の繰り返し実行。スキャナー型の統合で推奨されるパターン</td></tr><tr><td><a href="/pages/U9MkqzlxfBuuDXulKQQ1">イベントトピック付きジョブ</a></td><td>MQTTのカスタム <code>eventTopic</code> へ進捗をパブリッシュする例。 <code>eventTopic</code> と <code>mqttTopics.allowedPublications</code> の対応づけ</td></tr></tbody></table>

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

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

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


---

# 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/integrations/examples.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.