jwt

JWT (JSON Web Token) patterns for authentication. Use when implementing token-based authentication, verifying tokens, or configuring JWT in Better Auth.

📖 中文导读:JWT (JSON Web Token) patterns for authentication. Use when implementing token-based authentication, verifying tokens, or configuring JWT in Better Auth. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: jwt description: JWT (JSON Web Token) patterns for authentication. Use when implementing token-based authentication, verifying tokens, or configuring JWT in Better Auth. allowed-tools: Read, Edit, Write, Glob, Grep, Bash

JWT Skill

Quick Reference

JWT is used for stateless authentication between frontend (Better Auth) and backend (FastAPI).

JWT Structure

Header.Payload.Signature

# Header
{
  "alg": "HS256",
  "typ": "JWT"
}

# Payload (Claims)
{
  "sub": "user_123",
  "email": "user@example.com",
  "name": "John Doe",
  "iat": 1700000000,
  "exp": 1700600000
}

# Signature
HMAC-SHA256(header.payload, SECRET)

Better Auth JWT Configuration

// frontend/lib/auth.ts
import { createAuth } from "better-auth"
import { jwt } from "better-auth/plugins"

export const auth = createAuth({
  plugins: [
    jwt({
      jwt: {
        secret: process.env.BETTER_AUTH_SECRET!,
        expiry: "7d",
      },
    }),
  ],
})

Backend JWT Verification (Python)

# backend/auth.py
import jwt
from jwt.exceptions import PyJWTError

BETTER_AUTH_SECRET = os.getenv("BETTER_AUTH_SECRET")

async def verify_jwt(token: str) -> dict:
    try:
        payload = jwt.decode(
            token,
            BETTER_AUTH_SECRET,
            algorithms=["HS256"]
        )
        return payload
    except PyJWTError as e:
        raise HTTPException(status_code=401, detail=f"Invalid token: {e}")

async def get_current_user(credentials) -> str:
    payload = await verify_jwt(credentials.credentials)
    return payload.get("sub")

Token Claims

Claim Meaning
sub Subject (user ID)
email User email
name User name
iat Issued at (timestamp)
exp Expiration (timestamp)
iss Issuer
aud Audience

For Detailed Reference

See REFERENCE.md for:

  • Token refresh
  • Token revocation
  • Security best practices
  • Debugging JWT issues