iOS 软件加固前怎样说明签名与分发责任：候选、证书与平台证明边界

先把签名责任拆成可验收的角色，而不是一句“由客户签名”

加固接入会跨过研发、移动安全、证书管理和发布运营四类工作。若需求单只写“签名由客户负责”，发生问题时无法判断是签名身份选错、权限配置漂移、加固后候选被替换，还是上传人员拿了另一份 IPA。可执行的做法是给每个动作指定角色、输入、输出、批准条件和回执，并在工作开始前由双方确认。

责任矩阵至少要区分签名身份所有者、签名执行者、加固候选批准者、最终候选批准者、分发上传者、隐私声明维护者、第三方 SDK 负责人和平台证明服务端负责人。同一人可以承担多个角色，但每个角色仍要有独立动作记录。这样做不是增加流程，而是让失败能够落到一个具体输入和一个可修复责任点。

边界确认还要写明加固服务能够接触什么。通常可以提交候选文件、公开构建元数据和经过最小化处理的诊断材料；私钥、证书口令、Apple 账号会话、一次性验证码和无关业务数据不应因为“方便签名”进入普通工单或内容系统。若最终签名必须由资产所有者控制，就应把签名动作留在其受控环境，只交付摘要和结果回执。

用三个候选身份固定加固前、加固后和最终签名阶段

一个可审计交付至少存在三个候选：进入加固流程的输入候选、加固完成但尚未执行最终发布签名的输出候选，以及准备上传的最终已签名候选。签名和重新打包都会改变文件字节，因此三个对象不能共享同一个 SHA-256。清单应记录每个对象的摘要、大小、生成时间、Bundle ID、版本、构建号和产生该对象的责任步骤。

Bundle ID、版本和构建号用于说明业务身份，却不足以唯一定位文件。同一组标识可以对应多次构建、不同编译器输入或不同签名结果；相同文件名也可能被复制覆盖。验收时应以实际文件重新计算的 SHA-256 为主键，再把 Team ID、计划分发渠道、签名证书公开指纹、权限清单摘要和来源证明作为关联属性，避免凭截图或文件名放行。

签名材料的记录要遵守最小披露。清单可保存证书公开信息、签名身份标签、Team ID、权限摘要和签名动作回执，不应保存私钥原文、导出密码或账号凭据。若签名通过硬件密钥、受控构建节点或专用签名服务完成，应记录执行环境标识、审批号与结果摘要，而不是把密钥复制到加固服务或发布人员电脑。

正确理解 Apple 代码签名能证明什么，以及不能证明什么

Apple app code signing process 说明，平台使用代码签名、证书和运行时验证建立 App 代码与获准开发者身份之间的关系。工程上应把签名验证作为候选身份和完整性门禁：签名执行前确认目标身份与渠道，执行后从最终候选读取签名信息，并把结果绑定到该文件摘要。任何重新打包、资源变更或再签名都产生新的验收对象。

权限声明是签名边界中的高风险字段。加固前应导出原候选所需的能力和权限，说明哪些必须保留、哪些由渠道或账号配置决定；加固后再从最终候选读取实际结果，逐项比较。仅凭安装成功不能证明权限完全一致，因为未覆盖的系统能力、推送、关联域或密钥链访问可能只在特定路径和账号状态下暴露问题。

有效签名不等于安全结论。它不能证明加固策略阻断了逆向分析，不能证明第三方 SDK 没有收集数据，也不能证明服务端接受的请求来自可信业务会话。文章中的签名清单只用于控制身份、责任和交付一致性；保护强度、兼容范围和攻击面变化仍需要针对同一最终候选的独立测试证据。

把分发渠道写成签名输入，不要到上传前才决定

分发渠道不是发布团队最后填写的备注，而是签名责任的输入。项目应在加固前写明计划渠道、负责账号、最终签名发生位置、允许使用的签名身份、需要保留的能力，以及平台拒绝时由谁收集回执。渠道尚未确定时可以保留候选，但不能把该候选标记为可发布，更不能提前声称签名方案已验收。

交接时应采用单向清单：加固输出先由候选批准者确认摘要，再进入受控签名环境；签名执行者输出最终摘要和公开签名检查结果；发布负责人只接受清单中的最终摘要；上传者在发送前再次重算文件摘要。任何人若重新导出、压缩、嵌入资源或改变权限，都必须回到新的候选记录，不能沿用旧批准。

