Skip to content

Commit c82c12d

Browse files
committed
Adds usage documentation
1 parent 12a0833 commit c82c12d

File tree

1 file changed

+48
-1
lines changed

1 file changed

+48
-1
lines changed

README.md

Lines changed: 48 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,49 @@
11
# terraform-cloudflare-no-email
2-
SPF, DKIM and DMARC records for zones with no MX entries.
2+
3+
SPF, DKIM and DMARC records for zones which do not send email.
4+
5+
This creates a `cloudflare_record` resource for SPF, DKIM and DMARC of the given `zone_id`.
6+
7+
The SPF and DMARC policies are set to reject all and you must provide an email address for DMARC Aggregate and Failure reports, through the `dmarc_rua` and `dmarc_ruf` variables respectively.
8+
9+
## Usage
10+
11+
```terraform
12+
13+
resource "cloudflare_zone" "example_com" {
14+
zone = "example.com"
15+
}
16+
17+
module {
18+
source = "rsclarke/no-email/cloudflare"
19+
20+
zone_id = cloudflare_zone.example_com.id
21+
dmarc_rua = ["[email protected]"]
22+
23+
}
24+
```
25+
26+
## Requirements
27+
28+
| Name | Version |
29+
|------|---------|
30+
| terraform | `~> 0.14.0` |
31+
| cloudflare | `>= 2.0` |
32+
33+
## Providers
34+
35+
| Name | Version |
36+
|------|---------|
37+
| cloudflare | `>= 2.0` |
38+
39+
## Inputs
40+
41+
| Name | Description | Type | Required |
42+
|------|-------------|------|:--------:|
43+
| zone_id | Cloudflare Zone ID | `string` | yes |
44+
| dmarc_rua | Email addresses for DMARC Aggregate reports (excluding `mailto:`), at least one and contains the `@` symbol. | `list(string)` | yes |
45+
| dmarc_rua | Email addresses for DMARC Failure (or Forensic) reports (excluding `mailto:`), at least one and contains the `@` symbol. | `list(string)` | yes |
46+
47+
## Outputs
48+
49+
This module does not expose any ouputs.

0 commit comments

Comments
 (0)