The CDK Construct Library for AWS::CertificateManager
Project description
AWS Certificate Manager Construct Library
---This package provides Constructs for provisioning and referencing certificates which can be used in CloudFront and ELB.
The following requests a certificate for a given domain:
# Example automatically generated. See https://github.com/aws/jsii/issues/826
cert = certmgr.Certificate(self, "Certificate",
domain_name="example.com"
)
After requesting a certificate, you will need to prove that you own the domain in question before the certificate will be granted. The CloudFormation deployment will wait until this verification process has been completed.
Because of this wait time, when using manual validation methods, it's better to provision your certificates either in a separate stack from your main service, or provision them manually and import them into your CDK application.
Email validation
Email-validated certificates (the default) are validated by receiving an email on one of a number of predefined domains and following the instructions in the email.
See Validate with Email in the AWS Certificate Manager User Guide.
DNS validation
If Amazon Route 53 is your DNS provider for the requested domain, the DNS record can be created automatically:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
Certificate(self, "Certificate",
domain_name="hello.example.com",
validation=CertificateValidation.from_dns(my_hosted_zone)
)
Otherwise DNS records must be added manually and the stack will not complete creating until the records are added.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
Certificate(self, "Certificate",
domain_name="hello.example.com",
validation=CertificateValidation.from_dns()
)
See also Validate with DNS in the AWS Certificate Manager User Guide.
When working with multiple domains, use the CertificateValidation.fromDnsMultiZone()
:
# Example automatically generated. See https://github.com/aws/jsii/issues/826
example_com = route53.HostedZone(self, "ExampleCom",
zone_name="example.com"
)
example_net = route53.HostedZone(self, "ExampelNet",
zone_name="example.net"
)
cert = acm.Certificate(self, "Certificate",
domain_name="test.example.com",
subject_alternative_names=["cool.example.com", "test.example.net"],
validation=acm.CertificateValidation.from_dns_multi_zone({
"text.example.com": example_com,
"cool.example.com": example_com,
"test.example.net": example_net
})
)
Use the DnsValidatedCertificate
construct for cross-region certificate creation:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
DnsValidatedCertificate(self, "CrossRegionCertificate",
domain_name="hello.example.com",
hosted_zone=my_hosted_zone,
region="us-east-1"
)
This is useful when deploying a stack in a region other than us-east-1
with a
certificate for a CloudFront distribution.
If cross-region is not needed, the recommended solution is to use the
Certificate
construct which uses a native CloudFormation implementation.
Importing
If you want to import an existing certificate, you can do so from its ARN:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
arn = "arn:aws:..."
certificate = Certificate.from_certificate_arn(self, "Certificate", arn)
Sharing between Stacks
To share the certificate between stacks in the same CDK application, simply
pass the Certificate
object between the stacks.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aws-cdk.aws-certificatemanager-1.55.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c458083c4829c35cd2efb202147799f29c8449bdce5d14275a07b052f1cb6c3 |
|
MD5 | 9356c85a549e0dc2caf658f1a2aa4a12 |
|
BLAKE2b-256 | 6f52eb0f27550f63db2559a8248e807bab580aea6fa03391fdf0c11d6dfd9f91 |
Hashes for aws_cdk.aws_certificatemanager-1.55.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b01b984a49039b43730748dbd0d3cc2ccda7992f15fa556daa8bb696dbb82301 |
|
MD5 | 596489746443bb611d79016915b7d3f3 |
|
BLAKE2b-256 | b90ae2e3012db1c98b06d8b75a2fafe76914ca9768549a25787441b869c225f1 |