← Cloudflare BYOIP / byoip

Začínáme

Pokud chcete s Cloudflare používat vlastní IP adresy, ověřte si u svého account teamu, zda vaše smlouva tuto funkci pokrývá. Budete muset nakonfigurovat nastavení specifická pro služby, které chcete používat, a splnit standardní požadavky platné pro všechny zákazníky BYOIP.

Jakmile máte nastavené konfigurace účtu, projděte si následující části, kde se dozvíte, jak nastavit své prefixy BYOIP. Nezapomeňte si také projít BYOIP Service-Specific Terms ↗.

• Váš prefix musí být zaregistrován u jednoho z regionálních internetových registrů (RIR):

  • AFRINIC ↗
  • APNIC ↗
  • ARIN ↗
  • LACNIC ↗
  • RIPE ↗

• Také ověřte, že váš Internet Routing Registry (IRR) záznamy jsou aktuální a obsahují:

  • route nebo route6 objekty odpovídající přesným prefixům, které chcete zaregistrovat
  • origin odpovídající správnému ASN, které chcete zaregistrovat

• Musíte použít Ověření Resource Public Key Infrastructure (RPKI) a ujistěte se, že vaše ROA jsou přesná. Můžete použít RPKI portál Cloudflare ↗ a druhý zdroj, například Routinator ↗ a znovu zkontrolujte své prefixy.

• Pokud nejste obeznámeni s fungováním API Cloudflare, přečtěte si Základy. Ujistěte se, že máte potřebná oprávnění a že znáte ID svého účtu.

1. Použijte Koncový bod Add Prefix a vytvořte prefix v účtu Cloudflare, který má být vlastníkem prefixu BYOIP.

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes" \
	--request POST \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '{
		"cidr": "203.0.113.0/24",
		"asn": 13335,
		"delegate_loa_creation": true
	}'

 "result": {
	 "id": "72823e95d6c64d48a8111fec81179816",
    "created_at": "2025-02-25T00:34:11.423722Z",
    "modified_at": "2025-02-25T00:34:11.423722Z",
    "cidr": "203.0.113.0/24",
    "account_id": "654c5f71c324478cc9f68d60065d4620",
    "description": "",
    "approved": "P",
    "on_demand_enabled": false,
    "on_demand_locked": false,
    "advertised": null,
    "advertised_modified_at": null,
    "loa_document_id": "b9ff4afe312246a8b2e7324d98f40b23",
    "asn": 13335,
    "ownership_validation_token": "<OWNERSHIP_VALIDATION_TOKEN>",
    "delegate_loa_creation" : true,
    "irr_validation_state": "pending",
    "rpki_validation_state": "pending",
    "ownership_validation_state": "pending",
  }

2. Poznamenejte si id přiřazené k prefixu, který jste přidali. Bude použito v dalších krocích.

1. Vlastnictví prefixu ověřte jedním z následujících způsobů:

   1. Zkopírujte ownership_validation_token vrácené voláním API.
   2. Do záznamu IRR pro prefix, který zavádíte, přidejte následující řetězec buď do description nebo remarks pole. Nahraďte <OWNERSHIP_VALIDATION_TOKEN> skutečným tokenem, který jste zkopírovali v předchozím kroku.

   cf-validation: <OWNERSHIP_VALIDATION_TOKEN>

   1. Zvažte velikost prefixu, který chcete přenést do Cloudflare. Vzhledem k tomu, že standardní in-addr.arpa strom předpokládá delegace na hranicích oktetů nebo niblů. Pokud zavádíte prefixy, které s těmito hranicemi nejsou zarovnané, musíte prefix rozdělit na podsítě a pro každou z nich vytvořit odpovídající reverzní DNS zónu.

   Příklad

   Pro výpočet počtu menších podsítí, které potřebujete, použijte následující vzorec:

   2^(next boundary - current netmask)

   Pro 1.1.0.0/23, museli byste nastavit dvě (2^(24-23)) reverzní DNS zóny, jednu pro 1.1.0.0/24 a další pro 1.1.1.0/24.

   Pro 2001:0db8::/34, museli byste nastavit čtyři (2^(36-34)) reverzních DNS zón pro 2001:0db8::/36, 2001:0db8:1:/36, 2001:0db8:2::/36, a 2001:0db8:3::/36.

   2. Nastavte reverzní DNS zónu. Pokud pro DNS používáte Cloudflare, přečtěte si Reverzní DNS zóny. Pokud používáte jiného poskytovatele DNS, postupujte podle jeho pokynů.
   3. Vytvořte záznamy TXT pomocí cf-validation jako své name. Měly by vypadat podobně jako v tomto příkladu:

   cf-validation.<REVERSE_ZONE_ADDRESS> IN TXT <TOKEN>

   4. Aktualizujte nameservery u svého regionálního internetového registru (RIR). Přesné kroky pro aktualizaci nameserverů závisí na registru, který používáte.

