企业官网建设流程全解析

🔐 Pastel 是一款开源的 macOS 工具，用于在 Mac 上搜索并下载 iOS、iPadOS 与 visionOS App 的历史版本（IPA）。由于它必须登录你的 Apple 账户才能从 Apple 服务器获取安装包，很多人担心：密码会不会被明文保存？登录凭证会不会泄露到磁盘上？本文带你完整读懂 Pastel 的账户安全设计——macOS 钥匙串（Keychain）存储密码、AES-256-GCM 会话加密、匿名管道传递凭证，以及 30 天会话有效期机制。

一、先搞清楚：Pastel 会接触到哪些敏感信息？

下载历史版本前，Pastel 需要先以你的 Apple 账户登录 Apple 的 Store 服务。整个流程中会涉及以下四类数据，Pastel 对它们的存放方式各不相同：

官方界面中也明确提示：“Apple 账户密码存储在 macOS Keychain 中，本机只保存账户名称和地区等非敏感设置”（见 Pastel/PastelApp.swift）。

二、密码存哪里？——macOS 钥匙串（Keychain）

🗝️ Pastel 不会把 Apple 账户密码写进任何普通文件，而是交给 macOS 钥匙串统一管理：

• 系统级保护：密码通过kSecClassGenericPassword条目写入钥匙串，并设置kSecAttrAccessibleWhenUnlockedThisDeviceOnly属性——只有本机处于解锁状态时才允许访问，且绝不离开这台 Mac（实现见 Pastel/PastelApp.swift 中的KeychainPasswordStore）。
• 元数据最小化：磁盘上只保留一份accounts.json元数据文件，内容仅有账户名称、商店地区、Apple ID 等非敏感设置，且文件权限被收紧为 600（仅当前用户可读写），存放目录权限为 700（见 Pastel/PastelApp.swift 的CredentialVault）。
• 删除即彻底清除：在 Pastel 中移除账户时，deleteAllPasswords()会同步删除钥匙串中的全部密码条目，不会残留明文（Pastel/PastelApp.swift）。

💡 对新手来说，这意味着：你不需要再手动输入一遍密码让 Pastel“记住”它——密码直接由系统钥匙串保管，Pastel 每次需要时再从钥匙串读取。

三、会话数据如何加密？——AES-256-GCM 完整流程

登录成功后，Apple 会返回一批登录凭证（Token、Cookie 等）。如果直接存到磁盘，任何能读取文件的进程都能拿到它们。Pastel 的做法是：先用 AES-256-GCM 加密，再落盘。

1. 会话密钥从哪里来？

首次使用时，Pastel 调用系统安全随机数接口SecRandomCopyBytes生成一把32 字节（256 位）随机密钥，同样存入 macOS 钥匙串（服务名...session-encryption，见 Pastel/PastelApp.swift 的SessionEncryptionKeyStore）。钥匙只存在于钥匙串里，不写任何明文文件。

2. 加密会话长什么样？

每次保存会话时，Pastel 都会随机生成一个 12 字节 IV，用 AES-256-GCM 算法加密整个会话，并保留认证标签（Auth Tag）用于防篡改。落盘的 JSON 只有四样东西：格式标识pastel-session-aes-gcm-v1、IV、标签、密文——没有任何可读的 Token 或 Cookie（实现见 NodeProject/src/ipa.js 的sealSession/openSession）。

GCM 模式的关键优势：它不只是加密，还带完整性校验。会话文件哪怕被改动一个字节，解密时也会立即失败，而不是解出一堆乱码。

3. 会话文件存放在哪？如何防止暴露身份？

• 位置：~/Library/Application Support/IPA Download/sessions/（见 NodeProject/src/ipa.js）。
• 文件名是账户邮箱的SHA-256 哈希值，而非邮箱本身——即使文件被看到，也无法直接反推出是哪个账户。
• 文件权限 600、目录权限 700；写入时先写临时文件再原子改名，避免写入中途崩溃留下半截文件（NodeProject/src/ipa.js）。
• 早期版本遗留的明文会话会在下次运行时自动一次性迁移为加密格式（NodeProject/src/ipa.js）。

四、密码不落命令行：通过匿名管道传给后端

🚫 一个容易被忽略的泄露点：如果程序把密码作为命令行参数传给子进程，任何用户都可以通过进程列表看到它。Pastel 的做法是——Swift 端把账户、密码、验证码和会话密钥打包成 JSON，通过匿名 stdin 管道一次性写入 Node 后端，写完立即关闭管道（Pastel/PastelApp.swift）。

Node 端则只从标准输入读取这份数据，绝不经过命令行参数或环境变量（NodeProject/src/credentials.js）。密码只存在于两个进程的内存中，用完即弃。

五、会话有效期 30 天，过期自动重新登录

即使加密文件被复制走了，攻击者拿到的也只是密文——没有钥匙串里那把密钥，什么都解不出来。Pastel 还额外设置了“保险丝”：

• 默认 30 天会话有效期（DEFAULT_SESSION_TTL_MS，见 NodeProject/src/ipa.js），到期自动失效，下次使用时重新登录。
• Device GUID 机制：Pastel 26.6 引入设备 GUID 并保存在钥匙串中，减少频繁触发双重认证的打扰；若系统无法提供可靠的 GUID，Pastel 会直接阻止登录以保护账户（Pastel/PastelApp.swift）。
• Token 失效识别：当 Apple 返回会话过期类错误（如 401/403、密码已变更提示）时，Pastel 会识别并引导重新认证，而不是带着失效凭证继续请求（测试见 NodeProject/test/session-expiry.test.js）。

六、这些安全机制可信吗？——有自动化测试兜底

🧪 Pastel 的加密逻辑配有专门的单元测试，例如 NodeProject/test/session-encryption.test.js 验证了三件事：

1. 序列化后的会话文件里确实不包含明文 Token 与 Cookie；
2. 用错误的密钥解密会直接抛错被拒绝；
3. 会话默认有效期确为 30 天。

加上只读仓库的开源属性，任何人都可以对照 NodeProject/src/ 与 Pastel/PastelApp.swift 自行审查这套实现。

七、新手安全使用建议

常见问题 FAQ

Q1：Pastel 会把我的 Apple 密码上传到网上吗？不会。密码只存在于本机钥匙串与进程内存中，仅用于与 Apple 官方服务通信，Pastel 源码中不存在任何第三方上传逻辑。

Q2：删除 Pastel 后，我的密码还在钥匙串里吗？在 App 内移除账户即可同步清除钥匙串条目；即使直接卸载 App，也可在 macOS“钥匙串访问”中按服务名（com.allenmiao.ipahistorydownload）找到并删除残留条目。

Q3：30 天后需要重新输入密码吗？通常只需处理双重认证验证码即可，会话失效后 Pastel 会自动引导重新认证。

🎯小结：Pastel 用“钥匙串存密码 + 钥匙串存密钥 + AES-256-GCM 加密会话 + 匿名管道传参 + 30 天有效期”五层设计，让一个需要登录 Apple 账户的第三方下载工具也能做到敏感数据不落明文、不离本机、可验证、可清除。放心搜索、下载你的 App 历史版本吧。