萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python Bottle 框架用戶認證:裝飾器實現優雅的權限控制

痛點:重複的認證代碼

後台多個路由需相同認證邏輯,若在每個視圖函式中重複寫入驗證代碼,違反 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')

進階:角色基礎存取控制 (RBAC)


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='用戶名或密碼錯誤')

最佳實踐總結

  1. 裝飾器順序:@route 在最上方,認證裝飾器在下方 (由內而外執行)。
  2. Secret 管理:使用環境變數儲存 secret,勿硬編碼。
  3. Cookie 安全屬性:httponly=True 防 XSS、secure=True (HTTPS)、samesite='Lax' 防 CSRF。
  4. Token 設計:使用 JWT 或隨機字串 + 伺服器端儲存 (Redis),支援撤銷。
  5. 錯誤處理:統一導向登入頁,避免洩露系統資訊。
copyright © 萬盛學電腦網 all rights reserved