← Cloudflare Network Firewall / cloudflare-network-firewall / packet-captures

Nastavení bucketu PCAP

Než budete moci zahájit úplné paket zachycení musíte nejprve nakonfigurovat úložiště, které může Cloudflare použít k nahrání vašich souborů. Nastavení úložiště není nutné pro ukázková zachycení paketů.

Jako cíl můžete nakonfigurovat bucket Amazon S3 nebo Google Cloud Platform. Můžete také použít R2 jako cíl pomocí API.

Naučte se nastavit bucket pro použití s úplným zachytáváním paketů.

Dále ověřte bucket a potvrďte vlastnictví.

Po počátečním nastavení bucketu musíte prostřednictvím ověření vlastnictví potvrdit, že bucket vlastníte. Jakmile bucket ověříte, můžete jej začít používat ke sběru úplných zachycení paketů.

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/pcaps/ownership \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "destination_conf": "'${bucket}'"
}'

{
	"result": {
		"id": "cc20c2d6c62e11ecbe646b173af3b6b9",
		"status": "pending",
		"submitted": "2022-04-22T18:54:13.397413Z",
		"validated": "",
		"destination_conf": "gs://bucket-test", // Ensure you use a bucket that you created and registered in the Cloudflare dashboard.
		"filename": "ownership-challenge-1234.txt"
	},
	"success": true,
	"errors": [],
	"messages": []
}

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/pcaps/ownership/validate \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "destination_conf": "'${bucket}'",
  "ownership_challenge": "'${ownership_text}'"
}'

{
	"result": {
		"id": "cc20c2d6c62e11ecbe646b173af3b6b9",
		"status": "success",
		"submitted": "2022-04-22T18:54:13.397413Z",
		"validated": "2022-04-27T14:54:46.440548Z",
		"destination_conf": "gs://<bucket-name>", // Ensure you use a bucket that you created and registered in the Cloudflare dashboard
		"filename": "ownership-challenge-1234.txt"
	},
	"success": true,
	"errors": [],
	"messages": []
}

Stav bucketu zobrazuje jednu z následujících možností:

• Úspěch: Bucket je plně ověřený a připravený k použití.
• Čeká na vyřízení: Byla zahájena odpověď na výzvu, ověření ale ještě čeká na dokončení. Ověření bucketu může trvat pět až deset minut.
• Selhalo: Úložiště se nepodařilo ověřit. Pokud k tomu dojde, zkontrolujte informace o vlastnictví.

Zobrazit seznam všech bucketů nakonfigurovaných ve vašem účtu.

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/pcaps/ownership \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"

{
	"result": [
		{
			"id": "9a993aa6c58711ec89d3037647342e63",
			"status": "success",
			"submitted": "2022-04-26T16:58:24.550762Z",
			"validated": "2022-04-26T17:01:18.426458Z",
			"destination_conf": "s3://test-bucket?region=us-east-1",
			"filename": "ownership-challenge-1234.txt"
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

Chcete-li se dozvědět, jak provádět zachytávání paketů, přečtěte si Shromáždit zachycené pakety.

Abyste mohli začít sbírat zachycení paketů pomocí R2, musíte ho nejprve správně nakonfigurovat. Všechny potřebné podrobnosti najdete v Cloudflare R2 dokumentace.

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

   Přejděte na Přehled ↗

2. Vyberte Vytvořit bucket.

3. Zadejte název bucketu > Vytvořit bucket.

4. Přejděte na stránku R2 Overview a vyberte Správa tokenů R2 API.

5. Vyberte Create API Token.

6. V Oprávnění, vyberte Object Read & Write. Nezapomeňte také vybrat Použít pouze na konkrétní buckety, a z rozbalovací nabídky vyberte bucket, který jste vytvořili pro soubory PCAP.

7. Vyberte Create API Token.

8. Ujistěte se, že jste zkopírovali Secret Access Key a Access Key ID hodnoty, protože je budete potřebovat v dalším kroku.

Vytvořte svůj počáteční požadavek na R2:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/pcaps/ownership \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "destination_conf": "r2://<BUCKET_NAME>?account-id=<ACCOUNT_ID>&access-key-id=<R2_ACCESS_KEY_ID>&secret-access-key=<R2_SECRET_ACCESS_KEY>"
}'

odpověď má "filename" parametr s názvem souboru, který Cloudflare zapsal do vašeho R2 bucketu. Tento soubor budete muset stáhnout pro další krok. Příklad:

{
	"errors": [],
	"messages": [],
	"result": {
		"destination_conf": "<YOUR_R2_BUCKET>",
		"filename": "ownership-challenge-9883874ecac311ec8475433579a6bf5f.txt",
		"id": "9883874ecac311ec8475433579a6bf5f",
		"status": "success",
		"submitted": "2020-01-01T08:00:00Z",
		"validated": "2020-01-01T08:00:00Z"
	},
	"success": true
}

Viz Ověřit bucket Pokyny API, kde najdete podrobnosti k celému procesu ověřit váš R2 bucket. Při zadávání cíle R2 pro toto ověření nezahrnujte do URL tajný klíč a přístupový klíč.