---
title: "Certificate Managerの概要"
slug: "security-certificatemanager"
updated: 2026-10-08T07:19:00Z
published: 2026-10-08T07:19:00Z
canonical: "api.ncloud-docs.com/security-certificatemanager"
---

> ## 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.

# Certificate Managerの概要

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

Certificate Managerは、NAVERクラウドプラットフォームの連携サービス(Load Balancer、Global edge)と外部環境で使用する SSL/TLS証明書を発行、登録、管理するサービスです。証明書の発行および管理機能は RESTful API形式で提供され、APIの呼び出しには API Gatewayの IAM認証が必要です。

|  | Certificate Manager API 1.0 | Certificate Manager API 2.0 |
| --- | --- | --- |
| Base URL(ドメイン) | https://certificatemanager.apigw.ntruss.com/api/v1 | https://certificatemanager.apigw.ntruss.com/api/v2 |
| APIの種類 | 外部証明書の登録、削除、照会の3つの機能だけ提供 - createExternalCertificate、deleteCertificate、getCertificateList | コンソールで提供されるすべての証明書管理機能を APIで同様に提供 - 証明書の申し込み、再発行、状態照会、ダウンロード、更新設定、削除など |

## Certificate Manager API共通設定

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

### リクエスト

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

#### API URL

Certificate Manager APIはバージョンごとに以下の Base URLを提供します。連携したい機能のバージョンに合わせて URLを選択してご利用ください。

```
Certificate Manager API 1.0: https://certificatemanager.apigw.ntruss.com/api/v1
Certificate Manager API 2.0: https://certificatemanager.apigw.ntruss.com/api/v2
```

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

ヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00 UTCからの経過時間(ミリ秒単位) • API Gatewayサーバと**5分以上の時間差**が発生した場合は無効なリクエストとみなす |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key • [証明書作成ガイド](/docs/ja/common-ncpapi#1-%EC%9D%B8%EC%A6%9D%ED%82%A4-%EC%83%9D%EC%84%B1)を参照 • サブアカウントの利用時、[サブアカウント作成ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-use)を参照 |
| `x-ncp-apigw-signature-v2` | Required | Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)を使用して作成した署名(Base64エンコード) • [シグネチャー作成ガイド](/docs/ja/common-ncpapi#2-%ED%97%A4%EB%8D%94-%EC%83%9D%EC%84%B1)を参照 |
| `Content-Type` | Required | リクエストデータの形式 - `application/json` |
| `Accept` | Required | レスポンスデータの形式 • `application/json` |

### レスポンス

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

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

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

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | 1002 | Unable to load certificate. Expecting PEM format file. | 無効な PEM形式 |
| 200, 400 | 1000 | Error | リクエスト処理失敗 必須値の欠落など、リクエストが無効な場合に返す |
| 200 | 1006 | No certificate exists. | 対象証明書なし |
| 200 | 2101 | Invalid parameter : ... | 無効なパラメータ値または組み合わせ |
| 200 | 1004 | Failed to delete the certificate. Delete the instance being used first or replace the certificate being used for the instance. | 証明書削除失敗(インスタンスで使用中) |
| 200 | 1004 | Failed to delete the certificate. No certificate was found with a matching with requested certificate name and certificate number. | 証明書削除失敗(名前、番号の不一致) |
| 200 | 2200 | No certificate was found. | 証明書検索結果なし |
| 200 | 26034 | The certificate is invalid. | 無効な証明書 |
| 200 | 26040 | Public key in certificate does not match with private key. | 無効な秘密鍵の整合性 |
| 400 | 100 | Bad Request Exception | リクエスト構文エラー |
| 400 | 2000 | CertificateName is invalid. certificateName can only contain 3-20 English alphabet, numbers, and "-" and must start with an alphabetic character. | 無効な証明書名 |
| 400 | 2100 | CertificateName is missing; PrivateKey is missing; PublicKeyCertificate is missing; CertificateChain is missing. | 証明書の名前、または秘密鍵、公開鍵、チェーンが見つからない |
| 401 | 200 | Authentication Failed | 認証失敗 |
| 401 | 210 | Permission Denied | アクセス権限なし |
| 404 | 300 | Not Found Exception | サーバで見つからない |
| 413 | 430 | Request Entity Too Large | リクエストサイズ超過 |
| 429 | 400 | Quota Exceeded | リクエストの割り当て量超過 |
| 429 | 410 | Throttle Limited | 早すぎるか、あまりにも頻繁なリクエスト |
| 429 | 420 | Rate Limited | 特定の時間に過剰なリクエスト |
| 503 | 500 | Endpoint Error | エンドポイントエラー |
| 504 | 510 | Endpoint Timeout | エンドポイントタイムアウト |
| 500 | 900 | Unexpected Error | 不明なエラー |

              参考

              

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)をご参照ください。

## Certificate Manager API 1.0

Certificate Managerサービスが提供する API 1.0の説明は次の通りです。

