すべてのプロダクト
Search
ドキュメントセンター

Certificate Management Service:CreateClientCertificateWithCsr

最終更新日:Aug 24, 2026

カスタム証明書署名リクエスト (CSR) に基づいて単一のクライアント証明書を発行します。

操作説明

この操作を呼び出す前に、 CreateRootCACertificate を呼び出してルート CA 証明書を作成し、 CreateSubCACertificate を呼び出してサブ CA 証明書を作成しておく必要があります。クライアント証明書を発行できるのはサブ CA 証明書のみです。

QPS 制限

この操作のユーザー単位の QPS 上限は毎秒 10 回の呼び出しです。毎秒の呼び出し回数が上限を超えると、速度制限がトリガーされます。これにより、ビジネスに影響が生じる可能性があります。この操作は適切に呼び出してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cert:CreateClientCertificateWithCsr

create

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Csr

string

任意

CSR の内容。OpenSSL または Keytool を使用して CSR を生成できます。詳細については、「CSR ファイルの作成方法」をご参照ください。

-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----

SanType

integer

任意

クライアント証明書の Subject Alternative Name (SAN) 拡張のタイプ。有効な値:

  • 0: otherName (0): その他の名前。

  • 1: rfc822Name (1): RFC 822 名。通常はメールアドレスです。

  • 2: dNSName (2): DNS 名 (ドメイン名)。

  • 3: x400Address (3): X.400 アドレス。初期の電子メール標準アドレスです。

  • 4: directoryName (4): ディレクトリ名。通常は X.500 識別名 (DN) です。

  • 5: ediPartyName (5): Electronic Data Interchange (EDI) パーティ名。

  • 6: uniformResourceIdentifier (6): Uniform Resource Identifier (URI)。

  • 7: iPAddress (7): IP アドレス。

  • 8: registeredID (8): 登録済み ID (Object Identifier, OID)。

2

SanValue

string

任意

