Поддержка и документация

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']

Рекомендации