SES Domain Identity Construct for AWS CDK

This package provides Constructs for provisioning & validating SES Domain Identity which can be used in SES.

Inspired from Automatic DNS-validated certificates using Route 53 of aws-cdk-lib/aws-certificatemanager package.

This package automatically validates SES Domain Identity like aws-cdk-lib/aws-certificatemanager does.

---

About CDK Compatibility

Now aws-cdk-ses-domain-identity has been migrated to CDK v2. The major version of aws-cdk-ses-domain-identity matches to compatible CDK version.

• For CDK v1 users: Use 1.x.x version
  • npm i aws-cdk-ses-domain-identity@1 --save
• For CDK v2 users: Use 2.x.x version
  • npm i aws-cdk-ses-domain-identity@latest --save
  • or npm i aws-cdk-ses-domain-identity@2 --save

Example

1import * as route53 from "aws-cdk-lib/aws-route53";
2import { DnsValidatedDomainIdentity } from "aws-cdk-ses-domain-identity";
3
4// ... (truncated)
5    const hostedZone = route53.HostedZone.fromLookup(this, 'HostedZone', {
6      domainName: 'example.com',
7      privateZone: false,
8    });
9
10    const identity = new DnsValidatedDomainIdentity(this, 'DomainIdentity', {
11      domainName: 'example.com',
12      dkim: true,
13      region: 'us-east-1',
14      hostedZone,
15    });
16// ... (truncated)

Constructs

DnsValidatedDomainIdentity

Initializer

1new DnsValidatedDomainIdentity(scope: Construct, id: string, props?: DnsValidatedDomainIdentityProps)

Construct Props

1interface DnsValidatedDomainIdentityProps {
2  /**
3   * Fully-qualified domain name to request a domain identity for.
4   */
5  readonly domainName: string;
6
7  /**
8   * Whether to configure DKIM on domain identity.
9   * @default true
10   */
11  readonly dkim?: boolean;
12
13  /**
14   * Route 53 Hosted Zone used to perform DNS validation of the request.  The zone
15   * must be authoritative for the domain name specified in the Domain Identity Request.
16   */
17  readonly hostedZone: route53.IHostedZone;
18  /**
19   * AWS region that will validate the domain identity. This is needed especially
20   * for domain identity used for AWS SES services, which require the region
21   * to be one of SES supported regions.
22   *
23   * @default the region the stack is deployed in.
24   */
25  readonly region?: string;
26
27  /**
28   * Role to use for the custom resource that creates the validated domain identity
29   *
30   * @default - A new role will be created
31   */
32  readonly customResourceRole?: iam.IRole;
33}

Properties

Name	Type	Description
identityArn	string	The ARN of the domain identity.

License

MIT

See full license on mooyoul.mit-license.org