公开文档

TrueFrame(水印相机)认证说明

TrueFrame(水印相机)认证说明

生效日期: 2026年11月12日
更新日期: 2026年11月12日
适用应用: TrueFrame(水印相机)iOS 版,最低要求 iOS 17.0
个人信息处理者: fuqing_sun(个人开发者)
联系邮箱: trueframe@zzoxx.cn
验证服务器: https://api.hckz.top
个人主页: https://www.hckz.top

1. 目的与范围

本应用的认证机制用于证明两件事:照片由本应用生成认证信息;照片的图像数据与签名时记录的数据一致。本机验证无需联网;开启联网验证后,可由验证服务器确认该照片声明已登记且未被改动。

照片本身不加密,不使用自定义加密算法;联网验证传输使用标准 X25519、HKDF、AES-256-GCM 与 Ed25519。未开启联网验证或服务器不可用时,仅提供本地认证 Level B;联网登记成功并通过服务器比对时,提供 Level A。

2. 认证信息字段

认证元数据包含:version、type、photoId、sessionId、captureTime、timezone、GPS、address、title、remark、appVersion、hashAlgorithm、hash、signatureAlgorithm、signature、publicKeyId。

签名版本 1.1 将上述全部字段纳入 Ed25519 签名范围;旧版 1.0 仅签核心字段,本版本仍可按 1.0 规则验证旧照片。

拼图额外包含:sessionId、photoCount、layout、photos(每张照片的 PhotoID 与哈希)以及最终拼图的 hash 与 signature。

联网登记声明额外包含:photoId、type、hash、hashAlgorithm、canonicalHash、captureTime、photoCount、layout、photos 摘要、publicKeyId、appVersion;不包含 address、title、remark、GPS 或照片像素。

地址、标题、备注等文本同时出现在可见水印像素中;可见水印像素与 DQT/DHT/SOF 等解码数据一起受图像完整性摘要保护。

3. 密钥体系

应用首次生成认证信息时,在本机创建 Ed25519 私钥与公钥。私钥保存在 Keychain,使用 ThisDeviceOnly 可访问级别,不写入普通文件、不上传、不同步到 iCloud Keychain、不输出到日志。

PublicKey ID 是公钥摘要的短标识,写入认证元数据,用于标识签名所用密钥。开启联网验证时,应用会把公钥、PublicKey ID 和随机 deviceId 提交给验证服务器登记;公钥不是秘密,私钥始终不离开本机。

验证只读取本机已有公钥,不会在验证时新建密钥;本机没有密钥时会明确提示本机无法验证,但仍可尝试联网验证。

开发者无法访问或恢复您的私钥。私钥丢失、设备更换、卸载或系统重置后,旧照片可能无法通过本机验证;若已联网登记,可在其他设备通过服务器验证。

4. 图像哈希

当前版本使用 SHA256-CORE:保留 SOI、DQT、DHT、SOF、DRI、APP14 与 SOS 扫描数据,仅排除 Photos/编辑器可能追加或改写的 APP0–APP13、APP15 与 COM 注释段。

这样既能在 Photos 追加 APP1/APP13 元数据时保持验证成功,也能防止仅修改量化表(DQT)、DHT 或帧头改变解码图像却不被发现。

旧版本使用 SHA256-SCAN(仅扫描数据)或整文件 SHA256(hashAlgorithm = SHA256);本版本仍可验证,但会提示使用旧算法。请使用新版本重新拍摄以获得 SHA256-CORE 认证。

5. 签名规范

签名版本 1.1 覆盖全部认证字段:version、type、photoId、sessionId、hash、captureTime、timezone、GPS、appVersion、title、remark、address、hashAlgorithm、signatureAlgorithm、publicKeyId;拼图还覆盖 photoCount、layout、photos。

签名版本 1.0 仅覆盖核心字段;旧照片按 1.0 规则验证。

联网登记使用同一设备 Ed25519 密钥对声明规范字符串签名;声明只包含哈希与最小元数据,不包含地址、标题、备注或 GPS。

签名用于确认认证字段由本机密钥生成。设备时间与 GPS 在签名时由系统提供;签名证明应用记录了这些值,不证明这些值真实准确。

6. 元数据写入

