Фильтр authenticate в WordPress: как изменить процесс аутентификации пользователей

Фильтр authenticate в WordPress позволяет разработчикам вмешиваться в процесс аутентификации пользователя во время входа на сайт. Этот фильтр срабатывает, когда WordPress проверяет логин и пароль пользователя, и его можно использовать для кастомизации процесса входа, добавления дополнительных проверок или изменений стандартной логики аутентификации.

Как работает фильтр authenticate

Фильтр authenticate вызывается, когда пользователь пытается войти на сайт через форму авторизации. Основная функция, которая вызывает этот фильтр, — это wp_signon().

Формат использования:

add_filter( 'authenticate', 'custom_authenticate', 30, 3 );

function custom_authenticate( $user, $username, $password ) {
    // Здесь можно изменить логику аутентификации
    if ( $username === 'admin' ) {
        return new WP_Error( 'invalid_username', 'Вы не можете использовать этот логин.' );
    }

    // Возвращаем пользователя, если нет ошибок
    return $user;
}

Параметры функции:

  • $user — объект WP_User, если аутентификация прошла успешно, или объект WP_Error, если произошла ошибка. Значение по умолчанию — null.
  • $username — введённое имя пользователя.
  • $password — введённый пароль.

Пример: блокировка пользователя по имени

Рассмотрим пример, где пользователь с именем admin не может войти на сайт:

add_filter( 'authenticate', 'block_admin_login', 30, 3 );

function block_admin_login( $user, $username, $password ) {
    // Запрещаем вход пользователю с логином 'admin'
    if ( $username === 'admin' ) {
        return new WP_Error( 'invalid_username', 'Этот логин заблокирован для входа.' );
    }
    
    return $user;
}

Пример: проверка двухфакторной аутентификации

Вы можете использовать фильтр authenticate для добавления двухфакторной аутентификации (2FA) в процесс входа:

add_filter( 'authenticate', 'custom_two_factor_auth', 30, 3 );

function custom_two_factor_auth( $user, $username, $password ) {
    if ( is_wp_error( $user ) ) {
        return $user; // Если уже есть ошибка, возвращаем её
    }
    
    // Проверяем, есть ли у пользователя включён двухфакторный вход
    $two_factor_enabled = get_user_meta( $user->ID, 'two_factor_enabled', true );

    if ( $two_factor_enabled ) {
        // Проверяем код двухфакторной аутентификации (например, через сторонний сервис)
        if ( ! custom_check_two_factor_code( $user->ID ) ) {
            return new WP_Error( 'invalid_two_factor', 'Неверный код двухфакторной аутентификации.' );
        }
    }

    return $user;
}

function custom_check_two_factor_code( $user_id ) {
    // Ваша логика проверки кода 2FA
    return true; // Пример
}

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

Изменение приоритета фильтра

Важным аспектом работы с фильтром authenticate является приоритет вызова функции. Обычно WordPress выполняет свои внутренние проверки (например, проверку логина и пароля) с приоритетом 20. Если вы хотите изменить или расширить поведение стандартной аутентификации, рекомендуется использовать приоритет выше 20, как в приведённых выше примерах с приоритетом 30.

Пример: кастомная ошибка при неправильном пароле

Вы можете также использовать этот фильтр для изменения стандартных сообщений об ошибках. Например, если вы хотите показать своё сообщение об ошибке при неправильном пароле:

add_filter( 'authenticate', 'custom_auth_error_message', 30, 3 );

function custom_auth_error_message( $user, $username, $password ) {
    if ( is_wp_error( $user ) && isset( $user->errors['incorrect_password'] ) ) {
        return new WP_Error( 'incorrect_password', 'Вы ввели неверный пароль. Попробуйте ещё раз.' );
    }

    return $user;
}

Теперь, если пользователь вводит неправильный пароль, он получит кастомное сообщение об ошибке.

Почитаем еще?: