Skip to content

Commit 6f5dcb2

Browse files
[DNS] New cf-proxied tag and use in import/export (#18858)
* Clear out lists of non-proxiable records * Adjust FQDM trailing period from explanatory to restrictive * Fix cf-flatten tag name and create placeholders for new one * Re-structure with h4s and add explanation for cf-proxied * Add example for the cf- tags
1 parent 18cba31 commit 6f5dcb2

File tree

5 files changed

+28
-33
lines changed

5 files changed

+28
-33
lines changed

src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Make a `PATCH` request to the [Update DNS Settings](/api/resources/dns/subresour
4747

4848
Paid zones also have the option of flattening specific `CNAME` records.
4949

50-
If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten` will be added to the respective flattened `CNAME` records in your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without losing this configuration.
50+
If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten-cname` will be added to the respective flattened `CNAME` records in your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without losing this configuration.
5151

5252
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
5353

src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx

Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Use import and export to have more control over your DNS records and make proces
1919

2020
Create a [BIND zone file](https://en.wikipedia.org/wiki/Zone_file) for your domain. If you need help, use a [third-party tool](https://pgl.yoyo.org/as/bind-zone-file-creator.php).
2121

22-
If you are using certain record types — for example, `CNAME`, `DNAME`, `MX`, `NS`, `PTR`, or `SRV` records — make sure that the **content** of those records contains fully qualified domain names (which end in a trailing period like `example.com.`). For more details, refer to [RFC 1035](https://www.rfc-editor.org/rfc/rfc1035#section-5.1) or this [post on Stack Exchange](https://superuser.com/questions/348282/fqdn-format-in-bind-zone#348284).
22+
If you are using certain record types — for example, `CNAME`, `DNAME`, `MX`, `NS`, `PTR`, or `SRV` records — make sure that the **content** of those records contains fully qualified domain names ending in a trailing period (as in `example.com.`). For more details, refer to [RFC 1035](https://www.rfc-editor.org/rfc/rfc1035#section-5.1) or this [post on Stack Exchange](https://superuser.com/questions/348282/fqdn-format-in-bind-zone#348284).
2323

2424
### Import zone file to Cloudflare
2525

@@ -90,9 +90,29 @@ f.example.com. 60 IN A 1.1.1.1 ; this is the comment cf_tags=tag1:value1,ta
9090
g.example.com. 60 IN A 1.1.1.1
9191
```
9292

93-
### cf-flatten tag
93+
### Reserved cf- tags
9494

95-
If you are on a paid zone and want to use [Per-record CNAME flattening](/dns/cname-flattening/set-up-cname-flattening/#per-record), use the tag `cf-flatten` next to each flattened CNAME record in your zone file. On export, this tag is automatically added to reflect the record configuration that you have on your zone.
95+
When exporting and importing, special tags starting by `cf-` allow you to control specific Cloudflare configurations. On export, these tags are automatically added to reflect the current configuration for each record on your zone.
96+
97+
```txt title="Records with cf- tags example"
98+
;; CNAME Records
99+
a.cloudflaredocs.com. 1 IN CNAME example.com. ; cf_tags=test:1,cf-flatten-cname
100+
b.cloudflaredocs.com. 1 IN CNAME example.com. ; cf_tags=cf-proxied:false
101+
c.cloudflaredocs.com. 1 IN CNAME example.com. ; cf_tags=tag-without-value,cf-proxied:true
102+
```
103+
104+
#### cf-proxied
105+
106+
On export, [proxied DNS records](/dns/manage-dns-records/reference/proxied-dns-records/#proxied-records) will present a tag `cf-proxied:true` while DNS-only records will have this tag set to `cf-proxied:false`.
107+
108+
When importing zone files, the value in the `cf-proxied` tag will take precedence in determining whether a record should be proxied. This means that:
109+
110+
- If the tag is present, its value will be considered for the respective record regardless of the **Proxy imported DNS records** option being selected (via dashboard), or the `proxied` parameter being generally set to `true` or `false` (via API).
111+
- If the tag is absent, the proxied status will fall back to the general import option, meaning **Proxy imported DNS records** selected or not (via dashboard) or the `proxied` parameter set to `true` or `false` (via API).
112+
113+
#### cf-flatten-cname
114+
115+
If you are on a paid zone and want to use [Per-record CNAME flattening](/dns/cname-flattening/set-up-cname-flattening/#per-record), use the tag `cf-flatten-cname` next to each flattened CNAME record in your zone file. On export, this tag is automatically added to reflect the record configuration that you have on your zone.
96116

97117
## DNS zone file directives
98118

src/content/docs/dns/manage-dns-records/reference/record-attributes.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Create or edit record attributes just like any other aspect of DNS records, whet
5151

5252
You can also add or edit attributes by [exporting and re-importing](/dns/manage-dns-records/how-to/import-and-export/#dns-record-attributes) your records, or using the [Batch record changes API](/dns/manage-dns-records/how-to/batch-record-changes/#use-the-api).
5353

54-
When exporting and importing, a special tag `cf-flatten` allows you to control [CNAME flattening for individual records](/dns/cname-flattening/set-up-cname-flattening/#per-record). On export, this tag is automatically added to reflect the record configuration you have on your zone.
54+
When exporting and importing, special tags starting by `cf-` allow you to control specific Cloudflare configurations. On export, these tags are automatically added to reflect the current configuration for each record on your zone. Refer to [reserved cf- tags](/dns/manage-dns-records/how-to/import-and-export/#reserved-cf--tags) for details.
5555

5656
***
5757

src/content/docs/dns/troubleshooting/faq.mdx

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -61,15 +61,7 @@ If you are an Enterprise customer and require more DNS records, contact your acc
6161

6262
## Which record types does Cloudflare not proxy?
6363

64-
Cloudflare does not proxy the following record types:
65-
66-
- `LOC`
67-
- `MX`
68-
- `NS`
69-
- `SPF`
70-
- `TXT`
71-
- `SRV`
72-
- `CAA`
64+
Only `A`, `AAAA`, and `CNAME` records can be proxied. Cloudflare will not proxy any other [DNS record types](/dns/manage-dns-records/reference/dns-record-types/).
7365

7466
---
7567

src/content/partials/dns/limitations.mdx

Lines changed: 2 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,10 @@ import { Render } from "~/components"
77

88
#### Proxy eligibility
99

10-
By default, `A`, `AAAA`, and `CNAME` DNS records that serve `HTTP/HTTPS` traffic can be proxied.
10+
Only `A`, `AAAA`, and `CNAME` DNS records can be proxied.
1111

1212
If you encounter a `CNAME` record that you cannot proxy — usually associated with another CDN provider — a proxied version of that record will cause connectivity errors. Cloudflare is purposely preventing that record from being proxied to protect you from a misconfiguration.
1313

14-
The following types of DNS records may be in your DNS configuration, but cannot be proxied:
15-
16-
* `CAA`
17-
* `DKIM`
18-
* `DMARC`
19-
* `DNSKEY`
20-
* `DS`
21-
* `HTTPS`
22-
* `MX`
23-
* `NS`
24-
* `PTR`
25-
* `SOA`
26-
* `SPF`
27-
* `SRV`
28-
* `SVCB`
29-
* `TXT`
30-
3114
#### Ports and protocols
3215

3316
To proxy `HTTP/HTTPS` traffic on [non-standard ports](/fundamentals/reference/network-ports/) or to proxy a `TCP-` or `UDP-` based application, use [Cloudflare Spectrum](/spectrum/).
@@ -47,5 +30,5 @@ For enhanced security, we recommend rolling your origin IP addresses at your hos
4730

4831
#### Windows authentication
4932

50-
Because Microsoft Integrated Windows Authentication, NTLM, and Kerberos violate HTTP/1.1 specifications, they are not compatible with proxied DNS records.
33+
Because Microsoft Integrated Windows Authentication, NTLM, and Kerberos violate HTTP/1.1 specifications, they are not compatible with proxied DNS records.
5134
:::

0 commit comments

Comments
 (0)