# リスク管理

## はじめに <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 (クラウドセキュリティ態勢管理) 環境に取り込みます。設定不備の検出を自動化し、認証情報管理環境全体にわたる是正対応の進捗を追跡できます。

{% hint style="info" %}
**Wiz、Tenable、Saviyntなどのセキュリティポスチャ管理ツール向けのネイティブコネクターは近日提供予定です。**

現時点では、管理者はAWS CloudTrailやCloudWatchなどのミドルウェアを使用して、KeeperからWizへデータを中継できます。詳細については、[AWSのドキュメント](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/monitor-cloudtrail-log-files-with-cloudwatch-logs.html)をご参照ください。
{% endhint %}

## 要件 <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日間の比較                 |

## リスク管理API <a href="#configuration" id="configuration"></a>

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

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

```
GET /api/rest/rmd/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://local.keepersecurity.com/api/rest/rmd/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-stat-details" id="enterprise-stat-details"></a>

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

```
GET /api/rest/rmd/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://local.keepersecurity.com/api/rest/rmd/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": "rvasilyev+1@keepersecurity.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/rmd/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://local.keepersecurity.com/api/rest/rmd/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/rmd/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 | はい | 統計情報から取得した監査イベントタイプ |

#### ヘッダ <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://local.keepersecurity.com/api/rest/rmd/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="#security-alerts-detail-security-notes" id="security-alerts-detail-security-notes"></a>

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

***

### セキュリティベンチマークの取得 <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/rmd/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://local.keepersecurity.com/api/rest/rmd/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="#get-security-benchmarks-security-notes" id="get-security-benchmarks-security-notes"></a>

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

***

### セキュリティ指標の設定 <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/rmd/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://local.keepersecurity.com/api/rest/rmd/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 | 内部サーバーエラー | サーバーで予期しないエラーが発生しました    |

***

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

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


---

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