[根目录](../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 | 初始化 | 首次生成模块文档 |