ジョブの例

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

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

ジョブの例

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

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

始める前に

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