> 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/commander-cli/admin-rest-api/risk-management.md).

# リスク管理

## はじめに <a href="#description" id="description"></a>

リスク管理エンドポイントは、Keeper[リスク管理ダッシュボード](/enterprise-guide/jp/risk-management-dashboard.md)で収集された、セキュリティ態勢の指標、コンプライアンスのベンチマーク、組織全体のKPI (主要業績指標) に、プログラムからアクセスするためのエンドポイントです。

リスク管理ダッシュボードでは、Keeperエンタープライズ環境全体における主要な利用状況指標を把握できます。具体的には、ユーザーのオンボーディング状況、ボルトの利用状況、2要素認証 (2FA) の導入状況、Keeperセキュリティベンチマークへの準拠状況などが含まれます。リスク管理エンドポイントは、これらのデータをREST形式のインターフェースを通じて提供し、CSPM (クラウドセキュリティ態勢管理) との連携や、プログラムによるセキュリティ態勢の評価を可能にします。

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

管理者向けREST APIのリスク管理エンドポイントは、Keeperエンタープライズ環境における包括的なセキュリティ態勢データを提供します。この機能は、次のような重要なセキュリティ、コンプライアンス、運用上の用途を支援します。

### セキュリティ態勢の監視 <a href="#security-posture-monitoring" id="security-posture-monitoring"></a>

ユーザー展開状況、ボルトの利用状況、2要素認証 (2FA) の導入率などの指標をリアルタイムで取得できます。全ユーザーを対象に組織全体のセキュリティ状況を把握し、認証情報保護の不足箇所を特定できます。

### コンプライアンスの自動化 <a href="#compliance-automation" id="compliance-automation"></a>

Keeperセキュリティベンチマークへの準拠状況をプログラムで評価できます。SOX、ISO 27001、HIPAA、PCI-DSS、社内セキュリティポリシーに対するコンプライアンス状況を、GRC (ガバナンス・リスク・コンプライアンス) プラットフォームへ連携し、自動レポート化できます。

### 経営層向けダッシュボード <a href="#executive-dashboards" id="executive-dashboards"></a>

セキュリティ態勢の分析データやKPIをBI (ビジネスインテリジェンス) プラットフォームに連携し、経営層が可視化できる形で提供します。導入状況の進捗、ユーザー利用の傾向、セキュリティベンチマークの是正状況を時系列で追跡できます。

### CSPM連携 <a href="#cspm-integration" id="cspm-integration"></a>

Keeperのセキュリティ態勢データをCSPM (クラウドセキュリティ態勢管理) 環境に取り込みます。設定不備の検出を自動化し、認証情報管理環境全体にわたる是正対応の進捗を追跡できます。

### 要件 <a href="#prerequisites" id="prerequisites"></a>

* 有効なKeeperエンタープライズサブスクリプションが必要です。
* [レポート・アラートモジュール (ARAM)](/enterprise-guide/jp/event-reporting.md) のアドオンが有効になっている必要があります。
* レポート権限を含む管理者権限が必要です。
* 有効なAPI認証情報が必要です。

### 利用可能な主要指標 <a href="#key-metrics-available" id="key-metrics-available"></a>

本エンドポイントでは、以下のセキュリティ態勢データにアクセスできます。

| 指標カテゴリ            | 説明                                         |
| ----------------- | ------------------------------------------ |
| ユーザー展開            | 総ユーザー数、アクティブユーザー数、招待済みユーザー数、招待承認率          |
| ボルト利用状況           | レコードを作成したユーザー数、レコード作成のアクティビティ              |
| ログインアクティビティ       | 過去30日以内にログインしたユーザー数、最終ログイン日時               |
| 2要素認証 (2FA) の導入状況 | 2要素認証 (2FA) で保護されたボルトを使用しているユーザー数 (非SSO環境) |
| ライセンス利用状況         | 使用中ライセンス数、未使用ライセンス数、利用率                    |
| セキュリティベンチマーク      | 対応が必要な重要項目数、完了したベンチマーク数、無視されたベンチマーク数       |
| セキュリティアラート        | 高優先度アラートの件数、発生傾向、過去30日間の比較                 |

