68 lines
1.7 KiB
Markdown
68 lines
1.7 KiB
Markdown
|
[根目录](../CLAUDE.md) > **nflg-wms-auth**
|
|||
|
|
|
|||
|
|
# nflg-wms-auth - 认证服务
|
|||
|
|
|
|||
|
|
## 模块职责
|
|||
|
|
|
|||
|
|
SSO 单点登录认证服务，负责：
|
|||
|
|
- Sa-Token SSO Server 端实现
|
|||
|
|
- 用户登录/登出/Token 签发
|
|||
|
|
- LDAP 域账号集成验证
|
|||
|
|
- H5 移动端认证接口
|
|||
|
|
|
|||
|
|
## 入口与启动
|
|||
|
|
|
|||
|
|
| 项 | 值 |
|
|||
|
|
|----|-----|
|
|||
|
|
| 入口类 | `com.nflg.wms.auth.AuthApplication` |
|
|||
|
|
| 端口 | 8101 |
|
|||
|
|
| 服务名 | auth-local |
|
|||
|
|
|
|||
|
|
## 关键依赖
|
|||
|
|
|
|||
|
|
- nflg-wms-common
|
|||
|
|
- nflg-wms-starter
|
|||
|
|
- Spring LDAP Core
|
|||
|
|
- Redisson
|
|||
|
|
- Loki Logback Appender
|
|||
|
|
|
|||
|
|
## 对外接口
|
|||
|
|
|
|||
|
|
| Controller | 路由 | 说明 |
|
|||
|
|
|-----------|------|------|
|
|||
|
|
| `SsoServerController` | SSO 相关路由 | SSO 单点登录服务端接口（ticket 签发/校验/登出等） |
|
|||
|
|
| `H5Controller` | H5 相关路由 | H5 移动端认证接口 |
|
|||
|
|
|
|||
|
|
## 关键目录说明
|
|||
|
|
|
|||
|
|
| 路径 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `AuthApplication.java` | 启动入口 |
|
|||
|
|
| `controller/SsoServerController.java` | SSO 服务端控制器 |
|
|||
|
|
| `controller/H5Controller.java` | H5 移动端控制器 |
|
|||
|
|
| `service/LdapService.java` | LDAP 域账号验证服务 |
|
|||
|
|
|
|||
|
|
## 配置
|
|||
|
|
|
|||
|
|
- Sa-Token SSO 配置：token-name 为 `authorization`，有效期 30 天
|
|||
|
|
- SSO Server 模式二：Ticket 有效期 300 秒，允许所有回调地址
|
|||
|
|
- JWT 秘钥配置
|
|||
|
|
|
|||
|
|
## 测试
|
|||
|
|
|
|||
|
|
- `DeployDevTest.java` - 开发环境部署测试
|
|||
|
|
- `DeploySitTest.java` - SIT 环境部署测试
|
|||
|
|
|
|||
|
|
## 相关文件清单
|
|||
|
|
|
|||
|
|
- `src/main/java/com/nflg/wms/auth/` - 全部源码（4 个文件）
|
|||
|
|
- `src/main/resources/application*.yml` - 配置文件（4 个环境）
|
|||
|
|
- `src/main/resources/logback-spring.xml` - 日志配置
|
|||
|
|
- `pom.xml` - 模块依赖定义
|
|||
|
|
|
|||
|
|
## 变更记录 (Changelog)
|
|||
|
|
|
|||
|
|
| 时间 | 操作 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| 2026-05-23 14:16:58 | 初始化 | 首次生成模块文档 |
|