Skip to content

Latest commit

 

History

History
98 lines (70 loc) · 6.74 KB

authentication.md

File metadata and controls

98 lines (70 loc) · 6.74 KB

Проверить пароль и защитить маршрут JWT

English

Откройте страницу, чтобы повторить локальную проверку пароля, выдачу JWT и отказ защищённого маршрута. Рецепт рассчитан на один учебный сервис и доверенный клиент password flow.

Задача Приём Пример / подробности
Подготовить ключ и пакеты Случайный ключ в окружении Подготовка
Выдать и проверить JWT Argon2, OAuth2PasswordBearer, jwt.decode Полное приложение
Проверить доступ и отказ POST /token, GET /users/me Результат · Тесты
Оценить границы рецепта Ключи, HTTPS, отзыв, роли Ограничения

Краткий справочник · Тесты отказа доступа

Параметр Значение
Уровень Продвинутый
Предпосылки HTTP Authorization, зависимости, переменные окружения, основы хеширования и JWT

Учебный сценарий: форма с логином/паролем → проверка Argon2-хеша → JWT с ограниченным сроком → проверка JWT и пользователя на защищённом маршруте. Это минимальная локальная демонстрация. OAuth2 password flow требует доверенного клиента. Этот flow не заменяет внешний провайдер входа для произвольных приложений.

Подготовка

Используйте Python 3.14.

В отдельном виртуальном окружении:

python -m pip install 'fastapi==0.162.0' 'uvicorn[standard]' python-multipart PyJWT 'pwdlib[argon2]'
export JWT_SECRET_KEY="$(python -c 'import secrets; print(secrets.token_hex(32))')"

Ключ создаётся локально для учебного запуска. Не записывайте ключ в исходники. Используйте один и тот же ключ во всех процессах одного приложения. Новый ключ после перезапуска делает прежние токены недействительными.

Полный пример

Сохраните полный пример в файле auth_app.py. Учебный пользователь — alice. Учебный пароль — training-password-123. Пароль открыто указан только для воспроизводимости примера. Словарь хранит хеш пароля.

auth_app.py

Хеширование пароля занимает процессорное время. Поэтому пример использует синхронные функции. FastAPI выполнит обработчик def и зависимость def в пуле потоков. Dummy hash сохраняет работу проверки хеша для неизвестного имени. Этот приём не обещает одинаковое время HTTP-ответа.

Запуск и результат

uvicorn auth_app:app --reload

В другом терминале:

curl -i -X POST http://127.0.0.1:8000/token -d 'username=alice&password=training-password-123'
curl -i http://127.0.0.1:8000/users/me

Первый запрос даёт 200, access_token и token_type=bearer. Второй запрос даёт 401. В curl передайте полученный токен в заголовке Authorization: Bearer <токен>. Маршрут /users/me вернёт {"username":"alice"}. В Swagger UI /docs нажмите Authorize. Введите учебные username/password. UI сам получит токен у /token. Затем UI подставит заголовок. Неверный пароль даёт 401. Испорченный или истёкший токен даёт 401. Отсутствие обязательного exp даёт 401. Неизвестный пользователь даёт 401. Тесты проверяют эти случаи без запуска HTTP-сервера.

Ограничения и следующие задачи

  • JWT подписан, но payload токена не зашифрован. Не помещайте в payload пароль или другие секреты. Алгоритм задаёт сервер. Сервер не выбирает алгоритм из непроверенного заголовка токена.
  • Демо-словарь и хеш создаются при импорте для одного известного пользователя. Настоящие хеши хранятся в БД. Клиент никогда не получает password_hash.
  • Для эксплуатации нужны HTTPS, ограничения перебора паролей, управление ключами, политика отзыва/обновления токенов и проверка разрешений. При нескольких потребителях/издателях настройте также aud/iss. Здесь приложение одно, поэтому aud/iss отсутствуют.
  • Нет регистрации, восстановления пароля, refresh-токенов и полной интеграции с внешним OAuth/OIDC-провайдером. Не добавляйте эти возможности в короткий рецепт без отдельной модели угроз и требований.

Источники: FastAPI: пароль, хеширование и JWT, PyJWT: проверка exp и обязательных claims, PyJWT: decode и алгоритмы, pwdlib: базовый API.