当前位置：首页 > news >正文

一文搞懂lamp-boot的网关统一鉴权：从原理到实践的完整教程

news 2026/8/13 17:59:11

一文搞懂lamp-boot的网关统一鉴权：从原理到实践的完整教程

【免费下载链接】lamp-bootlamp-boot 基于jdk21、jdk17、jdk11、jdk8 + SpringBoot的前后分离的快速开发平台，其中的可配置的SaaS功能尤其闪耀，具备RBAC功能、网关统一鉴权、Xss防跨站攻击、自动代码生成、多种存储系统、分布式事务、分布式定时任务等多个模块，支持多业务系统并行开发，支持多服务并行开发，可以作为后端服务的开发脚手架。代码简洁，注释齐全，架构清晰，非常适合学习和企业作为基础框架使用。项目地址: https://gitcode.com/gh_mirrors/la/lamp-boot

lamp-boot是基于SpringBoot的前后分离快速开发平台，其网关统一鉴权功能为多业务系统提供了安全可靠的访问控制机制。本文将从核心原理、配置方法到实际应用，全面解析lamp-boot网关统一鉴权的实现方式，帮助开发者快速掌握这一关键功能。

什么是网关统一鉴权？

网关统一鉴权是lamp-boot平台的核心安全机制之一，通过在网关层集中处理所有请求的认证与授权，确保只有具备合法权限的用户才能访问系统资源。这种机制不仅简化了权限管理流程，还能有效防止未授权访问和跨站攻击，为多服务并行开发提供了坚实的安全保障。

lamp-boot网关鉴权的核心原理

lamp-boot的网关统一鉴权基于Sa-Token权限认证框架实现，通过以下关键组件协同工作：

StpInterfaceImpl实现类：位于lamp-boot-server/src/main/java/top/tangyh/lamp/base/satoken/StpInterfaceImpl.java，负责权限和角色列表的获取。
权限判断流程：
- 从会话中获取用户ID
- 检查用户是否为管理员
- 根据用户角色查询资源权限
- 返回权限列表供网关进行鉴权决策
资源权限管理：通过DefResourceService和BaseRoleService实现资源与角色的关联管理，支持细粒度的权限控制。

网关鉴权的配置步骤

1. 基础配置

在application.yml中启用网关鉴权：

ignore: # 是否启用网关的 uri权限鉴权 (设置为false，则后台不校验访问权限) authEnabled: true # 前端校验按钮 是否区分大小写 caseSensitive: false

配置文件路径：lamp-boot-server/src/main/resources/application.yml

2. 权限忽略配置

设置不需要鉴权的路径：

ignore: anyone: # 请求中 需要携带Tenant 且 需要携带Token(不需要登录)，但不需要验证uri权限 ALL: - /defParameter*/** - /defDict*/** - /defClient*/**

3. 自定义权限实现

通过重写StpInterfaceImpl类的getPermissionList和getRoleList方法，实现自定义的权限逻辑：

@Override public List<String> getPermissionList(Object loginId, String loginType) { SaSession tokenSession = StpUtil.getSession(); long employeeId = tokenSession.getLong(JWT_KEY_EMPLOYEE_ID); // 超管 返回 * List<DefResource> list; boolean isAdmin = baseRoleService.checkRole(employeeId, RoleConstant.TENANT_ADMIN); List<String> resourceCodes = Collections.emptyList(); if (isAdmin) { // 管理员 拥有所有权限 list = List.of(DefResource.builder().code("*").build()); } else { List<Long> resourceIdList = baseRoleService.findResourceIdByEmployeeId(null, employeeId); if (resourceIdList.isEmpty()) { return Collections.emptyList(); } list = defResourceService.findByIdsAndType(resourceIdList, resourceCodes); } return CollHelper.split(list, DefResource::getCode, StrPool.SEMICOLON); }