python-jose

### Python JOSE库简介

Python JOSE 是一个用于处理 JSON Object Signing and Encryption (JOSE) 的 Python 实现[^1]。此库主要用于创建和验证 JSON Web Tokens (JWT)，这对于保护应用程序接口(APIs) 和实现身份验证至关重要。

#### 安装 python-jose

要开始使用 `python-jose`，可以通过 pip 进行安装：

pip install python-jose[cryptography]

这会安装必要的依赖项以支持加密操作[^3]。

#### 创建 JWT Token

下面展示如何利用 `python-jose` 来生成一个新的 JWT token:

from jose import jwt
import time

secret_key = "your_secret_key"
algorithm = 'HS256'

payload_data = {
    "sub": "user@example.com",
    "exp": int(time.time()) + 3600,  # 设置过期时间为当前时间之后的一小时
}

token = jwt.encode(payload_data, secret_key, algorithm=algorithm)

print(f"Generated JWT: {token}")

这段代码首先导入所需的模块并设置密钥与算法参数；接着准备负载数据（这里包含了用户的邮箱地址作为主题(subject)），最后调用 `jwt.encode()` 方法编码这些信息到一个字符串形式的令牌中[^4]。

#### 解码和验证 JWT Token

当接收到客户端发送过来的 JWT 后，则可以对其进行解码及有效性校验：

try:
    decoded_token = jwt.decode(token, secret_key, algorithms=[algorithm])
    print("Token is valid.")
except jwt.ExpiredSignatureError:
    print("Token has expired.")
except jwt.JWTClaimsError as e:
    print(f"One or more claims are unverifiable; error={e}.")
except Exception as ex:
    print(f"An unexpected exception occurred while decoding the token: {ex}")

上述脚本尝试对传入的 token 执行解码动作，并检查其签名是否有效以及是否存在任何声明错误。如果一切正常则打印消息表示该 token 被认为是有效的；反之亦然，对于不同类型的异常情况分别给出相应的提示信息。