3. 认证机制：基于的接口鉴权与动态计划调整的权限控制

在采购计划动态调整场景中，到货验收流程涉及多个系统间的频繁接口调用。若缺乏统一的认证机制，恶意请求可能篡改计划数量、绕过验收节点或越权查看敏感数据。本章聚焦 鉴权 与 动态权限控制 的核心原理与实战技巧，帮助你在接口设计中建立安全防线。

3.1 鉴权的基本流程

鉴权采用“无状态”设计，服务端不保存会话信息，仅通过验证 的签名与有效期来确认请求合法性。典型流程如下：

1. 客户端请求 ：携带用户名/密码或 向认证服务发起请求。
2. 认证服务签发 ：验证身份后，生成包含用户标识、角色、过期时间的 JWT（JSON Web ），并返回给客户端。
3. 客户端携带 调用业务接口：在 HTTP Header 的 Authorization: Bearer <> 中传递。
4. 业务服务验证 ：解析 JWT，校验签名、有效期、权限范围，通过后执行请求。

3.2 动态计划调整中的权限控制模型

采购计划动态调整涉及多个角色（采购员、质检员、仓库管理员、审批人），不同角色对“到货验收”接口的访问粒度不同。推荐采用 RBAC（基于角色的访问控制） 结合 属性级权限 的混合模型：

3.3 刷新与动态权限变更处理

采购计划调整可能持续数小时甚至跨天， 过期会导致流程中断。同时，用户角色可能在流程中被临时提升（如紧急审批授权）。解决方案如下：

• 双 机制：access_（短时效，15-30 分钟）用于业务调用；refresh_（长时效，7 天）用于静默续期。
• 权限缓存失效策略：当用户角色变更时，认证服务推送事件到消息队列，业务服务清除该用户的本地权限缓存，下次请求强制从 中重新解析。
• 动态计划调整专用 Scope：在 中增加 scope: plan_adjust，仅允许携带该 scope 的请求修改计划数量，验收接口则要求 scope: inspection，实现接口级隔离。

// 示例：JWT payload 结构（动态计划调整场景）
{
  "sub": "user_12345",
  "role": "inspector",
  "group_id": "G-202",
  "scope": ["inspection", "plan_query"],
  "iat": 1710000000,
  "exp": 1710001800,
  "jti": "unique--id-abc123"
}

3.4 接口鉴权与权限校验的代码实现要点

以下是一个基于 Spring Boot 的过滤器实现片段，展示如何在到货验收接口中同时验证 有效性与动态权限：

@Component
public class TokenAuthFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest request,
                                    HttpServletResponse response,
                                    FilterChain chain) throws IOException, ServletException {

        String authHeader = request.getHeader("Authorization");
        if (authHeader == null || !authHeader.startsWith("Bearer ")) {
            response.setStatus(401);
            response.getWriter().write("Missing or invalid ");
            return;
        }

        String  = authHeader.substring(7);
        try {
            // 1. 验证 JWT 签名与有效期
            Claims claims = Jwts.parser()
                    .setSigningKey(secretKey)
                    .parseClaimsJws()
                    .getBody();

            // 2. 提取角色与资源范围
            String role = claims.get("role", String.class);
            String groupId = claims.get("group_id", String.class);

            // 3. 动态权限校验：到货验收接口要求 inspector 角色
            String requestURI = request.getRequestURI();
            if (requestURI.contains("/inspection/receive")) {
                if (!"inspector".equals(role)) {
                    response.setStatus(403);
                    response.getWriter().write("Insufficient permissions");
                    return;
                }
                // 4. 将 groupId 放入请求上下文，供后续业务使用
                request.setAttribute("groupId", groupId);
            }

            chain.doFilter(request, response);
        } catch (JwtException e) {
            response.setStatus(401);
            response.getWriter().write(" validation failed");
        }
    }
}

3.5 鉴权与动态权限控制架构图

下图展示了从客户端发起请求到业务服务完成权限校验的完整链路，重点突出 验证与动态计划调整权限的交互关系：

3.6 常见鉴权失败场景与处理策略