Skip to content

Commit bb58b9e

Browse files
[BYOIP] More information on MT and service bindings (#26458)
* Call out MT cannot be used as additional binding * Text touch-up and leverage tip Aside option * Add section for details on MT under #scope * Re-org existing and new info for cohesiveness * Call out CDN or Spectrum in the contract as prereq * Add instruction to contact account team * Edit requirement for better alignment with tutorial scope * Apply suggestion from code review Co-authored-by: Patricia Santa Ana <[email protected]> --------- Co-authored-by: Patricia Santa Ana <[email protected]>
1 parent e2044cb commit bb58b9e

File tree

3 files changed

+46
-16
lines changed

3 files changed

+46
-16
lines changed

src/content/docs/byoip/get-started.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -251,6 +251,10 @@ In the response body, the initial provisioning state should be `provisioning`.
251251

252252
Once a service binding is created (or deleted), it will take **four to six hours** to propagate across Cloudflare's global network.
253253

254+
:::note
255+
Magic Transit can only be used as default binding, spanning across your entire prefix. For more details, refer to [Service bindings scope](/byoip/service-bindings/#scope).
256+
:::
257+
254258
---
255259

256260
## 3. Advertise the BGP prefix

src/content/docs/byoip/service-bindings/index.mdx

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,14 @@ sidebar:
1111
description: In IP address management, service binding refers to the association of IPs to specific Cloudflare services. Review the available options and the API endpoints to set up service bindings.
1212
---
1313

14-
Service bindings are mappings that control whether traffic destined for a given IP address is routed to [Magic Transit](/magic-transit/), the CDN pipeline [^1], or the Spectrum pipeline [^2].
14+
import { DirectoryListing } from "~/components";
15+
16+
In IP address management, service bindings are mappings that control whether traffic destined for a given IP address is routed to [Magic Transit](/magic-transit/), the CDN pipeline [^1], or the Spectrum pipeline [^2].
17+
18+
Service binding operations are currently only available via API. You can find all endpoints and their specifications in the [Cloudflare API documentation](/api/resources/addressing/subresources/prefixes/subresources/service_bindings/). For detailed guidance, refer to the sections and tutorials linked below.
1519

1620
:::note
17-
Service binding operations are currently only available via API. You can find all endpoints and their specifications in the [Cloudflare API documentation](/api/resources/addressing/subresources/prefixes/subresources/service_bindings/).
21+
Service bindings take four to six hours to propagate across Cloudflare's global network after being created or deleted. Services for the IP addresses in scope are likely disrupted during this window.
1822
:::
1923

2024
## Scope
@@ -39,10 +43,28 @@ When a service binding of type `CDN` is applied, once the change has propagated
3943

4044
When a service binding of type `Spectrum` is applied, once the change has propagated across Cloudflare's global network (four to six hours), any TCP/UDP/HTTP requests are directed into the Spectrum pipeline for Layer 4 or Layer 7 processing.
4145

42-
## Limitations
46+
### Magic Transit
47+
48+
:::note
49+
Magic Transit can only be used as default binding, spanning across your entire prefix. You can then add CDN or Spectrum for smaller subnets but not the other way around.
50+
:::
51+
52+
The entire BYOIP prefix is primarily announced for Magic Transit, providing layer 3 DDoS protection and acceleration. Traffic not explicitly bound to CDN will flow through Magic Transit.
53+
54+
Also, traffic egressing to an IP in the prefix will always go to Magic Transit, even if there is an overlapping binding for CDN or Spectrum. This allows customers who want to use the same IP as ingress IP and as origin IP to do so.
55+
56+
```mermaid
57+
flowchart LR
58+
accTitle: Cloudflare as a reverse proxy
59+
accDescr: Diagram showing Cloudflare's network between clients and the origin server.
60+
A[Client] --ingress--> B((Cloudflare))--egress--> C[(Origin server)]
61+
```
62+
63+
When adding a service binding for a given IP address, it must be either a CDN service binding or a Spectrum service binding. It is not possible (or necessary) to bind both services.
64+
65+
## Tutorials
4366

44-
- When adding a service binding for a given IP address, it must be either a CDN service binding or a Spectrum service binding. It is not possible (or necessary) to bind both services.
45-
- Once a service binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's global network. Services for the IP addresses in scope will likely be disrupted during this window.
67+
<DirectoryListing />
4668

4769
[^1]: Layer 7 HTTP-based
4870
[^2]: Layer 4 or Layer 7 HTTP with custom ports

src/content/docs/byoip/service-bindings/magic-transit-with-cdn.mdx

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -27,14 +27,18 @@ It is important to note that traffic routed to the CDN pipeline is protected at
2727

2828
## Before you begin
2929

30-
<Render
31-
file="service-bindings-prereqs"
32-
product="byoip"
33-
params={{
34-
pre_existing_product: "Magic Transit",
35-
added_product: "CDN",
36-
}}
37-
/>
30+
- Make sure your contract includes CDN according to your needs. If you find any issues related to subscription when following the steps below, reach out to your account team.
31+
32+
- Plan for what IPs will be used:
33+
34+
<Render
35+
file="service-bindings-prereqs"
36+
product="byoip"
37+
params={{
38+
pre_existing_product: "Magic Transit",
39+
added_product: "CDN",
40+
}}
41+
/>
3842

3943
## 1. Get account information
4044

@@ -67,8 +71,8 @@ You can choose between two different scopes:
6771
- Account-level: uses the address map for all proxied DNS records across all of the zones within an account.
6872
- Zone-level: uses the address map for all proxied DNS records within a zone.
6973

70-
:::note
71-
If you need to map only specific subdomains (and not all proxied DNS records) to specific IP addresses, you can use a [Subdomain setup](/dns/zone-setups/subdomain-setup/).
74+
:::tip
75+
If you need to map only specific subdomains (and not all proxied DNS records) to specific IP addresses, you can use a zone on [Subdomain setup](/dns/zone-setups/subdomain-setup/).
7276
:::
7377

7478
<Tabs syncKey="dashPlusAPI">
@@ -118,7 +122,7 @@ To create records with the API, use a [POST request](/api/resources/dns/subresou
118122
</TabItem>
119123
</Tabs>
120124

121-
:::note
125+
:::tip
122126
As you create the necessary DNS records, [Total TLS](/ssl/edge-certificates/additional-options/total-tls/) can help making sure that you have SSL/TLS certificates in place for all your hostnames.
123127
:::
124128

0 commit comments

Comments
 (0)