《PRD需求文档-安管SOC平台v1.2.docx》由会员分享，可在线阅读，更多相关《PRD需求文档-安管SOC平台v1.2.docx（30页珍藏版）》请在三一文库上搜索。
1、安连宝平台需求新增说明云安全能力平台项目V1.2V1.218期2018-11-15目录第1 章概述 31. 1文档概述 31.2 范围 31.3 项目描述 3第2 章项目分析 42. 1用户角色 42. 1. 1 角色说明 42. 1. 2 角色从属关系说明 42. 2安全拦截流程 5第3 章忘记密码 53. 1账号信息确认 54. 2身份验证 73. 3设置密码 8第4 章批量升级 94. 1批量升级任务列表 94. 2新建批量升级任务 114. 3查看批量升级任务详情 125. 4升级失败重发 13第5 章批量导入设备 146. 1批量导入设备 15第6 章批量导入用户 167. 1批量导
2、入用户 17第7 章终端控制 188. 1移除终端 189. 2修改终端昵称 19第8 章设备测速 20第 1 章概述1. 1 文档概述目标：为用户方与开发方建立共同协议奠定基础，提高开发效率、强化进度控制，为项目的的评测与验收提供依据。预期读者：用户方的相关业务人员、双方的开发人员、测试人员和系统维护人员。作用：实现开发方与用户方的双向沟通，是把业务需求计算机化的关键步骤。为下一阶段的概要设计工作提供依据。当用户的需求发生变更时，应添写补充说明；如变动过大可形成新版本。2. 2 范围本文档为在安连宝安全云平台1.1 基础上，新增加的功能需求设计文档。3. 3 项目描述移动安全接入产品是一款接
3、入类安全产品，由安全能力云平台、安全接入设备及安全管控APP 构成。主要具备网络接入、安全控制、远程设备监控等功能。用户使用安全接入设备作为网络接入点，连接互联网或企业内网。接入设备会利用安全能力云平台集成的多种URL 特征库， 对用户访问的URL 进行安全检测，对恶意 URL 、钓鱼网站及不良信息网站等进行拦截并对用户进行告警。从而在满足用户移动接入需求的同时，保障用户安全上网。整体架构如下图所示：安全能力云平台（简称“云平台”）是移动安全接入产品的重要组成部分，为安全接入设备提供URL 安全检测和远程配置管理等服务，需要在高并发、低延时的场景下对 URL 安全检测请求进行处理。为了满足上述
4、需求，本期对云平台的开发工作进行招标。第2章 项目分析4. 1 用户角色2. 1. 1 角色说明用户角色角色描述企业管理员（二级用户）企业级的设备管理人员，主要负责安全接入设备的集中管控企业个人用户（三级用户）企业下属的个人用户，该类用户可绑定所属企业的安全接入设备2. 1. 2 角色从属关系说明企业内部人员可通过平台注册页面注册为企业管理员，企业管理员可通过平台安连宝平台需求新增说明第 16 页 共 23 页2. 2 安全拦截流程无变更，略第3章 忘记密码用户通过邮箱进行密码找回的功能。开始3. 1 账号信息确认用例用例编号3.1用例名称账号信息确认简要说明录入要找回的账号，并确认账号基本信
5、息父用例编号优先级中使用频度低执行者二级用户、三级用户前置条件存在邮箱账号后置条件发送验证邮件基本事件流录入邮箱，检查邮箱格式。录入图形验证码，验证图形验证码正确性。点击“下一步”后，检查邮箱今日找回密码次数，如大于5 次，提示错误；检查邮箱是否存在，存在则发送验证邮件；不存在则提示用户特定需求/规则假设和约束异常提示邮箱格式不正确：输入框下方提示请正确输入邮箱；邮箱不存在：输入框下方提示邮箱不存在；找回次数大于5 次：输入框下方提示找回密码次数过多，请明日再试图形验证码不正确：输入框下方提示图形验证码不正确。备注3. 2 身份验证用例用例编号3.2用例名称身份验证简要说明用户点击验证邮件中的
6、链接，验证链接有效性父用例编号优先级中使用频度低执行者二级用户、三级用户前置条件用户打开激活邮件中的链接后置条件跳转至【设置密码】基本事件流用户打开验证邮件中的链接 检查链接有效性，链接失效的提示失效原因 自动跳转至【设置密码】页面，设置对应用户的新密码特定需求/规则假设和约束异常提示备注5. 3 设置密码【原型】用例用例编号3.3用例名称设置密码简要说明用户验证链接验证成功后，设置新密码父用例编号优先级中使用频度低执行者二级用户、三级用户前置条件用户打开激活邮件中的链接、链接验证成功后置条件更新对应用户的密码、更改未激活账号状态为“已激活”基本事件流输入新密码校验密码格式再次输入新密码校验密
7、码格式校验两次输入是否一致点击下一步后更新该用户的密码，若当前用户状态为 “未激活”的， 更改状态为“已激活”特定需求/规则密码包含大小写字母、数字、特殊字符中的三种及以上，长度8-20 位，不能包含空格假设和约束异常提示密码校验不通过：输入框下方提示密码应为大小写字母、数字、特殊字符中的三种及以上，长度8-20 位，不能包含空格两次输入不一致：输入框下方提示两次输入密码不一致。设置完成后，提示密码重置成功备注第 4章 批量升级批量升级功能，适用于企业管理员为本公司设备进行升级推送，设备在线后将自动进行升级。二级用户勾选设备并点击升级升级仅进行一次，由升级包决定升级至何版本；发布新固件包时，删
8、除旧升级包，确保所有旧版本可直升最新版本6. 1 批量升级任务列表用例用例编号4.1用例名称升级任务列表简要说明查看所有批量升级任务父用例编号优先级中使用频度低执行者二级用户前置条件二级用户登录成功后置条件基本事件流进入【批量升级】页面，列表形式呈现当前任务和历史任务；列表字段包括：序号：任务编号时间：创建任务的时间，年月日时分秒形式；任务进度：成功a 个 #升级成功设备数量；失败b 个 #升级失败设备数量（升级失败后重发成功的，算升级成功）进行中X 个#显示进行中的设备数量；状态：设备状态全部为“升级成功”或“升级失败”，显示“已完成”；有进行中的设备，显示“进行中”列表字段包括： 查看详情
9、：打开【任务详情】删除：删除任务#只有已完成的任务可以删除，进行中的任务，删除按钮置灰点击删除按钮后应提供确认弹窗特定需求/规则设备升级状态包括：进行中、升级成功、升级失败。任务状态包括：进行中、已完成。已完成是指，任务中所选的设备均为“升级成功”或 “升级失败”，不存在“进行中”的。 只有状态为“已完成”的任务可以删除，状态为“进行中”的任务，删除按钮不可用。 “无可用更新”的设备，视为“升级成功”假设和约束异常提示无备注4. 2 新建批量升级任务用例用例编号4.2用例名称新建批量升级任务简要说明创建一个新的批量升级任务并执行父用例编号优先级中使用频度低执行者二级用户前置条件二级用户登录成功
10、后置条件新建一个批量升级任务、执行任务并更新设备升级结果基本事件流进入【批量升级】页面，点击【新建批量升级任务】按钮，弹出批量升级弹窗；采用“【分组】-【用户】-【设备】”的树形结构显示该公司所有设备，进行设备复选。#该部分功能与【策略下发】中选择设备部分完全一致点击确定后，弹出确认弹窗，提示信息“已选中N 个设备进行自动升级，设备上线后将自动升级并重启 。是否继续？”# N=选中设备数量再次确认后，新建一个批量升级任务并立即执行。同时，关闭弹窗并刷新【任务列表】。特定需求/规则设备升级应具备异常重试机制，对特定的错误类型自动进行重试，且每个设备最多重试5 次，依然失败再记录设备升级结果假设和
11、约束异常提示创建任务异常，应有气泡提示备注4. 3 查看批量升级任务详情用例用例编号4.3用例名称查看批量升级任务详情简要说明查看一个任务的下发详情父用例编号优先级中使用频度低执行者二级用户前置条件二级用户登录成功、存在批量升级任务后置条件基本事件流点击【批量升级任务列表】中任意栏目【操作】栏中的查看详情，弹窗显示升级结果【升级结果】弹窗中，以分页表格的形式显示各设备升级结果。#该功能与【策略下发】中查看【下发结果】功能一致。操作栏提供【重发】按钮，只有状态为失败的，才可重发【状态】栏中，“升级成功”及 “无可用更新”的显示 “成功”； 其余情况显示“失败”【详情】栏中，“升级成功”的设备显示
12、“已升级成功”；“无可用更新”的设备显示“已是最新版本，无需升级”；“升级失败”的设备，显示设备失败原因。特定需求/规则设备状态为“升级成功”和“进行中”的，【重发】按钮置灰，不可点击假设和约束异常提示备注失败提示：类型返回码原因提示点下载时10下载地址为空升级包下载异常，err:1011版本为空升级包下载异常，err:1112Md5为空升级包下载异常，err:1213文件大小小于1024升级包下载异常，err:138Change_Log为空升级包下载异常，err:815低电量电量过低，请充电后重试9开始下载启动失败升级包下载异常，err:9下载后升级前11版本号不对或为空升级包校验失败,er
13、r:111文件找不到或不完整升级包校验失败,err:12文件md5校验失败升级包校验失败,err:23包文件大小校验失败升级包校验失败,err:34包内版本号校验失败升级包校验失败,err:44. 4 升级失败重发用例用例编号4.4用例名称升级失败重发简要说明对升级失败的设备进行升级重试父用例编号优先级底使用频度低执行者二级用户前置条件二级用户登录成功、存在批量升级任务、任务中存在状态为“升级失败”的设备后置条件重新对指定设备升级、更新任务中的【设备状态】与【任务进度】、更新【任务状态】基本事件流1 、点击【批量升级】-【任务详情】中，升级失败设备的【重发】按钮；2、将该设备状态改为“进行中”
14、，加入升级队列，尝试重新升级安连宝平台需求新增说明3、 刷新【升级结果】弹窗，且不关闭4、 更新【任务进度】、【任务状态】，刷新【任务列表】特定需求/规则如点击重发后的处理时间较长，应提供loading 效果或其他措施，避免用户短时间内多次点击假设和约束异常提示重发指令如未生效（网络原因、后台异常等），应有气泡提示备注第 5章 批量导入设备文件校验数量校验格式校验添加文件是校验数量数据入库安连宝平台需求新增说明第 14页 共 23 页安连宝平台需求新增说明5. 1 批量导入设备安连宝平台需求新增说明第 30 页 共 23 页用例用例编号5.1用例名称批量导入设备简要说明批量导入设备父用例编号优
15、先级中使用频度低执行者二级用户前置条件二级用户登录成功后置条件基本事件流进入【设备】页面，点击批量导入按钮； 下载批量导入模板 选择本地文件上传 进行文件校验 进行导入数量校验 进行内容格式校验 校验失败的立即终止导入并提示 校验全部成功的，录入数据库，并刷新页面设备列表特定需求/规则1. 文件格式只能是.xlsx；2. 文件大小不能为0；3. 企业设备总数量上限为1 万台；4. 单次导入设备最多1000 个；5. 单次导入设备不能为0 个；6. 需校验设备ID 格式，如有异常需显示对应的位置（某行+某列）；7. 需判断设备ID 是否存在，如有异常需显示对应的位置（某行+某列）；8. 导入过程
16、中出现以上任何异常，本次导入终止失效。要求：必须全部校验完成后再开始导入，避免部分成功部分失败的情况！假设和约束异常提示1. 文件格式不正确提示文件格式不正确，请重新上传！2. 文件大小等于0文件为空，请重新上传！3. 企业已有设备数量=1 万企业设备数量已达上限，请联系管理员！4. 单次导入设备数量大于1000 个单次添加设备数量只能小于或等于 1000 个！5. 单次导入设备数量等于0 个未添加设备！6. 设备ID 格式不合法第 X 行，第X 列，设备ID 格式不正确，请修改后，重新上传！7. 设备ID 已存在第 X 行，第X 列，设备ID 已存在，请修改后，重新上传！备注第 6章 批量导
17、入用户文件校验数量校验格式校验发送邮件提示结果激活邮件发送6. 1 批量导入用户用例用例编号6.1用例名称批量导入用户简要说明批量导入用户父用例编号优先级中使用频度低执行者二级用户前置条件二级用户登录成功后置条件基本事件流进入【用户】页面，点击批量导入按钮；下载批量导入模板选择本地文件进行文件校验进行导入数量校验进行内容格式校验上述校验任意一条失败的，立即终止导入并提示原因校验全部成功后，开始发送激活邮件，页面显示LOADING 效果，且禁止点击其余部分，提示用户“请勿关闭此页面”，防止用户做页面跳转。弹窗提示用户导入结果，并刷新用户列表特定需求/ 规则1. 文件格式只能是.xlsx；2. 文
18、件大小不能为0；3. 企业用户总数量上限为1 万人；4. 同一账号每天导入用户不得超过100 个5. 单次导入用户最多20 个；6. 单次导入用户不能为0 个；7. 需校验邮箱格式，如有异常需提示对应的位置（某行+某列）；8. 需判断邮箱是否已存在且已激活，如有异常需提示对应的位置（某行+某列）；9. 导入过程中出现以上任何异常，本次导入立终止失效。注意：必须全部校验成功后再开始导入，避免部分成功部分失败的情况！假设和约束如果在导入过程中（ loading 状态）， 用户通过关闭浏览器、关闭标签页等方式，中断了导入，后台将进行数据回滚，但已发送的邮件无法撤回。导致的效果是：所有本次导入用户均不
19、成功，但有可能造成部分用户收到激活邮件且激活链接无效！异常提示1. 文件格式不正确提示文件格式不正确，请重新上传！2. 文件大小等于0文件为空，请重新上传！3. 企业已有用户数量=1 万企业用户数量已达上限，请联系管理员！4. 该账号在今日导入用户数量=100 企业今日添加用户数量已达上限！5. 单次导入用户数量大于20 个单次添加用户数量只能小于或等于 20 个！6. 单次导入用户数量等于0 个未添加用户！7. 邮箱格式不合法第X 行，第X 列，邮箱格式不正确，请修改后，重新上传！8. 邮箱已存在第 X 行，第X 列，邮箱已存在，请修改后，重新上传！发送激活邮件异常的，在弹窗结果中，显示发送
20、失败的用户，每行一个用户。提供复制按钮，复制全部失败用户文本。备注第 7章 终端控制该版本需求文档新增终端昵称修改以及终端移除功能，其他功能无变更。7. 1 移除终端用例用例编号7.1用例名称移除终端简要说明可选择移除连接设备上的某个终端父用例编号优先级中使用频度低执行者二级用户、三级用户前置条件用户登录成功、设备在线、设备下有可用终端后置条件设置完成后，被移除的终端从当前终端列表中移除基本事件流进入【设备设置终端控制】页面 点击终端列表中的配置按钮 弹框显示终端配置项 点击移除 确认移除后，页面返回到终端列表页并刷新 终端列表不再显示被移除的终端 被移除的终端断开与设备的连接特定需求/ 规则
21、点击移除，气泡确认框显示是否要移除终端假设和约束异常提示终端修改失败！原因【xxx】请稍后操作备注移除功能是一次性的操作，移除后，允许终端再次连接7. 2 修改终端昵称用例用例编号7.2用例名称修改终端昵称简要说明可给终端重命名昵称父用例编号优先级中使用频度低执行者二级用户、三级用户前置条件用户登录成功、设备在线、设备下有可用终端后置条件设置完成后，数据刷新，获取新设置的值基本事件流进入【设备设置终端控制】页面 点击终端列表中的配置按钮 弹框显示终端配置项 文本框输入昵称 点击确认完成修改，页面返回到终端列表页刷新数据特定需求/ 规则1. 终端昵称最大输入长度30 位；2. 只能包含中文、英文
22、、下划线以及“-”，不能包含空格；3. 不能全是特殊字符；4. 昵称可为空；5. 昵称可重复。假设和约束异常提示1. 终端修改失败！原因【xxx 】请稍后操作；2.昵称输入不符合校验在输入框下方提示：长度校验提示：最大长度为30 个字符字符检验提示：只能包含中文、英文、下划线以及“-”，不能包含空格，不能全是特殊字符备注在终端列表中新增一列“终端昵称”第8章 设备测速该功能可检测设备当前的下载速度、带宽以及延时测速中是测试完成返回设备操作页面用例用例编号8用例名称终端测速简要说明可检测设备当前的下载速度、带宽以及延时父用例编号优先级中使用频度低执行者二级用户、三级用户前置条件用户登录成功、设备
23、在线后置条件基本事件流进入【设备设置设备操作】页面点击设备测速按钮弹框显示测速页面Loading 动画展示形式，文字提示测速中测速过程中可点击取消测试按钮或弹框的关闭icon 取消测速，点击后页面回退至设备操作页面测速完成后，显示各项值测速完成后，可点击重新测速按钮进行再次测速或点击关闭icon 关闭测速弹窗特定需求/ 规则1. 在测速弹框显示的过程中，要求点击弹框遮罩层，弹框不关闭；2. 整个测速过程中要求时间待定；3. 下载速度为峰值速度；4. 带宽是基于下载速度进行计算，结果为整数；5. 时延取平均值。假设和约束1. 只能有一个测速任务执行，不可并发；异常提示提示展现形式：全局提示；提示文案：测速失败！原因【XXXX 】请稍后操作；注：1.并发点击测速，测速失败原因提示文案：设备忙，请稍后！2.如果接口不响应的，测速失败原因提示文案：网络超时备注等待执行时间+1s 后再次获取测速结果