可疑登录检测：数据、API 和操作
定义了可疑登录检测的存储、端点、事件、错误处理、监控和支持流程。此参考规范固定了采用边界、失败行为和可观察证据，同时允许配置环境特定的限制。
包状态： 参考上下文已准备好供人工审查。合同和测试场景已完成，但不保证采用实现已通过它们。
决策
对于可疑登录检测，采用服务器端凭证和会话生命周期管理，并提供明确保证。公开具有稳定身份、授权、验证、幂等性、兼容性和明确错误的资源或事件合同。此包为参考合同：采用团队必须根据自身环境中的证据选择数值限制、提供商、司法管辖区和运营负责人。
范围
- 本 API 块描述的可疑登录检测参与者、输入、输出、状态、策略或模式版本及外部可见结果。
- 主要和备用接口、后台工作、缓存、集成、支持路径及可行使相同边界的证据。
- 采用特定的配置、推广、恢复和验证职责，以安全应用参考规范。
本块之外
- 为每个采用者选择通用供应商、框架、司法管辖区、数值阈值、保留期限或服务级别目标。
- 声称已针对下游实现运行打包场景，或此参考授予法律、安全或无障碍认证。
合同
- 仅存储受保护的凭证材料，轮换签名和恢复密钥，且避免凭证出现在 URL、日志、分析和支持视图中。
- 将签发、使用、过期、撤销、恢复和重放处理绑定到命名主体和预期操作。
- 返回抗枚举的公共响应，同时保留足够的内部原因和关联数据以支持和应对滥用。
- 在主体、设备、认证器、风险或会话状态变化后重新评估敏感操作，而非永远信任陈旧登录。
- 记录方法或事件语义、必填字段、条件行为、限制和机器可读的错误词汇。
- 拒绝未知的安全敏感字段，保留对显式可扩展数据的前向兼容性。
- 将凭证、认证器、设备、网络、速率、位置、会话和先前账户信号结合在版本化风险策略下，并校准误报复审。
- 使用分级的升级验证、延迟、拒绝、会话撤销和可信通道通知，保持响应抗枚举，并提供攻击者无法触发的审计恢复以防止锁定受害者。
实施指导
- 在将生产流量路由到新版本之前，发布合同夹具和消费者测试。
- 在选择框架或供应商细节前，建模可疑登录检测的输入、输出、参与者、状态、不变量、副作用和证据。
- 将适用的可疑登录检测合同或策略版本与材料状态一起存储，以便迁移、重放和支持决策可追溯。
- 在受控推广后引入路径，比较预期与观察结果，并保持经过测试的恢复路径，直到采用证据完整。
失败处理和保障措施
- 缺失、过期、重放或矛盾的认证证据拒绝操作，并遵循速率限制的恢复路径。
- 无效或矛盾的可疑登录检测状态被拒绝或隔离；实现绝不猜测会扩大权限或重复效果的值。
- 重试受限且使用持久身份；耗尽后，工作进入可检查的终端状态并有责任人。
验证和运营
- 测试重试、重复请求、条件更新、分页或恢复、无效凭证、限制和依赖超时。
- 按合同版本监控可疑登录检测的成功、拒绝、验证失败、依赖失败、重试耗尽和恢复，且不包含敏感负载维度。
- 在策略、模式、依赖、迁移或边界变更后重新运行正负配对夹具，并保留产生的证据。
采用假设
- 示例中的名称和值为具体夹具，不是通用默认值；采用者通过文档化的证据和所有权替换它们。
- 采用系统能够提供认证身份、持久操作或记录版本、受限遥测和受控变更路径。
本包中看似可执行的示例为夹具和验收合同。运行集合验证器检查结构和元数据，然后在目标仓库中翻译并执行场景，最后记录实现证据。
参考文献
- NIST SP 800-63B-4，认证与认证器管理（自 2026-09-08 起适用）