AWS Private CA exemples utilisant AWS CLI - Exemples de code de l'AWS SDK
Actions

D'autres AWS SDK exemples sont disponibles dans le GitHub dépôt AWS Doc SDK Examples.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS Private CA exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS Private CA.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercreate-certificate-authority-audit-report.

AWS CLI

Pour créer un rapport d'audit de l'autorité de certification

La create-certificate-authority-audit-report commande suivante crée un rapport d'audit pour l'autorité de certification privée identifiée par leARN.

aws acm-pca create-certificate-authority-audit-report --certificate-authority-arn arn:aws:acm-pca:us-east-1:accountid:certificate-authority/12345678-1234-1234-1234-123456789012 --s3-bucket-name your-bucket-name --audit-report-response-format JSON

L'exemple de code suivant montre comment utilisercreate-certificate-authority.

AWS CLI

Pour créer une autorité de certification privée

La create-certificate-authority commande suivante crée une autorité de certification privée dans votre AWS compte.

aws acm-pca create-certificate-authority --certificate-authority-configuration file://C:\ca_config.txt --revocation-configuration file://C:\revoke_config.txt --certificate-authority-type "SUBORDINATE" --idempotency-token 98256344

L'exemple de code suivant montre comment utiliserdelete-certificate-authority.

AWS CLI

Pour supprimer une autorité de certification privée

La delete-certificate-authority commande suivante supprime l'autorité de certification identifiée par leARN.

aws acm-pca delete-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012

L'exemple de code suivant montre comment utiliserdescribe-certificate-authority-audit-report.

AWS CLI

Pour décrire un rapport d'audit destiné à une autorité de certification

La describe-certificate-authority-audit-report commande suivante répertorie les informations relatives au rapport d'audit spécifié pour l'autorité de certification identifiée par leARN.

aws acm-pca describe-certificate-authority-audit-report --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/99999999-8888-7777-6666-555555555555 --audit-report-id 11111111-2222-3333-4444-555555555555

L'exemple de code suivant montre comment utiliserdescribe-certificate-authority.

AWS CLI

Pour décrire une autorité de certification privée

La describe-certificate-authority commande suivante répertorie les informations relatives à l'autorité de certification privée identifiée par leARN.

aws acm-pca describe-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012

L'exemple de code suivant montre comment utiliserget-certificate-authority-certificate.

AWS CLI

Pour récupérer un certificat d'autorité de certification (CA)

La get-certificate-authority-certificate commande suivante permet de récupérer le certificat et la chaîne de certificats pour l'autorité de certification privée spécifiée par leARN.

aws acm-pca get-certificate-authority-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --output text

L'exemple de code suivant montre comment utiliserget-certificate-authority-csr.

AWS CLI

Pour récupérer la demande de signature de certificat pour une autorité de certification

La get-certificate-authority-csr commande suivante extrait le CSR pour l'autorité de certification privée spécifiée par leARN.

aws acm-pca get-certificate-authority-csr --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --output text

L'exemple de code suivant montre comment utiliserget-certificate.

AWS CLI

Pour récupérer un certificat émis

L'get-certificateexemple suivant récupère un certificat auprès de l'autorité de certification privée spécifiée.

aws acm-pca get-certificate \
    --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 \
    --certificate-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012/certificate/6707447683a9b7f4055627ffd55cebcc \
    --output text

Sortie :

-----BEGIN CERTIFICATE-----
MIIEDzCCAvegAwIBAgIRAJuJ8f6ZVYL7gG/rS3qvrZMwDQYJKoZIhvcNAQELBQAw
cTELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBgNVBAcMB1Nl
    ....certificate body truncated for brevity....
tKCSglgZZrd4FdLw1EkGm+UVXnodwMtJEQyy3oTfZjURPIyyaqskTu/KSS7YDjK0
KQNy73D6LtmdOEbAyq10XiDxqY41lvKHJ1eZrPaBmYNABxU=
-----END CERTIFICATE---- -----BEGIN CERTIFICATE-----
MIIDrzCCApegAwIBAgIRAOskdzLvcj1eShkoyEE693AwDQYJKoZIhvcNAQELBQAw
cTELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBgNVBAcMB1Nl
    ...certificate body truncated for brevity....