平台接收回执也要限制结论。上传成功只能说明平台在该时点接受了这个提交步骤，不能代替后续审核、设备运行、业务回归或加固强度验证。相反，平台拒绝信息应与最终候选摘要、渠道和签名回执一起保存，便于判断问题属于身份配置、权限声明、隐私材料还是二进制本身，而不是无目标地重复签名。

把 App Attest 放在服务端验证边界，不能拿它替代发布签名

Apple App Attest server validation 要求服务端验证证明并将其与请求处理绑定。接入说明应指定谁维护服务端验证逻辑、谁保管相关服务端配置、如何生成挑战、如何处理断言计数或重放风险，以及验证失败时采用拒绝、降级还是人工复核。把验证仅放在客户端会让信任决定处于可被本地修改的环境中。

App Attest 与发布签名解决不同问题。发布签名用于代码身份和平台执行链，App Attest 为服务端提供平台证明相关信号；二者都不能独立证明用户已经获得业务授权。加固可能改变客户端代码组织，但是否影响证明接入必须由同一最终候选进行注册、挑战、断言和服务端验证回归，不能从编译通过或签名有效推导。

证明数据也需要最小化处理。日志可以记录请求关联号、结果类别、服务端策略版本和经过控制的诊断字段，不应公开设备标识、完整令牌、私钥或可重放材料。平台证明仍是风险信号，业务系统要结合账号状态、会话、权限和异常处置作决定；校验器只能确认责任字段存在，不能模拟 Apple 服务或宣布真实性已经通过。

隐私清单和第三方 SDK 由应用方负责，加固不能替代声明核对

Apple privacy manifests 说明，App 与第三方 SDK 的数据收集和 required reason API 信息需要进入有效的隐私清单。加固接入前应由应用方提供当前依赖锁定结果、SDK 版本、隐私清单位置和声明负责人；加固完成后再核对资源是否保留、归档是否包含预期清单，以及最终提交材料是否对应同一候选。

Apple third-party SDK requirements 强调开发者仍对集成 SDK 的代码与数据行为负责，部分列明的 SDK 还涉及签名和隐私清单要求。签名责任矩阵因此要包含 SDK 所有者：谁批准版本、谁确认来源、谁处理供应商更新、谁验证 SDK 自带清单与签名材料。加固服务处理二进制不等于接管这些产品和合规判断。

隐私清单是声明与审核材料，不是运行时数据隔离。文件存在不能证明 SDK 实际行为与声明一致，也不能证明网络传输、存储和服务端使用符合业务政策。若加固流程改变依赖、资源或初始化路径，应重新做清单对比和行为回归；若没有变化，也要以摘要或构建来源记录证明核对对象，而不是沿用上一版本截图。

用来源证明和 SSDF 记录责任链，但不要把记录格式当成真实保证

SLSA Provenance v1.1 提供把产物主体、构建者、构建类型、外部参数和依赖材料写入来源证明的结构。用于 iOS 加固交付时，主体应绑定实际候选摘要，参数可记录经过审查的配置摘要，材料可引用输入候选和工具链标识。证明若只写版本号而不写主体摘要，仍无法回答最终上传文件是否来自该流程。

NIST SP 800-218 SSDF 将安全开发、来源、验证、变更和供应链风险放进组织实践。责任矩阵应据此指定证据保留人、复核人和异常处置人，并明确多长时间内能够取回候选、签名回执、依赖清单和测试结果。SSDF 不定义某个加固产品的功能，也不会替代 Apple 平台规则或项目实测。

证明格式本身也不保证内容真实。签发者身份、生成环境、时间、输入和主体摘要都要接受独立校验。交付演练应随机选择一个最终候选，从平台回执反向找到摘要、签名检查、来源证明、加固输入、SDK 清单和责任批准；任何断链都应在下一次发布前修复，而不是等线上崩溃或审核拒绝后再补材料。

用只读清单校验器在提交前发现签名责任和候选错配

下面的 Python 示例读取归档根目录和 `ios-signing-boundary.json`。清单必须声明候选相对路径与 SHA-256、Bundle ID、Team ID、分发渠道、六类责任角色、隐私清单和 SDK 清单状态。校验器拒绝绝对路径、目录逃逸、符号链接、格式错误、占位责任人和候选摘要错配，并输出待签名检查表。