| API | 説明 |
| --- | --- |
| [createExternalCertificate](/docs/ja/security-certificatemanager-createexternalcertificate) | 外部証明書を追加 |
| [deleteCertificate](/docs/ja/security-certificatemanager-deletecertificate) | 証明書を削除 |
| [getCertificateList](/docs/ja/security-certificatemanager-getcertificatelist) | 証明書を照会 |

## Certificate Manager API 2.0

Certificate Managerサービスが提供する API 2.0の説明は次の通りです。

#### Certificate Request

Certificate Request関連 APIを使用して、目的に合った証明書を新規に申し込んだり再発行することができ、他社で発行れた外部証明書の登録が可能です。

| API | 説明 |
| --- | --- |
| [CloudBasicCertificateRequest](/docs/ja/security-certificatemanager-cloudbasiccertificaterequest) | CloudBasic証明書の申し込み |
| [AdvancedCertificateRequest](/docs/ja/security-certificatemanager-advancedcertificaterequest) | Advanced証明書の申し込み |
| [GlobalEdgeCertificateRequest](/docs/ja/security-certificatemanager-globaledgecertificaterequest) | Global Edge証明書の申し込み |
| [ReissueCertificate](/docs/ja/security-certificatemanager-reissuecertificate) | 証明書を再発行 |
| [RegisterExternalCertificate](/docs/ja/security-certificatemanager-registerexternalcertificate) | 外部証明書を登録 |

#### Certificate Lookup

Certificate Inquiry & Status関連 APIは、各証明書種類別の証明書照会および状態照会時に使用される APIです。

| API | 説明 |
| --- | --- |
| [ListCertificateTypes](/docs/ja/security-certificatemanager-listcertificatetypes) | 証明書タイプリストを照会します。 |
| [ListCertificates](/docs/ja/security-certificatemanager-listcertificates) | 全証明書を照会 |
| [ListCloudCertificates](/docs/ja/security-certificatemanager-listcloudcertificates) | Cloud Basic SSLと GlobalEdge証明書を照会します。 |
| [ListAdvancedCertificates](/docs/ja/security-certificatemanager-listadvancedcertificates) | Advanced証明書を照会します。 |
| [ListDcvStatuses](/docs/ja/security-certificatemanager-listdcvstatuses) | 申し込んだ SSL証明書の DCV検証状態を照会します。 |
| [ListRecentCertChanges](/docs/ja/security-certificatemanager-listrecentcertchanges) | 指定した期間(分または秒)に状態が変更された証明書リストを照会します。 |

#### Certificate Management

Certificate Management & Lifecycle APIは、証明書の照会、ダウンロード、更新、削除など、証明書のライフサイクル管理に使用される APIです。

| API | 説明 |
| --- | --- |
| [GetCertificateChain](/docs/ja/security-certificatemanager-getcertificatechain) | リクエストした証明書を PEM形式で返し、証明書チェーンを一緒に提供 |
| [DownloadCertificate](/docs/ja/security-certificatemanager-downloadcertificate) | 証明書ファイルをダウンロード |
| [DeleteCertificate](/docs/ja/security-certificatemanager-deletecertificate) | 証明書を削除 |
| [RevokeCertificate](/docs/ja/security-certificatemanager-revokecertificate) | Advanced証明書を失効させる |
| [SetRenewalStatus](/docs/ja/security-certificatemanager-setrenewalstatus) | 証明書自動更新対象かを設定 |
| [RegisterPrivateKey](/docs/ja/security-certificatemanager-registerprivatekey) | 証明書に対する秘密鍵を登録 |
| [SubscriptionExtend](/docs/ja/security-certificatemanager-subscriptionextend) | Advanced証明書オーダー(Order)のサブスクリプション期間を延長 |

## Certificate Manager関連リソース

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

- Certificate Manager APIの使用方法
- [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): NAVERクラウドプラットフォームコンソールから発行されたサブアカウントの Access Key発行と確認方法
- [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに必要な API Keyの確認方法
- [署名(シグネチャー)の作成](/docs/ja/common-ncpapi#1-%EC%9D%B8%EC%A6%9D%ED%82%A4-%EC%83%9D%EC%84%B1): リクエストヘッダに必要な署名の作成方法
- [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Certificate Managerサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Certificate Managerサービスの使用方法
- [Certificate Managerご利用ガイド](https://guide.ncloud-docs.com/docs/ja/security-security-15-1): NAVERクラウドプラットフォームコンソールで Certificate Managerを使用する方法
- [Certificate Managerのブログ紹介](https://blog.naver.com/n_cloudplatform/222497761903): NAVERクラウドプラットフォーム公式ブログで Certificate Managerを紹介
- [Ncloud利用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド
- [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/security/certificateManager): Certificate Managerの料金体系、Certificate Managerの特徴と詳細機能のサマリー
- [サービスの最新情報](https://www.ncloud.com/intro/news): Certificate Managerに関する最新情報
- [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=SEC&categoryCode3=SV_0110): Certificate Managerユーザーからよく寄せられる質問とその回答
- [お問い合わせ](https://www.ncloud.com/support/question/service): ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