INTEGRITY Документация

Инструкции

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

У вас должен быть Роль Super Administrator или Secrets Store Admin в вашем аккаунте Cloudflare.

Управление через Wrangler

Wrangler это интерфейс командной строки (CLI), который позволяет управлять Cloudflare Workers проектов. См. Команды Wrangler с инструкциями по использованию с Secrets Store.

Создание секрета

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

    Перейдите в Secrets Store ↗
  2. Выберите Create secret.

  3. Заполните обязательные поля. Учтите, что после сохранения секрета его значение будет больше недоступно для просмотра.

  4. (Необязательно) Выберите Добавление дополнительного секрета чтобы создать более одного секрета за раз.

  5. Выберите Save для подтверждения.

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:
  • Secrets Store Write
Создание секрета
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/secrets_store/stores/$STORE_ID/secrets" \
	--request POST \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY" \
	--json '[
		{
				"name": "<MY_SECRET_NAME>",
				"value": "<SECRET_VALUE>",
				"scopes": [
						"workers"
				],
				"comment": ""
		},
		{
				"name": "<MY_SECRET_NAME_2>",
				"value": "<SECRET_VALUE>",
				"scopes": [
						"workers"
				],
				"comment": ""
		}
	]'

Дублирование секрета

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

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

    Перейдите в Secrets Store ↗
  2. Найдите нужный для дублирования секрет в списке существующих секретов.

  3. Нажмите на три точки рядом с секретом и выберите Дублировать.

  4. Измените Имя секрета, Область действия разрешения, или Комментарий, в соответствии с вашими потребностями.

  5. Выберите Save для подтверждения.

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/secrets_store/stores/$STORE_ID/secrets/$SECRET_ID/duplicate \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
    "name":"<NEW_DUPLICATE_NAME>",
    "scopes":["workers"],
    "comment":""
}'

Редактирование секрета

Редактирование секрета позволяет заменить существующее значение новым.

Вы также можете изменить секрет Область действия разрешения и Комментарий.

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

    Перейдите в Secrets Store ↗
  2. Найдите нужный для редактирования секрет в списке существующих секретов.

  3. Нажмите на три точки рядом с секретом и выберите Изменить.

  4. Измените доступные поля в соответствии со своими потребностями и выберите Save для подтверждения.

См. Secrets Store API с полной документацией по API.

curl --request PATCH \
https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/secrets_store/stores/$STORE_ID/secrets/$SECRET_ID \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
    "comment":"<NEW_COMMENT>",
    "value":"<NEW_SECRET_VALUE>",
    "scopes":["workers"]
}'

Удаление секрета

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

    Перейдите в Secrets Store ↗
  2. Найдите нужный для удаления секрет в списке существующих секретов.

  3. Нажмите на три точки рядом с секретом и выберите Удалить.

  4. Введите имя секрета и выберите Удалить для подтверждения.

См. Secrets Store API с полной документацией по API.

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:
  • Secrets Store Write
Удаление секрета
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/secrets_store/stores/$STORE_ID/secrets/$SECRET_ID" \
	--request DELETE \
	--header "X-Auth-Email: $CLOUDFLARE_EMAIL" \
	--header "X-Auth-Key: $CLOUDFLARE_API_KEY"