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

Настройка бакета PCAP

Прежде чем вы сможете начать полный пакет захват, сначала настройте бакет, в который Cloudflare сможет загружать ваши файлы. Для выборочных захватов пакетов настраивать бакет не обязательно.

Вы можете настроить бакет Amazon S3 или Google Cloud Platform для использования в качестве цели. Вы также можете использовать R2 как цель через API.

Узнайте, как настроить бакет для использования с полными захватами пакетов.

Далее проверьте бакет и подтвердите владение им.

После первоначальной настройки бакета необходимо подтвердить владение бакетом с помощью проверки владения. После подтверждения бакета вы сможете использовать его для сбора полных захватов пакетов.

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": []
}

Статус bucket отображает один из следующих вариантов:

• Успешно: Бакет полностью подтверждён и готов к использованию.
• Ожидает: Отклик на проверочный запрос отправлен, но верификация ещё не завершена. Верификация бакета может занять от пяти до десяти минут.
• Сбой: Не удалось проверить бакет. Если это произошло, проверьте информацию о владении.

Просмотр списка всех buckets, настроенных в вашем аккаунте.

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": []
}

Чтобы узнать, как собирать захваты пакетов, см. Сбор захватов пакетов.

Чтобы начать собирать захваты пакетов через R2, сначала настройте его должным образом. Все необходимые сведения приведены в Cloudflare R2 документация.

1. На панели управления Cloudflare перейдите к разделу R2 страницу.

   Перейдите в Обзор ↗

2. Выберите Создание бакета.

3. Введите название бакета > Создание бакета.

4. Перейдите на страницу R2 Overview и выберите Управление API-токенами R2.

5. Выберите Создать API-токен.

6. В Разрешения, выберите Object Read & Write. Также обязательно выберите Применить только к отдельным бакетам, и выберите в раскрывающемся меню бакет, который вы создали для PCAP.

7. Выберите Создать API-токен.

8. Убедитесь, что вы скопировали Secret Access Key и Access Key ID значения: они понадобятся вам на следующем шаге.

Создайте первоначальный запрос к 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>"
}'

ответ имеет "filename" параметр с именем файла, который Cloudflare записал в ваш бакет R2. Его нужно скачать для следующего шага. Пример:

{
	"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
}

См. Проверьте бакет инструкции по API, где подробно описан весь процесс проверить ваш бакет R2. При указании назначения R2 для этой проверки исключите секретный ключ и ключ доступа из URL-адреса.