-
Notifications
You must be signed in to change notification settings - Fork 9.8k
[BYOIP] Get-started updates #25122
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
+357
−65
Merged
[BYOIP] Get-started updates #25122
Changes from 29 commits
Commits
Show all changes
35 commits
Select commit
Hold shift + click to select a range
2fb9760
Import changes based on initial Gdoc draft
RebeccaTamachiro b4d0a6b
Bring previous version for easier reference
RebeccaTamachiro 79e6e41
Adjust formatting and add accepted RIRs list
RebeccaTamachiro 204a055
Add links to RIRs list and order alphabetically
RebeccaTamachiro e021ee9
Add WIP note to work depending on API docs or tabled for later
RebeccaTamachiro 3902eb7
Unnest delegate_loa_creation and use reserved docs IP
RebeccaTamachiro a9472e8
Adjust service bindings verbiage from overriding to adding
RebeccaTamachiro 51c1636
Add instruction to remove the token and placeholder for more detail
RebeccaTamachiro 379d1dd
Review and complete service binding instructions
RebeccaTamachiro 3522e53
Fix cidr example to match throughout and mark id line
RebeccaTamachiro e0164a8
Use h3s and horizontal lines for better skimmability
RebeccaTamachiro 0b19881
Add example for aggregated CIDR in additional bindings
RebeccaTamachiro 55486cd
Add subnet calculation example based on Spec
RebeccaTamachiro ad0f97d
Remove RADB and NTT so that registries lists are consistent
RebeccaTamachiro 7993b7b
Remove ARIN focus and make intro paragraphs more generic
RebeccaTamachiro ba5f967
Merge branch 'production'
RebeccaTamachiro 7221ad0
Make TabItem labels more uniform and fix missing monospace
RebeccaTamachiro 6279f6d
Move prefix validation details into separate page
RebeccaTamachiro b0b9f2d
Delete old get-started reference page
RebeccaTamachiro ae9bbc9
Import missing component in prefix-validation.mdx
RebeccaTamachiro 4a4ec87
Fill in prefix-validation.mdx using bash code block for now
RebeccaTamachiro de8c9a8
Bring new RPKI intro and updated IRR from dedicated branch
RebeccaTamachiro 06dafda
Link to address-maps from the get-started guide
RebeccaTamachiro 0e2ab81
LOA: acknowledge automation, link to service terms, and review loa.mdx
RebeccaTamachiro a768a81
IRR instances: remove outdated recommentations and improve text
RebeccaTamachiro eea878d
Overall review and text touch-ups
RebeccaTamachiro 5a4619b
Remove MT-specific notes and call out out-of-scope at the top
RebeccaTamachiro 8661cd2
Merge branch 'production'
RebeccaTamachiro ac86fa4
Text review and move auto-LOA from note to its own section
RebeccaTamachiro 1b55f41
Touch-up API examples after reviewing API staging docs
RebeccaTamachiro f36d124
Apply suggestion from code review
RebeccaTamachiro c68f106
Reword intro paragraph for clarity
RebeccaTamachiro ca152c6
Merge branch 'production' into rebecca/byoip-ss-onboarding
RebeccaTamachiro 27802c8
Merge branch 'production'
RebeccaTamachiro 2312be4
Use APIRequest for create and validate endpoints
RebeccaTamachiro 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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,17 +1,22 @@ | ||
| --- | ||
| title: Internet Routing Registry | ||
| title: Internet Routing Registry (IRR) | ||
| pcx_content_type: concept | ||
| sidebar: | ||
| order: 2 | ||
|
|
||
| label: Overview | ||
| group: | ||
| label: Internet Routing Registry | ||
| head: | ||
| - tag: title | ||
| content: IRR Overview | ||
| --- | ||
|
|
||
| The [Internet Routing Registry (IRR)](http://www.irr.net/index.html) is a globally distributed database of routing information. The IRR contains announced routes and routing policies in a common format, and network operators use this information to configure their backbone routers. | ||
| import { GlossaryDefinition } from "~/components"; | ||
|
|
||
| The IRR consists of many individual [routing registries](http://www.irr.net/docs/list.html), and some are managed by regional entities, such as APNIC, ARIN, and RIPE. Each routing registry contains IRR entries that provide information about IP prefixes and the [autonomous systems](https://www.cloudflare.com/learning/network-layer/what-is-an-autonomous-system/) authorized to announce them. | ||
| <GlossaryDefinition term="Internet Routing Registry (IRR)" prepend="The [Internet Routing Registry (IRR)](http://www.irr.net/index.html) is " /> | ||
|
|
||
| To announce your subnet prefixes, Cloudflare requires accurate IRR entries for your prefixes and autonomous system numbers (ASNs). | ||
| The IRR consists of many individual [routing registries](http://www.irr.net/docs/list.html), and some are managed by regional entities - such as the American Registry for Internet Numbers (ARIN), the Regional Internet Registry for Europe, Middle East and Central Asia (RIPE), and so on. Each routing registry contains IRR entries that provide information about IP prefixes and the [autonomous systems](https://www.cloudflare.com/learning/network-layer/what-is-an-autonomous-system/) authorized to announce them. | ||
|
|
||
| When you configure network infrastructure for services such as [Magic Transit](/magic-transit/about/), [verify your IRR entries](/byoip/concepts/irr-entries/best-practices/#verify-an-irr-entry). | ||
| To announce your subnet prefixes, Cloudflare requires accurate IRR entries for your prefixes and autonomous system numbers (ASNs). | ||
|
|
||
| For help with adding missing IRR entries or updating inaccurate entries, refer to the [best practices for IRR entries](/byoip/concepts/irr-entries/best-practices/). | ||
| When you configure network infrastructure for services such as [Magic Transit](/magic-transit/about/), or before onboarding your IP to Cloudflare, [verify your IRR entries](/byoip/concepts/irr-entries/best-practices/#verify-an-irr-entry). |
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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| --- | ||
| title: Route filtering and RPKI | ||
| pcx_content_type: concept | ||
| sidebar: | ||
| order: 2 | ||
| --- | ||
|
|
||
| import { GlossaryTooltip } from "~/components"; | ||
|
|
||
| As referred in the [IRR concept page](/byoip/concepts/irr-entries/), network operators use IRR records to configure backbone routers. In summary, it is the IRR records that provide information about IP prefixes and the <GlossaryTooltip term="autonomous system numbers (ASNs)">autonomous systems (ASN)</GlossaryTooltip> authorized to announce them. Then, network operators will apply filtering policies to avoid invalid announcements. | ||
|
|
||
| Considering this important role of IRR records, validation via Resource Public Key Infrastructure (RPKI) was introduced. With RPKI, the IP/ASN association is cryptographically validated before being passed on to the routers. | ||
|
|
||
| When registering your prefix under one of the five Regional Internet Registries (RIRs)[^1], you can generate a cryptographically-signed object called Route Origin Authorization (ROA). ROAs are public and you can use [Cloudflare's RPKI Portal](https://rpki.cloudflare.com/?view=validator) or other sources, such as [Routinator](https://rpki-validator.ripe.net/ui/), to check your prefixes. | ||
|
|
||
| [^1]: AFRINIC, APNIC, ARIN, LACNIC, and RIPE. |
Oops, something went wrong.
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.