kdRGB6P2hpxstDOUIwAoCbhoaWwfA4ybJznf+jOQhAziNlRdKQRR8nODWpKt7H9w
dJ5nxsTk/fniJz86Ddtp6n8s82wYdkN3cVffeK72A9aTCOU=
-----END CERTIFICATE-----

La première partie de la sortie est le certificat lui-même. La deuxième partie est la chaîne de certificats qui est liée au certificat de l'autorité de certification racine. Notez que lorsque vous utilisez cette --output text option, un TAB caractère est inséré entre les deux éléments du certificat (c'est la cause du texte en retrait). Si vous avez l'intention de prendre cette sortie et d'analyser les certificats avec d'autres outils, vous devrez peut-être supprimer le TAB caractère afin qu'il soit traité correctement.

  • Pour API plus de détails, voir GetCertificatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserimport-certificate-authority-certificate.

AWS CLI

Pour importer le certificat de votre autorité de certification dans ACM PCA

La import-certificate-authority-certificate commande suivante importe le certificat d'autorité de certification privée signé pour l'autorité de certification spécifiée par le ARN dans ACMPCA.

aws acm-pca import-certificate-authority-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --certificate file://C:\ca_cert.pem --certificate-chain file://C:\ca_cert_chain.pem

L'exemple de code suivant montre comment utiliserissue-certificate.

AWS CLI

Pour émettre un certificat privé

La issue-certificate commande suivante utilise l'autorité de certification privée spécifiée par le ARN pour émettre un certificat privé.

aws acm-pca issue-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --csr file://C:\cert_1.csr --signing-algorithm "SHA256WITHRSA" --validity Value=365,Type="DAYS" --idempotency-token 1234

  • Pour API plus de détails, voir IssueCertificatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-certificate-authorities.

AWS CLI

Pour répertorier vos autorités de certification privées

La list-certificate-authorities commande suivante répertorie les informations relatives à tous les éléments privés CAs de votre compte.

aws acm-pca list-certificate-authorities --max-results 10

L'exemple de code suivant montre comment utiliserlist-tags.

AWS CLI

Pour répertorier les balises de votre autorité de certification

La list-tags commande suivante répertorie les balises associées à l'autorité de certification privée spécifiée par leARN.

aws acm-pca list-tags --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/123455678-1234-1234-1234-123456789012 --max-results 10

  • Pour API plus de détails, voir ListTagsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserrevoke-certificate.

AWS CLI

Pour révoquer un certificat privé

La revoke-certificate commande suivante révoque un certificat privé de l'autorité de certification identifiée par leARN.

aws acm-pca revoke-certificate --certificate-authority-arn arn:aws:acm-pca:us-west-2:1234567890:certificate-authority/12345678-1234-1234-1234-123456789012 --certificate-serial 67:07:44:76:83:a9:b7:f4:05:56:27:ff:d5:5c:eb:cc --revocation-reason "KEY_COMPROMISE"

  • Pour API plus de détails, voir RevokeCertificatela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-certificate-authority.

AWS CLI

Pour associer des balises à une autorité de certification privée

La tag-certificate-authority commande suivante attache une ou plusieurs balises à votre autorité de certification privée.

aws acm-pca tag-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --tags Key=Admin,Value=Alice

L'exemple de code suivant montre comment utiliseruntag-certificate-authority.

AWS CLI

Pour supprimer une ou plusieurs balises de votre autorité de certification privée

La untag-certificate-authority commande suivante supprime les balises de l'autorité de certification privée identifiée par leARN.

aws acm-pca untag-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-123456789012 --tags Key=Purpose,Value=Website

L'exemple de code suivant montre comment utiliserupdate-certificate-authority.

AWS CLI

Pour mettre à jour la configuration de votre autorité de certification privée

La update-certificate-authority commande suivante met à jour le statut et la configuration de l'autorité de certification privée identifiée par leARN.

aws acm-pca update-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-west-2:123456789012:certificate-authority/12345678-1234-1234-1234-1232456789012 --revocation-configuration file://C:\revoke_config.txt --status "DISABLED"