Услуги Портфолио Контакты БлогНовости +7 (800) 302‑79‑27 Обсудить проект
Безопасность

В WordPress 7.2 появится Secrets API: ключи и токены плагинов будут храниться зашифрованными

16 ноября 2026·5 мин чтения
WordPress 7.2Secrets API
Secrets API в WordPress 7.2: зашифрованное хранение ключей и токенов плагинов

WordPress 7.2, релиз которого назначен на 8 декабря 2026 года, получит Secrets API: API-ключи, токены и пароли плагинов будут храниться в базе зашифрованными, а не открытым текстом в wp_options. Для работы нужен отдельный ключ WP_SECRETS_KEY в wp-config.php. Без него API ничего не сохраняет. 17 ноября выходит RC1, и до этой даты хостингов просят протестировать новинку.

Для владельцев сайтов это первая встроенная защита учётных данных на случай утечки дампа базы или копии staging-сервера. Сейчас ключи платёжных шлюзов, CRM и почтовых сервисов у большинства плагинов лежат в БД как обычный текст. Если вы ведёте сайт на WordPress с интеграциями, переход стоит запланировать заранее.

При этом функция вызвала спор в сообществе. Создатель REST API WordPress Райан Маккью (Human Made) предложил убрать Secrets API из релиза 7.2, автор API Эрик Манн ответил на критику. Пока функция остаётся в ветке. Командам поддержки сайтов разумно подготовиться к обоим исходам.

Что такое Secrets API в WordPress 7.2

Secrets API — набор функций ядра, через которые плагины сохраняют и читают чувствительные значения. Основных функций три: wp_set_secret() сохраняет значение в зашифрованном виде, wp_get_secret() читает его, wp_delete_secret() удаляет. Дополнительно есть wp_list_secrets() (только имена и метаданные, без значений), wp_import_option_as_secret() для переноса старых опций и сетевые варианты функций для мультисайта.

Имена секретов строятся по схеме plugin-slug/secret-name: строчные латинские буквы, цифры, дефисы и подчёркивания. Префикс не даёт плагинам перезаписывать чужие значения, но доступ он не ограничивает. Как прямо пишут в dev note, любой код на сайте может прочитать любой секрет.

wp_get_secret() возвращает объект WP_Secret. При выводе в лог или на экран он показывает заглушку вида [secret:my-plugin/api-key], а настоящее значение отдаёт только метод reveal(). Сериализовать или клонировать такой объект нельзя: будет исключение. Так ключи реже случайно оказываются в debug-логах.

Как устроено шифрование и зачем нужен WP_SECRETS_KEY

Значения шифруются через libsodium алгоритмом XChaCha20-Poly1305 и хранятся в таблице опций. Каждый секрет шифруется корневым ключом, а тот, в свою очередь, ключом WP_SECRETS_KEY из wp-config.php. Сам ключ в базе не лежит, поэтому одной копии БД для расшифровки недостаточно.

  • Ключ обязателен. Начиная с поздних бет запасной вариант через LOGGED_IN_KEY и LOGGED_IN_SALT убран. Без WP_SECRETS_KEY любая запись и чтение возвращают ошибку secret_key_unavailable.
  • Не любой ключ подходит. Пустое значение, заглушка из wp-config-sample.php или копия одной из солей не засчитываются. Нужны 32 случайных байта в base64.
  • Ключ нельзя просто поменять. Если после сохранения секретов изменить или удалить WP_SECRETS_KEY, все значения станут нечитаемыми, пока старый ключ не вернут. Для смены ключа есть отдельная процедура ротации через WP-CLI.
  • Site Health подскажет. В «Здоровье сайта» появятся проверки источника ключа, нерасшифровываемых секретов и учётных данных, ожидающих ротации.

Хостинги могут подключить своё хранилище через drop-in wp-content/secrets.php: KMS или HSM для ключей, внешнее хранилище записей или полностью внешний менеджер секретов. Если провайдер работает только на чтение, wp_set_secret() вернёт WP_Error, а wp_secrets_provider_is_writable() покажет false.

