Tous les produits
Search
Centre de documentation

:CreateWHClientCertificate

Dernière mise à jour :Aug 06, 2026

Émet un certificat client unique à partir du référentiel général de certificats utilisateur.

Description de l'opération

Cette API est limitée à 10 QPS par utilisateur. Le dépassement de cette limite déclenche une limitation de débit, ce qui peut affecter votre activité. Appelez cette API à une fréquence raisonnable pour éviter toute perturbation.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

SanType

integer

Non

Le type de nom alternatif du sujet (SAN) pour le certificat client. Valeurs valides :

  • 1 : adresse e-mail.

  • 2 : nom de domaine.

  • 6 : identificateur de ressource uniforme (URI).

  • 7 : adresse IP.

2

SanValue

string

Non

La valeur de l'extension SAN. Pour spécifier plusieurs valeurs, séparez-les par des virgules (,).

example.com

CommonName

string

Non

Le nom commun du certificat client. Prend en charge les caractères chinois, anglais et autres.

aliyun

Algorithm

string

Non

L'algorithme de clé pour le certificat client. Le format est <encryption_algorithm>_<key_length>. Valeurs valides :

  • RSA_1024 : l'algorithme de signature correspondant est Sha256WithRSA.

  • RSA_2048 : l'algorithme de signature correspondant est Sha256WithRSA.

  • RSA_4096 : l'algorithme de signature correspondant est Sha256WithRSA.

  • ECC_256 : l'algorithme de signature correspondant est Sha256WithECDSA.

  • ECC_384 : l'algorithme de signature correspondant est Sha256WithECDSA.

  • ECC_512 : l'algorithme de signature correspondant est Sha256WithECDSA.

  • SM2_256 : l'algorithme de signature correspondant est SM3WithSM2.

L'algorithme de chiffrement du certificat client doit correspondre à celui du certificat d'autorité de certification subordonnée émetteur, mais les longueurs de clé peuvent différer. 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.

RSA_2048

Csr

string

Non

Le contenu de la demande de signature de certificat (CSR). Vous pouvez générer un CSR avec des outils tels que OpenSSL ou Keytool.

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

ParentIdentifier

string

Oui

L'identifiant unique du certificat d'autorité de certification subordonnée émetteur.

273ae6bb538d538c70c01f81jh2****

Days

integer

Non

La période de validité du certificat client, en jours.

Vous ne pouvez pas laisser les paramètres Days, BeforeTime et AfterTime tous vides. Les paramètres BeforeTime et AfterTime doivent être spécifiés ensemble ou pas du tout.

  • Si vous spécifiez le paramètre Days, la spécification de BeforeTime et AfterTime est facultative.

  • Si vous ne spécifiez pas le paramètre Days, vous devez spécifier à la fois BeforeTime et AfterTime.

Remarque

Si vous spécifiez Days, BeforeTime et AfterTime simultanément, le paramètre Days est prioritaire pour déterminer la période de validité.

365

BeforeTime

integer

Non

L'heure d'émission du certificat client, sous forme d'horodatage Unix en secondes. Si omis, la valeur par défaut est l'heure de l'appel de l'API.

Remarque

Les paramètres BeforeTime et AfterTime doivent être spécifiés ensemble ou pas du tout.

1634283958

AfterTime

integer

Non

L'heure d'expiration du certificat client, spécifiée sous forme d'horodatage Unix en secondes.

Remarque

Les paramètres BeforeTime et AfterTime doivent être spécifiés ensemble ou pas du tout.

1665819958

Organization

string

Non

Le nom de l'organisation associé au certificat d'autorité de certification racine, généralement le nom de votre société ou entreprise. Prend en charge les caractères chinois, anglais et autres.

阿里巴巴网络技术有限公司

OrganizationUnit

string

Non

Le nom du département ou de l'unité commerciale au sein de l'organisation.

IT

Country

string

Non

Le pays où se trouve l'organisation.

CN

State

string

Non

La province, la municipalité ou la région autonome où se trouve l'organisation. Les caractères chinois, anglais et autres sont pris en charge.

Zhejiang

Locality

string

Non

La ville où se trouve l'organisation. Les caractères chinois, anglais et autres sont pris en charge.

Hangzhou

Years

integer

Non

La période de validité du certificat, en années.

1

Months

integer

Non

La période de validité du certificat, en mois.

12

Immediately

integer

Non

Indique le contenu du certificat à renvoyer dans la réponse.

  • 0 : ne renvoie pas le certificat (par défaut).

  • 1 : renvoie le certificat.

  • 2 : renvoie le certificat et sa chaîne de certificats.

1

Éléments de réponse

Élément

Type

Description

Exemple

object

L'objet de réponse.

Identifier

string

L'identifiant unique du certificat client.

190ae6bb538d538c70c01f81dcf2****

RequestId

string

L'identifiant de la requête. Cet identifiant unique est généré par Alibaba Cloud pour chaque requête et peut être utilisé pour le dépannage.

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

RootX509Certificate

string

Le contenu du certificat d'autorité de certification racine.

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

ParentX509Certificate

string

Le contenu du certificat d'autorité de certification subordonnée.

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

X509Certificate

string

Le contenu du certificat client.

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

CertificateChain

string

La chaîne de certificats.

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

Exemples

JSON format

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

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.