翻译模块
This commit is contained in:
1 parent
79c43d5340
commit
f6c1cc250e
47 files changed
+10822
-104
No files matched your search
@@ -1,22 +1,19 @@
|
||||
//! 敏感串的统一存放处(Windows 系统凭据管理器,DPAPI 保护)。
|
||||
//! 音乐模块的凭据键约定与便捷读取。
|
||||
//!
|
||||
//! 存在的理由:本项目里出现过**两种安全姿态**——WebDAV 账号密码走凭据管理器,
|
||||
//! 而飞牛登录 token 与 QQ 音乐 Cookie 明文躺在 `settings.json` / localStorage。
|
||||
//! 同样是可冒充身份的凭据,不该区别对待。
|
||||
//! 底层读写原语已抽到 crate 级 [`crate::secrets`](同一套 `Thing` 服务名与迁移
|
||||
//! 策略,翻译模块等其他使用者共享)。本文件只保留**音乐自己的键名**与
|
||||
//! 「前端可达范围」这道闸门,读写一律委托给公共模块,避免出现第二套实现。
|
||||
//!
|
||||
//! 约定:
|
||||
//! - 一律使用 `Thing` 作为凭据服务名,`key` 作为用户名(Entry 的 account)。
|
||||
//! 服务名是历史值,改动会导致已有凭据读不到。
|
||||
//! - 明文只允许存在于内存与系统凭据库,禁止回写 `settings.json` / localStorage。
|
||||
//! - 迁移采用「先写凭据库成功、再清明文」的顺序;**写失败时保留明文**,
|
||||
//! 宁可牺牲一致性也不能把用户已登录的会话弄丢。
|
||||
//! - 非 Windows 平台没有凭据管理器:读取返回 None、写入报错,
|
||||
//! 调用方据此退化为「明文存 settings」(功能优先)。
|
||||
|
||||
use crate::logger;
|
||||
|
||||
/// 凭据服务名(与历史实现一致,改动会导致已有 WebDAV 凭据读不到)。
|
||||
#[cfg(windows)]
|
||||
const SERVICE: &str = "Thing";
|
||||
pub use crate::secrets::{secret_delete, secret_read, secret_write, try_store};
|
||||
|
||||
/// WebDAV 凭据的 key(**历史值,不可更改**)。
|
||||
pub const KEY_WEBDAV: &str = "webdav-credentials";
|
||||
@@ -43,79 +40,12 @@ pub fn frontend_key_allowed(key: &str) -> bool {
|
||||
FRONTEND_KEYS.contains(&key)
|
||||
}
|
||||
|
||||
/// 读取明文(未配置 → `Ok(None)`)。
|
||||
#[cfg(windows)]
|
||||
pub fn secret_read(key: &str) -> Result<Option<String>, String> {
|
||||
let entry = keyring::Entry::new(SERVICE, key).map_err(|e| format!("无法访问系统凭据管理器: {e}"))?;
|
||||
match entry.get_password() {
|
||||
Ok(v) => Ok(Some(v)),
|
||||
Err(keyring::Error::NoEntry) => Ok(None),
|
||||
Err(e) => Err(format!("读取凭据失败: {e}")),
|
||||
}
|
||||
}
|
||||
|
||||
/// 写入明文(覆盖式)。
|
||||
#[cfg(windows)]
|
||||
pub fn secret_write(key: &str, value: &str) -> Result<(), String> {
|
||||
let entry = keyring::Entry::new(SERVICE, key).map_err(|e| format!("无法访问系统凭据管理器: {e}"))?;
|
||||
entry.set_password(value).map_err(|e| format!("保存凭据失败: {e}"))
|
||||
}
|
||||
|
||||
/// 删除凭据(不存在视为成功)。
|
||||
#[cfg(windows)]
|
||||
pub fn secret_delete(key: &str) -> Result<(), String> {
|
||||
let entry = keyring::Entry::new(SERVICE, key).map_err(|e| format!("无法访问系统凭据管理器: {e}"))?;
|
||||
match entry.delete_credential() {
|
||||
Ok(()) => Ok(()),
|
||||
Err(keyring::Error::NoEntry) => Ok(()),
|
||||
Err(e) => Err(format!("删除凭据失败: {e}")),
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(not(windows))]
|
||||
pub fn secret_read(_key: &str) -> Result<Option<String>, String> {
|
||||
Ok(None)
|
||||
}
|
||||
|
||||
#[cfg(not(windows))]
|
||||
pub fn secret_write(_key: &str, _value: &str) -> Result<(), String> {
|
||||
Err("当前平台不支持系统凭据管理器".to_string())
|
||||
}
|
||||
|
||||
#[cfg(not(windows))]
|
||||
pub fn secret_delete(_key: &str) -> Result<(), String> {
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 把明文**尽力**迁入凭据库(失败只记日志,不抛错)。
|
||||
///
|
||||
/// 返回「明文是否可以安全清除」:只有写入成功才为 true。
|
||||
/// 调用方用这个返回值决定要不要清空内存/配置里的明文。
|
||||
pub fn try_store(key: &str, value: &str) -> bool {
|
||||
if value.is_empty() {
|
||||
return true;
|
||||
}
|
||||
match secret_write(key, value) {
|
||||
Ok(()) => true,
|
||||
Err(e) => {
|
||||
logger::log_error(
|
||||
"music",
|
||||
&format!("凭据 {key} 写入系统凭据管理器失败(保留明文作为降级): {e}"),
|
||||
);
|
||||
false
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 读取飞牛连接 token;未配置或读取失败 → 空串(等价于未登录)。
|
||||
pub fn read_feiniu_token(connection_id: &str) -> String {
|
||||
if connection_id.is_empty() {
|
||||
return String::new();
|
||||
}
|
||||
secret_read(&feiniu_token_key(connection_id))
|
||||
.ok()
|
||||
.flatten()
|
||||
.unwrap_or_default()
|
||||
crate::secrets::read_or_empty(&feiniu_token_key(connection_id))
|
||||
}
|
||||
|
||||
/// 该连接是否已有可用 token(供前端展示「已登录」)。
|
||||
|
||||
Reference in new issue
Block a user