|
| 1 | +--- |
| 2 | +title: (REF) Get started |
| 3 | +pcx_content_type: get-started |
| 4 | +sidebar: |
| 5 | + order: 2 |
| 6 | +--- |
| 7 | + |
| 8 | +import { GlossaryTooltip } from "~/components"; |
| 9 | + |
| 10 | +Work with your account team to understand everything you need to ensure a smooth transition during the onboarding process. |
| 11 | + |
| 12 | +Cloudflare requires a service-specific configuration for your prefixes, as well as some requirements common to all BYOIP customers regardless of service type. |
| 13 | + |
| 14 | +## Requirements |
| 15 | + |
| 16 | +The following requirements are common to all products compatible with BYOIP. |
| 17 | + |
| 18 | +You must verify that your [Internet Routing Registry (IRR)](/byoip/concepts/irr-entries/) records are up to date and contain: |
| 19 | + |
| 20 | + - `route` or `route6` objects matching the exact prefixes you want to onboard |
| 21 | + - `origin` matching the correct ASN you want to onboard |
| 22 | + |
| 23 | +:::caution[RPKI validation] |
| 24 | +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. |
| 25 | +::: |
| 26 | + |
| 27 | +## Process overview |
| 28 | + |
| 29 | +Overall, the steps can be summarized as follows: |
| 30 | + |
| 31 | +1. You revise your [IRRs and ROAs](#requirements) (if applicable) to make sure they are correct. |
| 32 | +2. You prepare a [Letter of Agency (LOA)](/byoip/concepts/loa/) containing both the prefix you are authorizing Cloudflare to announce and which ASN they will be announced under. Cloudflare will present this to our transit partners as evidence that we are allowed to announce the route. |
| 33 | +3. You use the [Upload LOA Document](/api/resources/addressing/subresources/loa_documents/methods/create/) API endpoint to submit the letter under your account and the [Add Prefix](/api/resources/addressing/subresources/prefixes/methods/create/) endpoint to create the prefix in your account with the associated `loa_document_id`. |
| 34 | +4. After receiving the LOA, Cloudflare validates the [requirements](#requirements) and provisions the IPs. |
| 35 | +5. (Optional) You can use [prefix delegations](/byoip/concepts/prefix-delegations/) to share all or part of your prefix with another Cloudflare account. |
| 36 | +6. You use [service bindings](/byoip/service-bindings/)[^1] and [address maps](/byoip/address-maps/)[^2] to control how your IPs are used. |
| 37 | +7. You advertise or withdraw the BGP route for a prefix via the [BGP Prefixes API](/api/resources/addressing/subresources/prefixes/subresources/bgp_prefixes/). |
| 38 | + |
| 39 | +[^1]: Mappings that control through which pipeline traffic destined for a given IP address will be routed. |
| 40 | +[^2]: Mappings that specify which IP addresses should be used when Cloudflare responds to DNS queries for proxied hostnames. |
0 commit comments