CreateClientCertificate - - Centre de documentation Alibaba Cloud

Émet un certificat client unique basé sur une demande de signature de certificat (CSR) générée par le système.

Description de l'opération

Avant d'appeler cette opération, vous devez avoir appelé CreateRootCACertificate pour créer un certificat d'autorité de certification racine et appelé CreateSubCACertificate pour créer un certificat d'autorité de certification subordonnée. Seuls les certificats d'autorité de certification subordonnée peuvent émettre des certificats clients.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 10 appels par seconde. Si cette limite est dépassée, l'appel d'API est limité, ce qui peut affecter votre activité. Appelez cette opération de manière appropriée.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

yundun-cert:CreateClientCertificate

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SanType	integer	Non	Le type de nom alternatif du sujet (SAN) pris en charge par le certificat client. Valeurs valides : 1 : adresse e-mail. 6 : identifiant de ressource uniforme (URI).	1
SanValue	string	Non	Les informations d'extension SAN spécifiques du certificat client. Vous pouvez saisir plusieurs valeurs SAN séparées par des virgules (,).	somebody@example.com
Organization	string	Non	Le nom de l'organisation. Valeur par défaut : Alibaba Inc.	Alibaba Cloud
OrganizationUnit	string	Non	Le nom du département. Valeur par défaut : Aliyun CDN.	IT
Country	string	Non	Le pays. Valeur par défaut : CN.	CN
CommonName	string	Non	Le nom du sujet du certificat. Le sujet d'un certificat d'authentification client (ClientAuth) est généralement une personne, une entreprise, une organisation ou une application. Spécifiez le nom commun du sujet. Par exemple, John Doe, Alibaba, Alibaba Cloud Crypto Platform ou Tmall Genie.	aliyun
State	string	Non	Le nom de la province ou de l'État où se trouve l'organisation du certificat. Les caractères chinois et anglais sont pris en charge. Valeur par défaut : la province ou l'État du certificat d'autorité de certification subordonnée qui émet ce certificat.	Zhejiang
Locality	string	Non	Le nom de la ville où se trouve l'organisation du certificat. Les caractères chinois et anglais sont pris en charge. Valeur par défaut : la ville du certificat d'autorité de certification subordonnée qui émet ce certificat.	Hangzhou
Algorithm	string	Non	L'algorithme de clé du certificat client. L'algorithme de clé est au format `<algorithme de chiffrement>_<longueur de clé>`. Valeurs valides : RSA_1024 : l'algorithme de signature est Sha256WithRSA. RSA_2048 : l'algorithme de signature est Sha256WithRSA. RSA_4096 : l'algorithme de signature est Sha256WithRSA. ECC_256 : l'algorithme de signature est Sha256WithECDSA. ECC_384 : l'algorithme de signature est Sha256WithECDSA. ECC_512 : l'algorithme de signature est Sha256WithECDSA. SM2_256 : l'algorithme de signature est SM3WithSM2. L'algorithme de chiffrement du certificat client doit être identique à celui du certificat d'autorité de certification subordonnée, mais la longueur de clé peut être différente. Par exemple, si l'algorithme de clé du certificat d'autorité de certification subordonnée est RSA_2048, l'algorithme de clé du certificat client doit être RSA_1024, RSA_2048 ou RSA_4096. Remarque Vous pouvez appeler DescribeCACertificate pour interroger l'algorithme de clé du certificat d'autorité de certification subordonnée.	RSA_2048
ParentIdentifier	string	Non	L'identifiant unique du certificat d'autorité de certification subordonnée qui émet ce certificat. L'instance d'autorité de certification privée (PrivateCaInstanceId) liée à l'autorité de certification subordonnée doit être dans un état valide et non expiré. Remarque Vous pouvez appeler [DescribeCACertificateList] pour interroger l'identifiant unique du certificat d'autorité de certification subordonnée.	273ae6bb538d538c70c01f81jh2****
Years	integer	Non	La période de validité du certificat. Unité : années.	5
Months	integer	Non	La période de validité du certificat. Unité : mois.	1
Days	integer	Non	La période de validité du certificat client. Unité : jours. Les paramètres Days, BeforeTime et AfterTime ne peuvent pas être tous vides, et les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux spécifiés. Les règles suivantes s'appliquent : Si vous définissez le paramètre Days, vous pouvez éventuellement définir à la fois BeforeTime et AfterTime ou les laisser vides. Si vous ne définissez pas le paramètre Days, vous devez définir à la fois BeforeTime et AfterTime. Remarque Si vous définissez Days, BeforeTime et AfterTime en même temps, la période de validité est déterminée par le paramètre Days. La période de validité du certificat client ne peut pas dépasser celle du certificat d'autorité de certification subordonnée. Vous pouvez appeler DescribeCACertificate pour interroger la période de validité du certificat d'autorité de certification subordonnée.	365
BeforeTime	integer	Non	L'heure d'émission du certificat client au format d'horodatage. Valeur par défaut : l'heure à laquelle vous appelez cette opération. Unité : secondes. Remarque Les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux spécifiés.	1634283958
AfterTime	integer	Non	L'heure d'expiration du certificat client au format d'horodatage. Unité : secondes. Remarque Les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux spécifiés.	1665819958
Immediately	integer	Non	Indique si le certificat numérique doit être renvoyé immédiatement. Valeurs valides : 0 : ne renvoie pas le certificat. Il s'agit de la valeur par défaut. 1 : renvoie le certificat. 2 : renvoie le certificat et sa chaîne de certificats.	1
EnableCrl	integer	Non	Indique si l'adresse de la liste de révocation de certificats (CRL) doit être incluse. Valeurs valides : 0 : Non. 1 : Oui.	1
Tags	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de la balise.	account
Value	string	Non	La valeur de la balise.	1
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-aek****wia
CustomIdentifier	string	Non	L'identifiant personnalisé, qui sert de clé unique.	**6bb538d538c70c01f81jh2**
AliasName	string	Non	Le nom du certificat émis.	cert-name
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. La valeur est générée par le client et doit être unique pour les différentes requêtes. La valeur peut contenir jusqu'à 64 caractères ASCII et ne peut pas contenir de caractères non ASCII.	XXX
AsynchronousFlag	boolean	Non	L'indicateur de traitement asynchrone. Si la valeur est définie sur "true", le service principal émet le certificat de manière asynchrone. Une fois la requête soumise, vous pouvez appeler l'opération ListClientCertificate pour obtenir le certificat le plus récent.	false

Lors de l'appel de cette opération, en plus des paramètres de requête décrits dans cette rubrique, vous devez également inclure les paramètres de requête communs de l'API Alibaba Cloud.

Pour le format de la requête, reportez-vous à l'exemple de requête dans la section Exemples de cette rubrique.

Éléments de réponse

Élément	Type	Description	Exemple
	object	CreateCertificateResponse
X509Certificate	string	Le contenu du certificat client.	-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----
CertificateChain	string	La chaîne de certificats de l'autorité de certification.	-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n
Identifier	string	L'identifiant unique du certificat client.	190ae6bb538d538c70c01f81dcf2****
SerialNumber	string	Le numéro de série du certificat.	084bde9cd233f0ddae33adc438cfbbbd****
RequestId	string	L'identifiant de la requête. Alibaba Cloud génère un identifiant unique pour chaque requête, qui peut être utilisé pour le dépannage et les diagnostics.	8C467B38-3910-447D-87BC-AC049166F216

Exemples

JSON format

{
  "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"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.