从零掌握skill和mcp的token机制：新手避坑指南与实战解析

1次阅读

共计 3268 个字符，预计需要花费 9 分钟才能阅读完成。

在构建 skill 和 mcp 系统时，token 机制是身份认证和权限控制的核心。但开发者在实现过程中常会遇到以下三类问题：

过期策略不当 ：token 过期时间设置过长会增加安全风险，过短则影响用户体验。常见错误包括未实现滑动过期（sliding expiration）或未考虑不同业务场景的差异。
签名验证漏洞 ：未正确验证 token 签名（signature）或使用弱加密算法（如 HS256 密钥强度不足），导致伪造 token 风险。
权限粒度失控 ：token 中的 claims 设计不合理，权限（permission）划分过粗或过细，难以维护和扩展。

JWT：
优点：自包含（self-contained）、轻量级，适合无状态服务
缺点：无法主动撤销，需配合黑名单（blacklist）
QPS 测试：单节点可达 10,000+（HS256 算法）
OAuth2.0：
优点：标准化流程，支持多级授权（authorization）
缺点：实现复杂，依赖中心化授权服务器
QPS 测试：授权码模式约 2,000-3,000（含数据库交互）
自定义 token：
优点：完全可控，可定制加密逻辑
缺点：需自行处理安全性和兼容性问题
QPS 测试：取决于实现方式，通常介于前两者之间

# -*- coding: utf-8 -*-
import jwt
import time
from datetime import datetime, timedelta

# 密钥轮换示例（key rotation）current_secret = 'your_strong_secret_2023'
old_secrets = ['previous_secret_2022']

def generate_token(user_id: str, roles: list) -> str:
    payload = {
        'sub': user_id,
        'roles': roles,
        'iat': datetime.utcnow(),
        'exp': datetime.utcnow() + timedelta(hours=1),
        'jti': str(uuid.uuid4())  # 唯一标识防重放
    }
    return jwt.encode(payload, current_secret, algorithm='HS256')

def verify_token(token: str) -> dict:
    try:
        # 尝试当前密钥
        payload = jwt.decode(token, current_secret, algorithms=['HS256'])
        return payload
    except jwt.InvalidSignatureError:
        # 尝试旧密钥（支持密钥轮换期间的无缝过渡）for secret in old_secrets:
            try:
                payload = jwt.decode(token, secret, algorithms=['HS256'])
                return payload
            except jwt.InvalidSignatureError:
                continue
        raise

package main

import (
    "crypto/rsa"
    "github.com/golang-jwt/jwt/v4"
    "time"
)

var (
    currentPrivateKey *rsa.PrivateKey
    currentPublicKey  *rsa.PublicKey
)

// 生成 token
type CustomClaims struct {
    UserID string `json:"sub"`
    Roles  []string `json:"roles"`
    jwt.RegisteredClaims
}

func GenerateToken(userID string, roles []string) (string, error) {
    claims := CustomClaims{
        UserID: userID,
        Roles:  roles,
        RegisteredClaims: jwt.RegisteredClaims{ExpiresAt: jwt.NewNumericDate(time.Now().Add(1 * time.Hour)),
            IssuedAt:  jwt.NewNumericDate(time.Now()),
            ID:        uuid.New().String(),
        },
    }
    token := jwt.NewWithClaims(jwt.SigningMethodRS256, claims)
    return token.SignedString(currentPrivateKey)
}

// 验证 token
func VerifyToken(tokenString string) (*CustomClaims, error) {token, err := jwt.ParseWithClaims(tokenString, &CustomClaims{}, func(token *jwt.Token) (interface{}, error) {return currentPublicKey, nil})
    // ... 错误处理省略...
}

使用 NTP 服务保证各节点时间同步
在 token 验证时允许一定的时间漂移（如±30 秒）

在 payload 中添加 jti（JWT ID）唯一标识
服务端维护已使用 jti 的短期缓存（如 Redis，5 分钟过期）
拒绝重复的 jti 请求

# metrics.yaml 示例
metrics:
  - name: token_requests_total
    type: counter
    help: Total token verification requests
    labels: [status]
  - name: token_processing_seconds
    type: histogram
    help: Token verification latency
    buckets: [0.1, 0.5, 1, 2, 5]

现象：GitHub 提交历史中包含 HS256 密钥
修复：
立即轮换密钥
使用密钥管理服务（如 AWS KMS）
设置.gitignore 排除敏感文件

现象：攻击者修改 alg 为 ”none” 绕过验证
修复：
在解码时明确指定允许的算法列表
拒绝 alg 为 none 的 token

现象：用户权限变更后旧 token 仍有效
修复：
缩短 token 过期时间
实现 token 版本控制
关键操作要求重新认证

错误处理 ：传递 context 以便链路追踪

func VerifyToken(ctx context.Context, token string) (*Claims, error) {// 使用 ctx 传递超时和追踪 ID}

内存安全 ：敏感数据零值化

def clear_secret(secret: str):
    # 将密钥从内存中清除
    secret_array = bytearray(secret, 'utf-8')
    for i in range(len(secret_array)):
        secret_array[i] = 0

性能监控 ：关键路径添加 pprof 埋点

import "runtime/pprof"

func tokenHandler(w http.ResponseWriter, r *http.Request) {pprofLabel := pprof.Labels("path", r.URL.Path)
    pprof.Do(r.Context(), pprofLabel, func(ctx context.Context) {// 处理逻辑})
}

如何设计跨 skill 的 token 联邦体系？建议从以下方向验证：