Skip to content

← All integrations

Cloud service

Imports the certificate into ACM in us-east-1 and puts it on the distribution.

The appliance runs the integration and connects to AWS CloudFront through AWS API over HTTPS on port 443. No service agent is installed on AWS CloudFront.

What happens

  1. The appliance connects to AWS CloudFront through AWS API on port 443.
  2. The certificate must cover every distribution alias. The integration imports into ACM us-east-1 and changes the viewer certificate with an ETag check, preserving TLS settings.
  3. The integration waits for Deployed and probes the first non-wildcard alias over TLS. Continued propagation or an unreachable edge is reported with the API confirmation.

Technical details

Connection
The integration runs on the appliance, which connects over HTTPS to AWS API, port 443. No service agent is installed.
What you need
AWS console > IAM > Users > Create user. Permissions > Add permissions > Create inline policy allowing acm:ImportCertificate, DescribeCertificate, ListCertificates and DeleteCertificate, and cloudfront:GetDistribution, GetDistributionConfig, UpdateDistribution and ListDistributions. Security credentials > Create access key. Enter the key ID and the secret (shown only once) here; CloudFront's certificates live in ACM in us-east-1.
Actions
Discovery, Installation, Verification, Rollback, Removal
Integrations
aws-cloudfront-api 2.0.0
Note
  • Restoration and rollback use deploy’s previous_state to select the previous viewer certificate. Later changes are preserved. Undeploy also deletes the imported ACM copy once no resources use it. No local backup directory or AWS CLI is required.

Next steps