成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

OIDC/SSO 登录失败错误码分诊

对照 IdP/STS 错误码与登录日志,生成根因候选、修复提纲与用户侧说明;不代改生产应用注册。

飞书DeepSeekClaudeChatGPT🛠️ 开发者工具🏢 企业协作

场景说明

面向独立开发者与企业 IT:把 OIDC/OAuth/SSO 登录失败从「打不开」变成可对照错误码的分诊包,区别于邮箱晨报或开通清单。

案例叙事

01他们做了什么

SSO 一挂,业务方只说「登不进去」。值班需要的是把 AADSTS/OAuth 错误码翻译成「改 redirect URI 还是条件访问还是客户端密钥过期」。本地化做法是让 Agent 当错误码分诊员。

Microsoft Learn《Microsoft Entra authentication & authorization error codes》汇总安全令牌服务返回的 AADSTS 等错误说明、修复建议与部分 workaround,并覆盖如 `invalid_grant`(授权码/刷新令牌/PKCE 等材料无效)、`interaction_required`(需要交互式再认证)等常见授权错误语义。本场景输出:错误指纹、根因候选、配置核对表、用户沟通稿、管理员升级问题。禁止编造租户特有策略结论;禁止指导绕过 MFA/条件访问合规控制。

02实际效果

  • 源未披露量化「平均缩短多少分钟登录故障」;公开文档提供错误码含义与建议修复方向。
  • 一线可用白话回复用户,减少重复截图来回。
  • 升级工单带齐错误码与已核对项,缩短管理员定位时间。

03值得知道

  • 错误码目录会更新;以当前 Learn 页与租户实际策略为准。
  • 同一文案在不同 IdP(Auth0/Okta/自建 OIDC)字段不同,需映射到本环境。
  • 上面写的是 Microsoft 公开错误码说明,不是对你的租户健康诊断。

04可复制提示词

OIDC/SSO 登录失败分诊

你是 OIDC/SSO 登录失败分诊助手。只根据用户提供的错误码与上下文分析,不要编造租户策略。

错误码/原文:{{error}}
应用类型与回调 URI(可脱敏):{{app}}
最近变更:{{changes}}
影响范围(人数/环境):{{blast_radius}}

输出 Markdown:
1. 错误指纹与公开文档中的含义复述(不确定则标「需对照官方码表」)
2. 根因候选(按可能性)
3. 配置核对清单(redirect URI、客户端密钥/证书、授权类型、logout URL、时钟偏移等)
4. 给终端用户的白话说明(不暴露内部细节)
5. 给 IdP 管理员的升级问题(最多 8 个)
禁止指导关闭 MFA 来「快速修好」;禁止索要客户端密钥明文。

修复后回归与对外说明

登录问题已处理,请写回归检查与对外说明草稿。

根因结论:{{root_cause}}
已做变更:{{fix}}

输出:
1. 回归用例(不同浏览器/设备/已登录会话)
2. 给业务群的恢复通知
3. 防再发(密钥到期提醒、回调 URI 变更评审)
不要声称「永不复发」。

怎么做

  1. 粘贴错误码/错误页文案(如 AADSTS* / invalid_grant)、应用类型(Web/SPA/移动)、最近变更(回调 URI、密钥、条件访问)
  2. Agent 对照公开错误码说明,输出:可能根因、要核对的配置项、给终端用户的白话说明、升级给 IdP 管理员的问题清单
  3. 人工在 Entra/IdP 控制台修改;Agent 不持有租户管理员权限

实用提示

  • 先区分「用户账号问题」与「应用注册/重定向配置问题」,避免全员重置密码
  • 与 customer-onboarding-n8n-feishu-checklist 不同:本条是登录失败分诊,不是客户开通 Webhook 待办
#OIDC#SSO#AADSTS#登录失败#身份分诊