后端認(rèn)證鑒權(quán)身份認(rèn)證【免費下載鏈接】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 倉庫中 docs/socialaccount/providers/figma.rst 為骨架完整講解如何為 Django 項目接入 Figma 第三方登錄從 Figma 開發(fā)者平臺注冊應(yīng)用、獲取 Client ID/Secret、配置回調(diào)地址到啟用figmaprovider、完成登錄與賬號綁定。讀完本文你將能獨立完成 Figma OAuth2 登錄的最小可用配置并理解其底層調(diào)用鏈與用戶數(shù)據(jù)提取邏輯。一、前置準(zhǔn)備在 Figma 開發(fā)者平臺注冊應(yīng)用接入 Figma OAuth2 的第一步是在 Figma 官方開發(fā)者平臺創(chuàng)建 OAuth 應(yīng)用以獲取后續(xù)配置所必需的Client IDkey與Client Secretsecret。原文檔明確指出應(yīng)用注冊入口為應(yīng)用注冊地址獲取 key 和 secrethttps://www.figma.com/developers/apps創(chuàng)建應(yīng)用時平臺會要求你填寫應(yīng)用名稱、重定向回調(diào)地址等基本信息。注冊完成后妥善保存頁面上展示的 Client ID 與 Client Secret——它們將分別作為 django-allauth 側(cè)SOCIALACCOUNT_PROVIDERS配置中的client_id與secret字段。二、開發(fā)環(huán)境回調(diào)地址OAuth2 授權(quán)碼流程要求第三方平臺在授權(quán)完成后將用戶重定向回你的站點因此必須在 Figma 應(yīng)用配置中登記回調(diào)地址。原文檔給出的開發(fā)環(huán)境回調(diào) URL 為http://localhost:8000/accounts/figma/login/callback/該地址由兩部分組成站點根地址http://localhost:8000對應(yīng)本地 Django 開發(fā)服務(wù)器默認(rèn)端口若使用其他端口需同步修改回調(diào)路徑/accounts/figma/login/callback/由 django-allauth 的 URL 路由自動生成見下文“路由與回調(diào)鏈路”一節(jié)無需手工編寫視圖。生產(chǎn)環(huán)境部署時將http://localhost:8000替換為你的正式域名并在 Figma 開發(fā)者平臺中同步登記該生產(chǎn)回調(diào)地址任何未登記的地址都會在授權(quán)回調(diào)時被 Figma 拒絕。三、啟用 Figma Provider1. 安裝并注冊應(yīng)用django-allauth 將 Figma 登錄能力封裝為獨立的 Django 應(yīng)用allauth.socialaccount.providers.figma啟用方式是在INSTALLED_APPS中加入該應(yīng)用。參考倉庫 docs/installation/quickstart.rst 的完整安裝清單示例配置如下INSTALLED_APPS [ django.contrib.admin, django.contrib.auth, django.contrib.contenttypes, django.contrib.sessions, django.contrib.messages, django.contrib.sites, # allauth 核心 allauth, allauth.account, allauth.socialaccount, # 第三方提供商 allauth.socialaccount.providers.figma, ]隨后執(zhí)行數(shù)據(jù)遷移創(chuàng)建社交賬戶相關(guān)數(shù)據(jù)表python manage.py migrate2. 配置 Provider 憑據(jù)在 Django 設(shè)置文件中通過SOCIALACCOUNT_PROVIDERS字典配置 Figma 應(yīng)用憑據(jù)該設(shè)置項的完整說明參見 docs/socialaccount/configuration.rstSOCIALACCOUNT_PROVIDERS { figma: { APP: { client_id: 你的-Figma-Client-ID, secret: 你的-Figma-Client-Secret, } } }client_id與secret即第一步在 Figma 開發(fā)者平臺獲取的 key 與 secret。也可以不在此處硬編碼而是通過 Django Admin 的“社交應(yīng)用Social applications”管理界面創(chuàng)建SocialApp記錄provider 選擇Figma并將站點關(guān)聯(lián)到該應(yīng)用——兩種方式最終都會為授權(quán)流程提供相同的憑據(jù)。四、URL 路由與登錄入口Figma 登錄無需手工編寫視圖或路由。倉庫中 allauth/socialaccount/providers/figma/urls.py 僅有如下內(nèi)容from allauth.socialaccount.providers.figma.provider import FigmaProvider from allauth.socialaccount.providers.oauth2.urls import default_urlpatterns urlpatterns default_urlpatterns(FigmaProvider)default_urlpatterns定義于 allauth/socialaccount/providers/oauth2/urls.py為每個 provider 統(tǒng)一生成兩條路由login/跳轉(zhuǎn)到 Figma 授權(quán)頁的登錄視圖對應(yīng)figma_loginlogin/callback/接收 Figma 授權(quán)回調(diào)的視圖對應(yīng)figma_callback。因此只要你已在根 URLconf 中include(allauth.socialaccount.urls)上述回調(diào)地址/accounts/figma/login/callback/即自動生效。登錄鏈接可通過模板標(biāo)簽生成例如{% load socialaccount %} a href{% provider_login_url figma %}使用 Figma 登錄/a五、OAuth2 端點與登錄流程源碼解析1. 三個關(guān)鍵端點Figma provider 的 OAuth2 適配器定義于 allauth/socialaccount/providers/figma/views.py其中明確聲明了 Figma 平臺的三個核心端點用途URL源碼位置授權(quán)端點authorizehttps://www.figma.com/oauthviews.pyauthorize_url換取令牌端點tokenhttps://www.figma.com/api/oauth/tokenviews.pyaccess_token_url用戶信息端點userinfohttps://api.figma.com/v1/meviews.pyuserinfo_url這些端點繼承自基類OAuth2Adapter見 allauth/socialaccount/providers/oauth2/views.py基類還負(fù)責(zé)令牌解析parse_token從響應(yīng)中讀取access_token并將refresh_token存入token_secret、依據(jù)expires_in計算過期時間。2. 完整登錄調(diào)用鏈Figma 登錄走標(biāo)準(zhǔn)的 OAuth2 授權(quán)碼流程由通用視圖OAuth2LoginView與OAuth2CallbackView驅(qū)動用戶訪問login/OAuth2LoginView將用戶重定向至https://www.figma.com/oauth附帶client_id、redirect_uri即/accounts/figma/login/callback/的絕對地址、state等參數(shù)用戶在 Figma 頁面授權(quán)后Figma 攜帶授權(quán)碼code重定向回login/callback/OAuth2CallbackView使用授權(quán)碼向https://www.figma.com/api/oauth/token發(fā)起 POST 請求換取訪問令牌access_token_method默認(rèn)為POST隨后調(diào)用適配器的complete_login拉取用戶信息并構(gòu)造SocialLogin。3. complete_login 的實現(xiàn)細(xì)節(jié)views.py 中的complete_login展示了令牌的使用方式def complete_login(self, request, app, token, **kwargs): headers {Authorization: fBearer {token.token}} with get_adapter().get_requests_session() as sess: resp sess.get(self.userinfo_url, headersheaders) resp.raise_for_status() extra_data resp.json() return self.get_provider().sociallogin_from_response(request, extra_data)即將 OAuth2 訪問令牌以Authorization: Bearer token的形式附加到請求頭請求https://api.figma.com/v1/me獲取當(dāng)前用戶資料再把返回的 JSON 交給 provider 完成登錄對象構(gòu)造。這里的get_requests_session()走 django-allauth 統(tǒng)一的會話管理見 allauth/socialaccount/adapter.py。六、用戶數(shù)據(jù)提取與賬號綁定用戶資料如何映射為 Django 用戶字段由 provider 類 allauth/socialaccount/providers/figma/provider.py 定義class FigmaProvider(OAuth2Provider): id figma name Figma account_class FigmaAccount oauth2_adapter_class FigmaOAuth2Adapter def extract_uid(self, data): return str(data[id]) def extract_common_fields(self, data): return { email: data.get(email), name: data.get(handle), } def extract_email_addresses(self, data): email EmailAddress( emaildata.get(email), primaryTrue, verifiedFalse, ) return [email]idprovider 標(biāo)識符即 URL 中的figma段同時用于SOCIALACCOUNT_PROVIDERS字典的鍵extract_uid以 Figma 用戶 API 返回的id字段作為社交賬戶的唯一標(biāo)識用于賬號去重與關(guān)聯(lián)extract_common_fields將 Figma 的handle用戶名映射為 Django 用戶nameemail直接透傳extract_email_addresses把 Figma 郵箱生成為EmailAddress記錄標(biāo)記為主郵箱primaryTrue。注意verifiedFalse——郵箱驗證狀態(tài)由 Figma 側(cè)返回的數(shù)據(jù)決定django-allauth 并未將其視為已驗證郵箱這符合第三方登錄郵箱默認(rèn)不可信的保守策略。此外FigmaAccount類提供get_avatar_url()從extra_data[img_url]讀取 Figma 頭像地址供模板中顯示用戶頭像使用。provider 定義文件末尾通過providers.registry.register(FigmaProvider)完成注冊這也是所有 provider 的通用注冊方式provider 基類見 allauth/socialaccount/providers/base/provider.py。七、常見問題與排障回調(diào)地址不匹配redirect_uri mismatch請逐一核對 Figma 開發(fā)者平臺登記的回調(diào)地址、Django 站點配置中的域名SITE_ID對應(yīng)站點的 domain需與回調(diào)絕對地址的域名一致含http://localhost:8000或生產(chǎn)域名以及實際訪問地址是否三者一致。郵箱未驗證導(dǎo)致的流程中斷由于extract_email_addresses將郵箱標(biāo)記為verifiedFalse若項目啟用了“郵箱驗證后才可登錄”等嚴(yán)格策略Figma 登錄后可能要求用戶額外驗證郵箱?？赏ㄟ^調(diào)整ACCOUNT_EMAIL_VERIFICATION等賬戶設(shè)置適配業(yè)務(wù)需求參見 docs/account/configuration.rst。生產(chǎn)環(huán)境必須使用 HTTPSOAuth2 回調(diào)涉及令牌交換生產(chǎn)環(huán)境應(yīng)確保站點啟用 HTTPS并在 Figma 平臺登記對應(yīng)的https://回調(diào)地址。用戶信息拉取失敗complete_login中resp.raise_for_status()會在 Figma 用戶信息端點返回非 2xx 時拋出異常請檢查令牌是否有效、應(yīng)用是否仍處于可用狀態(tài)如已被刪除或令牌被撤銷。八、延伸閱讀Figma provider 文檔原始出處docs/socialaccount/providers/figma.rst全部已支持 provider 索引docs/socialaccount/providers/index.rst完整安裝步驟docs/installation/quickstart.rst社交賬戶通用配置與SOCIALACCOUNT_PROVIDERS說明docs/socialaccount/configuration.rstFigma provider 實現(xiàn)源碼provider.py、views.py、urls.pyOAuth2 通用適配器與路由生成邏輯oauth2/views.py、oauth2/urls.py贊分享后端認(rèn)證鑒權(quán)身份認(rèn)證【免費下載鏈接】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點擊查看免費下載相關(guān)推薦思源宋體TTF字體專業(yè)設(shè)計師的5個隱藏優(yōu)勢與實戰(zhàn)應(yīng)用思源宋體TTF字體專業(yè)設(shè)計師的5個隱藏優(yōu)勢與實戰(zhàn)應(yīng)用 還在為中文排版的專業(yè)性與美觀度難以兼顧而煩惱嗎思源宋體TTF字體或許是你未曾發(fā)現(xiàn)的秘密武器。這款由Ad后端認(rèn)證鑒權(quán)身份認(rèn)證CogVideoX 文生視頻本地實操從一條命令推理到 LoRA 微調(diào)CogVideoX 文生視頻本地實操從一條命令推理到 LoRA 微調(diào) CogVideo 是智譜 AI 開源的文生視頻 / 圖生視頻模型目前主力是 CogVi后端認(rèn)證鑒權(quán)身份認(rèn)證Label Studio 時間序列與音視頻同步標(biāo)注指南基于時間與基于索引的配置方案Label Studio 時間序列與音視頻同步標(biāo)注指南基于時間與基于索引的配置方案 本指南以 Label Studio 官方時間序列模板 timeseries后端認(rèn)證鑒權(quán)身份認(rèn)證上一篇AtlasOS終極指南如何讓你的Windows系統(tǒng)運行如飛性能提升50%下一篇FinBERT-FLS震撼發(fā)布金融前瞻語句智能分類的終極解決方案創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考