用途:为生产环境中 Clerk 认证相关问题提供事故响应流程,覆盖故障分类、紧急认证绕过、恢复脚本与事后复盘。
主要能力:
- 分类分级:按 Clerk 服务中断、密钥泄露、中间件失败、会话异常、Webhook 积压划分严重级别,并给出诊断脚本思路(检查 status.clerk.com、API 连通性、应用健康端点)。
- 紧急认证绕过:通过环境变量 CLERK_EMERGENCY_BYPASS 在中间件中临时放行全部请求,仅限 Clerk 中断时使用,恢复后须移除。
- 密钥轮换:密钥泄露时在 dashboard.clerk.com 生成新 Secret Key,更新各环境并重新部署,随后验证端点并监控未授权访问。
- 会话恢复:提供管理员端点批量吊销活跃会话,用于大规模异常登出后的恢复。
- Webhook 重放:在 Dashboard 的 Webhook 消息日志中重试失败消息,或核对数据库中缺失的用户记录。
- 事后复盘:提供包含时间线、根因、影响与行动项的事故报告模板。
使用方式:需具备 Clerk Dashboard 访问权限、应用日志与监控、值班联系人及回滚流程。按步骤执行诊断、缓解与恢复,命令与代码保持原样。
适用场景:认证中断、密钥泄露、中间件 500、用户随机登出、Webhook 同步延迟等生产事故。
限制:紧急绕过会临时关闭认证,存在安全风险,仅限服务中断时启用;会话吊销会强制用户重新登录;具体环境变量与部署命令需按实际平台调整。部分细节(如具体监控配置)暂未提供。