INTEGRITY Dokumentace

Regionální hostitelské názvy

Regionální hostitelské názvy jsou nejběžnějším způsobem, jak využít Regional Services: přiřadíte proxovanému hostitelskému názvu region a Cloudflare pak provoz pro tento hostitelský název pomocí svých sdílených anycast IP adres směruje do datových center v daném regionu, kde probíhá ukončení TLS a zpracování. Další způsoby regionalizace provozu najdete v Způsoby využití Regional Services.

Regionální hostitelské názvy podporují spravované regiony. Pokud potřebujete vlastní region, použijte Regionalizované aplikace Spectrum nebo Regionalizované vazby IP místo toho.

Regionální hostitelské názvy můžete nakonfigurovat přes dashboard nebo přes API.

Konfigurace Regional Services v dashboardu

Chcete-li používat Regional Services, musíte nejprve v dashboardu vytvořit DNS záznam:

  1. V dashboardu Cloudflare přejděte na Záznamy stránce.

    Přejděte na Záznamy ↗
  2. Postupujte podle těchto kroků, abyste vytvoření DNS záznamu.

  3. Z Region rozevírací nabídce vyberte region, který chcete pro svou doménu použít. Tato hodnota se použije na všechny DNS záznamy se stejným názvem hostitele. To znamená, že pokud máte dva DNS záznamy se stejným názvem hostitele a u jednoho z nich změníte region, oba záznamy budou mít stejný region.

Podívejte se na tabulku na Dostupné regiony a podpora produktů pro úplný seznam dostupných regionů, jejich definic a podpory produktů

Konfigurace Regional Services přes API

Regional Services můžete použít také přes API.

Konfigurace Regional Services mohou upravovat uživatelé s rolí Super Administrator, Administrator nebo Domain Administrator. Role Domain Administrator Read Only v současné době nezahrnuje přístup pro čtení ke konfiguracím Regional Services. Použijte DNS: Read/Write oprávnění API pro /addressing/ endpointy pro čtení nebo zápis konfigurací Regional Services.

Zde je několik příkladů požadavků API.

Vypsat všechny dostupné regiony

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • DNS Read
  • DNS Write
Vypsat regiony
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/regional_hostnames/regions" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Odpověď
{
	"success": true,
	"errors": [],
	"result": [
		{
			"key": "ca",
			"label": "Canada"
		},
		{
			"key": "eu",
			"label": "Europe"
		}
	],
	"messages": []
}

Vytvořte nový záznam regionálního hostname

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • DNS Write
Create Regional Hostname
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"hostname": "ca.regional.ipam.rocks",
		"region_key": "ca"
	}'
Odpověď
{
	"success": true,
	"errors": [],
	"result": {
		"hostname": "ca.regional.ipam.rocks",
		"region_key": "ca",
		"created_on": "2023-01-13T23:59:45.276558Z"
	},
	"messages": []
}

Vypsat všechny regionální hostitelské názvy pro zónu nebo získat konkrétní záznam

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • DNS Read
  • DNS Write
Vypsat regionální hostitelské názvy
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Odpověď
{
	"success": true,
	"errors": [],
	"result": [
		{
			"hostname": "ca.regional.ipam.rocks",
			"region_key": "ca",
			"created_on": "2023-01-14T00:47:57.060267Z"
		}
	],
	"messages": []
}

Vypsat všechny regionální hostitelské názvy pro konkrétní zónu

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • DNS Read
  • DNS Write
Fetch Regional Hostname
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames/$HOSTNAME" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Odpověď
{
	"success": true,
	"errors": [],
	"result": {
		"hostname": "ca.regional.ipam.rocks",
		"region_key": "ca",
		"created_on": "2023-01-13T23:59:45.276558Z"
	},
	"messages": []
}

Upravit region pro konkrétní hostitelský název

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • DNS Write
Aktualizovat regionální hostitelský název
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames/$HOSTNAME" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"region_key": "eu"
	}'
Odpověď
{
	"success": true,
	"errors": [],
	"result": {
		"hostname": "ca.regional.ipam.rocks",
		"region_key": "eu",
		"created_on": "2023-01-13T23:59:45.276558Z"
	},
	"messages": []
}

Odstranění konfigurace regionu

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • DNS Write
Odstranění regionálního hostitelského názvu
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames/$HOSTNAME" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Odpověď
{
	"success": true,
	"errors": [],
	"result": null,
	"messages": []
}

Ověření regionální mapy pro Zero Trust

Chcete-li ověřit, že se vaše regionální mapa uplatňuje správně, zkontrolujte IngressColoName pole ve vašem Zero Trust Network Session logs. Toto pole zobrazuje název datového centra Cloudflare, kde provoz vstoupil do sítě. Protože se regionalizace uplatňuje ještě před Gateway, vstupní datové centrum bude ležet v rámci vaší nakonfigurované regionální mapy, což potvrzuje, že provoz je zpracováván ve správném regionu.

Podpora Terraformu

Regional Services můžete nakonfigurovat také pomocí Terraformu. Více informací najdete v cloudflare_regional_hostname zdroj ↗ v dokumentaci Terraform.