> 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/reference/local-endpoints.md).

# ローカルエンドポイント

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

**対象:** スクリプトやツールからエージェントに対して管理タスク (ヘルスチェック、プラグイン制御、ジョブ、設定など) を実行するIT管理者向けです。

### 概要 <a href="#overview" id="overview"></a>

エンドポイント特権マネージャーは**localhost**専用の**HTTP/HTTPS API** (既定ポートはHTTP 6888、HTTPS 6889) を公開します。ヘルスチェック、プラグインの開始/停止/再起動、ジョブの一覧とトリガー、設定およびプラグイン設定、登録、その他の管理操作に利用します。エンドポイントはいずれもマシン**ローカル**であり、ネットワークに公開することを想定していません。

**ベースURL:**

* **HTTP:** `http://127.0.0.1:6888`
  * `HTTP` から `HTTPS` へ自動リダイレクト
* **HTTPS:** `https://127.0.0.1:6889`
  * 通信はローカルマシン内のみで行われるため、エンドポイント特権マネージャーが証明書のライフサイクルと検証を自動で管理します。証明書はメモリ上に保持され (ディスクには書き込まない)、内部でローテーションされ、サービス起動のたびに新しい証明書が生成されます。

**認証レベル:**

* **公開:** 認証なし (ヘルス、ルート、システムステータス)
* **プラグイン:** 呼び出し元がエンドポイント特権マネージャーにより起動されたプロセスで、有効な証明書を持つこと (例: プラグイン、ジョブ)
* **昇格管理者:** 呼び出し元が管理者権限を持つ (または信頼されたシステムプロセスである) こと、および有効な証明書を持つこと

多くの管理操作は**プラグイン**または**管理者**を要します。手動で実行するスクリプトでは多くの場合**管理者**を使用します (例: 昇格したPowerShellから、またはrootとして)。証明書ベースの呼び出しでは、スクリプト用のクライアント証明書が製品から提供される場合があります。デプロイのドキュメントをご参照ください。

## 公開エンドポイント (認証なし) <a href="#public-endpoints-no-auth" id="public-endpoints-no-auth"></a>

監視および基本的な確認に使用します。

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="110.99993896484375">メソッド</th><th width="192.6666259765625">パス</th><th>説明</th></tr></thead><tbody><tr><td>GET</td><td><code>/health</code></td><td>ヘルスチェック。ステータス (例: healthy)、タイムスタンプ、バージョンを返す</td></tr><tr><td>GET</td><td><code>/</code></td><td>ルート。サービス名、ステータス、バージョン</td></tr><tr><td>GET</td><td><code>/api/system/status</code></td><td>システムステータス: 実行中、プラグイン数、ジョブ数 (合計/有効)</td></tr></tbody></table>

#### **例:**

```
curl -k https://localhost:6889/health
curl -k https://localhost:6889/
curl -k https://localhost:6889/api/system/status
```

## プラグイン管理 <a href="#plugin-management" id="plugin-management"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="99">メソッド</th><th width="262.6666259765625">パス</th><th width="82.6666259765625">認証</th><th>説明</th></tr></thead><tbody><tr><td>GET</td><td><code>/api/plugins</code></td><td>プラグイン</td><td>すべてのプラグインを一覧表示 (id、名前、ステータス、processId、lastStartTime)</td></tr><tr><td>POST</td><td><code>/api/plugins/{name}/start</code></td><td>管理者</td><td>プラグインを開始</td></tr><tr><td>POST</td><td><code>/api/plugins/{name}/stop</code></td><td>管理者</td><td>プラグインを停止</td></tr><tr><td>POST</td><td><code>/api/plugins/{name}/restart</code></td><td>管理者</td><td>プラグインを再起動</td></tr></tbody></table>

`{name}` をプラグインID (例: KeeperPolicy、KeeperAPI) に置き換えます。プラグインが固まったあとやプラグイン構成を変更したあとの復旧に使用します。

