後台多個路由需相同認證邏輯,若在每個視圖函式中重複寫入驗證代碼,違反 DRY 原則,難以維護。
Python 裝飾器本質是高階函式,可在不修改原函式的前提下添加橫切關注點 (認證、日誌、快取等)。
from functools import wraps
from bottle import request, redirect, response
def require_auth(func):
"""認證裝飾器:驗證 Cookie 中的用戶憑證"""
@wraps(func)
def wrapper(*args, **kwargs):
# 1. 從 Cookie 獲取憑證
user = request.get_cookie('user', secret='your-secret-key')
token = request.get_cookie('token', secret='your-secret-key')
if not user or not token:
redirect('/login')
return
# 2. 驗證憑證有效性 (示例:查詢資料庫/快取)
if not validate_session(user, token):
# 清除無效 Cookie
response.delete_cookie('user')
response.delete_cookie('token')
redirect('/login')
return
# 3. 將用戶資訊注入請求上下文 (可選)
request.user = user
# 4. 執行原視圖函式
return func(*args, **kwargs)
return wrapper
def validate_session(user, token):
"""實際驗證邏輯:查詢 Redis/資料庫"""
# 這裡示例:簡單檢查 token 格式
return token == f"valid_token_for_{user}"
from bottle import route, template
@route('/admin')
@require_auth
def admin_dashboard():
# request.user 可用
return template('admin_dashboard', user=request.user)
@route('/admin/users')
@require_auth
def admin_users():
users = User.all()
return template('admin_users', users=users)
@route('/admin/settings')
@require_auth
def admin_settings():
return template('admin_settings')
def require_role(*allowed_roles):
"""角色授權裝飾器工廠"""
def decorator(func):
@wraps(func)
def wrapper(*args, **kwargs):
user = request.get_cookie('user', secret='secret')
role = request.get_cookie('role', secret='secret')
if not user or role not in allowed_roles:
redirect('/403') # 權限不足頁面
return
return func(*args, **kwargs)
return wrapper
return decorator
# 使用
@route('/admin/delete')
@require_auth
@require_role('admin', 'superadmin')
def delete_user():
pass
@route('/login', method=['GET', 'POST'])
def login():
if request.method == 'GET':
return template('login')
username = request.forms.get('username')
password = request.forms.get('password')
if authenticate(username, password): # 實作資料庫驗證
# 設定安全 Cookie (HttpOnly, Secure, SameSite)
response.set_cookie('user', username, secret='secret', httponly=True, max_age=3600)
response.set_cookie('token', generate_token(username), secret='secret', httponly=True, max_age=3600)
response.set_cookie('role', get_user_role(username), secret='secret', httponly=True, max_age=3600)
redirect('/admin')
else:
return template('login', error='用戶名或密碼錯誤')
@route 在最上方,認證裝飾器在下方 (由內而外執行)。secret,勿硬編碼。httponly=True 防 XSS、secure=True (HTTPS)、samesite='Lax' 防 CSRF。