Skip to content

Commit a770e0e

Browse files
[BYOIP] Review get-started and IRR guidance (#18941)
* Specify requirements for IRR route, route6, and origin * Remove note on less specific prefixes being acceptable * Add callout for when using RPKI and link to CF portal * Nit: remove duplicated Overview h2 * Add glossary definition and tooltip for ROA * Adjust ROA definition * Remove dupe sentence and old button from Overview * Add second source for RPKI validation
1 parent dd16fb1 commit a770e0e

File tree

4 files changed

+15
-19
lines changed

4 files changed

+15
-19
lines changed

src/content/docs/byoip/concepts/irr-entries/best-practices.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -81,10 +81,6 @@ Add or update IRR entries when they meet any of these criteria:
8181
* The entry is incomplete or inaccurate — for example, when the route object does not show the correct origin.
8282
* The entry is complete but requires updating — for example, when they correspond to supernets but need to correspond to subnets used in Magic Transit.
8383

84-
You are strongly encouraged to verify IRR entries for the exact prefixes you will use to onboard with Cloudflare.
85-
86-
IRR entries for less specific prefixes are acceptable as long as you understand and accept the following risk: if you modify your IRR entries in the future (for example, by changing your ASN) and the IRR entry for the supernet no longer matches the prefix or origin mapping in your Magic Transit configuration, the prefix will have reduced reachability due to networks Cloudflare peers with automatically filtering the prefix. Having specific IRR entries helps minimize (but not entirely remove) this risk.
87-
8884
### IRR entry verification methods
8985

9086
To verify your prefix and ASN route, use the tools and methods outlined on the table below:

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

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,23 @@ import { GlossaryTooltip } from "~/components"
1111
To bring your own IPs, you must work with your account team to understand everything you need to ensure a smooth transition during the onboarding process.
1212

1313
:::note
14-
15-
BYOIP is ingress only.
14+
BYOIP is ingress only.
1615
:::
1716

18-
## Overview
19-
2017
Cloudflare requires a service-specific configuration for your prefixes, as well as some requirements common to all BYOIP customers regardless of service type. These requirements are common to all products compatible with BYOIP, such as [Magic Transit](/magic-transit/), [Spectrum](/spectrum/), and [CDN services](/cache/).
2118

2219
## Prerequisites
2320

2421
There are two major prerequisites before Cloudflare can begin onboarding your IP space.
2522

26-
1. You must verify your [Internet Routing Registry (IRR)](/byoip/concepts/irr-entries/) records are up to date with the correct prefix or ASN information.
27-
2. Cloudflare must receive a [Letter of Agency (LOA)](/byoip/concepts/loa/) to announce your prefixes, which we will share with our transit partners as evidence that we are allowed to announce the route.
23+
1. Cloudflare must receive a [Letter of Agency (LOA)](/byoip/concepts/loa/) to announce your prefixes, which we will share with our transit partners as evidence that we are allowed to announce the route.
24+
2. You must verify that your [Internet Routing Registry (IRR)](/byoip/concepts/irr-entries/) records are up to date and contain:
25+
- `route` or `route6` objects matching the exact prefixes you want to onboard
26+
- `origin` matching the correct ASN you want to onboard
2827

29-
Optionally, if you use the <GlossaryTooltip term="Resource Public Key Infrastructure (RPKI)">Resource Public Key Infrastructure (RPKI)</GlossaryTooltip> protocol to sign your routes, Cloudflare can help with this as well. Contact your account team if you are interested in using RPKI.
28+
:::caution[RPKI validation]
29+
You are not required to use <GlossaryTooltip term="Resource Public Key Infrastructure (RPKI)">Resource Public Key Infrastructure (RPKI)</GlossaryTooltip>. However, if you do, make sure your <GlossaryTooltip term="Route Origin Authorization (ROA)">ROAs</GlossaryTooltip> are accurate. You can use [Cloudflare's RPKI Portal](https://rpki.cloudflare.com/?view=validator) and a second source such as [Routinator](https://rpki-validator.ripe.net/ui/) to double check your prefixes.
30+
:::
3031

3132
After onboarding, [Border Gateway Protocol (BGP)](https://www.cloudflare.com/learning/security/glossary/what-is-bgp/) announcements for customer prefixes can be controlled with the [Dynamic Advertisement](/byoip/concepts/dynamic-advertisement/) API or via the Cloudflare dashboard.
3233

@@ -47,5 +48,5 @@ To protect your network using a Cloudflare IP address, contact your account mana
4748

4849
:::note
4950

50-
When you use a Cloudflare-managed IP space, you do not need to provide a Letter of Agency (LOA) and advertise your prefixes that are associated with bringing your own IP.
51+
When you use a Cloudflare-managed IP space, you do not need to provide a Letter of Agency (LOA) and advertise your prefixes that are associated with bringing your own IP.
5152
:::

src/content/docs/byoip/index.mdx

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,6 @@ import { LinkButton, Plan } from "~/components";
1212

1313
<Plan type="enterprise" />
1414

15-
With **Bringing Your Own IPs** (BYOIP), Cloudflare announces your IPs in all our locations. Use your IPs with Magic Transit, Spectrum, CDN services, or Gateway DNS.
15+
With **Bringing Your Own IPs** (BYOIP), Cloudflare announces your IPs in all our locations. Use your IPs with [Magic Transit](/magic-transit/), [Spectrum](/spectrum/), [CDN services](/cache/), or [Gateway DNS](/cloudflare-one/policies/gateway/dns-policies/).
1616

17-
BYOIP is compatible with [Magic Transit](/magic-transit/), [Spectrum](/spectrum/), [CDN services](/cache/), and [Gateway DNS](/cloudflare-one/connections/connect-devices/agentless/dns/locations/dns-resolver-ips/#bring-your-own-dns-resolver-ip).
18-
19-
{" "}
20-
<LinkButton variant="primary" href="/byoip/get-started/">
21-
Get started
22-
</LinkButton>
17+
Learn how to [get started](/byoip/get-started/).

src/content/glossary/byoip.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,10 @@ entries:
2323
general_definition: |-
2424
a cryptographic method of signing records that associate a route with an originating autonomous system number.
2525
26+
- term: Route Origin Authorization (ROA)
27+
general_definition: |-
28+
the RPKI-signed object that states an autonomous system is authorized to originate a particular IP address prefix or set of prefixes.
29+
2630
- term: Unicast Reverse Path Forwarding (uRPF)
2731
general_definition: |-
2832
a security feature that can prevent spoofing attacks.

0 commit comments

Comments
 (0)