LinuxMint Cinnamon Desklet安全存储API密码的实现方案咨询

一、基于GNOME Keyring的通用实现 #

Cinnamon依托GTK/GNOME生态，默认支持调用gnome-keyring完成敏感信息加密存储，这是目前最成熟的方案，无需额外安装依赖（多数Linux桌面环境预装）。核心逻辑是将密码存入密钥环的专属条目，完全避开明文存储在settings-schema.json的风险。

具体操作步骤 #

• 1. 密钥环调用基础：在Desklet的JS代码中，通过Cinnamon封装的GJS绑定调用Gnome.Keyring模块。
• 2. 存储密码示例：用Desklet唯一ID和API名称生成专属条目，避免与其他应用冲突，调用同步方法存入密码：

const Keyring = imports.gi.Gnome.Keyring;

function saveAPIPassword(apiName, username, password) {
    let attributes = new Keyring.AttributeList();
    attributes.append_string("desklet_id", "com.yourname.yourapidesklet");
    attributes.append_string("api_service", apiName);
    
    const result = Keyring.item_create_sync(
        Keyring.DEFAULT,
        Keyring.ItemType.NETWORK_PASSWORD,
        `${apiName} API Credentials (Your Desklet)`,
        attributes,
        password,
        true // 首次触发系统授权弹窗
    );
    
    if (result !== Keyring.Result.OK) {
        global.logError(`存储密码失败: ${Keyring.Result.get_string(result)}`);
    }
}

• 3. 读取密码示例：通过预设的属性查询密钥环，提取对应密码：

function loadAPIPassword(apiName) {
    let attributes = new Keyring.AttributeList();
    attributes.append_string("desklet_id", "com.yourname.yourapidesklet");
    attributes.append_string("api_service", apiName);
    
    const [result, items] = Keyring.find_items_sync(
        Keyring.ItemType.NETWORK_PASSWORD,
        attributes
    );
    
    if (result === Keyring.Result.OK && items.length > 0) {
        return items[0].secret;
    } else {
        global.logError(`读取密码失败: ${Keyring.Result.get_string(result)}`);
        return null;
    }
}

• 4. 授权处理：首次存储时系统会弹出授权对话框，用户确认后，后续存取操作无需重复验证。

二、Desklet配置的配合优化 #

• 仅在settings-schema.json中存储非敏感配置（如API端点、用户名），密码完全交由密钥环管理。
• 在Desklet的设置UI中添加“保存密码”按钮触发存储逻辑；启动时自动从密钥环读取密码，无需用户重复输入。

三、参考示例Desklet #

社区部分成熟Desklet已采用类似方案，可参考其代码逻辑：

• 第三方增强版Weather Desklet：存储天气API密钥时使用密钥环避免明文暴露。
• Cloud Sync Desklet：同步云服务账号密码时依赖gnome-keyring加密存储。

这些Desklet的代码可在Cinnamon Spices仓库中找到，核心均为调用Gnome.Keyring的同步方法完成密钥存取。

内容的提问来源于stack exchange，提问作者Janos Toberling