From 1dea2adef9fae1e0907276e12b654ccb88ea9bb7 Mon Sep 17 00:00:00 2001 From: Max Phillips Date: Fri, 24 Jan 2025 17:14:27 -0600 Subject: [PATCH 1/6] Update example list --- public/cloudflare-one/static/list-test.csv | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/public/cloudflare-one/static/list-test.csv b/public/cloudflare-one/static/list-test.csv index 0c976b5cde3f877..433cd82f475ab68 100644 --- a/public/cloudflare-one/static/list-test.csv +++ b/public/cloudflare-one/static/list-test.csv @@ -1,2 +1,4 @@ -https://example.com -https://example1.com +value,description +192.0.2.0/24,This is an IP address range in CIDR format +198.51.100.0/24,This is also an IP address range +203.0.113.0/24,This is the third IP address range \ No newline at end of file From a0a38459e4c79d0aa5b66c4a43da5ee281bd4af9 Mon Sep 17 00:00:00 2001 From: Max Phillips Date: Fri, 24 Jan 2025 17:21:31 -0600 Subject: [PATCH 2/6] Update requirements --- src/content/partials/cloudflare-one/gateway/lists.mdx | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-one/gateway/lists.mdx b/src/content/partials/cloudflare-one/gateway/lists.mdx index 0e49c4f5f44da2f..25ee7d1414031f7 100644 --- a/src/content/partials/cloudflare-one/gateway/lists.mdx +++ b/src/content/partials/cloudflare-one/gateway/lists.mdx @@ -6,9 +6,12 @@ import { TabItem, Tabs } from "~/components"; ## Create a list from a CSV file -Here is a [sample CSV file](/cloudflare-one/static/list-test.csv) of URLs that you can use for testing. When formatting the CSV: +Here is a [sample CSV file](/cloudflare-one/static/list-test.csv) of URLs that you can use for testing. + +When formatting the CSV: - Each line should be a single entry. +- Use a comma to delimit the descriptions of values. For Zero Trust to recognize descriptions, you need to include a header row. - Trailing whitespaces are not allowed. - CRLF (Windows) and LF (Unix) line endings are valid. From 8bc908bcb2533367868f64090a77450e847c2d43 Mon Sep 17 00:00:00 2001 From: Max Phillips Date: Fri, 24 Jan 2025 17:27:00 -0600 Subject: [PATCH 3/6] Add CSV example --- src/content/partials/cloudflare-one/gateway/lists.mdx | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/src/content/partials/cloudflare-one/gateway/lists.mdx b/src/content/partials/cloudflare-one/gateway/lists.mdx index 25ee7d1414031f7..3804e3da8161a6f 100644 --- a/src/content/partials/cloudflare-one/gateway/lists.mdx +++ b/src/content/partials/cloudflare-one/gateway/lists.mdx @@ -6,9 +6,16 @@ import { TabItem, Tabs } from "~/components"; ## Create a list from a CSV file -Here is a [sample CSV file](/cloudflare-one/static/list-test.csv) of URLs that you can use for testing. +Here is a [sample CSV file](/cloudflare-one/static/list-test.csv) of IP address ranges to test uploads: -When formatting the CSV: +```csv +value,description +192.0.2.0/24,This is an IP address range in CIDR format +198.51.100.0/24,This is also an IP address range +203.0.113.0/24,This is the third IP address range +``` + +When formatting a CSV file for upload: - Each line should be a single entry. - Use a comma to delimit the descriptions of values. For Zero Trust to recognize descriptions, you need to include a header row. From c01d2db12f1ffef929869241395637ea415ca044 Mon Sep 17 00:00:00 2001 From: Max Phillips Date: Fri, 24 Jan 2025 17:28:23 -0600 Subject: [PATCH 4/6] Add newlines --- public/cloudflare-one/static/list-test.csv | 2 +- src/content/partials/cloudflare-one/gateway/lists.mdx | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/public/cloudflare-one/static/list-test.csv b/public/cloudflare-one/static/list-test.csv index 433cd82f475ab68..52d09011a5038e2 100644 --- a/public/cloudflare-one/static/list-test.csv +++ b/public/cloudflare-one/static/list-test.csv @@ -1,4 +1,4 @@ value,description 192.0.2.0/24,This is an IP address range in CIDR format 198.51.100.0/24,This is also an IP address range -203.0.113.0/24,This is the third IP address range \ No newline at end of file +203.0.113.0/24,This is the third IP address range diff --git a/src/content/partials/cloudflare-one/gateway/lists.mdx b/src/content/partials/cloudflare-one/gateway/lists.mdx index 3804e3da8161a6f..0b00f3199e27e91 100644 --- a/src/content/partials/cloudflare-one/gateway/lists.mdx +++ b/src/content/partials/cloudflare-one/gateway/lists.mdx @@ -13,6 +13,7 @@ value,description 192.0.2.0/24,This is an IP address range in CIDR format 198.51.100.0/24,This is also an IP address range 203.0.113.0/24,This is the third IP address range + ``` When formatting a CSV file for upload: From 5990a758641eddb7e9f5dafcaa7adb896b798ab4 Mon Sep 17 00:00:00 2001 From: Max Phillips Date: Mon, 27 Jan 2025 15:07:17 -0600 Subject: [PATCH 5/6] Improve wording --- .../partials/cloudflare-one/gateway/lists.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/content/partials/cloudflare-one/gateway/lists.mdx b/src/content/partials/cloudflare-one/gateway/lists.mdx index 0b00f3199e27e91..777c0077c621d82 100644 --- a/src/content/partials/cloudflare-one/gateway/lists.mdx +++ b/src/content/partials/cloudflare-one/gateway/lists.mdx @@ -6,9 +6,9 @@ import { TabItem, Tabs } from "~/components"; ## Create a list from a CSV file -Here is a [sample CSV file](/cloudflare-one/static/list-test.csv) of IP address ranges to test uploads: +To get started with uploading CSV lists, you can download a [sample CSV file](/cloudflare-one/static/list-test.csv) or copy the following into a file: -```csv +```csv title="list-test.csv" value,description 192.0.2.0/24,This is an IP address range in CIDR format 198.51.100.0/24,This is also an IP address range @@ -16,11 +16,11 @@ value,description ``` -When formatting a CSV file for upload: +When you format a CSV file for upload: -- Each line should be a single entry. -- Use a comma to delimit the descriptions of values. For Zero Trust to recognize descriptions, you need to include a header row. -- Trailing whitespaces are not allowed. +- Each line should be a single entry that includes a value and an optional description. +- A header row must be present for Zero Trust to recognize descriptions. +- Trailing whitespace characters are not allowed. - CRLF (Windows) and LF (Unix) line endings are valid. To upload the list to Zero Trust: From b008b639f87918abc1298601402201cc8cc09b89 Mon Sep 17 00:00:00 2001 From: Max Phillips Date: Mon, 27 Jan 2025 15:12:37 -0600 Subject: [PATCH 6/6] Describe list --- src/content/partials/cloudflare-one/gateway/lists.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-one/gateway/lists.mdx b/src/content/partials/cloudflare-one/gateway/lists.mdx index 777c0077c621d82..675d41ae077b9d9 100644 --- a/src/content/partials/cloudflare-one/gateway/lists.mdx +++ b/src/content/partials/cloudflare-one/gateway/lists.mdx @@ -6,7 +6,7 @@ import { TabItem, Tabs } from "~/components"; ## Create a list from a CSV file -To get started with uploading CSV lists, you can download a [sample CSV file](/cloudflare-one/static/list-test.csv) or copy the following into a file: +To test uploading CSV lists, you can download a [sample CSV file](/cloudflare-one/static/list-test.csv) of IP address ranges or copy the following into a file: ```csv title="list-test.csv" value,description