ACM / Client / export_certificate

export_certificate

ACM.Client.export_certificate(**kwargs)

Exports a private certificate issued by a private certificate authority (CA) for use anywhere. The exported file contains the certificate, the certificate chain, and the encrypted private 2048-bit RSA key associated with the public key that is embedded in the certificate. For security, you must assign a passphrase for the private key when exporting it.

For information about exporting and formatting a certificate using the ACM console or CLI, see Export a Private Certificate.

See also: AWS API Documentation

Request Syntax

response = client.export_certificate(
    CertificateArn='string',
    Passphrase=b'bytes'
)

Parameters:

• CertificateArn (string) –

  [REQUIRED]

  An Amazon Resource Name (ARN) of the issued certificate. This must be of the form:

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

• Passphrase (bytes) –

  [REQUIRED]

  Passphrase to associate with the encrypted exported private key.

  Note

  When creating your passphrase, you can use any ASCII character except #, $, or %.

  If you want to later decrypt the private key, you must have the passphrase. You can use the following OpenSSL command to decrypt a private key. After entering the command, you are prompted for the passphrase.

  openssl rsa -in encrypted_key.pem -out decrypted_key.pem

Return type:

dict

Returns:

Response Syntax

{
    'Certificate': 'string',
    'CertificateChain': 'string',
    'PrivateKey': 'string'
}

Response Structure

• (dict) –

  • Certificate (string) –

    The base64 PEM-encoded certificate.

  • CertificateChain (string) –

    The base64 PEM-encoded certificate chain. This does not include the certificate that you are exporting.

  • PrivateKey (string) –

    The encrypted private key associated with the public key in the certificate. The key is output in PKCS #8 format and is base64 PEM-encoded.

Exceptions

• ACM.Client.exceptions.ResourceNotFoundException

• ACM.Client.exceptions.RequestInProgressException

• ACM.Client.exceptions.InvalidArnException