包详细信息

aws-cdk-ses-domain-identity

mooyoul12.8kMIT2.2.0

Constructs for provisioning and referencing domain identities which can be used in SES RuleSets and Actions Construct.

aws, aws-cdk, aws-cdk-construct, aws-ses

自述文件

SES Domain Identity Construct for AWS CDK

Build Status Semantic Release enabled Renovate enabled MIT license

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

import * as route53 from "aws-cdk-lib/aws-route53";
import { DnsValidatedDomainIdentity } from "aws-cdk-ses-domain-identity";

// ... (truncated)
    const hostedZone = route53.HostedZone.fromLookup(this, 'HostedZone', {
      domainName: 'example.com',
      privateZone: false,
    });

    const identity = new DnsValidatedDomainIdentity(this, 'DomainIdentity', {
      domainName: 'example.com',
      dkim: true,
      region: 'us-east-1',
      hostedZone,
    });
// ... (truncated)

Constructs

DnsValidatedDomainIdentity

Initializer

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

Construct Props

interface DnsValidatedDomainIdentityProps {
  /**
   * Fully-qualified domain name to request a domain identity for.
   */
  readonly domainName: string;

  /**
   * Whether to configure DKIM on domain identity.
   * @default true
   */
  readonly dkim?: boolean;

  /**
   * Route 53 Hosted Zone used to perform DNS validation of the request.  The zone
   * must be authoritative for the domain name specified in the Domain Identity Request.
   */
  readonly hostedZone: route53.IHostedZone;
  /**
   * AWS region that will validate the domain identity. This is needed especially
   * for domain identity used for AWS SES services, which require the region
   * to be one of SES supported regions.
   *
   * @default the region the stack is deployed in.
   */
  readonly region?: string;

  /**
   * Role to use for the custom resource that creates the validated domain identity
   *
   * @default - A new role will be created
   */
  readonly customResourceRole?: iam.IRole;
}

Properties

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

License

MIT

See full license on mooyoul.mit-license.org

更新日志

2.2.0 (2024-01-13)

Bug Fixes

  • release: bypass commitlint hooks to prevent publish failure (31f3f13)

Features

2.0.0 (2022-02-22)

Features

BREAKING CHANGES

  • Requires CDK v2

1.1.0 (2022-02-22)

Features

  • add identityArn property (6c1b938), closes #8
  • update requestor function to use Node.js 14 (71decd1)

1.0.6 (2021-09-30)

Bug Fixes

  • refactor #30 with FQDN usage for Route53 record name (ace6085)
  • respect existing TXT records (#31) (8635dda)

1.0.5 (2021-05-08)

Bug Fixes

  • delete-record: removing the ommitting of required parameters from DELETE record (#16) (af62caa)

1.0.4 (2020-07-06)

Bug Fixes

  • iam: fix missing IAM action for setting DKIM enabled (ec9325f)

1.0.3 (2020-06-28)

Bug Fixes

  • iam: fix invalid IAM action name for querying SES Domain Validation (d693380)

1.0.2 (2020-06-12)

Bug Fixes

  • deps: fix invalid CDK version in peer dependency list (85e7d96)

1.0.1 (2020-06-12)

Bug Fixes

  • iam: add addtional required SES IAM actions (ca41f94)
  • typing: fix broken types location (9162f52)

1.0.0 (2020-06-09)

Features