-
Notifications
You must be signed in to change notification settings - Fork 10k
[Learning paths] Magic Transit learning path for #22330
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 68 commits
Commits
Show all changes
69 commits
Select commit
Hold shift + click to select a range
0a78a51
added mt lp and concepts
marciocloudflare ca6a830
added what is mt
marciocloudflare a443ba0
refined content type
marciocloudflare ed95840
added benefits of mt
marciocloudflare b23a2b8
refined text
marciocloudflare 7807967
added mt lp json
marciocloudflare 34ef274
added mt lp icon
marciocloudflare c5e1249
refined text
marciocloudflare 15b3bcd
moved get started to partial
marciocloudflare 28f9a2a
get started scope config
marciocloudflare 4e4aa49
moved cf ips to partial
marciocloudflare 5c1f7e7
refined text
marciocloudflare d739295
refined text
marciocloudflare 7d50fe8
added JSX to cf ips partial
marciocloudflare 878589d
added render to gstarted cf ips
marciocloudflare 92dfb38
corrected cf ips params
marciocloudflare 6138e63
added lp param get started
marciocloudflare 60b07db
added router get started partial
marciocloudflare 638b28c
corrected loa text
marciocloudflare 5ae56a2
moved byoip loa to partial
marciocloudflare 15a3e0a
added loa partial
marciocloudflare 759c3fb
refined headers
marciocloudflare b5df45f
refined mss partial text
marciocloudflare 8f8f7d9
corrected ipsec mss value
marciocloudflare f6707e9
corrected get started headers
marciocloudflare 1e79a0d
added mt jsx for get started
marciocloudflare 95a52e3
added Lpath jsx to get started
marciocloudflare 4b1b015
corrected content type
marciocloudflare e90e161
added get started to lPath
marciocloudflare 68f2a5f
added config tunnels folder and overview
marciocloudflare 9aacb73
removed unnecessary import
marciocloudflare 12feae2
corrected title
marciocloudflare a8b1d16
added config tunnels to lPath
marciocloudflare f6dbfc3
config routes lPath
marciocloudflare b6b6a79
added ddos page
marciocloudflare cbb4259
moved ddos override partial file
marciocloudflare ad52f0e
added import
marciocloudflare 7223bd6
removed details from import
marciocloudflare 13200ce
added ddos partial
marciocloudflare 3cb7b82
move mt-advanced-ddos to advanced folder
marciocloudflare 44faf7e
corrected links mt-advanced-ddos
marciocloudflare 97cef81
added tcp
marciocloudflare 8497f72
created tcp intro and setup partials
marciocloudflare f3360e0
corrected links
marciocloudflare 1853f92
adv dns protection intro partial
marciocloudflare d8f73cd
replaced intro with partial
marciocloudflare 7c24146
created adv dns setup partial
marciocloudflare fae1b79
replaced setup with partial
marciocloudflare fd96c4d
added adv dns partials
marciocloudflare 10cad18
added mfirewall
marciocloudflare 91c6271
added notifications
marciocloudflare df2bbcb
added more details notifications
marciocloudflare 1fbb43e
added preflight checks
marciocloudflare 6b87337
refined preflight
marciocloudflare 2d22678
created adv prefixes partial
marciocloudflare 7549647
added render
marciocloudflare 6aa1b47
added troubleshooting content
marciocloudflare 3608f6d
replaced check with potential solutions
marciocloudflare ad5fcf3
corrected titles
marciocloudflare 3fb9559
fine tuning page
marciocloudflare 86ef9b7
removed fine tuning from troubleshooting
marciocloudflare 6984e6e
updated links for lPath
marciocloudflare 26693d0
added publicstats component
marciocloudflare afe24b4
refined language
marciocloudflare 2b306df
moved intro to jsx
marciocloudflare 71a59e7
changed content type
marciocloudflare 6a4b787
refined text
marciocloudflare 6b2b4dc
added bgp link
marciocloudflare ecbf11a
Apply suggestions from code review
marciocloudflare File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
10 changes: 10 additions & 0 deletions
10
src/content/docs/learning-paths/data-center-protection/advertise-prefixes.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| --- | ||
| title: Advertise prefixes | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 8 | ||
| --- | ||
|
|
||
| import { Render } from "~/components"; | ||
|
|
||
| <Render file="magic-transit/advertise-prefixes" product="networking-services" /> |
21 changes: 21 additions & 0 deletions
21
.../docs/learning-paths/data-center-protection/concepts/benefits-magic-transit.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| --- | ||
| title: Benefits of using Magic Transit | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 3 | ||
| --- | ||
|
|
||
| import { PublicStats } from "~/components"; | ||
|
|
||
| Magic Transit leverages Cloudflare's global anycast network. As of writing this guide, Cloudflare's global network spans <PublicStats id="data_center_cities" />, and has <PublicStats id="total_bandwidth" />. This bandwidth allows it to absorb all manners of attack that otherwise would overwhelm a typical data center or on-premise hardware Distributed Denial-of-Service (DDoS) appliances. | ||
|
|
||
| The number of DDoS attacks has been steadily increasing in recent years. In the first quarter of 2025, Cloudflared [mitigated 16.8 million network-layer DDoS attacks](https://blog.cloudflare.com/ddos-threat-report-for-2025-q1/#ddos-attacks-in-numbers). This represents a 397% increase quarter over quarter and a 509% increase year over year. | ||
|
|
||
| Other advantages of choosing Magic Transit: | ||
|
|
||
| - **Scalability**: As Cloudflare's global network expands, so does Magic Transit ability to absorb ever bigger DDoS attacks. | ||
| - **Ease of management**: Magic Transit offers centralized, cloud-based management tools that simplify configuration and monitoring of your network security. | ||
| - **Improvement of network performance**: Magic Transit steers traffic along tunnel routes based on priorities you define and uses equal-cost multi-path routing to provide load-balancing across tunnels with the same prefix and priority. | ||
| - **Integration with zero-trust services**: Magic Transit integrates with other Cloudflare products, including Cloudflare One's SASE offerings, Magic Firewall, and more. | ||
| - **Integration with CNI**: Directly connect your infrastructure to Cloudflare with CNI and bypass the Internet. Beyond a more reliable and secure experience, using CNI is an alternative to anycast GRE tunnels for getting traffic delivered to your infrastructure with a 1500-byte maximum transmission unit (MTU) handoff. | ||
| - **Real-time traffic visibility and alerting**: Monitor and analyze traffic patterns, threat activity, and mitigation actions in real time through Cloudflare's analytics and logging tools. Set up customized alerts to notify you of potential threats, enabling faster incident response and better-informed network decisions. |
15 changes: 15 additions & 0 deletions
15
src/content/docs/learning-paths/data-center-protection/concepts/index.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| title: Concepts | ||
| pcx_content_type: overview | ||
| sidebar: | ||
| order: 1 | ||
| --- | ||
|
|
||
| Learn core concepts about Magic Transit and its functionality, in order to protect your data centers from distributed denial-of-service (DDoS) attacks. | ||
|
|
||
| ## Objectives | ||
|
|
||
| By the end of this module you will be able to: | ||
| - Understand what Magic Transit is | ||
| - Why you should use it to protect your IP network | ||
|
|
18 changes: 18 additions & 0 deletions
18
...t/docs/learning-paths/data-center-protection/concepts/what-is-magic-transit.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,18 @@ | ||
| --- | ||
| title: What is Magic Transit? | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 2 | ||
| --- | ||
|
|
||
| Magic Transit is a network security and performance solution that offers Distributed Denial-of-Service (DDoS) protection, traffic acceleration, and more for on-premise, cloud-hosted, and hybrid networks. | ||
|
|
||
| Magic Transit works at Layer 3 of the OSI model, protecting entire IP networks from DDoS attacks. Instead of relying on local infrastructure that can be overwhelmed by large DDoS attacks, Magic Transit uses the [global Cloudflare Network](https://www.cloudflare.com/network/) to ingest and mitigate attacks close to their source. | ||
|
|
||
| Magic Transit delivers its connectivity, security, and performance benefits by serving as the front door to your IP network. This means it accepts IP packets destined for your network, processes them, and then forwards them to your origin infrastructure. | ||
|
|
||
| The Cloudflare network uses Border Gateway Protocol (BGP) to announce your company's IP address space, extending your network presence globally, and [anycast](/magic-transit/reference/tunnels/#anycast) to to absorb and distribute attack traffic. | ||
marciocloudflare marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| Once packets hit Cloudflare's network, traffic is inspected for attacks, filtered, steered, accelerated, and sent onward to your origin. Magic Transit users have two options for their implementation: ingress traffic or ingress and egress traffic. Users with an egress implementation will need to set up policy-based routing (PBR) or ensure default routing on their end forwards traffic to Cloudflare via tunnels. | ||
|
|
||
| For an in-depth explanation of Magic Transit, refer to [Magic Transit Reference Architecture](/reference-architecture/architectures/magic-transit/). | ||
39 changes: 39 additions & 0 deletions
39
src/content/docs/learning-paths/data-center-protection/configure-ddos.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,39 @@ | ||
| --- | ||
| title: Configure DDoS protection | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 4 | ||
| --- | ||
|
|
||
| import { Render } from "~/components" | ||
|
|
||
| Cloudflare DDoS protection automatically detects and mitigates Distributed Denial of Service (DDoS) attacks using its Autonomous Edge. Magic Transit customers have access to additional features, such as: | ||
|
|
||
| - [Advanced TCP protection](/ddos-protection/advanced-ddos-systems/overview/advanced-tcp-protection/) (disabled by default) | ||
| - [Advanced DNS protection (beta)](/ddos-protection/advanced-ddos-systems/overview/advanced-dns-protection/) | ||
|
|
||
| ## Create a DDoS override | ||
|
|
||
| <Render file="managed-rulesets/create-override" product="ddos-protection" /> | ||
|
|
||
| ## DDoS advanced protection | ||
|
|
||
| ### Advanced TCP Protection | ||
|
|
||
| <Render file="advanced-ddos/tcp-protection-intro" product="ddos-protection" /> | ||
|
|
||
| <Render file="advanced-ddos/mt-advanced-ddos-systems-onboarding" product="ddos-protection" /> | ||
|
|
||
| #### Setup | ||
|
|
||
| <Render file="advanced-ddos/tcp-setup" product="ddos-protection" /> | ||
|
|
||
| ### Advanced DNS Protection | ||
|
|
||
| <Render file="advanced-ddos/dns-protection-intro" product="ddos-protection" /> | ||
|
|
||
| <Render file="advanced-ddos/mt-advanced-ddos-systems-onboarding" product="ddos-protection" /> | ||
|
|
||
| #### Setup | ||
|
|
||
| <Render file="advanced-ddos/dns-setup" product="ddos-protection" /> |
22 changes: 22 additions & 0 deletions
22
...ning-paths/data-center-protection/configure-tunnels-routes/configure-routes.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| --- | ||
| title: Configure routes | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 2 | ||
| --- | ||
|
|
||
| import { Render } from "~/components" | ||
|
|
||
| <Render | ||
| file="routing/configure-routes" | ||
| product="networking-services" | ||
| params={{ | ||
| magicWord: "Magic Transit", | ||
| trafficSteeringPage: "/magic-transit/reference/traffic-steering/", | ||
| productName: "Magic Transit", | ||
| tunnelEndpoints: "/magic-transit/how-to/configure-tunnels/", | ||
| chooseWeights: "/magic-transit/reference/traffic-steering/#set-priority-and-weights-for-static-routes", | ||
| publicAsnMT: "[Public ASNs used for Magic Transit](/magic-transit/how-to/advertise-prefixes/#cloudflare-asn-vs-your-own-asn) are verified during the onboarding process.", | ||
| productGatewayOrEgress: "Magic Transit with Egress" | ||
| }} | ||
| /> |
26 changes: 26 additions & 0 deletions
26
...ing-paths/data-center-protection/configure-tunnels-routes/configure-tunnels.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| --- | ||
| title: Configure tunnels | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 1 | ||
| --- | ||
|
|
||
| import { GlossaryTooltip, Render } from "~/components"; | ||
|
|
||
| <Render file="routing/configure-tunnels" | ||
| product="networking-services" | ||
| params={{ | ||
| magicWord: "Magic Transit", | ||
| productName: "Magic Transit", | ||
| tunnelsAndEncapsulationPagePath: "/magic-transit/reference/tunnels/", | ||
| ciphersPagePath: "/magic-transit/reference/tunnels/#supported-configuration-parameters", | ||
| antiReplayPagePath: "/magic-transit/reference/anti-replay-protection/", | ||
| cniLink: "/magic-transit/network-interconnect/", | ||
| productPathDash: "Magic Transit > Configuration", | ||
| updateHCFrequencyPage: "/magic-transit/network-health/update-tunnel-health-checks/", | ||
| tunnelHealthChecksPage: "/magic-transit/reference/tunnel-health-checks/", | ||
| antiReplayPagePath: "/magic-transit/reference/anti-replay-protection/", | ||
| biVsUniHealthCheck: "unidirectional", | ||
| tunnelHealthDash: "/magic-transit/network-health/check-tunnel-health-dashboard/", | ||
| biVsUniHealthCheckDefaults: "For Magic Transit this option defaults to unidirectional" | ||
| }} /> |
15 changes: 15 additions & 0 deletions
15
...t/docs/learning-paths/data-center-protection/configure-tunnels-routes/index.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| title: Configure tunnels and routes | ||
| pcx_content_type: overview | ||
| sidebar: | ||
| order: 3 | ||
| --- | ||
|
|
||
| In this unit you will learn how to set up tunnels and routes to steer traffic. | ||
|
|
||
| ## Objectives | ||
|
|
||
| By the end of this module you will be able to: | ||
| - Create tunnels on both the Cloudflare side and your router side to connect to your infrastructure. | ||
| - Configure static routes or dynamic routes with BGP peering to steer your traffic via next-hop from Cloudflare's global network to your connected networks. | ||
|
|
15 changes: 15 additions & 0 deletions
15
src/content/docs/learning-paths/data-center-protection/enable-magic-firewall.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| title: Enable Magic Firewall | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 5 | ||
| --- | ||
|
|
||
|
|
||
| Magic Transit customers are automatically provided with the [standard features](/magic-firewall/plans/#standard-features) of Magic Firewall, Cloudflare's firewall-as-a-service product. | ||
|
|
||
| Cloudflare recommends creating a ruleset customized to your environment and needs. Without any rules configured, Magic Firewall will pass on all traffic after mitigations are applied to your tunnels. | ||
|
|
||
| The [Extended ruleset](/magic-firewall/best-practices/extended-ruleset/) is the best practice for reducing your attack surface by adopting a positive security model. If possible, use your current Edge Firewall policies to help you decide what ports to permit/block. | ||
|
|
||
| If you cannot use the extended ruleset, then use the [minimal ruleset guidance](/magic-firewall/best-practices/minimal-ruleset/) to create a customized ruleset to block known unwanted traffic and common vectors for attack. |
31 changes: 31 additions & 0 deletions
31
src/content/docs/learning-paths/data-center-protection/enable-notifications.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| title: Enable Notifications | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 6 | ||
| --- | ||
|
|
||
| import { Render } from "~/components"; | ||
|
|
||
| <Render | ||
| file="tunnel-health/magic-tunnel-health-alerts" | ||
| product="networking-services" | ||
| params={{ | ||
| magicWord: "Magic Transit", | ||
| productName: "Magic Transit", | ||
| magicTunnelHealthCheckCalculation: "/magic-transit/reference/magic-tunnels/", | ||
| networkAnalyticsPath: "/magic-transit/analytics/network-analytics/", | ||
| healthChecks: "/magic-transit/reference/tunnel-health-checks/", | ||
| }} | ||
| /> | ||
|
|
||
| ## Other notifications | ||
|
|
||
| Cloudflare also recommends that you enable the following account notifications for your Magic Transit service: | ||
|
|
||
| - Layer 3/4 DDoS Attack Alert | ||
| - Route Leak Detection Alert (to detect BGP Hijacks) | ||
| - (Optional) Advanced Layer 3/4 DDoS Attack Alert | ||
| - (Optional) Cloudflare status - Maintenance Notification (in case you want to be alerted regarding maintenance in specific Cloudflare data centers). | ||
|
|
||
| Refer to [Cloudflare Notifications](/notifications/) for more information on how to enable these notifications. |
10 changes: 10 additions & 0 deletions
10
src/content/docs/learning-paths/data-center-protection/get-started.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| --- | ||
| title: Get started | ||
| pcx_content_type: learning-unit | ||
| sidebar: | ||
| order: 2 | ||
| --- | ||
|
|
||
| import { Render } from "~/components" | ||
|
|
||
| <Render file="magic-transit/get-started" product="networking-services" params={{ magicWord: "Learning Path" }} /> |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.