### エンタープライズ統計 <a href="#enterprise-statistics" id="enterprise-statistics"></a>

#### エンドポイント <a href="#enterprise-stat-endpoint" id="enterprise-stat-endpoint"></a>

```
GET /api/rest/public/security_posture/get_enterprise_stat
```

#### 目的 <a href="#enterprise-stat-purpose" id="enterprise-stat-purpose"></a>

リスク管理における直近のログイン数を取得します。

#### 認証 <a href="#enterprise-stat-authentication" id="enterprise-stat-authentication"></a>

APIトークンを `x-api-token` ヘッダで送信します。

```
x-api-token: Bearer <API_TOKEN>
```

#### ヘッダ <a href="#enterprise-stat-headers" id="enterprise-stat-headers"></a>

| ヘッダ           | 例                    |
| ------------- | -------------------- |
| `x-api-token` | `Bearer <API_TOKEN>` |

#### クエリパラメータ <a href="#enterprise-stat-query-parameters" id="enterprise-stat-query-parameters"></a>

リクエスト

```bash
curl 'https://keepersecurity.com/api/rest/public/security_posture/get_enterprise_stat' \
  --header 'x-api-token: Bearer <API_TOKEN>'
```

#### 成功時のレスポンス例 (200) <a href="#enterprise-stat-example-success-response-200" id="enterprise-stat-example-success-response-200"></a>

```json
{
  "users_has_records": 0,
  "users_logged_recent": 1
}
```

#### エラーコード <a href="#enterprise-stat-error-codes" id="enterprise-stat-error-codes"></a>

| コード | メッセージ     | 原因                      |
| --- | --------- | ----------------------- |
| 401 | 認証されていません | APIトークンが無効、または指定されていません |
| 500 | 内部サーバーエラー | サーバーで予期しないエラーが発生しました    |

***

### セキュリティ上の注意 <a href="#enterprise-stat-security-notes" id="enterprise-stat-security-notes"></a>

* APIトークンはパスワードと同様に扱い、定期的にローテーションしてください。
* 権限は、必要最小限のロールと操作に制限してください。
* 有効期限は短く設定し、`never` は特別な自動化用途に限って使用してください。
* トークンはKeeperボルトなど、安全な場所に保管してください。

***

### エンタープライズ統計の詳細 <a href="#enterprise-statistics-details" id="enterprise-statistics-details"></a>

#### エンドポイント <a href="#enterprise-stat-details-endpoint" id="enterprise-stat-details-endpoint"></a>

```
GET /api/rest/public/security_posture/get_enterprise_stat_details
```

#### 目的 <a href="#enterprise-stat-details-purpose" id="enterprise-stat-details-purpose"></a>

直近30日以内にログインしたユーザー数と、ボルト内に少なくとも1件のレコードを持つユーザー数を取得します。

#### 認証 <a href="#enterprise-stat-details-authentication" id="enterprise-stat-details-authentication"></a>

APIトークンを `x-api-token` ヘッダで送信します。

```
x-api-token: Bearer <API_TOKEN>
```

#### ヘッダ <a href="#enterprise-stat-details-headers" id="enterprise-stat-details-headers"></a>

| ヘッダ           | 例                    |
| ------------- | -------------------- |
| `x-api-token` | `Bearer <API_TOKEN>` |

#### クエリパラメータ <a href="#enterprise-stat-details-query-parameters" id="enterprise-stat-details-query-parameters"></a>

#### リクエスト <a href="#enterprise-stat-details-request" id="enterprise-stat-details-request"></a>

```bash
curl 'https://keepersecurity.com/api/rest/public/security_posture/get_enterprise_stat_details' \
  --header 'x-api-token: Bearer <API_TOKEN>'
```

#### 成功時のレスポンス例 (200) <a href="#enterprise-stat-details-example-success-response-200" id="enterprise-stat-details-example-success-response-200"></a>

```json
{
  "enterprise_stat_details": [
    {
      "last_logged_in": "2025-11-21 22:11:15",
      "has_records": false,
      "enterprise_user_id": "user@company.com"
    }
  ]
}
```

#### エラーコード <a href="#enterprise-stat-details-error-codes" id="enterprise-stat-details-error-codes"></a>

