https://github.com/byu-oit/terraform-aws-ses
Configures and verifies an domain in AWS SES
https://github.com/byu-oit/terraform-aws-ses
Last synced: 5 months ago
JSON representation
Configures and verifies an domain in AWS SES
- Host: GitHub
- URL: https://github.com/byu-oit/terraform-aws-ses
- Owner: byu-oit
- License: apache-2.0
- Created: 2020-09-09T16:27:43.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2023-07-18T18:29:05.000Z (about 3 years ago)
- Last Synced: 2025-12-09T10:45:16.320Z (8 months ago)
- Language: HCL
- Size: 37.1 KB
- Stars: 0
- Watchers: 19
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# terraform-aws-ses
Configures and verifies a domain in AWS SES.
#### [New to Terraform Modules at BYU?](https://github.com/byu-oit/terraform-documentation)
## Usage
```hcl
data "aws_route53_zone" "mysubdomain" {
name = "mysubdomain.byu.edu."
}
module "ses" {
source = "github.com/byu-oit/terraform-aws-ses?ref=v1.0.0"
domain_name = "mysubdomain.byu.edu"
hosted_zone_id = data.aws_route53_zone.mysubdomain
}
```
## Requirements
* Terraform version 0.12.16 or greater
* You must already have a Route53 Hosted Zone setup for your domain, with proper NS routing setup in the parent DNS.
* You must already have an SES Rule Set created and active in your account.
## Email Verification
After applying this module, you will see a verification email inside the `mail_from_inbox_bucket_name` S3 bucket. Open that email and go to the verification link. You should then be able to use SES to send emails.
## Sandbox Mode
Your SES Domain starts off in sandbox mode. In sandbox mode, you will be restricted on how many emails you can send, and you can only send to verfied recipients. To get out of sandbox mode, you need to open a support ticket with AWS. There is a specific ticket type for SES limit increases that you should use.
## Inputs
| Name | Type | Description | Default |
| --- | --- | --- | --- |
| domain_name | string | The domain that you want to use for sending and receiving emails. | |
| hosted_zone_id | string | MX and verification records will be written here. The name of this Hosted Zone should match the `domain_name`. | |
| rule_set_name | string | Name of the active SES Rule Set in your account. | |
| mail_from_email_address | string | This email address will be created, and the verification process started. | reply@ |
| mail_from_inbox_bucket_name | string | The verification email will be delivered here. | ses-inbox- |
## Outputs
| Name | Type | Description |
| --- | --- | --- |
| Note | string | Description of manual steps that must be taken to complete SES setup. |
TODO: add more outputs.