auth-system-design
使用严格类型的 Python 示例的身份验证系统设计和实现指南。在以下情况下使用:(1) 设计身份验证流程(注册、登录、注销、刷新),(2) 在会话与基于令牌的身份验证之间进行选择,(3) 设计 JWT 结构和声明,(4) 实施 OAuth 2.0 流程,(5) 设置多服务身份验证模式,(6) 创建密码重置和电子邮件验证流程,(7) 实施基于角色的访问控制 (RBAC),(8) 为身份验证系统创建安全检查表,(9) 规划前端/后端身份验证集成。所有示例都遵循 Python 类型标准和安全最佳实践。
📖 中文导读:使用严格类型的 Python 示例的身份验证系统设计和实现指南。在以下情况下使用:(1) 设计身份验证流程(注册、登录、注销、刷新),(2) 在会话与基于令牌的身份验证之间进行选择,(3) 设计 JWT 结构和声明,(4) 实施 OAuth 2.0 流程,(5) 设置多服务身份验证模式,(6) 创建密码重置和电子邮件验证流程,(7) 实施基于角色的访问控制 (RBAC),(8) 为身份验证系统创建安全检查表,(9) 规划前端/后端身份验证集成。所有示例都遵循 Python 类型标准和安全最佳实践。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: auth-system-design description: | Authentication system design and implementation guidance with Python examples using strict typing. Use when: (1) Designing authentication flows (signup, login, logout, refresh), (2) Selecting between session vs token-based auth, (3) Designing JWT structure and claims, (4) Implementing OAuth 2.0 flows, (5) Setting up multi-service authentication patterns, (6) Creating password reset and email verification flows, (7) Implementing role-based access control (RBAC), (8) Creating security checklists for auth systems, (9) Planning frontend/backend auth integration. All examples follow Python typing standards and security best practices.
Authentication System Design
Design secure and scalable authentication systems following industry best practices and security standards.
Quick Reference
Authentication Method Selection
- Session-based: Traditional web apps, server-side control
- JWT Token: SPA/mobile/microservices, stateless
- OAuth 2.0: Third-party integration, standard protocols
- OpenID Connect: Identity + authentication
JWT Claims Structure
- Standard: iss, sub, aud, exp, nbf, iat, jti
- Custom: userId, roles, permissions
Decision Workflow
1. Choose Authentication Method
| Method | Best For | Key Considerations |
|---|---|---|
| Session-based | Traditional web apps | Server state required |
| JWT Token | SPA, mobile, microservices | Token revocation challenges |
| OAuth 2.0 | Third-party integration | Complex setup |
| OpenID Connect | Identity verification | More complex than OAuth |
2. Design Authentication Flows
- Sign Up: Validate → Create → Verify → Login
- Login: Validate → Generate tokens → Redirect
- Logout: Invalidate → Clear → Redirect
- Refresh: Check expiry → Use refresh token → Retry
3. JWT Structure & OAuth Selection
- Use RS256 algorithm, short expiry (15-60 min)
- Authorization Code flow for web apps, PKCE for public clients
4. Security Validation
- Password hashing (bcrypt/Argon2)
- Rate limiting, HTTPS, token expiration
- Input validation, secure headers
Essential Patterns
Secure Password Handling
import bcrypt
def hash_password(password: str) -> str:
salt = bcrypt.gensalt(rounds=12)
return bcrypt.hashpw(password.encode(), salt).decode()
def verify_password(plain: str, hashed: str) -> bool:
return bcrypt.checkpw(plain.encode(), hashed.encode())
JWT Token Operations
import jwt
from datetime import datetime, timedelta
def create_token(user_id: str, roles: list) -> str:
payload = {
"user_id": user_id,
"roles": roles,
"exp": (datetime.utcnow() + timedelta(minutes=15)).timestamp(),
"iss": "https://your-app.com"
}
return jwt.encode(payload, key="secret", algorithm="RS256")
Resources
| File | Purpose |
|---|---|
| auth-methods.md | Authentication method comparison |
| auth-flows.md | Flow diagrams and implementation |
| jwt-structure.md | JWT guidelines and examples |
| oauth-flows.md | OAuth 2.0 patterns |
| multi-service-auth.md | Multi-service strategies |
| password-reset.md | Secure reset implementation |
| rbac-system.md | Role-based access control |
| security-checklist.md | Security validation |
| integration-guide.md | Frontend/backend integration |
| jwt-template.yaml | JWT schema template |