认证 JSON 以 AC1: 前缀写入 JPEG COM(注释)段,并在 SOS 之前插入,以保持图像扫描数据不变。

应用同时通过 EXIF 写入拍摄时间、时区偏移和 GPS 坐标,便于系统相册显示时间与地点。

EXIF、XMP、ICC 等 APP 段不属于 SHA256-CORE 的取值范围;验证以 AC1 认证字段和 JPEG 解码相关段为准。

Photos、第三方编辑器或分享工具可能保留、追加、修改或剥离元数据;验证时以 AC1 认证段和图像完整性摘要为准。

7. 验证流程

读取照片中的 AC1 认证段;校验 version、type、字段完整性与坐标范围;按 hashAlgorithm 重新计算 SHA256-CORE、SHA256-SCAN 或 SHA256;使用本机已有公钥验证 Ed25519 签名;输出“本软件生成 / 本机签名有效 / 图像完整性”等检查结果。

若开启联网验证,应用会把照片编号、类型、当前图像哈希、认证规范哈希和 PublicKey ID 发送到验证服务器;服务器比对登记记录并返回联网结果。联网结果使用服务器 Ed25519 签名,应用校验通过后才接受。

验证只使用本机 Keychain 中已有的公钥,不会在验证时创建新密钥;若本机没有密钥,会提示本机无法验证,但仍可尝试联网验证。

验证读取相册中该照片的当前资产;如果照片在系统相册中被编辑(裁剪、文字、涂抹、滤镜等),应用会直接判定认证失效,避免只读取未修改的原图而误报正常。

若无法读取当前资产,可能回退到系统提供的编码数据,此时验证成功率可能下降。首次读取原图需要相册读取权限;若仅授予“仅添加”,验证可能失败。

8. 验证结果的含义

“本软件生成”:检测到可解析的 AC1 元数据、版本与类型受支持。

“本机签名有效”:认证字段可由本机已有公钥验证通过。

“图像完整性”:当前 JPEG 的解码相关段与扫描数据摘要与认证记录一致。

“联网验证通过”:验证服务器存在对应登记,且当前图像哈希、认证规范哈希、类型和 PublicKey ID 与登记记录一致,登记签名有效且密钥未被撤销。

本机三项同时通过时,标记为本地认证 Level B;联网验证通过时,标记为联网认证 Level A。任何失败都会显示原因。

9. 认证等级

Level A(可选,当前版本支持):本机签名或服务器登记 + 图像完整性 + 联网登记一致。联网验证默认开启,您可以在设置中关闭;需要验证服务器可用且照片已成功登记。

Level B(当前默认):本机签名有效 + 图像完整性。仅在本机有效;其他设备或换机后的旧照片默认无法验证。

Level C:认证元数据缺失、签名失败、图像哈希不匹配、认证字段无效、照片被编辑或联网登记不一致。

10. 能证明与不能证明

能证明:认证字段由本机私钥签名;当前图像解码相关段与扫描数据摘要一致;认证文件由本应用的元数据格式生成;开启联网验证并成功登记时,服务器保存了设备签名的最小照片声明。

不能证明:照片在真实世界的拍摄时间、地点、人物、事件或内容真实性;拍摄者身份;照片未在签名前被伪造;设备时间或 GPS 未被篡改;照片可被法院、平台或第三方机构采纳;未登记或服务器不可用时,照片不能在其他设备上通过联网验证。

联网验证只证明服务器登记与当前文件哈希一致,不代表照片内容真实、拍摄行为合法或服务器绝对可信。

本认证不是可信时间戳服务,不提供第三方公证或司法鉴定,不构成法律证据。

11. 拼图认证

拼图模式使用 Session ID 标识一次拍摄任务,记录照片数量、布局、每张照片的 PhotoID 与哈希,并对最终拼图生成图像完整性摘要与 Ed25519 签名。

中间照片仅在内存中临时处理,完成后不保存到相册。因此只能验证最终拼图,无法在事后验证已删除的中间照片;撤回、取消或退出应用会丢弃未保存照片。

处理失败时应用会在应用沙盒中暂存原始照片,允许重试或下次启动时恢复;放弃草稿或超过保留期限后会被清理。

