Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . acm-pca ]

issue-certificate

Description

Uses your private certificate authority (CA) to issue a client certificate. This function returns the Amazon Resource Name (ARN) of the certificate. You can retrieve the certificate by calling the get-certificate function and specifying the ARN.

Note

You cannot use the ACM list-certificate-authorities function to retrieve the ARNs of the certificates that you issue by using ACM PCA.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  issue-certificate
--certificate-authority-arn <value>
--csr <value>
--signing-algorithm <value>
--validity <value>
[--idempotency-token <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--certificate-authority-arn (string)

The Amazon Resource Name (ARN) that was returned when you called create-certificate-authority . This must be of the form:

``arn:aws:acm:region :account :certificate-authority/12345678-1234-1234-1234-123456789012 ``

--csr (blob)

The certificate signing request (CSR) for the certificate you want to issue. You can use the following OpenSSL command to create the CSR and a 2048 bit RSA private key.

openssl req -new -newkey rsa:2048 -days 365 -keyout private/test_cert_priv_key.pem -out csr/test_cert_.csr

If you have a configuration file, you can use the following OpenSSL command. The usr_cert block in the configuration file contains your X509 version 3 extensions.

openssl req -new -config openssl_rsa.cnf -extensions usr_cert -newkey rsa:2048 -days -365 -keyout private/test_cert_priv_key.pem -out csr/test_cert_.csr

--signing-algorithm (string)

The name of the algorithm that will be used to sign the certificate to be issued.

Possible values:

  • SHA256WITHECDSA
  • SHA384WITHECDSA
  • SHA512WITHECDSA
  • SHA256WITHRSA
  • SHA384WITHRSA
  • SHA512WITHRSA

--validity (structure)

The type of the validity period.

Shorthand Syntax:

Value=long,Type=string

JSON Syntax:

{
  "Value": long,
  "Type": "END_DATE"|"ABSOLUTE"|"DAYS"|"MONTHS"|"YEARS"
}

--idempotency-token (string)

Custom string that can be used to distinguish between calls to the issue-certificate function. Idempotency tokens time out after one hour. Therefore, if you call issue-certificate multiple times with the same idempotency token within 5 minutes, ACM PCA recognizes that you are requesting only one certificate and will issue only one. If you change the idempotency token for each call, PCA recognizes that you are requesting multiple certificates.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Examples

To issue a private certificate

The issue-certificate command uses your private CA to issue a private certificate:

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

Output

CertificateArn -> (string)

The Amazon Resource Name (ARN) of the issued certificate and the certificate serial number. This is of the form:

``arn:aws:acm:region :account :certificate-authority/12345678-1234-1234-1234-123456789012 /certificate/286535153982981100925020015808220737245 ``