| コード | メッセージ     | 原因                      |
| --- | --------- | ----------------------- |
| 401 | 認証されていません | APIトークンが無効、または指定されていません |
| 500 | 内部サーバーエラー | サーバーで予期しないエラーが発生しました    |

***

### セキュリティ上の注意 <a href="#enterprise-stat-details-security-notes" id="enterprise-stat-details-security-notes"></a>

* APIトークンはパスワードと同様に扱い、定期的にローテーションしてください。
* 権限は、必要最小限のロールと操作に制限してください。
* 有効期限は短く設定し、`never` は特別な自動化用途に限って使用してください。
* トークンはKeeperボルトなど安全な場所に保管してください。

***

### セキュリティアラートの概要 <a href="#security-alerts-summary" id="security-alerts-summary"></a>

#### エンドポイント <a href="#security-alerts-summary-endpoint" id="security-alerts-summary-endpoint"></a>

```
GET /api/rest/public/security_posture/get_security_alerts_summary
```

#### 目的 <a href="#security-alerts-summary-purpose" id="security-alerts-summary-purpose"></a>

直近30日間に発生したイベントの概要を取得します。

#### 認証 <a href="#security-alerts-summary-authentication" id="security-alerts-summary-authentication"></a>

APIトークンを `x-api-token` ヘッダで送信します。

```
x-api-token: Bearer <API_TOKEN>
```

#### ヘッダ <a href="#security-alerts-summary-headers" id="security-alerts-summary-headers"></a>

| ヘッダ           | 例                    |
| ------------- | -------------------- |
| `x-api-token` | `Bearer <API_TOKEN>` |

#### クエリパラメータ <a href="#security-alerts-summary-query-parameters" id="security-alerts-summary-query-parameters"></a>

リクエスト

```bash
curl 'https://keepersecurity.com/api/rest/public/security_posture/get_security_alerts_summary' \
  --header 'x-api-token: Bearer <API_TOKEN>'
```

#### 成功時のレスポンス例 (200) <a href="#security-alerts-summary-example-success-response-200" id="security-alerts-summary-example-success-response-200"></a>

```json
{
  "security_alerts_summary": [
    {
      "event_occurrences": 1,
      "unique_users": 1,
      "last_users": 0,
      "event": "account_recovery_decline",
      "last_events": 0
    }
  ]
}
```

#### エラーコード <a href="#security-alerts-summary-error-codes" id="security-alerts-summary-error-codes"></a>

| コード | メッセージ     | 原因                      |
| --- | --------- | ----------------------- |
| 401 | 認証されていません | APIトークンが無効、または指定されていません |
| 500 | 内部サーバーエラー | サーバーで予期しないエラーが発生しました    |

***

### セキュリティ上の注意 <a href="#security-alerts-summary-security-notes" id="security-alerts-summary-security-notes"></a>

* APIトークンはパスワードと同様に扱い、定期的にローテーションしてください。
* 権限は、必要最小限のロールと操作に制限してください。
* 有効期限は短く設定し、`never` は特別な自動化用途に限って使用してください。
* トークンはKeeperボルトなど安全な場所に保管してください。

***

### セキュリティアラートの詳細 <a href="#security-alerts-detail" id="security-alerts-detail"></a>

#### エンドポイント <a href="#security-alerts-detail-endpoint" id="security-alerts-detail-endpoint"></a>

```
GET /api/rest/public/security_posture/get_security_alerts_detail
```

#### 目的 <a href="#security-alerts-detail-purpose" id="security-alerts-detail-purpose"></a>

直近30日間に発生した特定のイベントについて、その前の30日間との比較を含む詳細情報を取得します。

**aet** は監査イベントタイプ (ID) です。

例: `account_recovery_decline`

#### 認証 <a href="#security-alerts-detail-authentication" id="security-alerts-detail-authentication"></a>

APIトークンを `x-api-token` ヘッダで送信します。

```
x-api-token: Bearer <API_TOKEN>
```

#### クエリパラメーター <a href="#security-alerts-detail-query-parameters" id="security-alerts-detail-query-parameters"></a>

