封禁与设备风控接入

后台提供账号、账号+IP、账号+IP+设备三档。账号/IP/设备限制独立命中即阻止对应普通业务;不要求三项同时命中。账号和设备可长期或限期,IP最多7天且有独立到期时间。封禁不删除用户、没收余额或改变VIP;原status生命周期字段不改变,后台列表新增banned表示当前有效账号处罚。

App顺序与兼容

  1. 读取设备策略;这是公开配置,不能因此在用户同意前读取Android ID或调用DeviceCheck。
  2. 明确同意当前隐私政策后,Android读取Settings.Secure.ANDROID_ID;iOS使用DCDevice生成临时token。通过设备检查以HTTPS提交,开发固定码HTTP例外不覆盖设备材料。
  3. 成功后再执行原登录流程。Android检查有效24小时,iOS15分钟;本地只需保存当前安装的检查期限,不持久化原始Apple token;清除数据/卸载重装后新安装重新检查。
  4. required=true的平台必须有有效检查才可申请登录验证码、三方登录、刷新及普通业务。遇到DEVICE_CHECK_REQUIRED先重新检查,成功后由原操作决定能否重试;写业务不自动重发。
  5. 配套发布默认required=false,避免旧客户端突然全部失败;此时后台第三档返回不可执行状态,不能用安装UUID替代系统设备标识。两端接入及实际HTTPS准备好后再逐平台启用,不能把客户端未上报当“安全设备”。

手机号、邮箱共用验证码申请的账号预检:点击获取验证码时已封禁则返回403 ACCOUNT_BANNED,不投递、不创建挑战,客户端直接提示受限而不进入验证码输入页。发码前没有完成身份验证,原因和期限不公开,申诉不绑定用户ID。验证码验证与会话签发时再次检查,刷新、带Bearer业务、受保护媒体和长连接仍在服务端拦截;移除Bearer也不能匿名取得受保护业务数据。

现有X-Device-Id保持安装UUID及会话绑定;Android系统ID单独处理,服务端只持久化用途隔离HMAC。Android自报值不等于可信硬件证明,当前目标是普通清除数据/卸载重装;系统重置、其他系统用户、签名变化或改机不保证。各发行渠道正式签名必须单独核验。

iOS向Apple实际查询/更新bit0,bit1保持;能力需要实际Apple配置。旧标记新安装返回DEVICE_REVIEW_REQUIRED,进入受限复核,不能仅凭标记永久认定新账号违规。后台显示真实平台同步状态,材料过期或平台失败不能显示跨重装封禁已成功。

受限响应

HTTP403的ACCOUNT_BANNED、NETWORK_BANNED、DEVICE_BANNED、DEVICE_REVIEW_REQUIRED是带data的明确例外,其他错误继续使用各接口原结构:

{
  "code": "ACCOUNT_BANNED",
  "message": "此账号已被限制使用,可查看限制详情并提交申诉。",
  "data": {
    "kind": "ACCOUNT",
    "reason": "经核实存在严重违规行为。",
    "expiresAt": null,
    "appealToken": "当前安装的短期受限凭据",
    "appealSubmitted": false
  },
  "errors": []
}

kind为ACCOUNT/IP/DEVICE/DEVICE_REVIEW;reason仅账号身份已验证时可含运营原因,网络与设备返回null以免泄露他人信息。手机/邮箱发码前返回的ACCOUNT限制同样令reason和expiresAt为null,不公开账号详情;此时null表示未公开期限,不代表永久处罚。appealToken有效24小时且绑定当前安装,只用于申诉,不能访问业务;只有已验证本人身份的凭据才绑定用户ID。appealSubmitted为非空布尔,表示当前限制是否已经真实收件;App重登后用此字段恢复“已提交过申诉”,不再开放重复提交。

Flutter停止业务请求并展示限制原因、期限及申诉,不把403无限刷新Token。申诉与设备检查不带旧Bearer,协议、公开配置仍可匿名读取。已有会话撤销后不能使用旧Token;解封后重新登录。新请求及连接认证/活动/默认每秒扫描执行限制,不能承诺取消已开始的事务或绝对零延迟。

提前提示沿用上述data结构,不返回空data:kind=ACCOUNT、reason=null、expiresAt=null,appealToken非空。客户端对未知原因与期限使用已有兜底提示,不能据此认定永久封禁;重新发送验证码同样执行预检,不自动重试。

提交申诉使用当前App主接口和普通请求层,不携带Bearer,不要求另配设备专用地址或先通过设备检查。当前dev固定码且显式允许开发HTTP时可直接申请;正式环境、关闭例外或真实投递模式仍要求HTTPS。设备检查保持独立HTTPS要求,申诉凭据、安装绑定、字段校验和每安装/IP额度保持,后台仅展示收件内容。

申诉流程只有收件与展示。同次账号处罚在服务端跨登录/安装去重,网络限制按处罚与安装隔离;重复POST返回409 APPEAL_ALREADY_SUBMITTED,不覆盖原文或生成新记录。后台只读查看全部内容,是否解封由管理员通过原封禁管理独立操作,不再有核查状态筛选、核查意见或申诉触发的平台清除操作。新处罚可重新提交一次。

管理后台

读取详情取得version与实际访问候选,再封禁或解封。每档均填写原因、期限;IP/设备只能选择服务端实际关联,显示IP和最近使用时间、平台及设备可用状态,不显示原始Android ID或Apple token。共享IP可能影响其他用户,不自动选择账号所有历史网络。

封禁/解封保持OWNER可写、VIEWER只读,HTTPS、Cookie、CSRF、JWE及事务审计保持。409保留输入并提示重读;写结果不明先查询状态,不自动重发。申诉在「封禁管理 → 封禁申诉」只读查看,OWNER/VIEWER均可读,旧state参数不再筛选;旧核查地址固定405,不改状态、审计或平台任务。旧核查和平台字段只保留历史兼容,当前收件不生成平台清除任务;已排队的旧任务继续按原结果处理。

实际验证边界

一次申诉和只读后台已配套发布,505项服务器全量回归零失败/错误/跳过,V25增加归并键与唯一索引;原文、联系方式、匿名身份和旧历史均保留,不凭历史观察伪造账号所有权。验证覆盖并发只收一次、重登和换安装恢复、新处罚可再次提交、共享网络隔离、四语/JWE、旧核查拒绝及旧数据迁移。Flutter24项专项及709项全量通过(43项条件跳过);管理网页12项功能和24组四语布局通过。线上旧申诉逐条指纹核对内容和历史不变,已成功归并;当前设备强制仍关闭。

开发HTTP申诉已部署,495项全量回归通过(新增11项),包括手机/邮箱与双平台的真实HTTP收件及普通业务继续受限;当前规则及实际验证结果以申诉接口为准。15项线上只读封禁检查涵盖策略四语、Android/iOS能力、设备材料保护、后台权限、封禁及申诉读取,开发HTTP空申诉进入400字段校验;此前8项公网请求确认本人资料、钱包、动态及媒体拒绝无凭据和伪造Token。真实封禁与收件使用隔离测试库验证,线上验证不创建测试用户或封禁运行账号。

Flutter和管理网页已交给对应聊天配套,设备required仍false;Apple未配置且实际App HTTPS、发行签名及真机清数据/重装未验收。平台替身、服务端HTTP/JWE测试不能代替这些验证。正式启用前同步真实隐私披露、采集时机和保留期限,保持明确信任TLS,不使用假token或忽略证书校验。