Неделя 47 · 16–22 ноября 2026
Secrets API в WordPress 7.2: ключи плагинов будут храниться шифрованно
В ядре появятся wp_set_secret() и wp_get_secret(): ключи API и секреты OAuth шифруются libsodium. Сайту нужна константа WP_SECRETS_KEY в wp-config.php.
Эрик Манн опубликовал на make.wordpress.org заметку для разработчиков о Secrets API — новом интерфейсе WordPress 7.2 (выход назначен на 8 декабря) для хранения учётных данных: ключей API, секретов OAuth и подобного. Значения шифруются через libsodium (XChaCha20-Poly1305) и по умолчанию лежат в таблице опций, но уже не открытым текстом. У каждого секрета сохраняется одна предыдущая версия, чтобы ротацию ключа можно было провести без простоя. Основные функции: wp_set_secret(), wp_get_secret(), wp_delete_secret(), wp_list_secrets() (отдаёт имена и метаданные, но не значения) и wp_import_option_as_secret() для переноса уже существующей опции. Для мультисайта есть парные функции вида wp_set_network_secret(). Имена секретов строятся как plugin-slug/secret-name.
Владельцам сайтов важно одно: API работает только при наличии константы WP_SECRETS_KEY в wp-config.php — случайных 32 байт в base64. Новые установки получат её автоматически, а на существующих сайтах нужную строку сгенерирует «Здоровье сайта», где в разделе «Безопасность» появятся три новых теста. Без ключа запись секрета не проходит, а чтение возвращает ошибку secret_key_unavailable. Если ключ потом сменить или удалить, сохранённые секреты станут нечитаемыми, так что хранить его надо так же бережно, как соли. Хостеры могут подменить хранение через drop-in wp-content/secrets.php: держать ключ в KMS или HSM, писать записи не в таблицу опций или отдать весь API внешнему менеджеру секретов.
Оговорки в заметке сформулированы прямо. Secrets API не разграничивает доступ: любой код, запущенный на сайте, может прочитать любой секрет, а сами функции не проверяют права пользователей — эти проверки остаются на плагине. Тем, кто тестировал бета-версии 7.2, придётся кое-что переделать: с первой беты WP_SECRETS_KEY стала обязательной (запасной вариант на основе LOGGED_IN_KEY убрали), а классы keyring, store и provider из интерфейсов превратились в абстрактные классы — drop-in со словом implements теперь даёт фатальную ошибку. Секреты, сохранённые в бетах, надо перешифровать по инструкции из заметки, через временную константу WP_SECRETS_KEY_PREVIOUS и команду WP-CLI. Для старых версий WordPress Манн предлагает тот же API в виде плагина ericmann/secrets-api на GitHub. Сколько плагинов перейдут на новое хранилище и когда, пока неизвестно: в 7.2 API просто появляется в ядре, существующие ключи в опциях сами никуда не переезжают.
Источник: Make WordPress Core