Поддержка и документация
FAQ и инструкция по интеграции OAuth 2.0 API
Общие вопросы
Что это за сервис?
Это единый сервер авторизации OAuth 2.0. Пользователи регистрируются один раз и могут входить во все ваши проекты через этот сервис.
Нужен ли Composer?
Нет. Всё работает на чистом PHP + MySQL без внешних зависимостей.
Интеграция API
Как подключить свой сайт?
Создайте OAuth-клиент в админке, получите client_id и client_secret, затем используйте стандартный Authorization Code Flow (см. инструкцию на этой странице).
Поддерживается ли PKCE?
Да. Рекомендуется для публичных клиентов (SPA, мобильные приложения).
Безопасность
Где хранятся токены?
Токены opaque (не JWT), хранятся в базе. Access token живёт 1 час, refresh — 30 дней (настраивается).
Интеграция по API (OAuth 2.0)
Сервер поддерживает Authorization Code Grant + PKCE + Refresh Token.
1. Создайте OAuth-клиент
В админке → Клиенты → Создать. Укажите название и один или несколько redirect_uri (каждый с новой строки).
Вы получите client_id и client_secret (для confidential-клиентов).
2. Эндпоинты
Authorization: https://bruid.ru/oauth/authorize.php
Token: https://bruid.ru/oauth/token.php
UserInfo: https://bruid.ru/api/userinfo.php
3. Шаг 1 — Редирект пользователя на авторизацию
GET https://bruid.ru/oauth/authorize.php
?response_type=code
&client_id=YOUR_CLIENT_ID
&redirect_uri=https://your-app.com/callback
&scope=profile
&state=RANDOM_STATE
&code_challenge=BASE64URL(SHA256(code_verifier)) # PKCE, рекомендуется
&code_challenge_method=S256
4. Шаг 2 — Обмен code на токены
POST https://bruid.ru/oauth/token.php
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code
&code=CODE_FROM_CALLBACK
&redirect_uri=https://your-app.com/callback
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET # если confidential
&code_verifier=ORIGINAL_VERIFIER # если использовали PKCE
Ответ:
{
"access_token": "...",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "...",
"scope": "profile"
}
5. Получение данных пользователя
GET https://bruid.ru/api/userinfo.php
Authorization: Bearer ACCESS_TOKEN
Ответ:
{
"sub": "123",
"email": "user@example.com",
"name": "Иван Иванов",
"created_at": "2026-01-15 12:00:00"
}
6. Обновление токена
POST https://bruid.ru/oauth/token.php
grant_type=refresh_token
&refresh_token=...
&client_id=...
&client_secret=...
7. Пример на PHP (серверный клиент)
<?php
// После получения code из callback
$ch = curl_init('https://bruid.ru/oauth/token.php');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => http_build_query([
'grant_type' => 'authorization_code',
'code' => $_GET['code'],
'redirect_uri' => 'https://your-app.com/callback',
'client_id' => 'YOUR_CLIENT_ID',
'client_secret' => 'YOUR_CLIENT_SECRET',
]),
]);
$tokens = json_decode(curl_exec($ch), true);
// Получение профиля
$ch = curl_init('https://bruid.ru/api/userinfo.php');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $tokens['access_token']],
]);
$user = json_decode(curl_exec($ch), true);
// $user['sub'], $user['email'], $user['name']
Рекомендации
- Всегда используйте HTTPS.
- Для SPA и мобильных приложений обязательно применяйте PKCE.
- Храните
client_secretтолько на сервере. - Проверяйте параметр
stateдля защиты от CSRF. - Access token короткий (1 час), используйте refresh token.