Почему Secrets API предлагают убрать из релиза

Критики считают, что WordPress должен только читать секреты, а не управлять ими. Райан Маккью, вице-президент по продукту Human Made и Altis, 12 ноября оставил под dev note комментарий с «сильным −1». По его словам, лучшая практика индустрии в том, чтобы секреты хранились отдельно от остальных данных и были доступны приложению только на чтение, а управление ими шло вне приложения: так проще аудит, контроль изменений и ротация по требованиям комплаенса. Он опасается, что API с записью «окостенеет» и внешним провайдерам придётся поддерживать запись ради совместимости. В пример он привёл плагин WordPress AI, который считает, что сохранение всегда проходит, и не сообщает об ошибке.

Эрик Манн ответил, что после похожих замечаний в августе API уже изменили: хостинги могут подключать собственные хранилища, в том числе только для чтения. Главный его аргумент в том, что у большинства сайтов на WordPress вообще нет внешнего менеджера секретов. Учётные данные приходят через страницу настроек плагина и лежат в wp_options открытым текстом, попадая в каждый дамп, бэкап и клон для staging. API только на чтение таким сайтам ничего не даёт.

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

Что проверить на своём сайте до 8 декабря

  1. Сделайте инвентаризацию секретов. Выясните, какие плагины хранят ключи API, токены и пароли в wp_options: платежи, CRM, почта, аналитика, ИИ-сервисы.
  2. Добавьте WP_SECRETS_KEY на staging. Сгенерируйте ключ, сохраните его в менеджере паролей вне сервера и проверьте, что бэкапы wp-config.php и базы не лежат в одном месте.
  3. Протестируйте обновление на копии сайта. Помимо Secrets API в 7.2 иконки админки переведены с Dashicons на SVG (CSS через ::before перестанет работать), а склейка скриптов админки через load-scripts.php отключена. Это может задеть кастомные темы и плагины.
  4. Если вы разрабатываете плагин, проверяйте wp_is_secrets_api_available(), обрабатывайте WP_Error при записи и не удаляйте старое хранилище, пока секрет не сохранён. Проверку прав пользователя функции не делают, её нужно добавить в своём коде.
  5. После переноса ротируйте ключи. Значение, которое лежало открытым текстом, уже попало в старые бэкапы, поэтому wp_import_option_as_secret() сам помечает такие секреты на ротацию.

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

Часто задаваемые вопросы

Когда выйдет WordPress 7.2?

Финальный релиз запланирован на 8 декабря 2026 года, RC1 на 17 ноября. Сроки ещё могут сдвинуться, а состав релиза окончательно фиксируется на этапе RC.

Будут ли старые плагины работать после обновления?

Да. Secrets API добровольный: плагины, которые хранят ключи в wp_options, продолжат работать как раньше. Защита появится только после того, как авторы перейдут на новые функции.

Защищает ли Secrets API от вредоносного плагина?

Нет. Шифрование помогает при утечке дампа базы, SQL-инъекции с чтением опций или публичной копии staging. Код, запущенный на самом сайте, по-прежнему может прочитать любой секрет, как и тот, у кого есть одновременно база и wp-config.php.

Что будет, если потерять WP_SECRETS_KEY?

Все сохранённые секреты станут нечитаемыми, и их придётся заново ввести в настройках плагинов. Поэтому ключ нужно хранить отдельно от сервера, например в корпоративном менеджере паролей.

Источники

Материал подготовлен редакцией YuSMP Group по открытым источникам. Нужна экспертиза по теме или разработка под задачу — обсудим проект.

Подготовим сайт на WordPress к обновлению 7.2

Проверим плагины и интеграции, перенесём ключи сервисов в защищённое хранилище и обновим сайт сначала на тестовой копии, чтобы релиз прошёл без простоев.

Заказать поддержку сайта