Подключите свой аккаунт Cloudflare для Pages, CDN и DNS

Что дает вам подключение

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

Перед началом работы

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

1. Создайте ключ в Cloudflare

В панели управления Cloudflare перейдите в раздел My Profile → API Tokens и выберите Create Token, затем Create Custom Token. Задайте ему имя, добавьте указанные ниже разрешения, а в поле Zone Resources выберите зоны, к которым вы хотите предоставить нам доступ — все зоны или только указанные вами. Проверьте параметры и нажмите Create Token. Cloudflare показывает токен только один раз; скопируйте его сразу же.

Добавьте следующие разрешения:

• Zone → Zone → Read
• Zone → DNS → Edit
• Zone → Cache Purge → Purge
• Zone → Zone Settings → Edit
• Account → Cloudflare Pages → Edit — только если вы хотите, чтобы мы публиковали сайты в Pages. Токен без этого разрешения все равно подключится и будет работать для DNS и кэша.

Устаревший альтернативный способ. Вместо токена вы можете подключиться с помощью Global API Key и адреса электронной почты, используемого для входа (My Profile → API Tokens → API Keys → Global API Key → View). Cloudflare не рекомендует этот способ: Global API Key предоставляет все права вашего аккаунта для каждой зоны, и их нельзя ограничить. По возможности используйте токен.

2. Подключите его здесь

Откройте раздел Интеграции в вашей панели управления и выберите Подключить аккаунт. Выберите Аккаунт Cloudflare (Pages, CDN и DNS) в качестве группы и Cloudflare в качестве аккаунта, заполните поле API-токен — или, при выборе устаревшей альтернативы, Ключ API и Электронная почта аккаунта, после чего нажмите Подключить аккаунт.

Мы проверяем вставленные данные до их сохранения. Неработающий ключ никогда не сохраняется, а в сообщении указывается причина ошибки. Работающий ключ хранится в зашифрованном виде в нашем хранилище секретов — ни в коем случае не в нашей базе данных — и больше никогда не отображается, даже вам.

Что происходит дальше

• Cloudflare Pages появится в качестве целевой платформы развертывания при создании или переносе статического сайта, и мы опубликуем сборку в проекте Pages на вашем аккаунте.
• ваши зоны смогут обслуживать DNS домена и кэш сайта из этого аккаунта.
• Мы проверим, может ли токен читать данные ваших зон, редактировать DNS, очищать кэш и изменять настройки зон. Чек-лист рядом с подключением покажет, какие из этих действий нам удалось подтвердить.

Если вы хотите использовать CDN и DNS на разных аккаунтах Cloudflare, подключите их по отдельности как Cloudflare CDN и Cloudflare DNS — для каждого из них предусмотрена отдельная инструкция.

Если не удается подключиться

Разрешение отображается как неподтвержденное. Cloudflare не всегда позволяет токену запрашивать собственный список разрешений, поэтому некоторые из них подтверждаются только при первом использовании. Если действие позже завершится ошибкой доступа, отредактируйте токен в My Profile → API Tokens и добавьте недостающее разрешение — значение токена не изменится, поэтому повторно подключать его не потребуется.

Зона отсутствует. Она не включена в параметр токена Zone Resources. Отредактируйте токен, чтобы включить эту зону или все зоны.

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

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

Отключение

Откройте раздел Интеграции, найдите аккаунт и нажмите Отключить. Это действие немедленно удалит сохраненный ключ. Любые процессы, использующие его, остановятся при следующем обращении, а экраны, зависящие от него, сообщат об ошибке вместо тихого сбоя.

Отключение не отменяет ранее выполненные действия — записи, развертывания или настройки, которые мы изменили в вашем аккаунте, останутся без изменений. Если вы считаете, что сам ключ мог быть скомпрометирован, также отзовите его на стороне сервиса; отключение удаляет только нашу копию, но не исходный ключ у поставщика.