ViCare 認(rèn)證機(jī)制大改版OAuth2 Client ID 三步搞定告別 401 報(bào)錯(cuò)【免費(fèi)下載鏈接】core:house_with_garden: Open source home automation that puts local control and privacy first.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/co/coreHome Assistant 的 Viessmann ViCare 集成把認(rèn)證機(jī)制從配置里存明文密碼改為 OAuth2 令牌流程。存量配置會(huì)自動(dòng)遷移升級(jí)后設(shè)備照常在線認(rèn)證失敗不再反復(fù)出現(xiàn)。新舊方案對(duì)比從明文密碼到 OAuth2 令牌舊方案用戶名、密碼、Client ID 直接寫在集成配置里每次靠它們調(diào)威仕曼云。新方案集成走 OAuth2 PKCEHA 只保存訪問令牌密碼不再落盤。左側(cè)是舊數(shù)據(jù)流憑證跟著每個(gè)請(qǐng)求走右側(cè)是新數(shù)據(jù)流令牌先找認(rèn)證服務(wù)器要再帶著令牌訪問業(yè)務(wù) API。核心原理令牌怎么拿、舊配置怎么遷遷移邏輯在homeassistant/components/vicare/__init__.py的async_migrate_entry中# 舊配置 1.2 - 2.1 的關(guān)鍵步驟 await async_import_client_credential(hass, DOMAIN, ClientCredential(client_id, , username)) token await hass.async_add_executor_job( obtain_token_via_basic_auth_pkce, client_id, username, password) data.pop(CONF_USERNAME) data.pop(CONF_PASSWORD) # 明文憑證從配置中移除白話說系統(tǒng)把你原來填的 Client ID 導(dǎo)入到 HA 的應(yīng)用憑證框架application_credentials再用一次性的用戶名密碼 PKCE換回令牌存進(jìn)配置隨后把密碼從配置里刪掉。令牌文件名定義在homeassistant/components/vicare/const.py的VICARE_TOKEN_FILENAME遷移完成即刪除舊文件。動(dòng)手配置三步完成 Client ID 申請(qǐng)與集成接入申請(qǐng) Client ID登錄威仕曼開發(fā)者門戶application_credentials提示頁會(huì)給出入口創(chuàng)建新應(yīng)用勾選 IoT 與 Offline Access 權(quán)限。填寫重定向 URI填/auth/external/callback必須與 HA 實(shí)際回調(diào)路徑完全一致復(fù)制生成的 Client ID 與 Client Secret。在 HA 接入設(shè)置 → 設(shè)備與服務(wù) → 添加集成 → Viessmann ViCare按提示粘貼 Client ID / Client Secret跳轉(zhuǎn)威仕曼登錄頁授權(quán)瀏覽器回到 HA 后集成自動(dòng)加載?? 重定向 URI 寫錯(cuò)一個(gè)字符令牌就換不回來表現(xiàn)為重定向 URI 不匹配需要回門戶改完再來。踩坑速查三個(gè)高頻問題現(xiàn)象日志出現(xiàn)OAuth2 token is invalid, please re-authenticate。原因令牌過期且刷新失敗或 Client Secret 被輪換。解法面板會(huì)彈出重新認(rèn)證通知點(diǎn)一下走一遍授權(quán)即可設(shè)備列表不需要重建。現(xiàn)象vicare_token.save文件找不到。原因新版不再使用這個(gè)文件遷移時(shí) HA 會(huì)主動(dòng)刪掉它。解法無需處理如果手動(dòng)升級(jí)后集成掉線重新觸發(fā)一次重新認(rèn)證就能恢復(fù)。現(xiàn)象日志出現(xiàn)Vicare API rate limit exceeded設(shè)備狀態(tài)刷新變慢。原因輪詢頻率超過威仕曼云端限流閾值。解法降低自動(dòng)化里的輪詢間隔。HA 也會(huì)按設(shè)備數(shù)量自動(dòng)拉長緩存時(shí)長默認(rèn) 60 秒 × 設(shè)備數(shù)多設(shè)備家庭屬正常行為。收尾用 OAuth 令牌取代明文密碼是云集成認(rèn)證的正確方向。存量用戶無需手動(dòng)操作升級(jí)后按配置問題面板的通知把重定向 URI 更新一下即可其余交給自動(dòng)遷移。【免費(fèi)下載鏈接】core:house_with_garden: Open source home automation that puts local control and privacy first.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/co/core創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考