## ジョブ管理 <a href="#job-management" id="job-management"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="98.3333740234375">メソッド</th><th width="248.3333740234375">パス</th><th width="82.666748046875">認証</th><th>説明</th></tr></thead><tbody><tr><td>GET</td><td><code>/api/Jobs</code></td><td>プラグイン</td><td>登録済みジョブをすべて一覧表示 (id、名前、有効、スケジュール、最終実行)</td></tr><tr><td>GET</td><td><code>/api/Jobs/{jobId}</code></td><td>プラグイン</td><td>IDで1件のジョブを取得</td></tr><tr><td>POST</td><td><code>/api/Jobs</code></td><td>管理者</td><td>ジョブを作成 (JSONボディ)</td></tr><tr><td>PUT</td><td><code>/api/Jobs/{jobId}</code></td><td>管理者</td><td>ジョブを更新</td></tr><tr><td>DELETE</td><td><code>/api/Jobs/{jobId}</code></td><td>管理者</td><td>ジョブを削除</td></tr><tr><td>POST</td><td><code>/api/Jobs/{jobId}/run</code></td><td>管理者</td><td>ジョブを直ちに実行</td></tr><tr><td>POST</td><td><code>/api/Jobs/{jobId}/trigger</code></td><td>管理者</td><td>イベントコンテキスト付きでジョブをトリガー (JSONボディ)</td></tr><tr><td>POST</td><td><code>/api/Jobs/validate</code></td><td>管理者</td><td>ジョブJSONを検証 (POSTボディ=ジョブJSON)</td></tr></tbody></table>

オンデマンド実行には**run**または**trigger**を、ジョブの作成・更新前には**validate**を使用します。

## 設定 <a href="#settings" id="settings"></a>

### プラグイン設定 <a href="#plugin-settings" id="plugin-settings"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="101.37109375">メソッド</th><th width="307.875">パス</th><th width="86.625">認証</th><th>説明</th></tr></thead><tbody><tr><td>GET</td><td><code>/api/PluginSettings/{pluginName}</code></td><td>プラグイン</td><td>プラグインのすべての設定を取得</td></tr><tr><td>GET</td><td><code>/api/PluginSettings/{pluginName}/{settingName}</code></td><td>プラグイン</td><td>プラグイン設定を1件取得</td></tr><tr><td>PUT</td><td><code>/api/PluginSettings/{pluginName}/{settingName}</code></td><td>管理者</td><td>プラグイン設定を1件更新 (ボディ=値)</td></tr><tr><td>POST</td><td><code>/api/PluginSettings/revert-all</code></td><td>管理者</td><td>ディスク上の各JSONファイルからすべてのプラグイン設定を再インポート</td></tr><tr><td>POST</td><td><code>/api/PluginSettings/{pluginName}/revert</code></td><td>管理者</td><td>1つのプラグインの設定をそのJSONファイルから再インポート</td></tr></tbody></table>

プラグインのJSONファイルを編集したあとや、ポリシーで構成をプッシュしたあとは、メモリ上の設定をディスクと一致させるために**revert**または**revert-all**を使用します。

### Keeper登録 <a href="#keeper-registration" id="keeper-registration"></a>

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="107.69140625">メソッド</th><th>パス</th><th>認証</th><th>説明</th></tr></thead><tbody><tr><td>GET</td><td><code>/api/Keeper/registration</code></td><td>プラグイン</td><td>エージェント登録ステータスを取得 (AgentUID、IsRegistered、Hostnameなど)</td></tr><tr><td>POST</td><td><code>/api/Keeper/register</code></td><td>管理者 (一部のデプロイでは公開)</td><td>エージェントを登録。クエリパラメータ <code>token=...</code> (および任意の <code>force=true</code>)</td></tr><tr><td>POST</td><td><code>/api/Keeper/unregister</code></td><td>管理者</td><td>エージェントの登録を解除</td></tr></tbody></table>

#### **例 (登録):**

```
curl -X POST "https://localhost:6889/api/Keeper/register?token=YOUR_TOKEN" -k
```

## その他のエンドポイント群 <a href="#other-endpoint-groups" id="other-endpoint-groups"></a>

APIには次のエンドポイントも含まれます。

* **監査:** 監査イベントのGET/POST
* **通知:** 通知の送信
* **ファイルアクセス:** ファイルアクセスの要求、付与、取り消し、履歴
* **ユーザーセッション:** ユーザーセッションでのプロセス起動、起動の検証
* **一時アカウント:** 一時アカウントの起動、一覧/削除、クリーンアップ
* **コントロール:** コントロール要求、承認、承認済み要求の起動
* **認証情報:** リスク評価用認証情報の保存/取得/削除
* **パス変数:** カスタムパス変数の作成/更新/削除 (有効な場合)

正確なパスおよびリクエスト/レスポンスの形は製品のAPIに従います。上記の表は最も一般的な**管理**タスクをまとめたものです。スクリプトでは**HTTPS**を使用し、**403** (認証) および**404** (見つからない) を扱い、必要に応じて管理者または適切な証明書を使用します。


---

# 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/reference/local-endpoints.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.