ДОКУМЕНТАЦИЯ
Делегирование · PKCE
Доступ от имени пользователя с его явного согласия.
Authorization Code + S256#
- Создайте случайный state и случайный code_verifier; длина code_verifier — 43–128 символов. Храните их только на время попытки. challenge = BASE64URL(SHA256(verifier)) без знаков заполнения (=).
- Откройте /developers/authorize на сайте соответствующего зеркала, не на домене документации или API. Параметры: client_id, redirect_uri, scope (области доступа через пробел), state, code_challenge, code_challenge_method=S256. Заранее зарегистрируйте клиент и точный redirect_uri.
- Страница показывает проверенное сервером приложение, URI и запрашиваемые области доступа; согласие подтверждается нажатием кнопки. После возврата на redirect_uri сначала проверьте state. Одноразовый code действует 120 секунд.
- Обменяйте code через POST /oauth/token с grant_type=authorization_code, числовым client_id, code, redirect_uri и code_verifier. Принимаются application/json и application/x-www-form-urlencoded.
- Токен rh_user_ действует 3600 секунд. Автоматического обновления токена или согласия без подтверждения нет. При загрузке, редактировании и скачивании повторно проверяются выданное разрешение, аккаунт, проект, текущие права, согласие и владелец ресурса.
Расчёт code_challenge на сервере#
JavaScript · Node.js
import { randomBytes, createHash } from "node:crypto";
const verifier = randomBytes(32).toString("base64url");
const state = randomBytes(24).toString("base64url");
const challenge = createHash("sha256").update(verifier).digest("base64url");
// Keep verifier + state in the server-side authorization attempt.
// Pass challenge and state to /developers/authorize, then validate callback state.Запрос обмена кода#
После согласия пользователя передайте выданный code, исходный code_verifier и зарегистрированный redirect_uri. Переменные ниже содержат значения текущей попытки авторизации.
cURL
curl --fail-with-body --max-time 15 \
-X POST "http://127.0.0.1:1335/public/v1/oauth/token" \
--data-urlencode "grant_type=authorization_code" \
--data-urlencode "client_id=$OAUTH_CLIENT_ID" \
--data-urlencode "code=$OAUTH_CODE" \
--data-urlencode "redirect_uri=$OAUTH_REDIRECT_URI" \
--data-urlencode "code_verifier=$OAUTH_VERIFIER"Ответы OAuth#
Записанные ответы локального приложения. В успешном ответе скрыт только access_token — секретный токен rh_user_. OAuth возвращает JSON без обёртки success/data/meta. Не сохраняйте токен в браузерном хранилище.
POST /public/v1/oauth/token
HTTP response
HTTP/1.1 200
x-request-id: 0f59bd1c-7dd7-4f88-8fab-4676e5b1068e
cache-control: no-store
pragma: no-cache
content-type: application/json; charset=utf-8
{
"access_token": "[REDACTED: generated user token]",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "downloads:create"
}POST /public/v1/oauth/token
HTTP response
HTTP/1.1 400
x-request-id: f1e15906-6833-4a18-9b82-6a395e97ba09
cache-control: no-store
pragma: no-cache
content-type: application/json; charset=utf-8
{
"error": "invalid_grant",
"error_description": "Token request rejected"
}