后端认证鉴权身份认证【免费下载链接】django-allauthIntegrated set of Django applications addressing authentication, registration, account management as well as 3rd party (social) account authentication. Mirror of https://codeberg.org/allauth/django-allauth/项目地址https://gitcode.com/gh_mirrors/dj/django-allauth点击查看免费下载本文是 django-allauth 的 Discord 社交登录Social Account集成实战指南。文章围绕 docs/socialaccount/providers/discord.rst 展开完整覆盖从 Discord 开发者门户注册应用、获取凭据、配置回调地址到理解identifyscope 作用的全过程并结合仓库内 Discord Provider 的源码实现解析登录、回调、用户数据映射与新旧用户名系统处理的底层逻辑。读完本文你将能够在自己的 Django 项目中稳定接入 Discord 第三方登录并具备定位回调失败、scope 缺失等常见问题的能力。前置准备在 Discord 开发者门户注册应用并获取凭据Discord 官方文档要求接入 OAuth2 前必须在 Discord 开发者门户中创建一个 Application并从中取得集成所需的两个关键凭据Client ID在 django-allauth 中对应SocialApp记录的client_id字段Client Secret对应SocialApp记录的secret字段。在开发者门户创建应用后凭据位于应用的OAuth2页面中。需要特别留意Discord 曾使用discordapp.com/developers/applications作为开发者门户入口目前入口统一位于discord.com/developers/applications本文档原docs/socialaccount/providers/discord.rst中登记的是旧版地址访问时会被重定向不影响使用。提示与大多数 OAuth2 提供商一样Discord 要求你先持有应用凭据才能在 django-allauth 中创建对应的SocialApp记录。完整的提供商通用接入说明参见 docs/socialaccount/providers/index.rst。在 Django Admin 中登记 SocialApp拿到 Client ID 和 Client Secret 后需要通过 Django Admin 添加一条SocialApp记录登录 Django Admin进入Social accounts → Social apps新建记录Provider 选择Discord填入上面获取的Client ID与Client Secret在Sites一栏中将当前站点对应SITE_ID加入关联站点列表——django-allauth 按站点隔离社交应用配置若未关联站点登录时会出现找不到应用的错误保存后即可通过模板中的{% provider_login_url discord %}或 URL 直接发起登录。django-allauth 对 Provider 的识别靠的是固定标识id在 provider.py 中可见class DiscordProvider(OAuth2Provider): id discord name Discord account_class DiscordAccount oauth2_adapter_class DiscordOAuth2Adapter因此 Admin 中的 Provider 选项显示为Discord其内部 id 为discord这也是所有相关 URL 名称与路径的前缀。配置回调地址Redirect URI最关键的步骤原文档反复强调必须在 Discord 应用中添加 Redirect URI。Discord 只会把授权码回调到你预先登记的白名单地址一旦地址不匹配登录必然失败。开发环境下的回调redirectURL 为http://127.0.0.1:8000/accounts/discord/login/callback/把这个地址完整添加到 Discord 应用 OAuth2 页面的Redirects列表中。回调地址为何是这个名字该路径由 urls.py 调用通用的 OAuth2 默认路由生成urlpatterns default_urlpatterns(DiscordProvider)而default_urlpatterns在 oauth2/urls.py 中为每个 Provider 生成两条路由path(login/, login_view, namef{provider.id}_login), path(login/callback/, callback_view, namef{provider.id}_callback),即discord/login/负责发起授权跳转discord/login/callback/负责接收 Discord 回跳并完成登录二者挂在accounts/命名空间下SITE_ID对应的站点根路径因此最终回调地址就是文档中的http://127.0.0.1:8000/accounts/discord/login/callback/。回调配置错误的表现按照 docs/socialaccount/providers/index.rst 的通用说明若回调地址配置不当登录时会看到如下错误An error occurred while attempting to login via your social network account.排查时优先核对两点Discord 侧 Redirects 列表中的地址是否与 django-allauth 实际回调地址逐字符一致注意结尾斜杠以及SITE_ID/ALLOWED_HOSTS是否让build_absolute_uri生成了预期的主机名回调 URL 的绝对地址由 views.py 中的get_callback_url基于当前请求构造。理解 scope为什么identify是必需的原文档明确指出必须请求identifyscope 才能获取用户 ID。extract_uid依赖/api/users/me返回数据中的id字段而该字段只有授权了identifyscope 才会返回。在 provider.py 中可以看到用户唯一标识的提取逻辑def extract_uid(self, data): return str(data[id])如果 scope 中缺少identifydata中不存在id提取会直接抛出KeyError导致登录失败——这就是文档强调该 scope 的原因。默认已包含 identify覆盖时需谨慎好消息是django-allauth 的 Discord Provider 默认 scope 已经包含identify与email见 provider.pydef get_default_scope(self): return [email, identify]因此开箱即用无需额外配置。但如果你通过SOCIALACCOUNT_PROVIDERS自定义了 scope就必须手动保留identify否则会破坏用户 ID 的获取# settings.py SOCIALACCOUNT_PROVIDERS { discord: { # 自定义 scope 时必须保留 identify否则无法获取用户 ID SCOPE: [ identify, email, guilds, # 如需读取用户所在服务器列表 guilds.join, # 如需管理用户加入的服务器 ], # 可选追加授权参数 # AUTH_PARAMS: {prompt: consent}, }, }scope 的解析顺序在 oauth2/provider.py 中定义SocialApp.settings中的scope优先其次读取 Provider 设置的SCOPE最后回退到get_default_scope()。此外Discord 的 scope 使用空格分隔scope_delimiter 见 views.py多个 scope 会以空格拼接后传给 Discord。登录与回调流程从跳转到建档的源码级链路Discord Provider 的 OAuth2 适配器定义在 views.pyclass DiscordOAuth2Adapter(OAuth2Adapter): provider_id discord access_token_url https://discord.com/api/oauth2/token # nosec authorize_url https://discord.com/api/oauth2/authorize profile_url https://discord.com/api/users/me def complete_login(self, request, app, token, **kwargs): headers { Authorization: fBearer {token.token}, Content-Type: application/json, } with get_adapter().get_requests_session() as sess: resp sess.get(self.profile_url, headersheaders) extra_data resp.json() return self.get_provider().sociallogin_from_response(request, extra_data)完整流程分四步发起授权用户访问discord/login/OAuth2LoginView将用户重定向到authorize_url/api/oauth2/authorize携带client_id、回调地址、scope 与 stateDiscord 回跳用户同意授权后Discord 携带code与state重定向到discord/login/callback/由OAuth2CallbackView接收views.py先校验 state再检查error/code参数随后用授权码向access_token_url/api/oauth2/token换取访问令牌拉取用户资料complete_login用Bearer {token.token}请求profile_url/api/users/me将返回的 JSON 作为extra_data交给 Provider用户映射与建档sociallogin_from_response依据extract_uid、extract_common_fields、extract_email_addresses完成账号匹配或新用户创建。其中用户资料的常见字段映射在 provider.pydef extract_common_fields(self, data): return dict( emaildata.get(email), usernamedata.get(username), namedata.get(username), )即email映射到邮箱username同时映射到用户名与显示名。而邮箱地址的导入是有条件的——只有 Discord 标记为已验证的邮箱才会被写入EmailAddress见 provider.pydef extract_email_addresses(self, data): ret [] email data.get(email) if email and data.get(verified): ret.append(EmailAddress(emailemail, verifiedTrue, primaryTrue)) return ret这意味着若用户在 Discord 中未验证邮箱django-allauth 将不会导入该邮箱除非另行配置邮箱必填逻辑也不会发生邮箱冲突判定这一点在排查登录后没有邮箱问题时需要特别留意。重新认证Reauthentication行为provider.py 还针对重新认证场景做了特殊处理def get_auth_params_from_request(self, request, action): ret super().get_auth_params_from_request(request, action) if action AuthAction.REAUTHENTICATE: ret[prompt] consent return ret当以processreauthenticate发起登录时会额外追加promptconsent授权参数强制 Discord 再次弹出用户授权确认页从而保证重新认证语义的真实性。新旧用户名系统的显示名处理与头像 URLDiscord 于 2023 年中期迁移了用户名体系旧体系为username#discriminator如Nelly#1337新体系取消了 discriminator 并引入global_name。DiscordAccount在 provider.py 中对此做了兼容若discriminator是合法的 4 位数字字符串判定为旧体系显示名渲染为username#discriminator若discriminator为02023-06-22 起新用户的占位值且存在global_name判定为新体系显示名取global_name缺失时回退到username若无法判定则仅返回username最终仍以or回退到通用to_str()确保返回值永远是字符串而非None。头像 URL 的构造在 provider.py当extra_data同时包含id与avatar时按 Discord CDN 规则拼接return https://cdn.discordapp.com/avatars/{id}/{avatar}.png.format(**self.account.extra_data)测试验证新旧用户名系统的行为确认仓库测试 tests/apps/socialaccount/providers/discord/tests.py 通过 MockedResponse 模拟了两种响应DiscordTestsdiscriminator: 0且global_name: Nelly新体系断言provider_account.to_str() NellyOldDiscordTestsdiscriminator: 1337旧体系断言provider_account.to_str() Nelly#1337。两个测试类同时覆盖了processconnect账号连接场景验证了登录后能正确生成SocialAccount记录且to_str()行为符合预期。如果你在本地扩展了 Discord Provider 的显示名逻辑可参照这两个测试类补充用例。常见问题排查清单现象可能原因处理方式回调后报 An error occurred while attempting to login...Redirect URI 与回调地址不一致含结尾斜杠、协议、主机名核对 Discord OAuth2 页面 Redirects 列表与http://127.0.0.1:8000/accounts/discord/login/callback/是否逐字符一致登录失败且提示缺少用户 IDscope 被自定义覆盖缺少identify在SOCIALACCOUNT_PROVIDERS[discord][SCOPE]中保留identify登录成功但用户没有邮箱Discord 侧邮箱未验证extract_email_addresses仅导入verifiedTrue的邮箱可引导用户在 Discord 验证邮箱找不到 SocialAppSITE_ID站点未关联在 Admin 的 SocialApp 记录的 Sites 中添加当前站点重新认证时未弹出授权确认缺少promptconsent参数该参数由源码自动追加确认请求的process为reauthenticate小结Discord 登录接入的要点可概括为三条在 Discord 开发者门户创建应用并登记 Client ID/Secret、在应用中添加与 django-allauth 完全一致的回调地址、确保 scope 中包含identify。其余的用户映射、邮箱导入、新旧用户名兼容与重新认证逻辑django-allauth 均已在 discord/provider.py 与 discord/views.py 中开箱实现。遇到问题时优先对照上述排查清单并参考 docs/socialaccount/providers/index.rst 的通用说明与 configuration.rst 的全局配置项。赞分享后端认证鉴权身份认证【免费下载链接】django-allauthIntegrated set of Django applications addressing authentication, registration, account management as well as 3rd party (social) account authentication. Mirror of https://codeberg.org/allauth/django-allauth/项目地址https://gitcode.com/gh_mirrors/dj/django-allauth点击查看免费下载相关推荐django-allauth 集成 Zoom 登录OAuth2 应用注册、回调配置与源码解析django allauth 集成 Zoom 登录OAuth2 应用注册、回调配置与源码解析 本篇技术指南面向使用 django allauth 的开发者讲后端认证鉴权身份认证django-allauth 集成 Yandex 社交登录应用注册、OAuth2 配置与源码解析django allauth 集成 Yandex 社交登录应用注册、OAuth2 配置与源码解析 导读 本文讲解如何在 django allauth 中启用后端认证鉴权身份认证django-allauth 集成 Tumblr OAuth2 登录应用注册、回调配置与 Provider 源码解析django allauth 集成 Tumblr OAuth2 登录应用注册、回调配置与 Provider 源码解析 本文是一份面向 Django 开发者的后端认证鉴权身份认证上一篇如何永久保存微信聊天记录WeChatMsg完整数据留痕终极指南下一篇3分钟搞定敏感数据防护Apache SkyWalking日志脱敏实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
