用途:将 dj-rest-auth 安装迁移到 django-modern-rest(DMR)。dj-rest-auth 是 django-allauth 之上的 DRF 层,迁移后账户管理仍归 allauth,通过其 headless 模式提供注册、邮箱验证、密码重置、社交登录、MFA 和 passkey;DMR 负责自有 API 面以及读取 allauth 凭据的认证类。
主要能力与流程:先清点 dj_rest_auth 的 URL、REST_AUTH 设置、被覆盖的序列化器、所用 token 策略及 allauth 安装情况;清点自定义行为(额外字段、校验、信号/分析/审计等副作用)。选定目标认证传输:XSessionTokenSyncAuth、HeaderJWTSyncAuth、CookieJWTSyncAuth、HeaderTokenSyncAuth(含 dmr token 应用)或 DjangoSessionSyncAuth,并保持原有安全姿态。接入 allauth、allauth.account、allauth.headless 到 INSTALLED_APPS 及 AccountMiddleware,选择 app(X-Session-Token)或 browser(会话 Cookie)客户端,移植 ACCOUNT_* 设置。按登录会话、登出、用户详情、改密、密码重置、注册验证、社交登录、MFA 与 passkey 的顺序逐流程迁移,逐项映射端点、移植校验与副作用、更新客户端和测试。allauth headless 没有用户详情端点,需用 DMR Controller 与类型化 DTO 重建,以 TypedDict 为主,区分输入输出,敏感方法加 @sensitive_post_parameters、@sensitive_variables(),凭据视图用 dmr.security 的 NO_STORE_HEADERS。Cookie 凭据需保持 httponly、secure、samesite 等标志,并用 CookieSpec 声明,DMR 自动对 Cookie 认证启用 CSRF。测试按流程保留同结果断言并加负路径与 Cookie 标志断言,最后运行 CI 同款命令、启用 validate_responses,报告分四节:保留行为、获批漂移、安全姿态变化、未解决缺口。
适用场景与限制:适合可协调前后端改动的项目;无法改客户端时应停止,兼容垫片是长期维护负担。端点路径与载荷会改变,allauth 使用 /_allauth/{client}/v1/... 路由与自有信封(status、data、meta);simplejwt 刷新轮换与黑名单不自动生效,需用 dmr jwt blocklist 应用;社交登录回调路径受提供商注册限制;迁移会丢失 OLD_PASSWORD_FIELD_ENABLED、LOGOUT_ON_PASSWORD_CHANGE 等行为,须显式核对。绝不为便利削弱安全属性。