FastAPI JWT 项目教程

FastAPI JWT 项目教程

fastapi-jwtFastAPI native extension, easy and simple JWT auth项目地址:https://gitcode.com/gh_mirrors/fas/fastapi-jwt

1. 项目的目录结构及介绍

fastapi-jwt/
├── app/
│   ├── __init__.py
│   ├── main.py
│   ├── config.py
│   ├── models/
│   │   └── user.py
│   ├── routes/
│   │   └── auth.py
│   ├── services/
│   │   └── jwt_handler.py
├── tests/
│   ├── __init__.py
│   └── test_auth.py
├── .env
├── .gitignore
├── requirements.txt
└── README.md

目录结构介绍

  • app/: 应用的主要代码目录。
    • __init__.py: 初始化文件。
    • main.py: 项目的启动文件。
    • config.py: 项目的配置文件。
    • models/: 数据模型目录。
      • user.py: 用户模型文件。
    • routes/: 路由目录。
      • auth.py: 认证路由文件。
    • services/: 服务目录。
      • jwt_handler.py: JWT 处理文件。
  • tests/: 测试代码目录。
    • __init__.py: 初始化文件。
    • test_auth.py: 认证测试文件。
  • .env: 环境变量文件。
  • .gitignore: Git 忽略文件。
  • requirements.txt: 项目依赖文件。
  • README.md: 项目说明文件。

2. 项目的启动文件介绍

main.py

from fastapi import FastAPI
from app.routes.auth import router as auth_router

app = FastAPI()

app.include_router(auth_router)

@app.get("/")
def read_root():
    return {"message": "Welcome to FastAPI JWT Auth"}

启动文件介绍

  • FastAPI 实例化:创建一个 FastAPI 应用实例。
  • 路由包含:将认证路由包含到主应用中。
  • 根路由:定义一个简单的根路由,返回欢迎消息。

3. 项目的配置文件介绍

config.py

from pydantic import BaseSettings

class Settings(BaseSettings):
    SECRET_KEY: str
    ALGORITHM: str
    ACCESS_TOKEN_EXPIRE_MINUTES: int

settings = Settings()

配置文件介绍

  • BaseSettings:使用 Pydantic 的 BaseSettings 类来加载环境变量。
  • SECRET_KEY:JWT 密钥。
  • ALGORITHM:加密算法。
  • ACCESS_TOKEN_EXPIRE_MINUTES:访问令牌过期时间。

以上是 FastAPI JWT 项目的目录结构、启动文件和配置文件的介绍。希望这篇教程能帮助你更好地理解和使用该项目。

fastapi-jwtFastAPI native extension, easy and simple JWT auth项目地址:https://gitcode.com/gh_mirrors/fas/fastapi-jwt

FastAPI是一个用Python编写的现代Web框架,它提供了高性能和易用性的优点。JWT(JSON Web Token)是一种在网络应用中传递信息的加密方式,它使用JSON对象作为安全令牌。 在FastAPI中使用JWT,你需要先安装PyJWT(Python JWT库)。然后,你需要定义一个JWT密钥(secret key),用于对JWT进行签名和解密。你可以在FastAPI的应用程序中定义一个全局的密钥,或者在每个路由中定义不同的密钥。 接下来,你需要编写一个认证函数,它会在每个请求中验证JWT令牌。如果令牌验证成功,你可以将请求传递给下一个处理程序。否则,你可以返回一个HTTP 401 Unauthorized错误。 最后,你需要在每个需要进行身份验证的路由中添加一个装饰器。这个装饰器将会在路由处理程序之前运行认证函数。 下面是一个使用FastAPIJWT进行身份验证的示例: ```python from fastapi import FastAPI, Depends, HTTPException from fastapi.security import OAuth2PasswordBearer, OAuth2PasswordRequestForm import jwt from jwt import PyJWTError app = FastAPI() JWT_SECRET_KEY = "mysecretkey" ALGORITHM = "HS256" ACCESS_TOKEN_EXPIRE_MINUTES = 30 oauth2_scheme = OAuth2PasswordBearer(tokenUrl="/token") def verify_token(token: str): try: payload = jwt.decode(token, JWT_SECRET_KEY, algorithms=[ALGORITHM]) username = payload.get("sub") if username is None: raise HTTPException(status_code=401, detail="Invalid authentication credentials") except PyJWTError: raise HTTPException(status_code=401, detail="Invalid authentication credentials") @app.post("/token") async def login(form_data: OAuth2PasswordRequestForm = Depends()): # Your authentication logic here access_token = jwt.encode({"sub": form_data.username}, JWT_SECRET_KEY, algorithm=ALGORITHM) return {"access_token": access_token, "token_type": "bearer"} @app.get("/protected") async def protected_route(token: str = Depends(oauth2_scheme)): verify_token(token) return {"message": "Hello World"} ``` 在这个示例中,我们定义了一个JWT_SECRET_KEY和一个ALGORITHM,用于对JWT进行签名和解密。我们还定义了一个ACCESS_TOKEN_EXPIRE_MINUTES,用于设置访问令牌的过期时间。 我们使用FastAPI的OAuth2PasswordBearer类定义了一个oauth2_scheme,用于获取请求中的JWT令牌。 我们编写了一个verify_token函数,它用于验证JWT令牌的有效性。如果令牌验证失败,我们将抛出一个HTTP 401 Unauthorized错误。 我们使用FastAPI的Depends装饰器来定义一个依赖项,它将会在每个需要进行身份验证的路由中运行。这个依赖项会调用oauth2_scheme来获取JWT令牌,并将其传递给verify_token函数进行验证。 最后,我们定义了一个/login路由,用于用户登录并生成JWT令牌。我们还定义了一个/protected路由,它需要进行身份验证才能访问。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

戚恬娟Titus

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值