クライアント証明書の具体的な SAN 拡張情報。カンマ (,) で区切って複数の値を入力できます。

  1. otherName (0): その他の名前

  • 例: 1.3.6.1.4.1.311.20.2.3 (OID) + user@domain.com (UPN, ユーザープリンシパル名 (UPN))

  • 説明: カスタム拡張タイプで、通常は特定の OID (Object Identifier) と対応する値で構成されます。Windows 環境では、スマートカードログイン用の UPN (ユーザープリンシパル名 (UPN)、例: zhangsan@company.com) を格納するために一般的に使用されます。

  1. rfc822Name (1): RFC 822 名 (メールアドレス)

  • 例: admin@example.com,support@company.cn

  • 説明: RFC 822 標準に準拠したインターネットメールアドレスです。S/MIME メールの署名および暗号化証明書で、メッセージの送信者または受信者を識別するために一般的に使用されます。

  • dNSName (2): DNS 名 (ドメイン名)

  • 例: www.example.com,api.test.cn,*.mydomain.com (ワイルドカードドメイン名)

  • 説明: HTTPS ウェブサイトの SSL/TLS 証明書で最も一般的に使用されるタイプです。SAN 拡張を通じて証明書に複数の DNS 名を含めることができ、単一の証明書で複数のサブドメインや全く異なるドメイン名を保護できます。

  1. x400Address (3): X.400 アドレス

  • 例: G=Zhang; S=San; O=Company; PRMD=IT; ADMD=Telecom; C=CN

  • 説明: 初期の電子メールシステムアドレス標準で、国 (C)、管理ドメイン (ADMD)、組織 (O)、姓 (S)、名 (G) などの属性を含む複雑な構造を持っています。現代のインターネット HTTPS 証明書で使用されることは稀で、主に従来の欧州の政府、企業、または軍事通信システムで見られます。

  1. directoryName (4): ディレクトリ名

  • 例: CN=IT Department, OU=Tech, O=Company Ltd, L=Beijing, ST=Beijing, C=CN

  • 説明: 標準的な X.500 識別名 (DN) です。証明書内の組織、部門、またはエンティティの完全な階層情報を明示的に識別するために一般的に使用されます。企業の内部ルート証明書や特定の政府デジタル証明書でよく見られます。

  1. ediPartyName (5): EDI パーティ名

  • 例: nameAssigner=GlobalTradeOrg, partyName=SupplierA

  • 説明: Electronic Data Interchange (EDI) ドメインで特に使用されます。ビジネスメッセージ交換 (注文や請求書の送信など) における特定の当事者を識別し、通常は名前割り当て権限 (nameAssigner) とパーティ名 (partyName) を含みます。

  1. uniformResourceIdentifier (6): Uniform Resource Identifier (URI)

  • 例: http://www.example.com/verify,https://api.test.cn/status

  • 説明: プロトコルプレフィックス (http:// や https:// など) を含む必要がある標準的な URL フォーマットです。特定のネットワークリソースアドレスをポイントできます。

  1. iPAddress (7): IP アドレス

  • 例: 192.168.1.100 (IPv4), 2001:0db8:85a3::8a2e:0370:7334 (IPv6)

  • 説明: サーバーの IP アドレスに直接バインドします。ドメイン名のない内部システム、API サーバー、またはパブリック IP アドレス経由でのみアクセス可能な特定のサービスに一般的に使用されます。注: パブリック IP 証明書には、通常厳格な組織検証 (OV) が必要です。

  1. registeredID (8): 登録済み ID (Object Identifier, OID)

  • 例: 1.2.3.4.55.6.5.99, 2.5.29.17

  • 説明: 国際標準化機関によって割り当てられた一意の数値識別子です。証明書内で主題名として直接使用されることは稀で、システム内の一意の ID コードまたはポリシー識別子としてより一般的に使用されます。

somebody@example.com

Organization

string

任意

組織名。デフォルト値: Alibaba Inc.

Alibaba Inc

OrganizationUnit

string

任意

組織単位名。デフォルト値: Aliyun CDN.

Security

Country

string

任意

国別コード。例: CN または US。

CN

CommonName

string

任意

証明書の共通名。漢字、英字、その他の文字がサポートされています。

説明

CsrPemString パラメーターを設定した場合、CommonName パラメーターの値は CsrPemString パラメーター内の対応する情報によって決定されます。

aliyundoc.com

State

string

任意

証明書組織が所在する州またはリージョンの名前。漢字、英字、その他の文字がサポートされています。デフォルト値は、この証明書を発行するサブ CA 証明書組織が所在する州またはリージョンの名前です。

Zhejiang

Locality

string

任意

証明書組織が所在する都市の名前。漢字、英字、その他の文字がサポートされています。 デフォルト値は、この証明書を発行するサブ CA 証明書組織が所在する都市の名前です。

Hangzhou

Algorithm

string

任意

クライアント証明書のキーアルゴリズム。キーアルゴリズムは <暗号化アルゴリズム>_<キー長> のフォーマットです。有効な値:

  • RSA_1024: 署名アルゴリズムは Sha256WithRSA です。

  • RSA_2048: 署名アルゴリズムは Sha256WithRSA です。

  • RSA_4096: 署名アルゴリズムは Sha256WithRSA です。

  • ECC_256: 署名アルゴリズムは Sha256WithECDSA です。

  • ECC_384: 署名アルゴリズムは Sha256WithECDSA です。

  • ECC_512: 署名アルゴリズムは Sha256WithECDSA です。

  • SM2_256: 署名アルゴリズムは SM3WithSM2 です。

クライアント証明書の暗号化アルゴリズムはサブ CA 証明書のものと同一である必要がありますが、キー長は異なっていても構いません。たとえば、サブ CA 証明書のキーアルゴリズムが RSA_2048 の場合、クライアント証明書のキーアルゴリズムは RSA_1024、RSA_2048、または RSA_4096 のいずれかである必要があります。

説明

DescribeCACertificate を呼び出して、サブ CA 証明書のキーアルゴリズムをクエリできます。

RSA_2048

ParentIdentifier

string

任意

この証明書を発行するサブ CA 証明書の一意の識別子。

説明

DescribeCACertificateList を呼び出して、サブ CA 証明書の一意の識別子をクエリできます。

270ae6bb538d538c70c01f81fg3****

Years

integer

任意

証明書の有効期間。単位: 年。

1

Months

integer

任意

証明書の有効期間。単位: か月。

12

Days

integer

任意

クライアント証明書の有効期間。単位: 日。 Days、BeforeTime、および AfterTime パラメーターをすべて空にすることはできません。BeforeTime および AfterTime パラメーターは、両方とも空にするか、両方とも指定する必要があります。以下のルールが適用されます。

  • Days パラメーターを設定する場合、BeforeTime および AfterTime パラメーターは設定しても設定しなくても構いません。

  • Days パラメーターを設定しない場合、BeforeTime および AfterTime パラメーターを設定する必要があります。

説明
  • Days、BeforeTime、および AfterTime パラメーターを同時に設定した場合、クライアント証明書の有効期間は Days パラメーターの値によって決定されます。

  • クライアント証明書の有効期間は、サブ CA 証明書の有効期間を超えることはできません。 DescribeCACertificate を呼び出して、サブ CA 証明書の有効期間を確認できます。

365

BeforeTime

integer

任意

UNIX タイムスタンプフォーマットでのクライアント証明書の発行時間。デフォルト値はこの操作を呼び出した時間です。単位: 秒。

説明

BeforeTime および AfterTime パラメーターは、両方とも空にするか、両方とも指定する必要があります。

1634283958

AfterTime

integer

任意

UNIX タイムスタンプフォーマットでのクライアント証明書の有効期限。単位: 秒。

説明

BeforeTime および AfterTime パラメーターは、両方とも空にするか、両方とも指定する必要があります。

1665819958

Immediately

integer

任意

デジタル証明書をすぐに返すかどうかを指定します。有効な値:

  • 0: 証明書を返しません。これがデフォルト値です。

  • 1: 証明書を返します。

  • 2: 証明書とその証明書チェーンを返します。

1

EnableCrl

integer

任意

証明書失効リスト (CRL) アドレスを含めるかどうかを指定します。有効な値:

  • 0: いいえ。

  • 1: はい。

1

Tags

array<object>

任意

タグのリスト。

object

任意

タグのリスト。

Key

string

任意

タグキー。

database

Value

string

任意

タグ値。

1

ResourceGroupId

string

任意

証明書が属するリソースグループの ID。

rg-ae******4wia

CustomIdentifier

string

任意

一意キーとして機能するカスタム識別子。

***e6bb538d538c70c01f81fg3****

AsynchronousFlag

boolean

任意

非同期処理フラグ。値が "true" の場合、バックエンドサービスは証明書を非同期で発行します。 リクエストが送信された後、ListClientCertificate 操作を呼び出して最新の証明書を取得できます。

false

この操作を呼び出す際は、本トピックで説明されているリクエストパラメーターに加えて、Alibaba Cloud API の共通リクエストパラメーターを含める必要があります。

リクエストフォーマットについては、本トピックの「Examples」セクションにあるリクエスト例をご参照ください。

レスポンスフィールド

フィールド

型

説明

例

object

CreateCertificateResponse

X509Certificate

string

クライアント証明書の内容。

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----

CertificateChain

string

CA 証明書チェーン。

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n

Identifier

string

クライアント証明書の一意の識別子。

200ae6bb538d538c70c01f81dcf2****

SerialNumber

string

証明書のシリアル番号。

084bde9cd233f0ddae33adc438cfbbbd****

RequestId

string

リクエスト ID。Alibaba Cloud は各 API リクエストに対して一意の識別子を発行します。この ID を使用して問題のトラブルシューティングを行えます。

31C66C7B-671A-4297-9187-2C4477247A74

CertSignBufKmc

string

暗号化された証明書の内容。

MIIDYDCCAwWgAwIBAgIU *** TmTk0CS3WNweqsjMEETyxd2pzU6DA

CertKmcRep1

string

暗号化された証明書の暗号文。

userSeal=MHkCIEu94PQAahFWuFk% *** EtFw%2FkMMBjw8i5bFfSkV%2FIUrcOJD

例

成功レスポンス

JSONJSON

{
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
  "Identifier": "200ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "31C66C7B-671A-4297-9187-2C4477247A74",
  "CertSignBufKmc": "MIIDYDCCAwWgAwIBAgIU\n***\nTmTk0CS3WNweqsjMEETyxd2pzU6DA",
  "CertKmcRep1": "userSeal=MHkCIEu94PQAahFWuFk%\n***\nEtFw%2FkMMBjw8i5bFfSkV%2FIUrcOJD"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。