Skip to content
v2.277.0

ViewerCertificateOptions Struct ​

Example ​

ts
    const s3BucketSource = new s3.Bucket(this, 'Bucket');

    const distribution = new cloudfront.CloudFrontWebDistribution(this, 'AnAmazingWebsiteProbably', {
      originConfigs: [{
        s3OriginSource: { s3BucketSource },
        behaviors: [{ isDefaultBehavior: true }],
      }],
      viewerCertificate: cloudfront.ViewerCertificate.fromIamCertificate(
        'certificateId',
        {
          aliases: ['example.com'],
          securityPolicy: cloudfront.SecurityPolicyProtocol.SSL_V3, // default
          sslMethod: cloudfront.SSLMethod.SNI, // default
        },
      ),
    });
python
s3_bucket_source = s3.Bucket(self, "Bucket")

distribution = cloudfront.CloudFrontWebDistribution(self, "AnAmazingWebsiteProbably",
    origin_configs=[cloudfront.aws_cloudfront.SourceConfiguration(
        s3_origin_source=cloudfront.aws_cloudfront.S3OriginConfig(s3_bucket_source=s3_bucket_source),
        behaviors=[cloudfront.aws_cloudfront.Behavior(is_default_behavior=True)]
    )],
    viewer_certificate=cloudfront.ViewerCertificate.from_iam_certificate("certificateId",
        aliases=["example.com"],
        security_policy=cloudfront.SecurityPolicyProtocol.SSL_V3,  # default
        ssl_method=cloudfront.SSLMethod.SNI
    )
)
java
Bucket s3BucketSource = new Bucket(this, "Bucket");

CloudFrontWebDistribution distribution = CloudFrontWebDistribution.Builder.create(this, "AnAmazingWebsiteProbably")
        .originConfigs(List.of(SourceConfiguration.builder()
                .s3OriginSource(S3OriginConfig.builder().s3BucketSource(s3BucketSource).build())
                .behaviors(List.of(Behavior.builder().isDefaultBehavior(true).build()))
                .build()))
        .viewerCertificate(ViewerCertificate.fromIamCertificate("certificateId", ViewerCertificateOptions.builder()
                .aliases(List.of("example.com"))
                .securityPolicy(SecurityPolicyProtocol.SSL_V3) // default
                .sslMethod(SSLMethod.SNI)
                .build()))
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
var s3BucketSource = new Bucket(this, "Bucket");

var distribution = new CloudFrontWebDistribution(this, "AnAmazingWebsiteProbably", new CloudFrontWebDistributionProps {
    OriginConfigs = new [] { new SourceConfiguration {
        S3OriginSource = new S3OriginConfig { S3BucketSource = s3BucketSource },
        Behaviors = new [] { new Behavior { IsDefaultBehavior = true } }
    } },
    ViewerCertificate = ViewerCertificate.FromIamCertificate("certificateId", new ViewerCertificateOptions {
        Aliases = new [] { "example.com" },
        SecurityPolicy = SecurityPolicyProtocol.SSL_V3,  // default
        SslMethod = SSLMethod.SNI
    })
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
s3BucketSource := s3.NewBucket(this, jsii.String("Bucket"))

distribution := cloudfront.NewCloudFrontWebDistribution(this, jsii.String("AnAmazingWebsiteProbably"), &CloudFrontWebDistributionProps{
	OriginConfigs: []SourceConfiguration{
		&SourceConfiguration{
			S3OriginSource: &S3OriginConfig{
				S3BucketSource: *S3BucketSource,
			},
			Behaviors: []Behavior{
				&Behavior{
					IsDefaultBehavior: jsii.Boolean(true),
				},
			},
		},
	},
	ViewerCertificate: cloudfront.ViewerCertificate_FromIamCertificate(jsii.String("certificateId"), &ViewerCertificateOptions{
		Aliases: []*string{
			jsii.String("example.com"),
		},
		SecurityPolicy: cloudfront.SecurityPolicyProtocol_SSL_V3,
		 // default
		SslMethod: cloudfront.SSLMethod_SNI,
	}),
})

Properties ​

aliasesoptionalstring[]aliasesoptionaltyping.List[str]aliasesoptionalList<String>Aliasesoptionalstring[]Aliasesoptional*[]*string#
Domain names on the certificate (both main domain name and Subject Alternative names).
securityPolicyoptionalSecurityPolicyProtocolsecurity_policyoptionalSecurityPolicyProtocolsecurityPolicyoptionalSecurityPolicyProtocolSecurityPolicyoptionalSecurityPolicyProtocolSecurityPolicyoptionalSecurityPolicyProtocol#
The minimum version of the SSL protocol that you want CloudFront to use for HTTPS connections.

Default: SSLv3 if sslMethod VIP, TLSv1 if sslMethod SNI

CloudFront serves your objects only to browsers or devices that support at least the SSL version that you specify.

sslMethodoptionalSSLMethodssl_methodoptionalSSLMethodsslMethodoptionalSSLMethodSslMethodoptionalSSLMethodSslMethodoptionalSSLMethod= SSLMethod.SNI#
How CloudFront should serve HTTPS requests.

See the notes on SSLMethod if you wish to use other SSL termination types.