Terbitkan Sertifikat CA Intermediate Eksternal via API - Certificate Management Service - Alibaba Cloud - Certificate Management Service

Membuat dan menerbitkan sertifikat CA bawahan eksternal berdasarkan CSR dan parameter API.

Deskripsi operasi

Operasi ini membuat sertifikat CA bawahan eksternal berdasarkan permintaan penandatanganan sertifikat (CSR) yang disediakan dan konfigurasi pass parameter opsional melalui API.
InstanceId wajib diisi dan menentukan ID instans dari instans CA bawahan eksternal yang akan diaktifkan.
Bidang Csr harus berisi permintaan penandatanganan sertifikat yang valid.
Parameter Validity menentukan periode validitas sertifikat dan mendukung format waktu relatif serta waktu absolut.
Anda dapat menggunakan ApiPassthrough untuk menimpa informasi tertentu dalam CSR atau menambahkan ekstensi sertifikat tambahan, seperti Subject dan Extensions.
Catatan: Untuk sertifikat EndEntity CA, pengaturan pathLenConstraint harus 0.

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

create

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	No	ID instans dari instans CA bawahan eksternal yang akan diaktifkan.	cas_deposit-cn-1234abcd
Csr	string	No	Permintaan penandatanganan sertifikat. CSR dapat berisi SubjectDN dan ekstensi kustom dari sertifikat CA. Ekstensi sertifikat SubjectKeyIdentifier, AuthorityKeyIdentifier, dan CRLDistributionPoints dihasilkan oleh CA, dan nilai dalam CSR diabaikan.	-----BEGIN CERTIFICATE REQUEST----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... vbIgMQIhAKHDWD6/WAMbtezAt4bysJ/BZIDz1jPWuUR5GV4TJ/mS -----END CERTIFICATE REQUEST-----
Validity	string	No	Periode validitas sertifikat. Waktu relatif dan waktu absolut didukung. Catatan Waktu relatif: Mendukung unit tahun, bulan, dan hari. Tahun - y Bulan - m Hari - d Catatan Waktu absolut: Menggunakan waktu GMT. Format: `yyyy-MM-dd'T'HH:mm:ss'Z'` Pengatur waktu akhir - `$NotAfter` Pengatur waktu mulai dan waktu akhir - `$NotBefore/$NotAfter`	10y
ApiPassthrough	object	No	Menimpa konten CSR atau menambahkan konten ke sertifikat CA melalui parameter API.
Subject	object	No	Informasi subjek sertifikat CA. Jika nilai ini ditentukan, nilai tersebut menimpa SubjectDN dalam CSR.
Country	string	No	Negara. Gunakan kode negara dua huruf ISO 3166-1.	CN
State	string	No	Negara bagian atau provinsi.	Zhejiang
Locality	string	No	Kota atau lokalitas.	Hangzhou
Organization	string	No	Organisasi atau perusahaan.	Alibaba
OrganizationUnit	string	No	Unit organisasi dalam organisasi, seperti departemen, tim, kelompok proyek, atau cabang.	Cloud Security
CommonName	string	No	Nama sertifikat CA saat ini.	Testing CA
Extensions	object	No	Ekstensi sertifikat CA. Jika nilai ini ditentukan, nilai tersebut menimpa nilai ekstensi dalam CSR atau menambahkannya ke ekstensi sertifikat CA.
PathLenConstraint	integer	No	Batasan panjang jalur sertifikat. Untuk EndEntity CA, nilai ini harus diatur ke 0, yang berarti sertifikat CA saat ini digunakan untuk menerbitkan sertifikat entitas akhir.	0
ExtendedKeyUsages	array	No	Penggunaan kunci diperluas.
	string	No	Nilai valid: any: tidak ada batasan serverAuth: otentikasi server clientAuth: otentikasi Klien codeSigning: penandatanganan kode emailProtection: perlindungan email timeStamping: cap waktu OCSPSigning: penandatanganan OCSP OID penggunaan kunci diperluas lainnya Valid values: codeSigning : codeSigning. emailProtection : emailProtection. serverAuth : serverAuth. timeStamping : timeStamping any : any. clientAuth : clientAuth OCSPSigning : OCSPSigning.	serverAuth
Tags	array<object>	No	Daftar tag.
	object	No	Daftar tag.
Key	string	No	Kunci tag.	database
Value	string	No	Nilai tag.	1
ResourceGroupId	string	No	ID kelompok sumber daya.	test
CertMaxTime	integer	No	Periode validitas maksimum untuk sertifikat yang diterbitkan, sebagaimana ditentukan oleh certMaxTime dari CA. Unit: hari.	30

Elemen respons

Element	Type	Description	Example
	object	OpenApiResponse
RequestId	string	ID permintaan.	12345678-1234-1234-1234-123456789ABC
Identifier	string	Pengidentifikasi unik sertifikat.	1ed4068c-6f1b-6deb-8e32-3f8439a851cb
Certificate	string	Konten sertifikat.	-----BEGIN CERTIFICATE----- MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/ ... ... ... KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg== -----END CERTIFICATE-----
CertificateChain	string	Rantai sertifikat CA.	-----BEGIN CERTIFICATE----- ... ... -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- ... ... -----END CERTIFICATE-----

Contoh

Respons sukses

JSONformat

{
  "RequestId": "12345678-1234-1234-1234-123456789ABC",
  "Identifier": "1ed4068c-6f1b-6deb-8e32-3f8439a851cb",
  "Certificate": "-----BEGIN CERTIFICATE-----\nMIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/\n...\n...\n...\nKOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n-----END CERTIFICATE-----\n",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----\n"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.