| 名前                 | 型      | 必須 | 説明                  |
| ------------------ | ------ | -- | ------------------- |
| `audit_event_type` | string | はい | 統計情報から取得した監査イベントタイプ |

以下は、指定可能な監査イベントタイプです。

```
  account_recovery
  account_recovery_decline
  added_admin_key
  alias_added
  bridge_deleted
  bw_record_high_risk
  bw_record_ignored
  change_master_password
  delete_security_key
  delete_user
  deleted_shared_folder
  email_provisioning_deleted
  enterprise_2fa_disabled_by_admin
  expire_password
  folder_add_outside_user
  lock_user
  login_failed_console
  login_failed_ip_whitelist
  login_failure
  msp_changes_mc_seats
  msp_pauses_mc
  msp_removes_mc
  node_deleted
  record_rotation_on_demand_fail
  record_rotation_scheduled_fail
  record_share_outside_user
  record_type_deleted
  role_enforcement_changed
  scim_deleted
  set_two_factor_off
  sso_deleted
  team_deleted
  two_factor_disabled_by_support
  vault_transferred
```

#### ヘッダ <a href="#security-alerts-detail-headers" id="security-alerts-detail-headers"></a>

| ヘッダー          | 例                    |
| ------------- | -------------------- |
| `x-api-token` | `Bearer <API_TOKEN>` |

#### クエリパラメーター <a href="#security-alerts-detail-query-parameters-1" id="security-alerts-detail-query-parameters-1"></a>

リクエスト

```bash
curl 'https://keepersecurity.com/api/rest/public/security_posture/get_security_alerts_detail?audit_event_type=account_recovery_decline' \
  --header 'x-api-token: Bearer <API_TOKEN>'
```

#### 成功時のレスポンス例 (200) <a href="#security-alerts-detail-example-success-response-200" id="security-alerts-detail-example-success-response-200"></a>

```json
{
  "security_alerts_summary": [
    {
      "event_occurrences": 1,
      "unique_users": 1,
      "last_users": 0,
      "event": "account_recovery_decline",
      "last_events": 0
    }
  ]
}
```

#### エラーコード <a href="#security-alerts-detail-error-codes" id="security-alerts-detail-error-codes"></a>

| コード | メッセージ                                     | 原因                                               |
| --- | ----------------------------------------- | ------------------------------------------------ |
| 400 | 必須のクエリパラメータ `audit_event_type` の値が見つかりません | `audit_event_type` が指定されていない、または内部マッピングと一致していません |
| 401 | 認証されていません                                 | APIトークンが無効、または指定されていません                          |
| 500 | 内部サーバーエラー                                 | サーバーで予期しないエラーが発生しました                             |

### セキュリティベンチマークの取得 <a href="#get-security-benchmarks" id="get-security-benchmarks"></a>

#### エンドポイント <a href="#get-security-benchmarks-endpoint" id="get-security-benchmarks-endpoint"></a>

```
GET /api/rest/public/security_posture/get_security_benchmarks
```

#### 目的 <a href="#get-security-benchmarks-purpose" id="get-security-benchmarks-purpose"></a>

呼び出し元のエンタープライズに設定されているセキュリティベンチマークの一覧を取得します。

#### 認証 <a href="#get-security-benchmarks-authentication" id="get-security-benchmarks-authentication"></a>

APIトークンを `x-api-token` ヘッダーで送信します。

```
x-api-token: Bearer <API_TOKEN>
```

#### ヘッダ <a href="#get-security-benchmarks-headers" id="get-security-benchmarks-headers"></a>

| ヘッダ           | 例                    |
| ------------- | -------------------- |
| `x-api-token` | `Bearer <API_TOKEN>` |

#### クエリパラメーター <a href="#get-security-benchmarks-query-parameters" id="get-security-benchmarks-query-parameters"></a>

リクエスト

```bash
curl 'https://keepersecurity.com/api/rest/public/security_posture/get_security_benchmarks' \
  --header 'x-api-token: Bearer <API_TOKEN>'
```

#### 成功時のレスポンス例 (200) <a href="#get-security-benchmarks-example-success-response-200" id="get-security-benchmarks-example-success-response-200"></a>

