wpsocial.ru wordpress WPSocial

Как настроить REST API WordPress: отключение, ограничения и безопасное использование

REST API WordPress нужен редактору блоков, мобильным приложениям и интеграциям, которые обмениваются данными с сайтом. Поэтому отключать его целиком «на всякий случай» обычно не стоит: можно нарушить работу админки или подключённых сервисов. Практичнее определить, какие маршруты нужны, закрыть ненужные и проверить права доступа.

Сначала проверьте, что именно доступно

Откройте https://example.com/wp-json/, заменив домен на свой. Это корень API: он показывает зарегистрированные пространства имён и маршруты. Проверку доступа к конкретному маршруту выполняйте в приватном окне браузера, где вы не авторизованы, например для списка пользователей: https://example.com/wp-json/wp/v2/users.

Публичный ответ не означает автоматически, что сайт взломан. REST API может отдавать опубликованные записи и другую общедоступную информацию. Но если API показывает данные, которые должны быть доступны только авторизованным пользователям, проверьте права на соответствующем маршруте и настройки плагинов, которые его добавляют. Один и тот же маршрут может вести себя по-разному для посетителя и пользователя с определённой ролью.

Если адрес с /wp-json/ не открывается, проверьте также вариант с параметром: https://example.com/?rest_route=/. На части сайтов работа красивых постоянных ссылок зависит от настроек сервера, но сам API может оставаться доступным через этот формат.

Когда стоит ограничивать API, а когда — отключать

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

Ограничивать API имеет смысл, когда конкретный маршрут раскрывает лишние данные или не используется на сайте. Например, можно убрать REST-маршруты пользователей, не отключая API записей. Если цель — снизить нагрузку, сначала найдите источник частых запросов: само наличие REST API не означает, что он создаёт заметную нагрузку. Часто запросы генерирует тема, плагин или интеграция.

Закройте API для неавторизованных посетителей

Если публичный доступ к REST API не нужен, но авторизованным пользователям и административным инструментам он должен остаться, можно потребовать вход для всех REST-запросов. Добавьте код в небольшой собственный плагин или файл в каталоге wp-content/mu-plugins. Для MU-плагина создайте PHP-файл, например rest-access.php, и поместите в него следующий код:

<?php
add_filter( 'rest_authentication_errors', function ( $result ) {
    if ( ! empty( $result ) ) {
        return $result;
    }

    if ( ! is_user_logged_in() ) {
        return new WP_Error(
            'rest_not_logged_in',
            'Для доступа к REST API необходимо войти на сайт.',
            array( 'status' => 401 )
        );
    }

    return $result;
} );

Фильтр возвращает ошибку 401 для запросов без авторизации и пропускает запросы вошедших пользователей. Не применяйте это правило вслепую: публичные функции темы и плагинов, которые обращаются к REST API от имени посетителя, перестанут работать. Перед установкой сохраните файл исходной версии; если после изменения сломался редактор или интеграция, удалите фильтр и проверьте журнал ошибок.

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

Отключите отдельные маршруты, не затрагивая остальные

Чтобы убрать из API маршруты пользователей, можно удалить их при регистрации. Этот вариант подходит, если публичные данные пользователей через REST API не нужны, но остальные маршруты должны работать. Добавьте фильтр в собственный плагин или MU-плагин:

<?php
add_filter( 'rest_endpoints', function ( $endpoints ) {
    unset( $endpoints['/wp/v2/users'] );
    unset( $endpoints['/wp/v2/users/(?P<id>[\d]+)'] );

    return $endpoints;
} );

Фильтр убирает из регистрации маршрут списка пользователей и маршрут отдельного пользователя. После этого запросы к ним должны перестать обрабатываться, а другие маршруты, например записи, останутся доступны. Проверьте оба адреса в приватном окне и отдельно проверьте работу сайта и админки.

Это не удаляет имена авторов из опубликованных записей и не скрывает информацию, которая уже выводится на страницах сайта. Также плагин может зарегистрировать собственные маршруты пользователей. Если конкретный маршрут всё ещё отвечает, посмотрите его точное имя в /wp-json/ и настройки плагина, который его добавляет. Не пытайтесь закрыть всё пространство имён поисковой заменой по URL: так легко задеть нужные маршруты.

Полное отключение API — крайний вариант

Если нужно отклонять вообще все запросы REST API, включая запросы вошедших пользователей, фильтр rest_authentication_errors может возвращать ошибку без проверки статуса входа. Но это вмешивается в работу редактора блоков, административных экранов и расширений, использующих API. До применения проверьте сайт на копии или в период, когда можно быстро отменить изменение.

<?php
add_filter( 'rest_authentication_errors', function () {
    return new WP_Error(
        'rest_disabled',
        'REST API временно отключён.',
        array( 'status' => 403 )
    );
} );

Чтобы вернуть API, удалите этот фильтр. Правило на уровне веб-сервера тоже может блокировать запросы, но результат зависит от конфигурации Apache, Nginx или хостинга. Кроме того, ограничение только адреса /wp-json/ может не охватить вариант с rest_route. Серверные правила стоит использовать, только если вы проверили оба способа обращения и понимаете, какие административные запросы они затронут.

Как использовать REST API безопасно

Для собственных маршрутов задавайте проверку прав в permission_callback. Возвращать разрешение всем запросам допустимо только для действительно публичных данных; операции создания, изменения и удаления должны проверять возможности текущего пользователя через current_user_can(). Входные параметры нужно валидировать и очищать, а секреты — хранить на сервере, не передавать в публичный JavaScript.

Для запросов из браузера авторизованного пользователя WordPress использует cookie-аутентификацию и REST nonce. Nonce помогает защитить запрос от подделки, но не заменяет проверку прав доступа. Внешние клиенты настраивают отдельно: им нужны HTTPS и подходящий метод аутентификации, а учётной записи — только те полномочия, которые необходимы интеграции.

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

×

AI-плагин

WPGPT
Сам создает статьи для вашего сайта WordPress

SEO и мета-теги

Парсинг конкурентов

Изображения

Комментарии

Подробнее