All Products
Search

This Product

    Certificate Management Service:CreateCustomCertificate

    Document Center

    Certificate Management Service:CreateCustomCertificate

    Last Updated:Jun 10, 2026

    Menerbitkan sertifikat digital kustom dengan subjek, subject alternative names (SANs), key usage, dan extended key usage yang ditentukan.

    Deskripsi operasi

    Secara default, subjek sertifikat diambil dari Certificate Signing Request (CSR). Jika Anda menentukan subjek sertifikat, subjek dari CSR akan diabaikan dan subjek yang ditentukan digunakan untuk menerbitkan sertifikat.

    Anda harus menentukan key usage atau extended key usage berdasarkan skenario Anda. Contoh berikut menunjukkan skenario umum:

    • Sertifikat autentikasi sisi server

    Key usage: digitalSignature, keyEncipherment

    Extended key usage: serverAuth

    • Sertifikat autentikasi klien

    Key usage: digitalSignature, keyEncipherment

    Extended key usage: clientAuth

    • Sertifikat autentikasi timbal balik mTLS

    Key usage: digitalSignature, keyEncipherment

    Extended key usage: serverAuth, clientAuth

    • Sertifikat penandatanganan email

    Key usage: digitalSignature, contentCommitment

    Extended key usage: emailProtection

    Catatan: CA Compliance dikelola oleh otoritas pihak ketiga dan tidak mendukung operasi ini.

    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:CreateCustomCertificate

    create

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ParentIdentifier

    string

    Yes

    Identifier dari sertifikat CA.

    1ed4068c-6f1b-6deb-8e32-3f8439a851cb
    Csr

    string

    Yes

    Konten CSR. Anda dapat membuat CSR menggunakan alat seperti OpenSSL atau Keytool. Untuk informasi lebih lanjut, lihat Membuat berkas CSR.

    -----BEGIN CERTIFICATE REQUEST----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... ... ... vbIgMQIhAKHDWD6/WAMbtezAt4bysJ/BZIDz1jPWuUR5GV4TJ/mS -----END CERTIFICATE REQUEST-----
    Validity

    string

    Yes

    Periode masa berlaku sertifikat. Periode ini tidak boleh melebihi masa berlaku instans. Anda dapat menggunakan waktu relatif atau waktu absolut.

    Waktu relatif: Mendukung tahun, bulan, dan hari.

    • Tahun - y

    • Bulan - m

    • Hari - d

    Waktu absolut: Menggunakan GMT. Format: yyyy-MM-dd'T'HH:mm:ss'Z'

    • Tentukan waktu akhir - $NotAfter

    • Tentukan waktu mulai dan akhir - $NotBefore/$NotAfter

    相对时间： ● 1y ● 3m ● 7d 绝对时间： ● 2006-01-02T15:04:05Z ● 2006-01-02T15:04:05Z/2023-03-09T17:48:13Z
    ApiPassthrough

    object

    No

    Parameter pass-through.

    Subject

    object

    No

    Subjek sertifikat.

    Country

    string

    No

    Kode negara. Gunakan kode negara dua huruf dari ISO 3166-1. Untuk informasi lebih lanjut, lihat ISO.

    CN
    State

    string

    No

    Provinsi atau negara bagian tempat organisasi berada.

    浙江省
    Locality

    string

    No

    Nama kota tempat organisasi berada. Karakter Mandarin dan huruf didukung.

    杭州市
    Organization

    string

    No

    Nama organisasi.

    XXX公司
    OrganizationUnit

    string

    No

    Nama departemen atau cabang dalam organisasi.

    XXX部门
    CommonName

    string

    No

    Common name pengguna sertifikat.

    张三
    CustomAttributes

    array<object>

    No

    Properti subjek kustom sertifikat.

    object

    No

    Properti subjek kustom sertifikat.

    ObjectIdentifier

    string

    No

    The key for the custom attribute. It must comply with industry standards. Examples:

    • 2.5.4.6: Country code

    • 2.5.4.10: Organization

    • 2.5.4.11: Organizational unit name

    • 2.5.4.12: Title

    • 2.5.4.3: Common name

    • 2.5.4.9: Street

    • 2.5.4.5: Serial number name

    • 2.5.4.7: Locality

    • 2.5.4.8: Province or city

    • 1.3.6.1.4.1.37244.1.1: Matter certificate - Node ID

    • 1.3.6.1.4.1.37244.1.5: Matter certificate - Fabric ID

    • 1.3.6.1.4.1.37244.2.1: Matter certificate Vendor ID (VID)

    • 1.3.6.1.4.1.37244.2.2: Matter certificate Product ID (PID)

    2.5.4.3
    Value

    string

    No

    The value of the custom attribute.

    Aliyun
    Extensions

    object

    No

    Ekstensi sertifikat.

    KeyUsage

    object

    No

    Key usage.

    DigitalSignature

    boolean

    No

    Digital signature. Allows the private key to create digital signatures and the public key to verify them.

    true
    ContentCommitment

    boolean

    No

    Content commitment. This was formerly known as NonRepudiation. It allows the certificate key to be used for content commitment.

    false
    NonRepudiation

    boolean

    No

    Non-repudiation. This has been renamed to ContentCommitment in the X.509 standard.

    false
    KeyEncipherment

    boolean

    No

    Key encipherment. Allows the certificate key to encrypt other keys.

    false
    DataEncipherment

    boolean

    No

    Data encryption.

    false
    KeyAgreement

    boolean

    No

    Key agreement.

    false
    EncipherOnly

    boolean

    No

    If KeyAgreement is true, this indicates that the certificate key can only be used for encryption.

    false
    DecipherOnly

    boolean

    No

    If KeyAgreement is true, this indicates that the certificate key can only be used for decryption.

    false
    ExtendedKeyUsages

    array

    No

    Extended key usages.

    string

    No

    Nilai berikut diizinkan:

    • any - Tanpa batasan

    • serverAuth - Autentikasi server

    • clientAuth - Autentikasi klien

    • codeSigning - Penandatanganan kode

    • emailProtection - Proteksi email

    • timeStamping - Timestamping

    • OCSPSigning - Penandatanganan OCSP

    • OID extended key usage lainnya

    1.3.6.1.4.1.311.20.2.2
    SubjectAlternativeNames

    array<object>

    No

    Subject alternative names (SANs) dari sertifikat.

    object

    No

    Subject alternative names (SANs) dari sertifikat.

    Type

    string

    Yes

    The following values are allowed:

    • rfc822Name - Email address

    • dNSName - Domain name

    • uniformResourceIdentifier - Uniform Resource Identifier (URI)

    • iPAddress - IP address

    dNSName
    Value

    string

    No

    A value that matches the definition of Type.

    rfc822Name: example.aliyundoc.com dNSName: learn.aliyundoc.com uniformResourceIdentifier: acs:ecs:regionid:15619224785*****:instance/i-bp1bzvz55uz27hf***** iPAddress: 127.0.0.1
    Criticals

    array

    No

    Jika sebuah ekstensi bersifat critical, namanya disertakan dalam daftar criticals.

    string

    No

    Nama ekstensi critical, seperti ExtendedKeyUsages.

    ExtendedKeyUsages
    SerialNumber

    string

    No

    Nomor seri kustom sertifikat. Harus berupa integer panjang.

    16889526086333
    Immediately

    integer

    No

    Dapatkan sertifikat secara langsung.

    • 0 - Terbitkan sertifikat secara asinkron.

    • 1 - Terbitkan sertifikat secara langsung.

    • 2 - Terbitkan sertifikat secara langsung dan kembalikan rantai sertifikat CA.

    0
    EnableCrl

    integer

    No

    Menentukan apakah akan menyertakan alamat CRL.

    • 0 - Tidak

    • 1 - Ya

    1
    Tags

    array<object>

    No

    Daftar tag.

    object

    No

    Daftar tag.

    Key

    string

    No

    Kunci tag.

    testKey
    Value

    string

    No

    Nilai tag.

    1
    ResourceGroupId

    string

    No

    ID grup sumber daya. Anda dapat memperoleh ID ini dengan memanggil operasi ListResources.

    rg-aek****wia
    customIdentifier

    string

    No

    Identifier kustom.

    XXX068c-6f1b-6deb-8e32-3f8439a8XXX

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    Identifier

    string

    Identifier unik sertifikat.

    160ae6bb538d538c70c01f81dcf2****
    Certificate

    string

    Konten sertifikat. Dikembalikan ketika Immediately diatur ke 1 atau 2.

    -----BEGIN CERTIFICATE----- MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/ ... ... ... KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg== -----END CERTIFICATE-----
    CertificateChain

    string

    Rantai sertifikat CA. Dikembalikan ketika Immediately diatur ke 2.

    -----BEGIN CERTIFICATE----- MIIBfzCCATGgAwIBAgIUfI5kSdcO2S0+LkpdL3b2VUJG10YwBQYDK2VwMDUxCzAJ ... ... ... ZYYG -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... ... ... KL5cUmF -----END CERTIFICATE-----
    SerialNumber

    string

    Nomor seri sertifikat. Dikembalikan ketika Immediately diatur ke 1 atau 2.

    084bde9cd233f0ddae33adc438cfbbbd****
    RequestId

    string

    ID permintaan. Ini adalah identifier unik yang dibuat oleh Alibaba Cloud untuk permintaan tersebut. Gunakan ID ini untuk memecahkan masalah.

    12345678-1234-1234-1234-123456789ABC

    Contoh

    Respons sukses

    JSONformat

    {
  "Identifier": "160ae6bb538d538c70c01f81dcf2****",
  "Certificate": "-----BEGIN CERTIFICATE-----\nMIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/\n...\n...\n...\nKOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\nMIIBfzCCATGgAwIBAgIUfI5kSdcO2S0+LkpdL3b2VUJG10YwBQYDK2VwMDUxCzAJ\n...\n...\n...\nZYYG\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ\n...\n...\n...\nKL5cUmF\n-----END CERTIFICATE-----",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "12345678-1234-1234-1234-123456789ABC"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.