```json
{
  "security_benchmarks": [
    {
      "id": "SB_DEPLOY_ACROSS_ENTIRE_ORGANIZATION",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "last_updated": "2025-12-11 23:37:29",
      "id": "SB_PREVENT_INSTALLATION_OF_UNTRUSTED_EXTENSIONS",
      "auto_resolve": false,
      "status": "RESOLVED"
    },
    {
      "id": "SB_ENABLE_ACCOUNT_TRANSFER_POLICY",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_REDUCE_ADMINISTRATOR_PRIVILEGE",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_ENSURE_OUTSIDE_SSO_ADMINISTRATOR_EXISTS",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_LOCK_DOWN_SSO_PROVIDER",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_CREATE_AT_LEAST_TWO_KEEPER_ADMINISTRATORS",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_ENSURE_TWO_FACTOR_AUTHENTICATION_ADMIN_USERS",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_ENFORCE_STRONG_MASTER_PASSWORD",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_ENSURE_TWO_FACTOR_AUTHENTICATION_FOR_END_USERS",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_CONFIGURE_IP_ALLOWLISTING",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_CREATE_ALERTS",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_DISABLE_BROWSER_PASSWORD_MANAGERS",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_DISABLE_ACCOUNT_RECOVERY",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    },
    {
      "id": "SB_ENFORCE_LEAST_PRIVILEGE_POLICY",
      "auto_resolve": false,
      "status": "UNRESOLVED"
    }
  ]
}
```

#### エラーコード <a href="#get-security-benchmarks-error-codes" id="get-security-benchmarks-error-codes"></a>

| コード | メッセージ     | 原因                      |
| --- | --------- | ----------------------- |
| 401 | 認証されていません | APIトークンが無効、または指定されていません |
| 500 | 内部サーバーエラー | サーバーで予期しないエラーが発生しました    |

### セキュリティベンチマークの設定 <a href="#set-security-benchmarks" id="set-security-benchmarks"></a>

#### エンドポイント <a href="#set-security-benchmarks-endpoint" id="set-security-benchmarks-endpoint"></a>

```
POST /api/rest/public/security_posture/set_security_benchmarks
```

#### 目的 <a href="#set-security-benchmarks-purpose" id="set-security-benchmarks-purpose"></a>

セキュリティベンチマークの一覧を設定します。対応する監査イベントが記録されます。

#### 認証 <a href="#set-security-benchmarks-authentication" id="set-security-benchmarks-authentication"></a>

APIトークンを `x-api-token` ヘッダで送信します。

```
x-api-token: Bearer <API_TOKEN>
```

#### ヘッダ <a href="#set-security-benchmarks-headers" id="set-security-benchmarks-headers"></a>

| ヘッダ           | 例                    |
| ------------- | -------------------- |
| `x-api-token` | `Bearer <API_TOKEN>` |

#### クエリパラメータ <a href="#set-security-benchmarks-query-parameters" id="set-security-benchmarks-query-parameters"></a>

リクエスト

```bash
curl -X POST \
  -H 'x-api-token: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  'https://keepersecurity.com/api/rest/public/security_posture/set_security_benchmarks' \
  -d '[{"benchmark": "SB_PREVENT_INSTALLATION_OF_UNTRUSTED_EXTENSIONS", "status": "RESOLVED"}]'
```

#### 成功時のレスポンス例 (200) <a href="#set-security-benchmarks-example-success-response-200" id="set-security-benchmarks-example-success-response-200"></a>

```json
{
  "security_benchmarks": [
    {
      "id": "SB_PREVENT_INSTALLATION_OF_UNTRUSTED_EXTENSIONS",
      "auto_resolve": false,
      "status": "RESOLVED"
    }
  ]
}
```

#### エラーコード <a href="#set-security-benchmarks-error-codes" id="set-security-benchmarks-error-codes"></a>

| コード | メッセージ     | 原因                      |
| --- | --------- | ----------------------- |
| 401 | 認証されていません | APIトークンが無効、または指定されていません |
| 500 | 内部サーバーエラー | サーバーで予期しないエラーが発生しました    |


---

# 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/commander-cli/admin-rest-api/risk-management.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.