脚本只读文件，不调用 `codesign`，不访问钥匙串，也不接触 Apple 账号或私钥。它确认的是清单完整性和候选字节身份，不确认签名证书有效、provisioning 合法、App Attest 服务端验证成功、隐私声明真实或加固保护强度。真实发布仍需在受控签名环境对同一摘要执行平台检查与设备回归。

准备 iOS 加固申请时，可整理三个候选阶段的摘要计划、Bundle ID、Team ID、分发渠道、权限基线、责任矩阵、SDK 与隐私清单、App Attest 服务端责任和来源证明，再通过御盾中央平台提交申请。提交动作不应附带私钥、证书密码或账号会话；校验通过也不表示签名、审核或兼容结果已经确认。

• 候选路径受归档根目录限制且不允许符号链接
• 实际候选 SHA-256 与清单完全一致
• Bundle ID、Team ID 和计划分发渠道格式明确
• 七类责任角色均有非占位负责人
• 隐私清单已经复核并有负责人
• 第三方 SDK 清单已经锁定并有负责人
• 校验结果不冒充签名、审核、兼容或加固效果结论

from pathlib import Path
import hashlib
import json
import os
import re
import sys

if len(sys.argv) != 3:
    raise SystemExit(2)
root = Path(sys.argv[1]).resolve()
manifest_path = Path(sys.argv[2]).resolve()
if not root.is_dir() or not manifest_path.is_file() or root not in manifest_path.parents:
    raise SystemExit(2)
manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
if manifest.get("schema") != "ios-signing-boundary-v1":
    raise SystemExit(2)

def safe_file(relative_path):
    if not isinstance(relative_path, str) or not relative_path or os.path.isabs(relative_path):
        raise SystemExit(2)
    unresolved = root / relative_path
    resolved = unresolved.resolve()
    if root not in resolved.parents or unresolved.is_symlink() or not resolved.is_file():
        raise SystemExit(2)
    return resolved

def sha256(path):
    digest = hashlib.sha256()
    with path.open("rb") as stream:
        for chunk in iter(lambda: stream.read(1024 * 1024), b""):
            digest.update(chunk)
    return digest.hexdigest()

candidate = manifest.get("candidate")
if not isinstance(candidate, dict):
    raise SystemExit(2)
expected = str(candidate.get("sha256", ""))
if not re.fullmatch(r"[0-9a-f]{64}", expected):
    raise SystemExit(2)
candidate_path = safe_file(candidate.get("path"))
actual = sha256(candidate_path)
if actual != expected:
    raise SystemExit(3)
identifiers = manifest.get("identifiers")
if not isinstance(identifiers, dict):
    raise SystemExit(2)
bundle_id = str(identifiers.get("bundleId", ""))
team_id = str(identifiers.get("teamId", ""))
channel = str(identifiers.get("distributionChannel", ""))
if not re.fullmatch(r"[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+", bundle_id):
    raise SystemExit(2)
if not re.fullmatch(r"[A-Z0-9]{10}", team_id) or not re.fullmatch(r"[a-z0-9_-]{2,40}", channel):
    raise SystemExit(2)
required_roles = {"inputApprover", "signingIdentityOwner", "finalSigner", "releaseApprover", "privacyOwner", "sdkOwner", "attestationVerifier"}
responsibilities = manifest.get("responsibilities")
if not isinstance(responsibilities, dict) or set(responsibilities) != required_roles:
    raise SystemExit(2)
for role, owner in responsibilities.items():
    if not isinstance(owner, str) or not re.fullmatch(r"[A-Za-z0-9_.@-]{3,80}", owner) or owner.lower() in {"tbd", "unknown", "none"}:
        raise SystemExit(2)
materials = manifest.get("materials")
if not isinstance(materials, dict) or materials.get("privacyManifestReviewed") is not True or materials.get("sdkInventoryLocked") is not True:
    raise SystemExit(2)
report = {"status": "signing-boundary-complete", "candidateSha256": actual, "bundleId": bundle_id, "teamId": team_id, "distributionChannel": channel, "responsibilityCount": len(responsibilities), "boundary": "manifest validation does not prove signature validity, review acceptance, attestation truth, privacy behavior, compatibility, or hardening strength"}
print(json.dumps(report, ensure_ascii=False, indent=2))