Авторизация через VK ID на PHP с OAuth 2.1 и PKCE
Вход через VK ID позволяет посетителю создать аккаунт на сайте без отдельного пароля. Разберём серверный сценарий на PHP 8.3–8.5 от редиректа с PKCE до получения профиля и создания локальной сессии.
Как устроен вход через VK ID
PHP перенаправляет браузер в VK ID. После подтверждения входа браузер возвращается в обработчик сайта с одноразовым кодом. Сервер обменивает код на access_token, запрашивает профиль и по идентификатору VK ID находит или создаёт локальную учётную запись. Дальше сайт использует собственную PHP-сессию.
В потоке Authorization Code с PKCE у каждого входа есть два случайных значения. state связывает ответ с попыткой входа в текущей браузерной сессии. code_verifier остаётся на сервере до обмена кода, а в исходный редирект попадает только его SHA-256-производная code_challenge с методом S256. При обмене VK ID проверяет, что исходный code_verifier соответствует переданному ранее значению.
Настройка приложения и PHP-сессии
Создайте веб-приложение в кабинете VK ID, возьмите его client_id и зарегистрируйте адрес обработчика возврата. Передавайте один и тот же redirect_uri при авторизации и обмене кода, включая схему, порт, путь и завершающий слеш. Адрес задавайте в конфигурации, чтобы он не зависел от входящего заголовка Host.
Примеры рассчитаны на PHP 8.3–8.5 с расширениями cURL и PDO PostgreSQL. В переменных окружения задайте VK_CLIENT_ID, VK_REDIRECT_URI и адреса трёх эндпоинтов VK ID: VK_AUTHORIZE_ENDPOINT, VK_TOKEN_ENDPOINT, VK_USER_INFO_ENDPOINT. Подключайте общий файл vk-bootstrap.php в обоих обработчиках до отправки заголовков.
<?php
declare(strict_types=1);
function config(string $name): string
{
$value = getenv($name);
if ($value === false || $value === '') {
throw new RuntimeException('Отсутствует настройка: ' . $name);
}
return $value;
}
// Обработчики входа работают по HTTPS.
ini_set('session.use_strict_mode', '1');
session_start([
'use_only_cookies' => 1,
'cookie_secure' => true,
'cookie_httponly' => true,
'cookie_samesite' => 'Lax',
]);
header('Cache-Control: no-store');SameSite=Lax позволяет браузеру передать cookie при возврате из VK ID обычной навигацией с методом GET. При нескольких экземплярах приложения настройте общее хранилище сессий с блокировкой на время чтения и изменения.
Переход в VK ID с PKCE
Кнопка входа ведёт в этот PHP-обработчик. Он создаёт временную запись с десятиминутным сроком жизни. Пример хранит одну попытку на сессию, поэтому повторное нажатие или вход из второй вкладки заменяет предыдущую попытку.
<?php
declare(strict_types=1);
require __DIR__ . '/vk-bootstrap.php';
// 32 случайных байта дают 64 допустимых для PKCE символа.
$verifier = bin2hex(random_bytes(32));
$state = bin2hex(random_bytes(32));
$challenge = rtrim(strtr(
base64_encode(hash('sha256', $verifier, true)), '+/', '-_'
), '=');
$_SESSION['vk_login'] = [
'state' => $state,
'verifier' => $verifier,
'expires' => time() + 600,
];
session_write_close();
$query = http_build_query([
'response_type' => 'code',
'client_id' => config('VK_CLIENT_ID'),
'redirect_uri' => config('VK_REDIRECT_URI'),
'state' => $state,
'code_challenge' => $challenge,
'code_challenge_method' => 'S256',
], '', '&', PHP_QUERY_RFC3986);
header('Location: ' . config('VK_AUTHORIZE_ENDPOINT') . '?' . $query, true, 302);
exit;Проверка возврата и обмен кода на токен
Сначала проверьте срок попытки и state. После совпадения удалите временную запись до обращения к VK ID. Если браузер повторит запрос, обработчик не начнёт новый обмен. При успешном возврате VK ID передаёт code и device_id. Оба значения нужны для запроса токена. Отказ пользователя и отсутствие обязательных параметров завершают попытку.
Следующий фрагмент начинает обработчик возврата. Код для получения профиля и записи пользователя из следующих разделов добавляется в тот же файл.
<?php
declare(strict_types=1);
require __DIR__ . '/vk-bootstrap.php';
function failLogin(int $status, string $message): never
{
http_response_code($status);
exit($message);
}
function vkPost(string $endpoint, array $fields): array
{
$curl = curl_init($endpoint);
curl_setopt_array($curl, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($fields, '', '&', PHP_QUERY_RFC3986),
CURLOPT_HTTPHEADER => [
'Content-Type: application/x-www-form-urlencoded',
'Accept: application/json',
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 3,
CURLOPT_TIMEOUT => 8,
]);
$body = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
if (!is_string($body) || $status < 200 || $status >= 300) {
throw new RuntimeException('Ошибка запроса к VK ID');
}
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!is_array($data) || isset($data['error'])) {
throw new RuntimeException('Ошибка ответа VK ID');
}
return $data;
}
$attempt = $_SESSION['vk_login'] ?? null;
$state = $_GET['state'] ?? null;
if (!is_array($attempt) || $attempt['expires'] <= time()
|| !is_string($state) || !hash_equals($attempt['state'], $state)) {
failLogin(400, 'Попытка входа недействительна. Начните вход заново.');
}
unset($_SESSION['vk_login']);
session_write_close();
$code = $_GET['code'] ?? null;
$deviceId = $_GET['device_id'] ?? null;
if (isset($_GET['error']) || !is_string($code) || $code === ''
|| !is_string($deviceId) || $deviceId === '') {
failLogin(400, 'Вход через VK ID не завершён.');
}
try {
$token = vkPost(config('VK_TOKEN_ENDPOINT'), [
'grant_type' => 'authorization_code',
'client_id' => config('VK_CLIENT_ID'),
'redirect_uri' => config('VK_REDIRECT_URI'),
'code' => $code,
'code_verifier' => $attempt['verifier'],
'device_id' => $deviceId,
'state' => $state,
]);
$accessToken = $token['access_token'] ?? null;
if (!is_string($accessToken) || $accessToken === '') {
throw new RuntimeException('В ответе отсутствует токен доступа');
}
} catch (RuntimeException | JsonException) {
failLogin(502, 'Не удалось завершить вход через VK ID. Попробуйте ещё раз.');
}Получение профиля
Передайте access_token и client_id в запросе user_info. Возьмите идентификатор из user.user_id и храните его как строку. Имя пригодится для отображения. Email и телефон могут отсутствовать, поэтому для поиска аккаунта используйте идентификатор провайдера.
try {
$info = vkPost(config('VK_USER_INFO_ENDPOINT'), [
'client_id' => config('VK_CLIENT_ID'),
'access_token' => $accessToken,
]);
$user = $info['user'] ?? [];
$vkId = $user['user_id'] ?? null;
if ((!is_int($vkId) && !is_string($vkId)) || (string) $vkId === '') {
throw new RuntimeException('В профиле отсутствует идентификатор');
}
// Имя из профиля экранируется при выводе в HTML.
$firstName = is_string($user['first_name'] ?? null) ? $user['first_name'] : '';
} catch (RuntimeException | JsonException) {
failLogin(502, 'Не удалось получить профиль VK ID. Попробуйте войти заново.');
}Хранение пользователя и локальный вход
Для сайта с одним способом входа достаточно таблицы с локальным id и уникальным vk_user_id. Ограничение в базе защищает от дублей, если два запроса впервые входят под одним аккаунтом VK ID одновременно.
CREATE TABLE users (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
vk_user_id text NOT NULL UNIQUE,
first_name text NOT NULL DEFAULT ''
);Одна операция PostgreSQL возвращает локальный id при первом и повторном входе. В примере имя обновляется из профиля при каждом входе. Если пользователь редактирует имя на сайте, храните его отдельно. После записи в базу смените идентификатор PHP-сессии и перенаправьте браузер на внутреннюю страницу, чтобы убрать параметры OAuth из адресной строки.
$pdo = new PDO(config('DB_DSN'), config('DB_USER'), config('DB_PASSWORD'));
$stmt = $pdo->prepare(
'INSERT INTO users (vk_user_id, first_name) VALUES (:vk_id, :first_name)
ON CONFLICT (vk_user_id) DO UPDATE SET first_name = EXCLUDED.first_name
RETURNING id'
);
$stmt->execute(['vk_id' => (string) $vkId, 'first_name' => $firstName]);
$userId = $stmt->fetchColumn();
if ($userId === false || !session_start() || !session_regenerate_id(true)) {
failLogin(500, 'Не удалось создать сессию.');
}
$_SESSION['user_id'] = (string) $userId;
session_write_close();
header('Location: ' . config('APP_AFTER_LOGIN_PATH'), true, 303);
exit;APP_AFTER_LOGIN_PATH задайте фиксированным внутренним путём в конфигурации сайта. В рабочем приложении исключения PDO обрабатывает общий обработчик ошибок. Если способов входа несколько, вынесите связи во внешнюю таблицу с полями user_id, provider, provider_user_id и уникальной парой из двух последних полей. Создавайте пользователя и его связь в одной транзакции. Для привязки VK ID к существующему аккаунту требуйте активную локальную сессию и явное подтверждение. Совпадения email для привязки недостаточно.
Чек-лист перед запуском
- Зарегистрирован точный
redirect_uri. В обоих обработчиках включены HTTPS и защищённые cookie сессии. - Каждая попытка использует новые
stateиcode_verifier. Истёкший, изменённый или повторно использованныйstateотклоняется. - Отмена входа, отсутствующий
device_id, тайм-аут VK ID и ошибка базы оставляют пользователя без новой локальной сессии. - Первый вход создаёт запись, повторный возвращает тот же локальный
id. После входа идентификатор сессии меняется. - Коды из запроса возврата и тела запросов с токенами исключены из журналов приложения, прокси и мониторинга. Если VK ID нужен только для входа, токены достаточно держать в памяти до получения профиля.
- Профиль без email и аватара проходит вход. Строки профиля экранируются при выводе, а локальный выход завершает сессию сайта.
Частые вопросы
Зачем проверять state, если уже используется PKCE?
В этой реализации state связывает возврат с конкретной попыткой входа в текущей браузерной сессии. PKCE защищает обмен кода, проверяя владение исходным code_verifier.
Нужно ли сохранять access_token и refresh_token в базе?
Для обычного входа достаточно получить профиль и сохранить связь с локальным пользователем. Хранение токенов имеет смысл, если серверу после входа нужен доступ к API VK от имени пользователя.
Что делать, если VK ID вернул профиль без email?
Выполните вход по идентификатору VK ID. Если сайту нужен адрес для уведомлений или восстановления доступа, предложите пользователю добавить и подтвердить его в локальном аккаунте.