Home Assistant Android应用中的localStorage访问令牌问题解析

Home Assistant Android应用中的localStorage访问令牌问题解析

【免费下载链接】android :iphone: Home Assistant Companion for Android 项目地址: https://gitcode.com/gh_mirrors/android5/android

问题背景

在Home Assistant生态系统中，开发者经常需要在前端组件中获取访问令牌(access_token)以实现认证请求。通常情况下，这些令牌会存储在浏览器的localStorage中，键名为"hassTokens"。然而，在Home Assistant Android应用中，开发者发现这一机制出现了异常。

现象描述

当开发者在Home Assistant Android应用(版本2024.10.3-full)中检查localStorage时，发现其中不包含预期的"hassTokens"键值对。同样，window.__tokenCache也未定义。这一问题在标准浏览器环境或其他应用(如Fully Kiosk和WallPanel)中并不存在。

技术分析

Home Assistant Android应用采用了不同于标准浏览器的认证机制。应用内部实现了自己的认证流程，因此不会将令牌存储在WebView的localStorage中。这是出于安全考虑和性能优化的设计选择。

解决方案

开发者可以通过以下替代方案获取访问令牌：

1. 使用hassConnection对象：Home Assistant Android应用提供了hassConnection对象，可以通过它获取认证信息。示例代码如下：

const getTokenFromHassConnection = () => {
    let hassConnection = window.hassConnection || window.parent.hassConnection;
    if(hassConnection) {
        return hassConnection.then((config) => {
            if (config?.auth?.data?.access_token) {
                return `access_token=${config.auth.data.access_token}`;
            }
            return `access_token=`;
        })
        .catch((err) => {
            console.log(`获取访问令牌时出错: ${err}`);
            return `access_token=`;
        })
    }
    return Promise.resolve(`access_token=`);
}

2. 使用官方认证API：建议开发者使用Home Assistant提供的官方前端认证API，而不是直接访问存储的令牌。这种方式更加稳定且受支持。

最佳实践

• 避免直接访问localStorage中的认证信息
• 使用官方提供的认证接口
• 考虑令牌的自动刷新机制
• 处理认证失败的情况

结论

Home Assistant Android应用采用了特定的认证机制，与标准浏览器环境有所不同。开发者应适应这种差异，使用官方推荐的认证方式，以确保应用的稳定性和安全性。通过hassConnection对象获取令牌是目前最可靠的解决方案。

【免费下载链接】android :iphone: Home Assistant Companion for Android 项目地址: https://gitcode.com/gh_mirrors/android5/android