---
title: "Key Management Serviceの概要"
slug: "security-kms"
tags: ["API Gateway", "Key Management Service", "overview", "Sub Account"]
updated: 2026-09-17T09:58:23Z
published: 2026-09-17T09:58:23Z
canonical: "api.ncloud-docs.com/security-kms"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Key Management Serviceの概要

Classic/VPC環境で利用できます。

Key Management Serviceは、暗号化の運用と具現化において必須要素の暗号キー管理機能を提供する NAVERクラウドプラットフォームのサービスです。Key Management Serviceは、暗号化と復号化をはじめとするいろいろなキー管理機能関連の APIを RESTful形式で提供します。

参考

2025年6月19日、リージョン隔離キー機能が API 2.0に追加されます。詳細は、[**Key Management Serviceの概念 > キー隔離**](https://guide.ncloud-docs.com/docs/ja/kms-info#%ED%82%A4%EA%B2%A9%EB%A6%AC)をご参照ください。

- 機能追加前に作成されて運用中のすべてのキーは自動的に全域(Global)キーに切り替わり、利用中の APIに変更はありません。

|  | Key Management Service API 1.0 | Key Management Service API 2.0 |
| --- | --- | --- |
| Base URL(ドメイン) | https://kms.apigw.ntruss.com | - 全域(GLOBAL): https://ocapi.ncloud.com - 隔離: 韓国(KR): https://ocapi-kr.ncloud.com - 隔離: 日本(JP): https://ocapi-jp.ncloud.com |
| APIの種類 | 暗号化、復号化 APIを6種類のみ提供 - Encrypt、Decrypt、Create Custom Key、Re-encrypt、Sign、Verify | - 暗号化、復号化 APIを6種類提供 - Encrypt、Decrypt、Create Custom Key、Re-encrypt、Sign、Verify - コンソールから提供されるキー管理機能をすべて提供 |
| 認証方式 | NAVERクラウドプラットフォームアカウント情報を利用したユーザー認証 | - アカウント認証 API: NAVERクラウドプラットフォームアカウント情報を利用したユーザー認証 - トーク認証 API: キー認証トークン |
| リクエスト処理性能 | Encrypt API (AES)基準でシステム最大200TPS - すべてのキーが200TPS処理性能を共有 | Encrypt API (AES)基準でキー別に最大300TPS - すべてのキーに対しそれぞれ最大300TPSの処理性能を個別に保証 |
| 可用性を保証 | リージョン限定高可用性(HA) - NAVERクラウドプラットフォームのリージョン障害時、暗号化、復号化、署名、検証などの APIに影響がある | リージョン限定またはクロスリージョン高可用性(HA) - 全域キー: クロスリージョン多重同期により、NAVERクラウドプラットフォームのリージョン障害により影響されず、暗号化、復号化、署名、検証などの APIの無停止動作を保証 - リージョン隔離キー: 地域外への持ち出し制限のため、地域内の冗長性をサポート |
| リクエストアクセス制御 | Sub Accountサービスが提供するサブアカウント単位の IP ACL機能を利用 | - Sub Accountサービスが提供するサブアカウント単位の IP ACL機能 - トークン単位で設定可能な IP ACL |

## Key Management Service API 1.0の共通設定

Key Management Service API 1.0で共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://kms.apigw.ntruss.com
```

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

- API Gateway request signature v1方式のリクエスト

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix timestamp形式 |
| `x-ncp-apigw-api-key` | Required | NAVERクラウドプラットフォームの API Gatewayサービスから発行された キー |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |
- API Gateway request signature v2方式のリクエスト

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix timestamp形式 |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | - | `success` | 成功 |

参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

#### エラー構文

リクエスト処理結果エラー構文の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `error` | Object | - | エラー情報 |
| `error.errorCode` | String | - | エラーコード |
| `error.message` | String | - | エラーメッセージ |
| `error.details` | String | - | エラーの詳細情報 |

```
{
"error": {
"errorCode": "300",
"message": "Not Found Exception",
"details": "URL not found."
}
}
```

状態コードが`200 OK`の場合でも、結果として失敗したエラー構文の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `code` | String | - | エラーコード |
| `msg` | String | - | エラーメッセージ |
| `data` | Object | - | レスポンス結果 - `null`と表示 |

- <例> 有効でないリクエストデータを入力

```
{
"code": "NOT_VALID_INPUT",
"msg": "Fail: not valid input",
"data": null
}
```

## Key Management Service API 2.0の共通設定

Key Management Service API 2.0で共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://ocapi.ncloud.com
```

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

- アカウント認証(Account Auth)方式のリクエスト

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix timestamp形式 |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |
- トークン認証(Token Auth)方式のリクエスト

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-ocapi-token` | Required | Key Management Serviceで生成したキーのアクセストークン(Access Token)またはリフレッシュトークン(Refresh Token) - JWT(JSON Web Token)タイプのトークン - トークンの生成: [Create Token Set](/docs/ja/security-kms2-token-set)を参照 - 使用 API - アクセストークン: [Encrypt](/docs/ja/security-kms2-token-encrypt)、[Decrypt](/docs/ja/security-kms2-token-decrypt)、[Create Custom Key](/docs/ja/security-kms2-token-custom-key)、[Re-encrypt](/docs/ja/security-kms2-token-reencrypt)、[Sign](/docs/ja/security-kms2-token-sign)、[Verify](/docs/ja/security-kms2-token-verify)、[Get Public Key](/docs/ja/security-kms2-token-public-key) - リフレッシュトーク: [Create Access Token](/docs/ja/security-kms2-token-access-token)、[Renew Token Set](/docs/ja/security-kms2-token-renew) |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | - | - | 正常 |
| 400 | 100 | `Bad Request` | リクエストエラー |
| 401 | - | `Authentication Failed` | 認証エラー |
| 401 | - | `Permission Denied` | 権限エラー |
| 403 | - | `Forbidden` | キーリソースにアクセス不可 |
| 404 | 300 | `Not Found` | キーリソースが存在しない |
| 429 | - | `Rate Limited` | リクエストの割り当て量超過 |
| 500 | - | `Unexpected Error` | - `FAIL_SERVER_INTERNAL`: KMSシステムエラー - `FAIL_IAM_REQUEST`: アカウントまたは権限システムエラー - `FAIL_CLA_REQUEST`: CLAシステムエラー - `FAIL_BLOC_REQUEST`: 会員または契約照会システムエラー |

#### エラー構文

リクエスト処理結果エラー構文の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `error` | Object | - | エラー情報 |
| `error.errorCode` | String | - | エラーコード |
| `error.message` | String | - | エラーメッセージ |
| `error.details` | String | - | エラーの詳細情報 |

```
{
"error": {
"errorCode": "300",
"message": "Not Found",
"details": "null"
}
}
```

## Key Management Service API

Key Management Service APIサービスで提供する APIの説明は次の通りです。

### Key Management Service API 1.0

Key Management Service API 1.0関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [Encrypt](/docs/ja/security-kms-encrypt) | キーの現在のバージョンでデータを暗号化 |
| [Decrypt](/docs/ja/security-kms-decrypt) | キーで暗号文を復号化 |
| [Create Custom Key](/docs/ja/security-kms-createusercustomkey) | 暗号キーとして使用する任意の生キー(raw key)を作成 |
| [Re-encrypt](/docs/ja/security-kms-reencrypt) | 暗号文を指定されたマスターキーの最新バージョンで再暗号化 |
| [Sign](/docs/ja/security-kms-sign) | データの署名を作成 |
| [Verify](/docs/ja/security-kms-verify) | データの署名と照合して検証結果を返す |

### Key Management Service API 2.0

Key Management Service API 2.0関連 APIの説明は次の通りです。

#### Account Auth API

Account Auth API関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [Create Key](/docs/ja/security-kms2-create-key) | キーを作成 |
| [Get Key Info](/docs/ja/security-kms2-key-info) | キーの詳細情報を照会 |
| [Get Key List](/docs/ja/security-kms2-key-list) | キーリストを照会 |
| [Get Public Key](/docs/ja/security-kms2-public-key) | 公開鍵を照会 |
| [Delete Key](/docs/ja/security-kms2-delete-key) | キーを削除 |
| [Enable Key](/docs/ja/security-kms2-enable-key) | キーを有効化 |
| [Disable Key](/docs/ja/security-kms2-disable-key) | キーを無効化 |
| [Enable Key Version](/docs/ja/security-kms2-enable-key-version) | キーのバージョンを有効化 |
| [Disable Key Version](/docs/ja/security-kms2-disable-key-version) | キーのバージョンを無効化 |
| [Rotate Key](/docs/ja/security-kms2-rotate-key) | キーをローテーションして新しいバージョンを作成 |
| [Request Key Deletion](/docs/ja/security-kms2-request-key-deletion) | キーの削除をリクエスト |
| [Cancel Key Deletion](/docs/ja/security-kms2-cancel-key-deletion) | キー削除リクエストをキャンセル |
| [Enable IP ACL](/docs/ja/security-kms2-enable-ip-acl) | トークンリクエストを許可する IPアドレスを制御する IP ACL機能を有効化 |
| [Disable IP ACL](/docs/ja/security-kms2-disable-ip-acl) | トークンリクエストを許可する IPアドレスを制御する IP ACL機能を無効化 |
| [Get ACL Rule List](/docs/ja/security-kms2-acl-list) | キーの IP ACL設定情報を照会 |
| [Add ACL Rule](/docs/ja/security-kms2-add-acl) | トークンリクエスト許可対象の IPアドレスを ACLに追加 |
| [Delete ACL Rule](/docs/ja/security-kms2-delete-acl) | トークンリクエストを許可した IPアドレスを ACLから削除 |
| [Create Token Generator](/docs/ja/security-kms2-create-token-gen) | トークンジェネレータを有効化 |
| [Get Token Generator](/docs/ja/security-kms2-get-token-gen) | トークンジェネレータを照会 |
| [Update Token Generator](/docs/ja/security-kms2-update-token-gen) | トークンジェネレータを交換 |
| [Delete Token Generator](/docs/ja/security-kms2-token-encrypt) | トークンジェネレータを削除(無効化時) |
| [Create Token Set](/docs/ja/security-kms2-token-set) | トークンセット(アクセストークンとリフレッシュトークン)を生成 |
| [Get Key Activity Logs](/docs/ja/security-kms2-key-activity-logs) | キー使用履歴リストを照会 |
| [Get Latest Use Info](/docs/ja/security-kms2-latest-use-info) | 直近のキー使用履歴を照会 |
| [Get Key Version List](/docs/ja/security-kms2-key-version-list) | キーのバージョンリストを照会 |
| [Update Memo](/docs/ja/security-kms2-update-memo) | キーに関するメモを更新 |
| [Update Rotation Period](/docs/ja/security-kms2-rotation-period) | キーの自動ローテーション周期を更新 |
| [Enable Auto Rotation](/docs/ja/security-kms2-enable-auto-rotation) | キーを自動ローテーションを有効化 |
| [Disable Auto Rotation](/docs/ja/security-kms2-disable-auto-rotation) | キーを自動ローテーションを無効化 |
| [Encrypt](/docs/ja/security-kms2-encrypt) | キーの現在のバージョンでデータを暗号化 |
| [Decrypt](/docs/ja/security-kms2-decrypt) | キーで暗号文を復号化 |
| [Create Custom Key](/docs/ja/security-kms2-custom-key) | 暗号キーとして使用する任意の生キー(raw key)を作成 |
| [Re-encrypt](/docs/ja/security-kms2-reencrypt) | 暗号文を指定されたマスターキーの最新バージョンで再暗号化 |
| [Sign](/docs/ja/security-kms2-sign) | データの署名を作成 |
| [Verify](/docs/ja/security-kms2-verify) | データの署名と照合して検証結果を返す |

#### Token Auth API

Token Auth API関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [Encrypt](/docs/ja/security-kms2-token-encrypt) | キーの現在のバージョンでデータを暗号化 |
| [Decrypt](/docs/ja/security-kms2-token-decrypt) | キーで暗号文を復号化 |
| [Create Custom Key](/docs/ja/security-kms2-token-custom-key) | 暗号キーとして使用する任意の生キー(raw key)を作成 |
| [Re-encrypt](/docs/ja/security-kms2-token-reencrypt) | 暗号文を指定されたマスターキーの最新バージョンで再暗号化 |
| [Sign](/docs/ja/security-kms2-token-sign) | データの署名を作成 |
| [Verify](/docs/ja/security-kms2-token-verify) | データの署名と照合して検証結果を返す |
| [Get Public Key](/docs/ja/security-kms2-token-public-key) | 公開鍵を照会 |
| [Create Access Token](/docs/ja/security-kms2-token-access-token) | アクセストークンを生成 |
| [Renew Token Set](/docs/ja/security-kms2-token-renew) | トークンセット(アクセストークンとリフレッシュトークン)を再生成 |

## Key Management Service関連リソース

Key Management Service APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Key Management Service APIの使用方法
- [署名(シグネチャー)の作成](/docs/ja/common-ncpapi): リクエストヘッダに追加する署名の作成方法
- [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに追加する API Keyを発行
- [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
- [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Key Management Serviceで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Key Management Serviceサービスの使用方法
- [Key Management Serviceご利用ガイド](https://guide.ncloud-docs.com/docs/ja/kms-overview): NAVERクラウドプラットフォームコンソールで Key Management Serviceを使用する方法
- [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポート有無に関するガイド
- [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/security/kms): Key Management Serviceの料金体系、特徴、詳細機能のサマリー
- [サービスのお知らせ](https://www.ncloud.com/intro/news): Key Management Serviceに関するお知らせ
- [よくある質問](https://www.ncloud.com/support/faq/all): Key Management Serviceに関するよくあるご質問
- [カスタマーサポート](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