2. Po provedení potřebných změn spusťte kontroly ověření pomocí koncového bodu Validate Prefix.

   Požadovaná oprávnění API tokenu

   Alespoň jeden z následujících oprávnění tokenu je povinné:

   • Magic Transit Write
   • IP Prefixes: Write
   Ověření prefixu

   curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/validate" \
   	--request POST \
   	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
   	--header "X-Auth-Key: $CLOUDFLARE_API_KEY"

Jakmile je ověření vlastnictví úspěšné, můžete token odstranit.

Jakmile projdou všechny validace (RPKI, IRR i vlastnictví), approved pole ve vašem prefixu vrátí "V". To znamená, že můžete pokračovat vytvořením vazeb služeb pro IP adresy¹.

V případě potřeby můžete použít Endpoint Prefix Details a zkontrolujte, zda validace neodhalila nějaké problémy. Pokud ano, proveďte potřebné změny a odešlete požadavek na opětovné spuštění validace. Podrobnosti najdete v Kontroly ověření prefixu s podrobnostmi.

Ostatním účtům můžete povolit používat část nebo celý váš prefix BYOIP. Více informací najdete v Delegování prefixů s podrobnostmi.

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/delegations" \
	--request POST \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '{
		"cidr": "<IP_PREFIX_TO_DELEGATE>",
		"delegated_account_id": "<ACCOUNT_ID>"
	}'

Ve správě IP adres vazby na služby mapují provoz směřovaný na danou IP adresu na službu Cloudflare, přes kterou má být směrován.

Při onboardingu vašich IP prefixů do Cloudflare musí existovat jedna vazba služby, která pokrývá celý váš prefix. Provoz směřující na danou IP adresu bude standardně směrován právě na tuto službu. Můžete také nakonfigurovat další vazby služeb jak je popsáno v dalším kroku.

1. Vytvořte GET požadavek na List Services endpoint a poznamenejte si id spojené se službou, kterou chcete použít.

2. (Volitelné) V případě potřeby použijte List Prefixes endpoint, abyste získali nebo potvrdili id spojené s vaším prefixem.
3. Vytvořte POST požadavek na Vytvoření vazby na službu endpoint a uveďte celý prefix BYOIP, který registrujete, a službu, jež se má použít pro váš výchozí binding.

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/bindings" \
	--request POST \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '{
		"cidr": "203.0.113.0/24",
		"service_id": "<DEFAULT_SERVICE>"
	}'

Odpovídající prefix BGP bude vytvořen automaticky. Před inzerováním prefixu počkejte pět hodin.

Pokud chcete provoz směrovat selektivně podle jednotlivých IP adres do CDN nebo Spectrum, můžete vytvořit další vazby na služby.

1. Naplánujte, které IP adresy získají dodatečnou vazbu. Cloudflare důrazně doporučuje implementovat service bindings prostřednictvím agregovaný CIDR blok, protože je to efektivnější než přidávat samostatné vazby pro nesouvislé CIDR bloky.

2. Vytvořte POST požadavek na Vytvoření vazby na službu endpoint a uveďte IP adresu, kterou chcete navázat na CDN nebo Spectrum. Zadejte odpovídající síťová maska podle potřeby.

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/bindings" \
	--request POST \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '{
		"cidr": "203.0.113.16/29",
		"service_id": "<SERVICE_ID>"
	}'

V těle odpovědi by měl být počáteční stav zřizování provisioning.

   {
     "errors": [],
     "messages": [],
     "success": true,
     "result": {
       "cidr": "203.0.113.16/29",
       "id": "<SERVICE_BINDING_ID>",
       "provisioning": {
         "state": "provisioning"
         },
       "service_id": "<SERVICE_ID>",
       "service_name": "<SERVICE_NAME>"
     }
   }

Jakmile je service binding vytvořen (nebo odstraněn), bude trvat čtyři až šest hodin než se rozšíří po celé globální síti Cloudflare.

Jakmile je automaticky vytvořeno (podle krok 2), jsou prefixy BGP nejprve staženy. Jakmile jsou všechna nastavení hotová, včetně mapy adres² pokud budete používat službu CDN, pokračujte inzercí BGP trasy pro váš prefix.

1. Použijte Update BGP prefix endpoint, abyste spustili inzerci.

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/bgp/prefixes/$BGP_PREFIX_ID" \
	--request PATCH \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '{
		"on_demand": {
				"advertised": true
		}
	}'