> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Провайдеры и аккаунты
> Поддерживаемые CDN-провайдеры, подключение аккаунта, проверка ключей, статусы и архивирование.
Аккаунт CDN-провайдера — это многоразовый профиль учётных данных: вы подключаете его один раз, а затем используете для любого количества CDN-блоков. Панель проверяет ключи при создании и при каждом обновлении, хранит секреты в зашифрованном виде и никогда не отдаёт их обратно.
Для кого: администратор панели. Требуемые права: управление CDN-аккаунтами.
## Поддерживаемые провайдеры
| Провайдер | Режим | Что это значит |
| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Yandex Cloud CDN | Полная автоматизация | Единственный провайдер с рабочим автоматическим провижинингом: домен, TLS, CDN-ресурс и DNS создаются панелью. |
| VK Cloud CDN | Кандидат | Ключи можно сохранить, но аккаунт получает статус `permission_limited`: провайдер не квалифицирован для продакшена, пока не пройдут проверки контракта, TLS, кэша и транспорта с реальными учётными данными. |
| Selectel CDN | Кандидат | Аналогично VK Cloud: хранение ключей — да, автоматический провижининг — пока нет. |
| Beget CDN | Кандидат | Аналогично VK Cloud и Selectel. |
| Timeweb CDN | Режим с инструкциями | У Timeweb нет публичного API управления CDN; доступны только режим с инструкциями/импортом и проверка DNS. |
| Ручной режим (Manual) | Ручная настройка | Вы настраиваете CDN в консоли провайдера самостоятельно; панель хранит только заметки в свободной форме и не проверяет никакие ключи. При применении конфигурации панель не вызывает API провайдера, а формирует инструкции для ручной настройки. |
Каждый провайдер декларирует свои возможности с уровнем подтверждения (от «заявлено в документации» до «проверено с реальными ключами»). Возможность, описанная только в документации провайдера, никогда не считается производственной гарантией без проверки с учётными данными. Сроки полной автоматизации для провайдеров-кандидатов уточняются.
Ручной режим скрыт из списка провайдеров при подключении нового аккаунта, но ранее созданные ручные аккаунты продолжают работать.
Cloudflare в этом списке нет намеренно: это не CDN-провайдер, а отдельная интеграция AutoDNS для записей нод — см. DNS и Cloudflare AutoDNS.
## Предварительные требования
* Действующий аккаунт у провайдера и ключи с нужными правами.
* Для Yandex Cloud: авторизованный ключ сервисного аккаунта (JSON) и идентификатор каталога (Folder ID). Сервисному аккаунту нужны роли `cdn.editor` и `certificate-manager.editor`; для автоматического управления DNS-зоной также потребуется доступ к Cloud DNS (`dns.editor`).
## Подключение аккаунта
Набор полей зависит от провайдера. Панель показывает нужные поля и подсказки в мастере добавления аккаунта.
Нажмите подключение нового аккаунта и выберите провайдера из списка.
Введите поля из схемы провайдера (для Yandex Cloud — JSON авторизованного ключа и Folder ID) и имя аккаунта.
Панель сразу проверит ключи у провайдера. Для Yandex Cloud проверяется аутентификация и доступ к CDN API, Certificate Manager API и Cloud DNS API; недостающие права перечисляются как `cdn.editor`, `certificate-manager.editor`, `dns.editor`.
Неудачная проверка не блокирует сохранение: аккаунт будет создан со статусом, отражающим ошибку, — вы можете исправить ключи и перепроверить их позже.
## Секреты: только на запись
Учётные данные — write-only:
* секреты шифруются при сохранении и хранятся только в зашифрованном виде;
* ни один API-метод не возвращает секреты обратно — ни целиком, ни частично;
## Статусы аккаунта
| Статус | Значение |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `draft` | Аккаунт сохранён, но ещё не проверен у провайдера. |
| `valid` | Проверка пройдена — аккаунт готов к использованию. |
| `permission_limited` | Ключи аутентифицируются, но не хватает прав; список недостающих ролей показывается в панели. Также этот статус получают провайдеры-кандидаты до прохождения квалификации. |
| `invalid` | Ключи не проходят аутентификацию у провайдера. |
| `expired` | Срок действия учётных данных истёк. |
| `error` | Проверка завершилась ошибкой (например, провайдер недоступен). |
| `archived` | Аккаунт в архиве: скрыт из списков и не используется для новых блоков. |
Статус отражает результат последней проверки. Вместе с ним сохраняются время проверки и человекочитаемая причина.
## Перепроверка ключей
Кнопка **Проверить ключи** в карточке аккаунта (или запрос ниже) повторно запускает проверку у провайдера и обновляет статус и время последней проверки:
## Архивирование и удаление
* **Архив** — обратимая операция: аккаунт скрывается из списков, но его можно вернуть (`PATCH` с `"archived": false`). Заархивированные аккаунты видны в списке с параметром `?include_archived=1`.
* **Удаление** — необратимо: аккаунт удаляется вместе с сохранённым секретом. Если на аккаунт ссылаются CDN-ресурсы, удаление блокируется с HTTP 409 — сначала уберите CDN-блоки или используйте архив.
## Проверка
Аккаунт готов, когда после нажатия **Проверить ключи** его статус стал `valid` («Готов»), а время последней проверки обновилось.
* Если статус `permission_limited` — панель перечислит недостающие роли; выдайте их сервисному аккаунту у провайдера и перепроверьте.
## Откат
* Ошиблись в ключах — передайте правильные значения через редактирование аккаунта: старый секрет будет заменён, новая проверка запустится автоматически.
* Аккаунт больше не нужен, но использовался ресурсами — заархивируйте его (обратимо). Удаление возможно только после того, как ни один CDN-ресурс на него не ссылается.
* Полный откат: удалите CDN-блоки, использующие аккаунт (см. Ресурсы и операции), затем удалите аккаунт — секрет будет удалён вместе с ним.
## Типовые ошибки
Для Yandex Cloud: сервисному аккаунту не хватает ролей — панель перечислит недостающие (`cdn.editor`, `certificate-manager.editor`, `dns.editor`). Для VK Cloud, Selectel и Beget это ожидаемое поведение: провайдер ещё не квалифицирован для автоматического провижининга.
Аккаунт используется CDN-ресурсами. Панель предлагает заархивировать его вместо удаления. Чтобы удалить окончательно, сначала деинсталлируйте связанные CDN-блоки.
`invalid` — ключи не проходят аутентификацию: проверьте, что вставили полный авторизованный ключ и правильный Folder ID. `error` — проверка не выполнилась (например, API провайдера недоступен): повторите **Проверить ключи** позже.
Связанные страницы: Ресурсы и операции, Наблюдаемость, Connection Units.
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.