Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 2.93 KB

2.credential-storage.md

File metadata and controls

37 lines (25 loc) · 2.93 KB
title Provider 凭据存储
description Desktop 与独立 CLI 共用的凭据存储和访问权限

Provider 凭据存储

Desktop、CLI 和 App Server 使用相同的 Provider 凭据 owner。数据库只保存随机引用,原始 API Key 不作为密文伪装后保存在数据库中。

LIME_HOME 指定凭据根目录,未设置时为用户目录下的 .lime。LIME_CREDENTIALS_STORE 在进程启动时读取:

值 行为
未设置或 file 默认模式,与 Codex 的 File 默认策略一致。每条凭据写入 credentials/API_KEY_<随机ID>.json 明文文件;Unix 创建为 0600,Windows 限制当前用户 ACL。不会访问 OS 密钥库或弹出钥匙串密码框,妥善保护用户目录和备份。
keyring 显式选择 OS 密钥库:随机口令保存在 OS 密钥库,凭据加密到 secrets/local.age。密钥库可能要求系统授权;不可用则报错,不自动切换存储。

例如,在没有可用桌面密钥库的独立 CLI 环境中:

LIME_HOME="$PWD/.lime-headless" LIME_CREDENTIALS_STORE=file lime

PowerShell:

$env:LIME_HOME = Join-Path $PWD ".lime-headless"
$env:LIME_CREDENTIALS_STORE = "file"
lime

同一数据库的 Desktop、CLI 和 App Server 必须使用相同的目录与模式。改变环境变量不会迁移现有凭据;切换前在原模式删除 Key,再在新模式重新添加。旧 XOR 凭据不再读取,请在设置中删除旧条目并重新录入。Provider 身份、多 Key 轮询、模型和协议配置保持原有语义。

共享 age 文件的读改写和 keyring 初始化通过同一个进程锁串行执行;锁等待最多十五秒,覆盖真实平台上可能超过三秒的 scrypt 读改写,锁文件不删除。文件模式同样参与锁定。锁定、权限、读取或持久化错误均明确返回,不回退到其他凭据来源。

数据库与密钥库是两个独立存储,不能形成跨存储原子事务:新增数据库写入失败时补偿删除新 secret;删除/替换在数据库提交后清理旧 secret,清理失败会报错。进程在两步之间崩溃可能留下无引用的 secret。备份与恢复必须同时考虑数据库、凭据目录和 OS 密钥库;只复制 age 文件不能恢复其解密口令。

默认策略依据 Codex codex-rs/config/src/types.rs 中的 AuthCredentialsStoreMode::File;Provider 引用和多 Key 管理由 Lime 现役 owner 负责。