Откройте страницу, чтобы повторить локальную проверку пароля, выдачу 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.
Пароль открыто указан только для воспроизводимости примера.
Словарь хранит хеш пароля.
Хеширование пароля занимает процессорное время.
Поэтому пример использует синхронные функции.
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.