Аутентификация

OpenPR использует JWT (JSON Web Tokens) для аутентификации пользователей и токены ботов для доступа AI-ассистентов и MCP-сервера.

Аутентификация пользователей (JWT)

Регистрация

Создайте новый аккаунт:

bash

curl -X POST http://localhost:8080/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "name": "John Doe",
    "password": "SecurePassword123"
  }'

Ответ:

json

{
  "code": 0,
  "message": "success",
  "data": {
    "user": {
      "id": "uuid",
      "email": "[email protected]",
      "name": "John Doe",
      "role": "user"
    },
    "access_token": "eyJ...",
    "refresh_token": "eyJ..."
  }
}

Первый пользователь

Первый зарегистрированный пользователь автоматически получает роль admin. Все последующие пользователи по умолчанию получают роль user.

Вход

bash

curl -X POST http://localhost:8080/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "SecurePassword123"
  }'

Ответ включает access_token, refresh_token и информацию о пользователе с role.

Использование токена доступа

Включите токен доступа в заголовок Authorization для всех аутентифицированных запросов:

bash

curl -H "Authorization: Bearer eyJ..." \
  http://localhost:8080/api/workspaces

Обновление токена

Когда истекает срок действия токена доступа, используйте токен обновления для получения новой пары:

bash

curl -X POST http://localhost:8080/api/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "eyJ..."}'

Получение текущего пользователя

bash

curl -H "Authorization: Bearer eyJ..." \
  http://localhost:8080/api/auth/me

Возвращает профиль текущего пользователя, включая role (admin/user).

Конфигурация токена

Время жизни JWT-токенов настраивается через переменные окружения:

Переменная	По умолчанию	Описание
`JWT_SECRET`	`change-me-in-production`	Секретный ключ для подписи токенов
`JWT_ACCESS_TTL_SECONDS`	`2592000` (30 дней)	Время жизни токена доступа
`JWT_REFRESH_TTL_SECONDS`	`604800` (7 дней)	Время жизни токена обновления

Безопасность продакшена

Всегда устанавливайте JWT_SECRET как надёжное случайное значение в продакшене. Значение по умолчанию небезопасно.