联网登记时,拼图声明包含照片数量、布局和每张照片摘要;不上传中间照片或拼图图像。

12. 常见失败原因

照片被编辑、裁剪、旋转、压缩、截图、添加滤镜/文字/涂抹或格式转换。

通过部分社交软件、网盘、邮件或第三方编辑器转发导致重新编码。

认证元数据被剥离、替换或损坏;文件不是原始文件。

使用旧版本拍摄(SHA256-SCAN 或整文件 SHA256),或应用版本/哈希算法不一致。

本机 Keychain 中没有认证密钥,或密钥已丢失;换机、卸载重装或系统迁移后旧照片可能无法验证。

仅授予“仅添加”相册权限,无法读取原图;或照片经过 iCloud 优化/下载后格式变化。

照片在系统相册中被编辑,应用读取当前资产后判定认证失效。

未开启联网验证、照片未登记、验证服务器不可用、设备或照片登记被撤销,或联网哈希/规范哈希不一致。

13. 提高验证成功率

使用当前版本重新拍摄;保持原始文件,不编辑、不压缩、不截图、不添加文字或涂抹。

分享时选择原始文件或“实际大小”,避免使用会重新编码的渠道。

验证时允许完整相册访问,选择当前资产,并保持拍摄设备与密钥不变。

不要在拍摄后修改系统时间、时区或使用模拟定位。

如需在其他设备验证,保持联网验证开启,并确保新照片已成功登记;服务器不可用时等待恢复后重试。

14. 安全边界与责任

本认证不能抵御设备被越狱、恶意软件、系统漏洞、密钥被窃取或攻击者控制相机/系统时间/GPS 的情况。

联网验证依赖开发者运营的服务器、TLS、服务器密钥和数据库。服务器被入侵、密钥泄露、内部人员滥用、拒绝服务或网络中断可能导致联网验证失败、延迟或错误结果。

标准密码学算法和系统框架可能存在未知漏洞;开发者不保证认证绝对不可伪造或永久有效。

认证结果仅作为技术辅助信息,不构成法律、司法、公证或第三方权威证明;详细责任限制见《免责声明》。

15. 版本兼容

认证元数据包含 version 字段;本版本支持 1.0 与 1.1。1.1 将全部认证字段纳入签名,1.0 保持旧格式。

联网协议包含 v=1 字段;新增字段应保持向后兼容。若哈希或签名算法变更,旧照片可能无法由新版本验证。

请保留拍摄时使用的应用版本与设备,或按应用提示重新拍摄。

16. 联网验证协议

联网验证使用 HTTPS,并在应用层使用 X25519 密钥交换、HKDF-SHA256 派生密钥、AES-256-GCM 加密请求与响应。

设备请求使用 Ed25519 签名,包含方法、路径、设备密钥标识、时间戳、随机数和请求体摘要;服务器应拒绝重放、过期或签名无效的请求。

服务器响应使用服务器 Ed25519 密钥签名;应用必须校验服务器签名后才接受联网结果。服务器密钥通过 /v1/TrueFrame/server-key 获取并进行自签名校验。

联网登记与验证只发送设备公钥、随机 deviceId、App/OS 版本、照片编号、类型、拍摄时间、图像哈希、认证规范哈希、拼图数量/布局/单张摘要和 PublicKey ID;不上传照片像素、地址、标题、备注或 GPS。

详细接口、JSON 格式、错误码与服务器实现要求见项目文档 docs/network-verification.md。

17. 出口合规与联系

本应用使用 Apple CryptoKit 提供的标准 Ed25519 签名、SHA-256 摘要、X25519 密钥交换与 AES-256-GCM 加密,用于认证、签名、密钥交换、数据完整性和联网验证传输保护。

应用不包含自定义或非标准加密实现。应用的 Info.plist 声明 ITSAppUsesNonExemptEncryption = true,发布者应在 App Store Connect 完成出口合规问卷,并根据实际分发地区和加密用途确认是否适用豁免或需要提交相关分类/证明。

如您对本说明有疑问,可通过以下方式与开发者 fuqing_sun 联系:联系邮箱 trueframe@zzoxx.cn;个人主页 https://www.hckz.top;验证服务器 https://api.hckz.top。

本说明最后更新:2026-11-12。