Keychain Dumper 技术文档

2024-12-24 00:32:04作者：盛欣凯Ernestine

1. 安装指南

1.1 前提条件

目标设备必须已经越狱。
确保设备上已安装必要的开发工具和证书。

1.2 下载与上传

从 GitHub 仓库下载 keychain_dumper 二进制文件。
将 keychain_dumper 上传到目标设备的指定目录（例如 /tmp）。
确保 keychain_dumper 具有可执行权限，若没有，请执行以下命令：
```
chmod +x ./keychain_dumper
```
确保 /private/var/Keychains/keychain-2.db 具有可读权限，若没有，请执行以下命令：
```
chmod +r /private/var/Keychains/keychain-2.db
```

1.3 更新权限

在设备上运行 updateEntitlements.sh 脚本，以授予 keychain_dumper 设备上所有可用的权限。
如果需要，可以手动构建工具并签名，具体步骤见下文。

2. 项目的使用说明

2.1 基本使用

上传 keychain_dumper 到目标设备后，可以直接运行以下命令来导出 Keychain 中的密码项：
```
./keychain_dumper
```
默认情况下，keychain_dumper 只会导出“通用密码”和“互联网密码”。如果设备已解锁，可能会显示更多条目。

2.2 高级选项

使用 -h 选项查看所有可用选项：
```
./keychain_dumper -h
```
例如，使用 -a 选项可以导出所有 Keychain 项：
```
./keychain_dumper -a
```

3. 项目API使用文档

3.1 导出特定权限组

使用 -s 选项可以导出特定权限组的所有 Keychain 项：
```
./keychain_dumper -s
```

3.2 导出权限

使用 -e 选项可以导出设备上的权限：
```
./keychain_dumper -e
```

3.3 导出其他类型

使用 -g 导出通用密码
使用 -n 导出互联网密码
使用 -i 导出身份
使用 -c 导出证书
使用 -k 导出密钥

4. 项目安装方式

4.1 构建项目

使用 Makefile 构建项目：
```
make
```
如果默认的 Apple SDK 无法编译，可以尝试使用 Theos SDK：
```
SDK="/path/to/theos/sdks/iPhoneOS14.5.sdk" make
```

4.2 签名

创建自签名证书：
- 打开 Keychain Access 应用。
- 创建一个自签名证书，确保证书类型为“代码签名”。

使用以下命令签名：

CER=<40 character hex string for certificate> make codesign

如果需要，可以使用 -e 选项生成特定设备的权限文件，并替换默认的 entitlements.xml。

4.3 示例权限文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>keychain-access-groups</key>
    <array>
      <string>groupName</string>
    </array>
    <key>platform-application</key> <true/>
    <key>com.apple.private.security.no-container</key>  <true/>
  </dict>
</plist>