AgentSkillsCN

security-fastapi

回顾 FastAPI 的安全审计模式,重点关注依赖项与中间件。在审计认证依赖、CORS 配置以及 TrustedHost 中间件时,可灵活运用此方法。在审查 FastAPI 应用时,应主动展开相关审计工作。 示例: - 用户:“审计 FastAPI 路由的安全性” → 检查 Depends() 与 Security() 的使用情况 - 用户:“检查 FastAPI 的 CORS 设置” → 在 allow_credentials=True 时,验证允许的源 - 用户:“审视 FastAPI 的中间件” → 检查 TrustedHost 与 HTTPSRedirect 的配置 - 用户:“保护 FastAPI 的 API 密钥” → 将密钥从查询参数移至头部方案 - 用户:“扫描 FastAPI 中是否存在潜在隐患” → 检查 Starlette 的集成情况与依赖项的加载顺序

SKILL.md
--- frontmatter
name: security-fastapi
description: |-
  Review FastAPI security audit patterns for dependencies and middleware. Use for auditing auth dependencies, CORS configuration, and TrustedHost middleware. Use proactively when reviewing FastAPI apps.
  Examples:
  - user: "Audit FastAPI route security" → check for Depends() and Security() usage
  - user: "Check FastAPI CORS setup" → verify origins when allow_credentials=True
  - user: "Review FastAPI middleware" → check TrustedHost and HTTPSRedirect config
  - user: "Secure FastAPI API keys" → move from query params to header schemes
  - user: "Scan for FastAPI footguns" → check starlette integration and dependency order
<overview>

Security audit patterns for FastAPI applications covering authentication dependencies, CORS configuration, and middleware security.

</overview> <vulnerabilities>

Core Risks to Check

Missing Auth on Routes

FastAPI expects authentication/authorization via dependencies on routes or routers. If no Depends()/Security() usage exists, review every route for unintended public access.

python
from fastapi import Depends, Security

@app.get("/private")
async def private_route(user=Depends(get_current_user)):
    return {"ok": True}

@app.get("/scoped")
async def scoped_route(user=Security(get_current_user, scopes=["items"])):
    return {"ok": True}

API Key Schemes

If using API keys, SHOULD prefer header-based schemes (APIKeyHeader) and validate the key server-side.

python
from fastapi import Depends, FastAPI
from fastapi.security import APIKeyHeader

api_key = APIKeyHeader(name="x-api-key")

@app.get("/items")
async def read_items(key: str = Depends(api_key)):
    return {"key": key}

CORS: Avoid Wildcards with Credentials

Using allow_origins=["*"] excludes credentialed requests (cookies/Authorization). For authenticated browser clients, MUST explicitly list allowed origins.

python
from fastapi.middleware.cors import CORSMiddleware

app.add_middleware(
    CORSMiddleware,
    allow_origins=["https://app.example.com"],
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

Host Header and HTTPS Enforcement

SHOULD use Starlette middleware to prevent host-header attacks and enforce HTTPS in production.

python
from starlette.middleware.trustedhost import TrustedHostMiddleware
from starlette.middleware.httpsredirect import HTTPSRedirectMiddleware

app.add_middleware(TrustedHostMiddleware, allowed_hosts=["example.com", "*.example.com"])
app.add_middleware(HTTPSRedirectMiddleware)
</vulnerabilities> <commands>

Quick Audit Commands

bash
# Detect FastAPI usage
rg -n "fastapi" pyproject.toml requirements*.txt

# Find routes
rg -n "@app\.(get|post|put|patch|delete)" . -g "*.py"

# Check for auth dependencies
rg -n "Depends\(|Security\(" . -g "*.py"

# CORS config and wildcards
rg -n "CORSMiddleware|allow_origins|allow_credentials" . -g "*.py"

# TrustedHost/HTTPS middleware
rg -n "TrustedHostMiddleware|HTTPSRedirectMiddleware" . -g "*.py"
</commands> <checklist>

Hardening Checklist

  • All sensitive routes require Depends() or Security() auth dependencies
  • API key schemes use headers (APIKeyHeader), not query params
  • allow_origins is explicit when allow_credentials=True
  • TrustedHostMiddleware configured for production domains
  • HTTPSRedirectMiddleware enabled in production (or enforced by proxy)
</checklist> <scripts>

Scripts

  • scripts/scan.sh - First-pass FastAPI security scan
</scripts>