INTEGRITY Dokumentace

Spravovat účty

Každý zákazník nebo tým, který používá Cloudflare, by měl mít vlastní účet. Zajistíte tím správné zabezpečení a přístup ke zdrojům. Každý účet funguje jako kontejner zón a dalších zdrojů. Podle svých potřeb můžete pro jednoho zákazníka nebo tým dokonce zřídit více účtů.

Když vytvoříte účet pomocí Tenant API, váš uživatel Cloudflare tento účet vlastní od jeho vytvoření přes průběžnou správu až po konečné odstranění.

Vytvořit účet

Každý zákazník nebo tým, který používá Cloudflare, by měl mít vlastní účet. Zajistíte tím správné zabezpečení a přístup ke zdrojům. Každý účet funguje jako kontejner zón a dalších zdrojů. Podle svých potřeb můžete pro jednoho zákazníka nebo tým dokonce zřídit více účtů.

Když vytvoříte účet pomocí Tenant API, váš uživatel Cloudflare tento účet vlastní od jeho vytvoření přes průběžnou správu až po konečné odstranění.

Chcete-li vytvořit účet v rámci vašeho tenantu pomocí dashboardu:

  1. Přihlaste se do Cloudflare dashboard ↗.
  2. Přejděte na Tenanti > Spravované účty.
  3. Vyberte Create Account.
  4. Zadejte Název účtu, Popis účtu, a Jednotka tenantu.
  5. Zvolte odpovídající předplatné účtu.
  6. Vyberte Přidat účet.

Chcete-li vytvořit účet pomocí API, proveďte POST požadavek na /accounts koncového bodu a uveďte následující hodnoty:

  • name string

    • Název účtu, který se zobrazuje v dashboardu Cloudflare.
  • type enum

    • Platné hodnoty jsou standard (výchozí) a enterprise. Pro samoobslužné zákazníky použijte standard. Pro firemní zákazníky použijte enterprise.
  • unit objekt

    • Informace týkající se jednotky Tenant.

    • id string

      • (volitelné) ID jednotky, ve které se má tento účet vytvořit. Je nutné jej uvést, pokud uživatel spravuje více tenantů. ID jednotky je unit_tag z vašeho podrobnosti tenantu.

Know-Your-Customer (volitelné)

Všechny parametry KYC jsou textová pole, mají limit 120 znaků a jsou volitelné, pokud je Tenant nevyžaduje.

  • business_name string

    • (volitelné) Název firmy přiřazené k tomuto účtu.
  • business_address string

    • (volitelné) Adresa firmy přiřazené k tomuto účtu.
  • business_email string

    • (volitelné) E-mail firmy přiřazené k tomuto účtu.
  • business_phone string

    • (volitelné) Telefonní číslo firmy přiřazené k tomuto účtu.
  • external_metadata string

    • (volitelné) Externí metadata tohoto účtu.
Požadavek
curl "https://api.cloudflare.com/client/v4/accounts" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "name": "<ACCOUNT_NAME>",
  "type": "standard"
}'

Úspěšný požadavek vrátí stav HTTP 200 a následující tělo odpovědi:

Odpověď
{
  "result": {
    "id": "2bab6ace8c72ed3f09b9eca6db1396bb",
    "name": "<ACCOUNT_NAME>",
    "type": "standard",
    "settings": {
      "enforce_twofactor": false
    }
  },
  "success": true,
  "errors": [],
  "messages": []
}

Požadavek s ID jednotky:

Požadavek
curl "https://api.cloudflare.com/client/v4/accounts" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "name": "<ACCOUNT_NAME>",
  "type": "standard",
  "unit": {
    "id": "1a2b3c4d5e6f7g8h"
  }
}'

Požadavek s ID jednotky a KYC:

Požadavek
curl "https://api.cloudflare.com/client/v4/accounts" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "name": "<ACCOUNT_NAME>",
  "type": "standard",
  "business_name": "Cloudflare",
  "business_email": "[email protected]",
  "business_address": "San Francisco",
  "business_phone": "1234567890",
  "external_metadata": "{'\''testKey'\'': '\''testValue'\''}",
  "unit": {
    "id": "1a2b3c4d5e6f7g8h"
  }
}'

Zobrazit účty

Když vytvoříte účet pomocí Tenant API, váš uživatel Cloudflare tento účet vlastní od jeho vytvoření přes průběžnou správu až po konečné odstranění.

Chcete-li pomocí dashboardu zobrazit účty vlastněné vaším tenantem:

  1. Přihlaste se do Cloudflare dashboard ↗.
  2. Přejděte na Tenanti > Spravované účty.

Chcete-li pomocí API načíst účty vlastněné vaším tenantem, odešlete GET požadavek na /accounts koncový bod.

Získáte zpět seznam všech účtů, které jste vytvořili, a také všech účtů, ke kterým váš uživatel již měl přístup.

Požadavek
curl https://api.cloudflare.com/client/v4/accounts \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"
Odpověď
{
	"result": [
		{
			"id": "a34bd6cc645a31486aa2ef71f1b9afb6",
			"name": "My Personal Account",
			"settings": {
				"enforce_twofactor": false
			}
		},
		{
			"id": "1b16db169c9cb7853009857198fae1b9",
			"name": "Created Account",
			"settings": {
				"enforce_twofactor": false
			}
		}
	],
	"result_info": {
		"page": 1,
		"per_page": 20,
		"total_pages": 1,
		"count": 2,
		"total_count": 2
	},
	"success": true,
	"errors": [],
	"messages": []
}

Aktualizovat účet

Chcete-li aktualizovat účet, odešlete PUT požadavek na /accounts/{account_id} koncový bod.

Odstranit účet

Chcete-li odstranit účet, který jste vytvořili, odešlete DELETE požadavek na /accounts/{account_id} koncový bod.

Odstranění účtu je trvalé a smaže všechny zóny a další prostředky patřící k danému účtu.

Požadavek
curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id} \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"

Úspěšný požadavek vrátí ID pro potvrzení operace:

Odpověď
{
	"result": {
		"id": "1b16db169c9cb7853009857198fae1b9"
	},
	"success": true,
	"errors": [],
	"messages": []
}