Keychain Dumper 技术文档

1. 安装指南

1.1 前提条件

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

1.2 下载与上传

1. 从 GitHub 仓库下载 keychain_dumper 二进制文件。
2. 将 keychain_dumper 上传到目标设备的指定目录（例如 /tmp）。
3. 确保 keychain_dumper 具有可执行权限，若没有，请执行以下命令：

   chmod +x ./keychain_dumper
   

4. 确保 /private/var/Keychains/keychain-2.db 具有可读权限，若没有，请执行以下命令：

   chmod +r /private/var/Keychains/keychain-2.db
   

1.3 更新权限

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

2. 项目的使用说明

2.1 基本使用

1. 上传 keychain_dumper 到目标设备后，可以直接运行以下命令来导出 Keychain 中的密码项：

   ./keychain_dumper
   

2. 默认情况下，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 构建项目

1. 使用 Makefile 构建项目：

   make
   

2. 如果默认的 Apple SDK 无法编译，可以尝试使用 Theos SDK：

   SDK="/path/to/theos/sdks/iPhoneOS14.5.sdk" make
   

4.2 签名

1. 创建自签名证书：
   • 打开 Keychain Access 应用。
   • 创建一个自签名证书，确保证书类型为“代码签名”。
2. 使用以下命令签名：

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

3. 如果需要，可以使用 -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>

5. 联系与帮助

• 如果在使用过程中遇到问题，可以在 GitHub 上提交问题。