设备授权与新设备验证
新设备手机验证是网页端在功能权限之外的一道登录闸门：同一个账号换一台电脑、换一个浏览器，第一次登录会被拦下来，要求用备案手机号收一次短信验证码；验证通过后这台设备进入受信列表，在信任天数内不再重复索要。系统管理 → 用户管理 → 设备授权管理 就是查看和撤销这些受信设备的地方。
一、功能概述
这套机制由三块组成：
| 环节 | 表现 | 依据 |
|---|---|---|
| 设备识别 | 浏览器登录时带上一枚设备指纹，形如 dev_1792930755442… | 前端生成，随登录请求上送 |
| 首次验证 | 弹窗「新设备验证」，向备案手机号发验证码 | 该「用户 + 设备」组合不在受信列表里 |
| 信任期 | 验证通过后写入一条受信记录，到期前不再拦 | 记录里的过期时间 = 最近验证时间 + 信任天数 |
三条要点：
- 按用户各算一份。 受信记录的唯一索引是「用户 + 设备」，同一台电脑，A 验证通过不会让 B 免验证；共用电脑的收银员每人都会被问一次。
- 每次成功登录都会续期。 命中受信记录时把过期时间刷新为「当前时间 + 信任天数」，常用设备实际上不会过期。
- 手机号来自用户档案。 验证用的是 用户管理 里那个人的 手机号码，不是登录者当场输入的号码。
二、界面布局说明
登录页本身只有四个元素：
| 区域 | 内容 |
|---|---|
| 品牌区 | 蓝色标题 安仕达管理系统，副标题 安全登录 · 智能管理，左侧是业务插画 |
| 客户 | 已选定套账时显示租户名（如 安仕达DEMO_O2O）与右侧蓝色 切换套账；首次访问时这里是输入框，占位提示 请输入客户码（10位） |
| 用户名 / 密码 | 操作员编号与密码；密码框不回显 |
| 登录 | 蓝色整宽 登 录 按钮 |
| 页脚 | ANSHIDA © 管理系统 |
新设备被拦时，登录页上叠一层弹窗：
| 元素 | 内容 |
|---|---|
| 图标 | 紫色圆形锁图标 |
| 标题 | 新设备验证 |
| 提示 | 检测到新设备登录，请验证手机号 |
| 手机号 | 中间四位打码的备案号码，形如 138****1234 |
| 验证码框 | 占位文字 请输入验证码 |
| 按钮 | 获取验证码（紫色，点击后进入倒计时）、确认验证（整宽紫色渐变按钮） |
受信设备清单在 用户管理 → 设备授权管理：
| 区域 | 内容 |
|---|---|
| 返回 | 左上 ← 返回用户管理 |
| 标题 | 设备授权管理 |
| 筛选 | 右上用户下拉，默认 -- 全部用户 --，选中后点蓝色 筛选 只看这个人的设备 |
| 列表列 | 用户 / 设备指纹（dev_ 开头，超长截断显示）/ 设备描述（浏览器 UA，如 Mozilla/5.0 (Windows NT 10.0; Win64…）/ 状态（绿色 信任中 徽章）/ 首次验证 / 最近验证 / 过期时间 / 操作 |
| 操作 | 每行一个红色描边的 删除 按钮，删掉即撤销这台设备的信任 |
三、业务操作步骤
在新电脑上第一次登录
- 打开后台地址，输入客户码（或直接使用记住的套账）、用户名、密码，点 登 录。
- 出现「新设备验证」弹窗，核对掩码手机号是不是本人。
- 点 获取验证码，手机收到短信，把六位码填进
请输入验证码。 - 点 确认验证。验证通过即完成登录进入首页，这台设备随后进入受信列表。
- 同一台电脑下次登录不再弹窗；换浏览器或清理浏览器数据后设备指纹会变，会再被问一次。
查某人有哪些受信设备
- 系统管理 → 用户管理，点工具栏 🖥 设备授权管理。
- 默认列出全部用户的全部设备，按 最近验证 倒序。
- 只看一个人：右上下拉选到该用户，点 筛选。
- 对照 过期时间 判断这台设备还能免验证多久。
撤销某台设备的信任
- 在同一页找到那行记录，点 删除。
- 该用户下次从这台设备登录就会重新弹「新设备验证」。
- 典型用途：员工离职、公用电脑外借、怀疑账号在别处登录。
关掉这道验证
开关在租户配置里，名为 启用新设备手机验证，旁边显示 信任天数：N 天，说明文字为「启用后，用户首次在新设备登录需通过手机号短信验证」。这一项由服务方在开通账套时设置，租户后台看不到入口；需要调整请通过服务支持渠道提出。关掉后所有人换设备都不再收码。
四、字段详细说明
| 字段 | 含义 |
|---|---|
| 用户 | 受信设备归属的操作员姓名；同一台电脑被多人使用会出现多行相近的设备描述 |
| 设备指纹 | 浏览器生成的设备标识，dev_ 前缀加一串数字；换浏览器、清理站点数据、隐私模式都会导致指纹变化 |
| 设备描述 | 登录时上送的 User-Agent，用来人肉分辨是哪台机器 |
| 状态 | 信任中 表示当前有效；过期时间过后不再计入 |
| 首次验证 | 这台设备第一次通过短信验证的时间 |
| 最近验证 | 最近一次命中并续期的时间 |
| 过期时间 | 下次要求重新验证的时间点 |
登录态有效期
| 项 | 值 | 影响 |
|---|---|---|
| 后台会话 | 30 分钟，每次请求滑动续期 | 半小时不操作会被要求重新登录 |
| 关闭浏览器 | 会话失效 | 重开浏览器需要重新登录 |
| 接口（REST）会话 | 7 天 | 收银台、门店后台等终端类接入用这一档 |
| 套账记忆 Cookie | 1 年 | 所以登录页默认显示上次的客户而不是输入框 |
五、典型使用场景
员工换笔记本。 新机第一次登录收一次码即可，旧机上的受信记录留着无妨；确认旧机已交接或报废时，到 设备授权管理 删掉那一行。
门店共用一台收银电脑。 每个操作员第一次登录都会被问一次码，属正常现象——信任记录按「用户 + 设备」计算，不会互相顶替。让店员提前把手机号填进用户档案，避免卡在「未绑定手机号」。
怀疑账号被盗用。 到 设备授权管理 按用户筛选，看有没有不认识的 设备描述 或异常时间的 首次验证；有就删掉那一行，同时改密码。
批量演示、不想每次收码。 临时关闭该账套的新设备验证开关（需服务方操作），演示结束再打开。
六、权限控制与前置条件
- 设备授权管理 入口挂在 系统管理 → 用户管理 的工具栏上，能看到这个按钮的人默认能撤销别人的设备信任，建议只开放给系统管理员岗。
- 验证依赖用户档案里的 手机号码：号码为空提示「您的账号未绑定手机号，请联系管理员」；号码不是 11 位数字提示「您的账号手机号格式不正确，请联系管理员」。两种情况下都登不进去，必须回 用户管理 修号码。
- 掩码手机号只暴露前三后四，验证码不会在页面上回显。
- 这道闸门只作用于 Web 登录，不影响桌面客户端与已注册的收银终端。
七、常见问题
换了浏览器又要验证一次。 设备指纹随浏览器与站点数据变化，属预期行为；清理过 Cookie/站点数据的浏览器会被当成新设备。
同办公室同事替我验证过，为什么我还要验证？ 受信记录按用户各自计算，别人验过的设备对你仍是新设备。
手机收不到验证码。 先确认 用户管理 里这个人的 手机号码 正确且能收短信；再确认没被短信通道限流——验证码按「用户 + 时间戳」发单，短时间反复点 获取验证码 会被限。
点确认验证提示号码格式不正确。 档案里的号码位数或字符不对（含空格、区号都会被判为格式错误），改成 11 位纯数字手机号。
能不能让某个人永久免验证。 只能靠信任期自动续期：常用设备每次登录都会把过期时间往后推。要彻底关闭这道闸门只能调整账套级的验证开关。
被踢回登录页不一定是设备问题。 后台会话 30 分钟无操作即失效，重登时若会话状态变了也可能重新走一次验证。