Skip to content

Commit 940879d

Browse files
Update prefix-delegations.mdx
general update - add note about service bindings and prefix delegation
1 parent f5290a6 commit 940879d

File tree

1 file changed

+21
-15
lines changed

1 file changed

+21
-15
lines changed

src/content/docs/byoip/concepts/prefix-delegations.mdx

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,35 +6,41 @@ sidebar:
66

77
---
88

9-
BYOIP supports prefix delegations, which occur when a prefix owner account (Account A) allows another account (Account B) to use part or all of their prefix.
9+
BYOIP supports prefix delegations, which occur when a prefix owner’s account (Account A) allows another account (Account B) to use all or part of their prefix. The original prefix is still managed by the original account, but a delegation allows another account to use the delegated IP(s) on various services within that account.
1010

11-
The effect of a delegation depends on the service used with the prefix. Currently BYOIP + CDN and BYOIP + Spectrum support prefix delegations.
11+
See [service bindings](/byoip/service-bindings/) for more information on the services an IP can be bound to.
1212

1313
## CDN
1414

15-
CDN delegations only have an effect if you are using [Cloudflare for SaaS](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/) in addition to BYOIP + CDN.
1615

17-
In this example, Account A is using BYOIP + CDN and Cloudflare for SaaS. Account A can validate and serve traffic for a custom hostname on any of the IPs in its prefix. If Account A delegates some or all of the prefix to Account B, Account B may also validate and serve traffic for custom hostnames on those IPs as well. This is very useful if you use Cloudflare for SaaS but manage different configurations in different accounts. All the accounts can use the IPs through a delegation.
16+
CDN delegations allow you to use the IP(s) with [Address Maps](/byoip/address-maps/) or [Cloudflare for SaaS](/cloudflare-for-platforms/cloudflare-for-saas/) customers.
17+
18+
Address Maps would allow you to assign IPs either at the account level or zone level.
19+
20+
In the Cloudflare for SaaS example, Account A is using BYOIP + CDN and Cloudflare for SaaS. Account A can validate and serve traffic for a custom hostname on any of the IPs in its prefix. If Account A delegates some or all of the prefix to Account B, Account B may also validate and serve traffic for custom hostnames on those IPs as well. This is very useful if you use Cloudflare for SaaS but manage different configurations in different accounts. All the accounts can use the IPs through a delegation.
21+
22+
## Spectrum
23+
24+
If Account A delegates use of part or all of a prefix to Account B via a prefix delegation, Account B can also use the [Spectrum API](/spectrum/about/byoip/) with the IPs it was delegated access to.
25+
26+
**Example:** Account A is the primary owner of prefix 1.2.3.0/24. Account A delegates the use of 1.2.3.0/32 to Account B. Account B can now use the Spectrum API to create a Spectrum app with 1.2.3.0/32.
1827

1928
## API calls for prefix delegations
2029

2130
API calls for delegations can be found at [Prefix Delegations](/api/resources/addressing/subresources/prefixes/subresources/delegations/methods/list/).
2231

32+
:::note
33+
34+
The dashboard only supports delegation of an entire prefix. If you want to delegate less than the entire prefix, use the API.
35+
36+
To bind an IP from one service to another, use the API.
37+
:::
38+
2339
## Configure prefix delegations
2440

2541
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2642
2. Go to **IP Addresses** > **IP Prefixes**.
2743
3. Select **Edit** to modify a prefix. **Edit IP Prefixes** displays.
2844
4. At the bottom of the page, select **Add Delegation**. Other accounts that your user is a part of will auto-load when you create the delegation.
2945
5. Select **Save**.
30-
31-
:::note
32-
33-
The dashboard only supports delegation of an entire prefix. If you want to delegate less than the entire prefix, use the API.
34-
:::
35-
36-
## Spectrum
37-
38-
If Account A delegates use of part or all of a prefix to Account B via a prefix delegation, Account B can also use the [Spectrum API](/spectrum/about/byoip/) with the IPs it was delegated access to.
39-
40-
**Example:** Account A is the primary owner of prefix 1.2.3.0/24. Account A delegates the use of 1.2.3.0/32 to Account B. Account B can now use the Spectrum API to create a Spectrum app with 1.2.3.0/32.
46+
6. Bind IP to a service via the [Service Bindings API](/api/resources/addressing/subresources/prefixes/subresources/service_bindings/) as needed.

0 commit comments

Comments
 (0)