You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[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
Copy file name to clipboardExpand all lines: src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ Make a `PATCH` request to the [Update DNS Settings](/api/resources/dns/subresour
47
47
48
48
Paid zones also have the option of flattening specific `CNAME` records.
49
49
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.
Copy file name to clipboardExpand all lines: src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx
+23-3Lines changed: 23 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Use import and export to have more control over your DNS records and make proces
19
19
20
20
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).
21
21
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).
23
23
24
24
### Import zone file to Cloudflare
25
25
@@ -90,9 +90,29 @@ f.example.com. 60 IN A 1.1.1.1 ; this is the comment cf_tags=tag1:value1,ta
90
90
g.example.com. 60 IN A 1.1.1.1
91
91
```
92
92
93
-
### cf-flatten tag
93
+
### Reserved cf- tags
94
94
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.
Copy file name to clipboardExpand all lines: src/content/docs/dns/manage-dns-records/reference/record-attributes.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -51,7 +51,7 @@ Create or edit record attributes just like any other aspect of DNS records, whet
51
51
52
52
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).
53
53
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.
Copy file name to clipboardExpand all lines: src/content/docs/dns/troubleshooting/faq.mdx
+1-9Lines changed: 1 addition & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -61,15 +61,7 @@ If you are an Enterprise customer and require more DNS records, contact your acc
61
61
62
62
## Which record types does Cloudflare not proxy?
63
63
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/).
Copy file name to clipboardExpand all lines: src/content/partials/dns/limitations.mdx
+2-19Lines changed: 2 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,27 +7,10 @@ import { Render } from "~/components"
7
7
8
8
#### Proxy eligibility
9
9
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.
11
11
12
12
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.
13
13
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
-
31
14
#### Ports and protocols
32
15
33
16
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
47
30
48
31
#### Windows authentication
49
32
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.
0 commit comments