Skip to content

[Cloudflare One] Network policies ELI5#28910

Merged
Oxyjun merged 2 commits intoproductionfrom
jun/cf1/network-policies/eli5
Mar 11, 2026
Merged

[Cloudflare One] Network policies ELI5#28910
Oxyjun merged 2 commits intoproductionfrom
jun/cf1/network-policies/eli5

Conversation

@Oxyjun
Copy link
Contributor

@Oxyjun Oxyjun commented Mar 11, 2026

Improves readability and reduces jargon across all four network policies pages (/cloudflare-one/traffic-policies/network-policies/), based on an ELI5 clarity analysis.

  • Rewrite introduction (index.mdx): Replace dense paragraph with concrete language — "Network policies control TCP and UDP traffic" with examples (SSH, RDP, database connections). Separates identity-based capability into its own paragraph. Fixes misleading "traffic leaving your endpoints" phrasing.
  • Add caution for Network Override silent failure (index.mdx): The override destination rewrite happens even when the target IP is unreachable, with no log entry. This operational surprise is now a :::caution aside instead of buried prose.
  • Define SNI (index.mdx): Replace "The host whose SNI header Gateway will filter traffic against" with a plain explanation of what SNI is and how Gateway uses it.
  • Add CIDR example (index.mdx): Expand the CIDR notation note with a concrete example (10.0.0.0/8 matches 10.0.0.0 to 10.255.255.255).
  • Clarify Allow action (index.mdx): Explain that Allow is meaningful in a default-block configuration where it defines exceptions.
  • Explain policy evaluation order (common-policies.mdx): Add note that policies are evaluated top-to-bottom, first match wins. The two-policy patterns on this page depend on this but never stated it.
  • Explain filters: ["l4"] (common-policies.mdx): Add note in the API tab explaining that l4 means this is a network (Layer 4) policy.
  • Surface TLS pass-through security behavior (protocol-detection.mdx): Non-HTTP protocols inside TLS bypass network policy filtering. Previously a dense paragraph — now a :::caution aside with a descriptive title.
  • Strengthen SSH logging deprecation (ssh-logging.mdx): Upgrade from :::note to :::caution with explicit "Legacy feature" title and "deprecated" language.
  • Fix outdated UI navigation path (ssh-logging.mdx): Remove "Firewall policies" from nav path — current UI uses "Network" directly.

Rewrite introduction for clarity, add caution asides for critical
security behaviors, define jargon (SNI, CIDR, L4), explain policy
evaluation order, and strengthen legacy deprecation warnings.
@github-actions
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-one/traffic-policies/ @cloudflare/pcx-technical-writing

## 7. Create an Audit SSH policy

1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Traffic policies** > **Network** > **Firewall policies**.
1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Traffic policies** > **Network**.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the actual path for the dashboard?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch. The correct path is Traffic policies > Firewall policies, then selecting the Network tab — matching the canonical partial in src/content/partials/cloudflare-one/gateway/get-started/create-network-policy.mdx.

The original had **Traffic policies** > **Network** > **Firewall policies** which was also wrong. Fixed in f6bb5ea.

@Oxyjun Oxyjun force-pushed the jun/cf1/network-policies/eli5 branch from 0ae57c7 to 73ec0ee Compare March 11, 2026 11:06
@Oxyjun Oxyjun changed the title [Cloudflare One] Improve clarity of network policies documentation [Cloudflare One] Network policies ELI5 Mar 11, 2026
@Oxyjun Oxyjun self-assigned this Mar 11, 2026
@Oxyjun Oxyjun merged commit 8173101 into production Mar 11, 2026
13 checks passed
@Oxyjun Oxyjun deleted the jun/cf1/network-policies/eli5 branch March 11, 2026 17:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants