@aws-cdk/aws-ses

The CDK Construct Library for AWS Simple Email Service

This module is part of the AWS Cloud Development Kit project.

Email receiving

Create a receipt rule set with rules and actions: example of setting up a receipt rule set

Alternatively, rules can be added to a rule set:

const ruleSet = new ses.ReceiptRuleSet(this, 'RuleSet'):

const awsRule = ruleSet.addRule('Aws', {
  recipients: ['aws.com']
});

And actions to rules:

awsRule.addAction(
  new ses.ReceiptRuleSnsAction({
    topic
  });
);

When using addRule, the new rule is added after the last added rule unless after is specified.

More actions

Drop spams

A rule to drop spam can be added by setting dropSpam to true:

new ses.ReceiptRuleSet(this, 'RuleSet', {
  dropSpam: true
});

This will add a rule at the top of the rule set with a Lambda action that stops processing messages that have at least one spam indicator. See Lambda Function Examples.

Import and export receipt rule set and receipt rules

Receipt rule sets and receipt rules can be exported:

const ruleSet = new ReceiptRuleSet(this, 'RuleSet');
const rule = ruleSet.addRule(this, 'Rule', {
  recipients: ['[e-mail]']
});

const ruleSetRef = ruleSet.export();
const ruleRef = rule.export();

And imported:

const importedRuleSet = ses.ReceiptRuleSet.import(this, 'ImportedRuleSet', ruleSetRef);

const importedRule = ses.ReceiptRule.import(this, 'ImportedRule', ruleRef);

const otherRule = ses.ReceiptRule.import(this, 'OtherRule', {
  name: 'other-rule'
});

importedRuleSet.addRule('New', { // This rule is added after the imported rule
  after: importedRule,
  recipients: ['mydomain.com']
});

importedRuleSet.addRule('Extra', { // Added after the 'New' rule
  recipients: ['extra.com']
});

Receipt filter

Create a receipt filter:

new ses.ReceiptFilter(this, 'Filter', {
  ip: '1.2.3.4/16' // Will be blocked
})

A white list filter is also available:

new ses.WhiteListReceiptFilter(this, 'WhiteList', {
  ips: [
    '10.0.0.0/16',
    '1.2.3.4/16',
  ]
});

This will first create a block all filter and then create allow filters for the listed ip addresses.

Changelog

0.30.0 (2019-05-02)

Bug Fixes

• cdk-dasm: fix bin for cdk-dasm (#2383) (760f518)

Code Refactoring

• awslint: construct-base-is-private, resource-attribute (#2349) (973b506), closes #2426 #2409

Features

• cdk-test: check API compatibility (#2356) (1642925), closes #145
• codepipeline: allow creation of GitHub Pipelines without source trigger (#2332) (ed39a8c)
• elbv2: add TLS listener for NLB (#2122) (71d694f)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• s3.Bucket.domainName renamed to s3.Bucket.bucketDomainName.
• codedeploy.IXxxDeploymentConfig.deploymentConfigArn is now a property and not a method.
• ec2.SecurityGroupBase is now private
• ec2.VpcNetworkBase is now private
• kinesis.StreamBase is now private
• kms.EncryptionKeyBase is now private
• logs.LogGroupBase is now private
• ssm.ParameterBase is now private
• eks.ClusterBase is now private
• codebuild.ProjectBase is now private
• codecommit.RepositoryBase is now private
• codedeploy.ServerDeploymentGroupBase is now private
• eks.ClusterBase is now private
• lambda.LayerVersionBase is now private
• rds.DatabaseClusterBase is now private
• secretsmanager.SecretBase is now private
• ses.ReceiptRuleSetBase is now private
• codepipeline: the pollForSourceChanges property in GitHubSourceAction has been renamed to trigger, and its type changed from a boolean to an enum.