All Products
Search

This Product

    Certificate Management Service:CreateClientCertificate

    Document Center

    Certificate Management Service:CreateClientCertificate

    Last Updated:Aug 24, 2026

    Menerbitkan satu sertifikat klien berdasarkan certificate signing request (CSR) yang dibuat oleh sistem.

    Deskripsi operasi

    Sebelum memanggil operasi ini, Anda harus telah memanggil CreateRootCACertificate untuk membuat sertifikat root CA dan memanggil CreateSubCACertificate untuk membuat sertifikat sub-CA. Hanya sertifikat sub-CA yang dapat menerbitkan sertifikat klien.

    Batas QPS

    Batas QPS per pengguna untuk operasi ini adalah 10 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    yundun-cert:CreateClientCertificate

    create

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    SanType

    integer

    No

    Tipe Subject Alternative Name (SAN) yang didukung oleh sertifikat klien. Nilai valid:

    • 1: alamat email.

    • 6: Uniform Resource Identifier (URI).

    1
    SanValue

    string

    No

    Informasi ekstensi SAN spesifik dari sertifikat klien. Anda dapat memasukkan beberapa nilai SAN yang dipisahkan dengan koma (,).

    somebody@example.com
    Organization

    string

    No

    Nama organisasi. Nilai default: Alibaba Inc.

    Alibaba Cloud
    OrganizationUnit

    string

    No

    Nama departemen. Nilai default: Aliyun CDN.

    IT
    Country

    string

    No

    Negara. Nilai default: CN.

    CN
    CommonName

    string

    No

    Nama subjek sertifikat. Subjek sertifikat otentikasi klien (ClientAuth) biasanya berupa orang, perusahaan, organisasi, atau aplikasi. Tentukan common name dari subjek tersebut. Contohnya, John Doe, Alibaba, Alibaba Cloud Crypto Platform, atau Tmall Genie.

    aliyun
    State

    string

    No

    Nama provinsi atau negara bagian tempat organisasi sertifikat berada. Karakter Mandarin dan Inggris didukung. Nilai default: provinsi atau negara bagian dari sertifikat sub-CA yang menerbitkan sertifikat ini.

    Zhejiang
    Locality

    string

    No

    Nama kota tempat organisasi sertifikat berada. Karakter Mandarin dan Inggris didukung. Nilai default: kota dari sertifikat sub-CA yang menerbitkan sertifikat ini.

    Hangzhou
    Algorithm

    string

    No

    Algoritma kunci dari sertifikat klien. Algoritma kunci menggunakan format <algoritma enkripsi>_<panjang kunci>. Nilai valid:

    • RSA_1024: Algoritma tanda tangan adalah Sha256WithRSA.

    • RSA_2048: Algoritma tanda tangan adalah Sha256WithRSA.

    • RSA_4096: Algoritma tanda tangan adalah Sha256WithRSA.

    • ECC_256: Algoritma tanda tangan adalah Sha256WithECDSA.

    • ECC_384: Algoritma tanda tangan adalah Sha256WithECDSA.

    • ECC_512: Algoritma tanda tangan adalah Sha256WithECDSA.

    • SM2_256: Algoritma tanda tangan adalah SM3WithSM2.

    Algoritma enkripsi sertifikat klien harus sama dengan algoritma enkripsi sertifikat sub-CA, tetapi panjang kunci dapat berbeda. Misalnya, jika algoritma kunci sertifikat sub-CA adalah RSA_2048, maka algoritma kunci sertifikat klien haruslah RSA_1024, RSA_2048, atau RSA_4096.

    Catatan

    Lihat DescribeCACertificate untuk mengkueri algoritma kunci dari sertifikat sub-CA.

    RSA_2048
    ParentIdentifier

    string

    No

    Pengenal unik dari sertifikat sub-CA yang menerbitkan sertifikat ini. Instans Private Certificate Authority (PrivateCaInstanceId) yang terikat pada sub-CA harus dalam keadaan valid dan belum kedaluwarsa.

    Catatan

    Lihat [DescribeCACertificateList] untuk mengkueri pengenal unik dari sertifikat sub-CA.

    273ae6bb538d538c70c01f81jh2****
    Years

    integer

    No

    Periode validitas sertifikat. Unit: tahun.

    5
    Months

    integer

    No

    Periode validitas sertifikat. Unit: bulan.

    1
    Days

    integer

    No

    Periode validitas sertifikat klien. Unit: hari. Parameter Days, BeforeTime, dan AfterTime tidak boleh kosong semuanya, dan parameter BeforeTime serta AfterTime harus keduanya kosong atau keduanya diisi. Aturan berikut berlaku:

    • Jika Anda mengatur parameter Days, Anda dapat secara opsional mengatur kedua parameter BeforeTime dan AfterTime atau membiarkannya kosong.

    • Jika Anda tidak mengatur parameter Days, Anda harus mengatur kedua parameter BeforeTime dan AfterTime.

    Catatan

    • Jika Anda mengatur Days, BeforeTime, dan AfterTime secara bersamaan, periode validitas ditentukan oleh parameter Days.

    • Periode validitas sertifikat klien tidak boleh melebihi periode validitas sertifikat sub-CA. Lihat DescribeCACertificate untuk mengkueri periode validitas dari sertifikat sub-CA.

    365
    BeforeTime

    integer

    No

    Pengatur waktu penerbitan sertifikat klien dalam format timestamp. Nilai default: pengatur waktu saat Anda memanggil operasi ini. Unit: detik.

    Catatan

    Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya diisi.

    1634283958
    AfterTime

    integer

    No

    Pengatur waktu kedaluwarsa sertifikat klien dalam format timestamp. Unit: detik.

    Catatan

    Parameter BeforeTime dan AfterTime harus keduanya kosong atau keduanya diisi.

    1665819958
    Immediately

    integer

    No

    Apakah akan segera mengembalikan sertifikat digital. Nilai valid:

    • 0: Tidak mengembalikan sertifikat. Ini adalah nilai default.

    • 1: Mengembalikan sertifikat.

    • 2: Mengembalikan sertifikat dan rantai sertifikatnya.

    1
    EnableCrl

    integer

    No

    Apakah akan menyertakan alamat Certificate Revocation List (CRL). Nilai valid:

    • 0: Tidak.

    • 1: Ya.

    1
    Tags

    array<object>

    No

    Daftar tag.

    object

    No

    Daftar tag.

    Key

    string

    No

    Kunci tag.

    account
    Value

    string

    No

    Nilai tag.

    1
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-aek****wia
    CustomIdentifier

    string

    No

    Pengenal kustom, yang berfungsi sebagai kunci unik.

    ****6bb538d538c70c01f81jh2****
    AliasName

    string

    No

    Nama sertifikat yang diterbitkan.

    cert-name
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Nilai dihasilkan oleh klien dan harus unik di berbagai permintaan. Nilai dapat berisi hingga 64 karakter ASCII dan tidak boleh berisi karakter non-ASCII.

    XXX
    AsynchronousFlag

    boolean

    No

    Flag pemrosesan asinkron. Jika nilainya diatur ke "true", layanan backend menerbitkan sertifikat secara asinkron. Setelah permintaan dikirim, Anda dapat memanggil operasi ListClientCertificate untuk mendapatkan sertifikat terbaru.

    false

    Saat memanggil operasi ini, selain parameter permintaan yang dijelaskan dalam topik ini, Anda juga harus menyertakan parameter permintaan umum API Alibaba Cloud.

    Untuk format permintaan, lihat contoh permintaan di bagian Contoh pada topik ini.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    CreateCertificateResponse

    X509Certificate

    string

    Konten dari sertifikat klien.

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

    string

    Rantai sertifikat CA.

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

    string

    Pengenal unik dari sertifikat klien.

    190ae6bb538d538c70c01f81dcf2****
    SerialNumber

    string

    Nomor seri sertifikat.

    084bde9cd233f0ddae33adc438cfbbbd****
    RequestId

    string

    ID permintaan. Alibaba Cloud menghasilkan pengenal unik untuk setiap permintaan, yang dapat digunakan untuk pemecahan masalah dan diagnostik.

    8C467B38-3910-447D-87BC-AC049166F216

    Contoh

    Respons sukses

    JSONformat

    {
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
  "Identifier": "190ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "8C467B38-3910-447D-87BC-AC049166F216"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.