Files
wecom_it_smart_desk/docs/07-项目管理/任务说明书/任务说明书-Token多IP异常检测.md
T
Simon 44e77dcb0e chore(docs): docs/ 目录全面重新编号 + 重组
**重构前**(旧编号 02-11):
- docs/02-产品需求/      → 00 产品规划/PRD
- docs/03-技术架构/      → 01-05 子目录散落
- docs/04-原型设计/      → 01-02 产品设计(HTML 原型)
- docs/05-原型设计/      → screens/
- docs/06-测试素材/      → 02-E2E / 03-功能 / 04-版本测试
- docs/07-项目管理/      → 任务说明书/日报/计划
- docs/08-安全审计/      → 审计报告
- docs/09-堡垒运维/      → toolbox / deploy
- docs/10-项目管理/      → 任务说明书(重复)
- docs/11-历史归档/      → deploy-nas-archived

**重构后**(新编号 00-07,语义化):
- docs/00-产品开发流程与文档管理规范.md
- docs/00-版本迭代总览.md
- docs/01-产品文档/      (PRD/原型/认证/会话/AI 服务/坐席/集成)
- docs/02-技术文档/      (技术方案/架构图/重构记录/前端改造/实现配置)
- docs/03-测试文档/      (E2E/功能用例/版本报告/缺陷单)
- docs/04-运维文档/      (部署运维/运维指南)
- docs/05-运营文档/      (品牌推广/用户手册)
- docs/06-安全审计/      (审计报告)
- docs/07-项目管理/      (任务说明书/日报/计划/看板)

**净收益**:
- 目录编号与产品文档管理规范对齐(按文档阶段 01-07 编号)
- 消除 02-产品需求 与 10-项目管理 的编号重叠
- 子目录按文档类型分组(如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录)
- 把运维/安全/项目管理从 0X 散落改为 04/06/07

合计 494 文件 + 78495 行 / - 14076 行
2026-08-03 18:46:55 +08:00

2.8 KiB

Token多IP异常检测 - 任务卡

项目: IT智能服务台 模块: 威胁检测 优先级: P1


1. 任务信息

字段 内容
任务ID 需在TAPD/任务管理系统中创建
任务名称 实现Token多IP异常检测功能
任务类型 新功能开发
所属迭代 当前迭代

2. 任务分解

2.1 技术实现 (开发)

子任务 预估工时 状态
创建 token_anomaly_detection.py 检测任务 2h 完成
在 token_service.py 增加 record_token_ip 方法 1h 完成
在 main.py 注册定时任务 0.5h 完成
配置项添加到 config.py 0.5h 完成

2.2 测试验证 (测试)

子任务 预估工时 状态
编写单元测试用例 1h 完成
执行T001-T006单元测试 1h 完成
执行I001-I003集成测试 1h 完成
冒烟测试 0.5h 完成

2.3 部署上线 (运维)

子任务 预估工时 状态
代码Code Review 0.5h 完成
部署到测试环境 0.5h 完成
测试环境验证 1h 完成
部署到生产环境 0.5h 完成
生产环境验证 0.5h 完成

3. 任务依赖

前置任务 后置任务
技术设计文档完成 开发任务开始
开发任务完成 测试任务开始
测试任务完成 部署任务开始

4. 验收标准

4.1 功能验收

  • 同一Token使用3个不同IP时触发告警
  • 同一Token使用1个IP不触发告警
  • 告警内容包含employee_id、ip_count、token_hash
  • 企微收到告警消息

4.2 性能验收

  • 定时任务执行时间 < 100ms
  • Redis存储不影响现有服务

4.3 稳定性验收

  • 告警发送失败不影响主流程
  • Redis连接失败有降级处理

5. 关联产出物

产出物 路径
技术设计文档 docs/04-运维文档/部署运维/技术设计-Token多IP异常检测.md
测试用例 docs/03-测试文档/testing-测试/Token多IP异常检测测试用例.md
部署指南 docs/04-运维文档/部署运维/Token多IP异常检测部署指南.md
检测规则 detections/brute_force_detection.yml

6. 时间估算

阶段 预估工时
技术实现 4h
测试验证 3.5h
部署上线 3.5h
总计 11h

7. 风险与 mitigation

风险 影响 概率 应对
误报率高 告警泛滥 调整阈值或添加白名单
Redis性能影响 服务延迟 优化SCAN操作

创建人: 威胁检测工程师 创建日期: 2026-07-14 任务状态: 待开始