Yagang IdentityOpenIddict 登录流程逐行讲解

授权服务器 + React 登录页：authorize / 登录 / 同意 / 换 token / 登出 / GitHub 外部登录

服务端：OpenIddict + ASP.NET Core Identity

AuthorizationController 负责 authorize / 同意 / 换 token / 登出，AuthenticationController 负责外部提供方回调，AccountController 负责 React 页面的后端（登录提交、防伪令牌、外部登录落地），含 TempData 防环、prompt/max_age、同意分支矩阵。

前端：React 登录页

登录 / 同意 / 登出 / 外部账号确认四页用 React 实现并与 OP 同源托管，页面 URL 用 `Account/*`（`/Account/Login`、`/Account/Consent`、`/Account/Logout`、`/Account/ExternalLoginConfirm`），服务端不渲染任何 Razor 视图。

六个阶段逐步拆解

授权请求与 Challenge、登录、同意、换 token、登出 end-session、GitHub 外部登录——每一阶段都配真实代码与请求响应样例。

踩坑记录

SQLite 库重建、防伪服务、SPA 回落、OpenIddict 选项校验、Windows 目录被占用……全部真实踩过并给出结论。

这个文档站讲什么

它讲的是 yagang-identity 这个学习项目里登录这一条链路的代码：

demos/yagang-client-demo（React SPA，5173）
        │  授权码 + PKCE 授权请求
        ▼
backend/Yagang.Identity（OP + 资源服务器，7016，OpenIddict + ASP.NET Core Identity）
        │  未认证 → 跳登录页；首次授权 → 跳同意页
        ▼
frontend/yagang-identity-app（React，同源托管在 OP 的 wwwroot）

读完流程总览你会得到一张完整时序图；读完代码走读你会知道每一段代码为什么这么写；最后一页坑速查是踩过的坑与结论，可以直接当排错清单用。

阅读顺序建议

这是什么项目 → 项目架构（先建立地图）
流程总览 → ①→⑥ 逐页读（在线路上理解代码）
Program.cs 与三个控制器走读（落回代码）
坑速查（提前知道哪里会翻车）
学完之后：下一步学什么（官方示例地图 + 继续深化的路线）