CreateExternalCACertificate - - Centre de documentation Alibaba Cloud

Crée et émet un certificat d'autorité de certification subordonnée externe à partir d'une CSR et de paramètres d'API.

Description de l'opération

Cette opération crée un certificat d'autorité de certification subordonnée externe à partir de la demande de signature de certificat (CSR) fournie et des configurations de paramètres facultatifs via l'API.
InstanceId est requis et spécifie l'identifiant de l'instance d'autorité de certification subordonnée externe à activer.
Le champ Csr doit contenir une demande de signature de certificat valide.
Le paramètre Validity définit la période de validité du certificat et prend en charge les formats de temps relatif et de temps absolu.
Vous pouvez utiliser ApiPassthrough pour remplacer certaines informations dans la CSR ou ajouter des extensions de certificat supplémentaires, telles que le sujet et les extensions.
Remarque : Pour les certificats d'autorité de certification d'entité finale, le paramètre pathLenConstraint doit être défini sur 0.

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

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
InstanceId	string	Non	L'identifiant de l'instance de l'autorité de certification subordonnée externe à activer.	cas_deposit-cn-1234abcd
Csr	string	Non	La demande de signature de certificat. La CSR peut contenir le SubjectDN et les extensions personnalisées du certificat de l'autorité de certification. Les extensions de certificat SubjectKeyIdentifier, AuthorityKeyIdentifier et CRLDistributionPoints sont générées par l'autorité de certification, et les valeurs dans la CSR sont ignorées.	-----BEGIN CERTIFICATE REQUEST----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... vbIgMQIhAKHDWD6/WAMbtezAt4bysJ/BZIDz1jPWuUR5GV4TJ/mS -----END CERTIFICATE REQUEST-----
Validity	string	Non	La période de validité du certificat. Le temps relatif et le temps absolu sont tous deux pris en charge. Remarque Temps relatif : prend en charge les unités d'année, de mois et de jour. Année - y Mois - m Jour - d Remarque Temps absolu : utilise l'heure GMT. Format : `yyyy-MM-dd'T'HH:mm:ss'Z'` Spécifier l'heure de fin - `$NotAfter` Spécifier l'heure de début et l'heure de fin - `$NotBefore/$NotAfter`	10y
ApiPassthrough	object	Non	Remplace le contenu de la CSR ou ajoute du contenu au certificat de l'autorité de certification via les paramètres de l'API.
Subject	object	Non	Les informations sur le sujet du certificat de l'autorité de certification. Si cette valeur est spécifiée, elle remplace le SubjectDN dans la CSR.
Country	string	Non	Le pays. Utilise le code pays à deux lettres de la norme ISO 3166-1.	CN
State	string	Non	L'État ou la province.	Zhejiang
Locality	string	Non	La ville ou la localité.	Hangzhou
Organization	string	Non	L'organisation ou l'entreprise.	Alibaba
OrganizationUnit	string	Non	L'unité organisationnelle au sein de l'organisation, telle qu'un département, une équipe, un groupe de projet ou une succursale.	Cloud Security
CommonName	string	Non	Le nom du certificat de l'autorité de certification actuelle.	Testing CA
Extensions	object	Non	Les extensions du certificat de l'autorité de certification. Si cette valeur est spécifiée, elle remplace les valeurs d'extension dans la CSR ou les ajoute aux extensions du certificat de l'autorité de certification.
PathLenConstraint	integer	Non	La contrainte de longueur de chemin du certificat. Pour une autorité de certification d'entité finale, cette valeur doit être définie sur 0, ce qui signifie que le certificat de l'autorité de certification actuelle est utilisé pour émettre des certificats d'entité finale.	0
ExtendedKeyUsages	array	Non	Les utilisations étendues de la clé.
	string	Non	Valeurs valides : any : aucune restriction serverAuth : authentification du serveur clientAuth : authentification du client codeSigning : signature de code emailProtection : protection des e-mails timeStamping : horodatage OCSPSigning : signature OCSP Autres OID d'utilisation étendue de la clé Valeurs valides : codeSigning : codeSigning. emailProtection : emailProtection. serverAuth : serverAuth. timeStamping : timeStamping. any : any. clientAuth : clientAuth. OCSPSigning : OCSPSigning.	serverAuth
Tags	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de la balise.	database
Value	string	Non	La valeur de la balise.	1
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	test
CertMaxTime	integer	Non	La période de validité maximale pour les certificats émis, telle que spécifiée par le certMaxTime de l'autorité de certification. Unité : jours.	30

Éléments de réponse

Élément	Type	Description	Exemple
	object	OpenApiResponse
RequestId	string	L'identifiant de la requête.	12345678-1234-1234-1234-123456789ABC
Identifier	string	L'identifiant unique du certificat.	1ed4068c-6f1b-6deb-8e32-3f8439a851cb
Certificate	string	Le contenu du certificat.	-----BEGIN CERTIFICATE----- MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/ ... ... ... KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg== -----END CERTIFICATE-----
CertificateChain	string	La chaîne de certificats de l'autorité de certification.	-----BEGIN CERTIFICATE----- ... ... -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- ... ... -----END CERTIFICATE-----

Exemples

JSON format

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

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.