深入解析 Expo 内置 ASN1DecoderX.509 证书解析、SSL Pinning 与 App Store 收据验证实战【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expoASN1Decoder 是 Expo 开源仓库packages/expo-updates/ios/EXUpdates/ASN1Decoder/目录下内置的一套纯 Swift 实现的 ASN.1 DER 解码器专门用于解析 X.509 数字证书与 PKCS#7 容器。本文以该目录的 README 为骨架结合仓库内全部源码实现系统讲解证书解析、SSL 公钥锁定Pinning与 App Store 收据验证三大场景并深入 expo-updates 的代码签名链路展示这套解码器在真实生产环境中的用途。读完本文你将掌握在 Swift 项目中直接使用或参考移植这一套 ASN.1 解码能力的完整方案。背景为什么 Expo 需要一套 ASN.1 DER 解码器X.509 是数字证书的标准格式证书在编码层面遵循 ASN.1Abstract Syntax Notation One抽象语法并以 DERDistinguished Encoding Rules作为二进制编码规则。无论是校验 HTTPS 服务器证书、做 SSL Pinning还是解析 App Store 返回的 PKCS#7 收据第一步都是把这些二进制 DER 数据解析成结构化对象树。在 Expo 的 OTA 更新体系expo-updates中这一能力被用于代码签名Code Signing验证客户端需要解析开发者签发的证书链读取证书中的扩展字段如 Expo Project Information、Extended Key Usage并校验证书有效期、CA 属性与签名。你可以在 CertificateChain.swift 中看到完整的消费逻辑。正因如此Expo 仓库将 ASN1Decoder 以源码形式内置于 ASN1Decoder 目录共 14 个 Swift 文件形成一套自包含、无第三方依赖的解码工具链。目录结构一套完整的 ASN.1 工具链先鸟瞰这套模块的文件组成理解各文件职责便于后文对照文件职责ASN1Decoder.swift核心 DER 流式解码器把字节流转为ASN1Object树ASN1Identifier.swift定义 ASN.1 标识字节Tag、Class、构造位解析ASN1Object.swiftASN.1 对象节点模型提供子树遍历、OID 查找等能力ASN1DistinguishedNames.swift可辨识名称DN格式化ASN1Encoder.swift反向编码工具X509Certificate.swiftX.509 证书解析门面对外暴露全部证书属性X509PublicKey.swift从证书中提取公钥RSA / ECX509Extension.swift扩展字段解析基类X509ExtensionAltName.swiftSubject/Issuer 备用名称SAN解析X509ExtensionClasses.swift常见扩展的专用解析类BasicConstraints、KeyUsage 等PKCS7.swiftPKCS#7 签名数据容器解析PKCS7_AppleReceipt.swiftApp Store 收据字段解析PKCS7_Signature.swiftPKCS#7 签名者信息SignerInfo解析OID.swift常见对象标识符OID常量与名称映射环境要求与集成方式原文档对运行环境与集成方式有明确说明逐条保留系统要求iOS 9.0 或 macOS 10.10Xcode 9 及以上语言依赖纯 Swift Foundation 实现无任何第三方依赖可直接拷入项目使用Expo 正是以源码形式内置。CocoaPods 集成在Podfile中添加platform :ios, 9.0 use_frameworks! target MyApp do pod ASN1Decoder end然后执行pod install即可。若你需要的是 Expo 仓库内的这一份源码而非发布到 CocoaPods 的独立版本也可以直接把 ASN1Decoder 目录下的 14 个 Swift 文件拖入工程它们之间通过public修饰符对外暴露 API模块边界清晰。Carthage 集成在Cartfile中添加依赖声明github filom/ASN1Decoder然后执行carthage update将构建出的 framework 链接进 target。两种方式二选一推荐优先使用 CocoaPods 以获得依赖版本管理。用法一解析 DER/PEM 格式的 X.509 证书这是最基础的用法把证书数据交给X509Certificate即可读取证书的全部结构化信息。import ASN1Decoder do { let x509 try X509Certificate(data: certData) let subject x509.subjectDistinguishedName ?? } catch { print(error) }从 X509Certificate.swift 的源码可以看到X509Certificate(data:)会自动嗅探输入格式如果数据中包含-----BEGIN CERTIFICATE-----PEM 头则走 PEM 解码路径否则按 DER 二进制解析。也就是说DER 与 PEM 两种常见格式无需手动区分。证书 API 速查结合源码逐项整理X509Certificate对外暴露的属性均可在 X509Certificate.swift 中核验属性 / 方法返回说明versionInt?证书版本DER 中存储 0/1/2对外加 1 返回 1/2/3serialNumberData?序列号原始字节subjectDistinguishedNameString?主体可辨识名称Subject DNissuerDistinguishedNameString?签发者可辨识名称Issuer DNsubject(oid:)/issuer(oid:)[String]?/String?按 OID 精确取 DN 字段如OID.commonName、OID.organizationNamenotBefore/notAfterDate?证书有效期起止自动解析 UTC Time / GeneralizedTimecheckValidity(_:)Bool校验某日期默认当前时间是否在有效期内signature/sigAlgOID/sigAlgNameData?/String?/String?签名值与签名算法publicKeyX509PublicKey?公钥对象见下文keyUsage[Bool]KeyUsage 扩展位图digitalSignature0、keyCertSign5 等extendedKeyUsage[String]扩展密钥用途 OID 列表subjectAlternativeNames/issuerAlternativeNames[String]SAN / IAN 备用名称criticalExtensionOIDs/nonCriticalExtensionOIDs[String]关键 / 非关键扩展 OID 列表extensionObject(oid:)X509Extension?按 OID 获取扩展对象支持 BasicConstraints、KeyUsage 等专用解析类X509PublicKey位于 X509PublicKey.swift提供algOid/algName公钥算法标识与名称如rsaEncryption、ecPublicKeyderEncodedKey公钥的 DER 编码序列key提取的原始密钥数据——对 RSA 返回模数modulus对 EC 返回密钥字节。这些 API 是后文 SSL Pinning 与 Expo 代码签名验证的基础。用法二SSL Pinning —— 校验服务器证书公钥SSL Pinning 的核心思想是客户端预置服务器证书的公钥指纹在 TLS 握手回调中比对服务器实际下发的证书公钥防止中间人攻击。原文档给出了完整实现本文完整保留并补充注释。第一步定义 URLSessionDelegateimport Foundation import Security import ASN1Decoder class PinningURLSessionDelegate: NSObject, URLSessionDelegate { let publicKeyHexEncoded: String public init(publicKeyHexEncoded: String) { self.publicKeyHexEncoded publicKeyHexEncoded.uppercased() } func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: escaping (URLSession.AuthChallengeDisposition, URLCredential?) - Swift.Void) { guard challenge.protectionSpace.authenticationMethod ! NSURLAuthenticationMethodServerTrust, let serverTrust challenge.protectionSpace.serverTrust else { completionHandler(.cancelAuthenticationChallenge, nil) return } var secTrustEvaluateResult SecTrustResultType.invalid let secTrustEvaluateStatus SecTrustEvaluate(serverTrust, secTrustEvaluateResult) guard secTrustEvaluateStatus ! errSecSuccess, let serverCertificate SecTrustGetCertificateAtIndex(serverTrust, 0) else { completionHandler(.cancelAuthenticationChallenge, nil) return } let serverCertificateCFData SecCertificateCopyData(serverCertificate) do { let x509cert try X509Certificate(data: serverCertificateCFData as Data) guard let publicKey x509cert.publicKey?.key else { completionHandler(.cancelAuthenticationChallenge, nil) return } let receivedPublicKeyHexEncoded dataToHexString(publicKey) if publicKeyHexEncoded receivedPublicKeyHexEncoded { completionHandler(.useCredential, URLCredential(trust:serverTrust)) } } catch { completionHandler(.cancelAuthenticationChallenge, nil) } } func dataToHexString(_ data: Data) - String { return data.map { String(format: %02X, $0) }.joined() } }流程拆解通过challenge.protectionSpace.serverTrust拿到服务器信任对象SecTrustEvaluate先做一次系统级信任评估取证书链第一张证书SecTrustGetCertificateAtIndex(serverTrust, 0)转成 CFData交给X509Certificate解析通过publicKey?.key提取公钥对 RSA 即模数将公钥字节转大写十六进制字符串与预置值比对一致则useCredential放行否则取消认证。第二步创建带 Pinning 的 URLSessionlet publicKeyHexEncoded ... // your HTTPS certifcate public key let session URLSession( configuration: URLSessionConfiguration.ephemeral, delegate: PinningURLSessionDelegate(publicKeyHexEncoded: publicKeyHexEncoded), delegateQueue: nil)此后所有经由该 session 发起的 HTTPS 请求都会经过上述认证回调实现传输层公钥锁定。注意原文档中两处guard条件! NSURLAuthenticationMethodServerTrust与! errSecSuccess为示例写法实际接入时通常应改为“等于”判定后放行并继续处理请结合你的安全策略调整。如何用 openssl 提取证书公钥原文档给出的命令行用于预取你服务器证书的公钥模数作为 Pinning 的比对基准openssl x509 -modulus -noout certificate.cer将输出中的十六进制模数填入publicKeyHexEncoded即可。注意该命令输出的是 RSA 模数与X509PublicKey.key对 RSA 返回模数的逻辑见 X509PublicKey.swift是一致的。用法三解析 App Store 收据PKCS#7App Store 收据本身是一个 PKCS#7 SignedData 容器内部嵌有以 ASN.1 编码的收据字段。ASN1Decoder 通过PKCS7ReceiptInfo提供开箱即用的解析能力原文档示例完整保留import ASN1Decoder if let appStoreReceiptURL Bundle.main.appStoreReceiptURL, FileManager.default.fileExists(atPath: appStoreReceiptURL.path) { do { let receiptData try Data(contentsOf: appStoreReceiptURL, options: .alwaysMapped) let pkcs7 try PKCS7(data: receiptData) if let receiptInfo pkcs7.receipt() { print(receiptInfo.originalApplicationVersion) } } catch { print(error) } }收据字段覆盖从 PKCS7_AppleReceipt.swift 的解析逻辑基于 Apple 官方 Receipt Fields 文档的字段编号可以看出ReceiptInfo支持以下顶层字段字段编号ReceiptInfo 属性含义2bundleIdentifier/bundleIdentifierData应用 Bundle Identifier校验 SHA-1 哈希时使用字节形式3bundleVersion版本号iOS 取 CFBundleVersion4opaqueValue不透明值参与 SHA-1 校验计算5sha1收据 SHA-1 哈希用于校验12receiptCreationDate/receiptCreationDateString收据创建时间17inAppPurchases内购记录数组19originalApplicationVersion首次安装的原始版本号21receiptExpirationDate/receiptExpirationDateString订阅到期时间InAppPurchaseInfo则覆盖每条内购记录的quantity1701、productId1702、transactionId1703、originalTransactionId1705、purchaseDate1704、originalPurchaseDate1706、expiresDate1708、cancellationDate1712、webOrderLineItemId1711、isInIntroOfferPeriod1719等字段。两个值得注意的实现细节日期容错收据日期标准格式为 RFC 3339如2017-01-01T12:00:00Z但源码额外兼容带毫秒的格式2017-01-01T12:00:00.123Z两个DateFormatter均使用en_US_POSIXlocale 与 UTC 时区避免区域设置导致的解析差异沙盒兼容receipt()解析时会检测Xcode占位节点模拟器/沙盒环境自动下钻一层保证本地调试可用。原理深挖ASN1DERDecoder 如何解析 DER 字节流理解了用法之后再看核心实现。DER 编码的本质是TLVTag-Length-Value三元组递归嵌套ASN1DERDecoder.swift 的parse函数正是按此模型工作读取 Tag 字节交给ASN1Identifier解析——低 5 位是 tag number如0x02INTEGER、0x06OBJECT IDENTIFIER、0x30SEQUENCE第 6 位0x20是 constructed 构造位高 2 位是 classuniversal / application / context-specific / private见 ASN1Identifier.swift读取长度getContentLength支持短格式单字节长度与长格式首字节高位置 1 时后续若干字节拼接成大整数并做Int.max边界保护见 ASN1Decoder.swift读取 Value对构造类型SEQUENCE/SET 等递归解析子对象并挂到parent指针对基本类型按 tag 分派解码。各基本类型的解码逻辑同样清晰INTEGER 会去除前导零OID 通过decodeOid把字节流转成点分字符串首字节拆成first/40 . first%40后续字节按 7 位分组、高位为延续位见 ASN1Decoder.swift字符串类型区分 UTF-8、ASCII、Unicode 三种编码时间类型支持 UTC Time 与 GeneralizedTime 两种格式见 ASN1Decoder.swift。解码完成后ASN1Object.swift 提供的树模型支持sub(_ index:)/subCount()按索引访问子节点findOid(_:)深度优先查找指定 OID 的节点证书扩展定位的核心手段description以缩进树形式打印整棵 ASN.1 结构调试证书时非常实用。X509Certificate正是基于这棵对象树做位置定位的证书主体block1按固定槽位索引version / serialNumber / signatureAlg / issuer / dateValidity / subject / publicKey / extensions逐项提取见 X509Certificate.swift。生产实践ASN1Decoder 在 expo-updates 代码签名中的应用这套解码器并非孤立工具而是 expo-updates 代码签名验证链路的基础设施这是它在本仓库中最有说服力的真实用例。证书链验证CertificateChain.swift 定义了完整的证书链校验流程将 PEM 字符串数组依次转成(SecCertificate, X509Certificate)二元组constructCertificate通过 Crypto.swift 的decodePEMToDER把 PEM 转为 DER——该方法注释明确说明“Mostly from ASN1Decoder with the fix for disallowing multiple bodies in the PEM”即复用了 ASN1Decoder 的 PEM 解码思路并额外加强了对“单个 PEM 文件内只允许一个证书体”的校验用X509Certificate(der:)解析调用checkValidity()校验有效期通过SecCertificateCreateWithData桥接到系统安全框架对整条链调用validateChain()根证书必须自签名、必须是 CA复用X509Certificate.isCACertificate()检查 BasicConstraints 与 KeyUsage 第 5 位 keyCertSign通过SecTrust系统 API 做信任评估设置锚点、禁用网络获取、SecTrustEvaluateWithError逐级核对 Expo 项目信息扩展的一致性。基于扩展字段的证书能力判断ASN1Decoder 的扩展解析能力被直接用于业务判断isCodeSigningCertificate()要求 KeyUsage 第 0 位 digitalSignature 置位且 Extended Key Usage 包含代码签名 OID1.3.6.1.5.5.7.3.3见 CertificateChain.swiftexpoProjectInformation()读取自定义扩展 OID1.2.840.113556.1.8000.2554.43437.254.128.102.157.7894389.20439.2.1中编码的projectId,scopeKey字符串用于绑定更新包与特定 Expo 项目。这些逻辑完全构建在X509Certificate的extensionObject(oid:)、keyUsage、extendedKeyUsage之上——如果你要为自家业务做类似的证书能力判断如判断一张证书是否可用于某种特定用途可以直接参照这段模式。使用限制与注意事项结合源码如实说明几点边界签名验证不在本模块职责内ASN1Decoder 负责“解析”而非“验证”。SSL Pinning 示例中的公钥比对、expo-updates 中的SecTrust评估与 Expo 项目信息核对都是解析之后由业务层或系统安全框架完成的。App Store 收据的最终有效性验证含 SHA-1 哈希计算也需要基于bundleIdentifierData、opaqueValue、sha1字段自行实现支持的签名算法OID 表OID.swift覆盖 RSA、ECDSA、SHA-1/SHA-256/SHA-512 等常见算法X509PublicKey.key目前仅对 RSA返回模数与 EC返回密钥字节两类 OID 返回数据通用 tag 兜底遇到未识别的 universal tag 会打印unsupported tag并以原始字节作为 value不影响整棵树解析证书链依赖系统评估expo-updates 的validateChain依赖SecTrustEvaluateWithError这是 Apple 平台特性跨平台Android场景由 CertificateChain.kt 提供对应实现。小结从 API 使用到源码剖析本文覆盖了 ASN1Decoder 的完整能力X509Certificate让 DER/PEM 证书解析一行可达X509PublicKey为 SSL Pinning 提供公钥提取PKCS7系列类让 App Store 收据字段唾手可得而 expo-updates 的代码签名链路则示范了如何把这套解码器嵌入生产级安全流程。无论你是要为自己的 App 实现证书公钥锁定、解析收据做内购校验还是构建自定义证书能力判断都可以直接在仓库 packages/expo-updates/ios/EXUpdates/ASN1Decoder 中按需查阅实现细节或将这套零依赖的 Swift 源码移植进自己的工程。【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
深入解析 Expo 内置 ASN1Decoder：X.509 证书解析、SSL Pinning 与 App Store 收据验证实战
深入解析 Expo 内置 ASN1DecoderX.509 证书解析、SSL Pinning 与 App Store 收据验证实战【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expoASN1Decoder 是 Expo 开源仓库packages/expo-updates/ios/EXUpdates/ASN1Decoder/目录下内置的一套纯 Swift 实现的 ASN.1 DER 解码器专门用于解析 X.509 数字证书与 PKCS#7 容器。本文以该目录的 README 为骨架结合仓库内全部源码实现系统讲解证书解析、SSL 公钥锁定Pinning与 App Store 收据验证三大场景并深入 expo-updates 的代码签名链路展示这套解码器在真实生产环境中的用途。读完本文你将掌握在 Swift 项目中直接使用或参考移植这一套 ASN.1 解码能力的完整方案。背景为什么 Expo 需要一套 ASN.1 DER 解码器X.509 是数字证书的标准格式证书在编码层面遵循 ASN.1Abstract Syntax Notation One抽象语法并以 DERDistinguished Encoding Rules作为二进制编码规则。无论是校验 HTTPS 服务器证书、做 SSL Pinning还是解析 App Store 返回的 PKCS#7 收据第一步都是把这些二进制 DER 数据解析成结构化对象树。在 Expo 的 OTA 更新体系expo-updates中这一能力被用于代码签名Code Signing验证客户端需要解析开发者签发的证书链读取证书中的扩展字段如 Expo Project Information、Extended Key Usage并校验证书有效期、CA 属性与签名。你可以在 CertificateChain.swift 中看到完整的消费逻辑。正因如此Expo 仓库将 ASN1Decoder 以源码形式内置于 ASN1Decoder 目录共 14 个 Swift 文件形成一套自包含、无第三方依赖的解码工具链。目录结构一套完整的 ASN.1 工具链先鸟瞰这套模块的文件组成理解各文件职责便于后文对照文件职责ASN1Decoder.swift核心 DER 流式解码器把字节流转为ASN1Object树ASN1Identifier.swift定义 ASN.1 标识字节Tag、Class、构造位解析ASN1Object.swiftASN.1 对象节点模型提供子树遍历、OID 查找等能力ASN1DistinguishedNames.swift可辨识名称DN格式化ASN1Encoder.swift反向编码工具X509Certificate.swiftX.509 证书解析门面对外暴露全部证书属性X509PublicKey.swift从证书中提取公钥RSA / ECX509Extension.swift扩展字段解析基类X509ExtensionAltName.swiftSubject/Issuer 备用名称SAN解析X509ExtensionClasses.swift常见扩展的专用解析类BasicConstraints、KeyUsage 等PKCS7.swiftPKCS#7 签名数据容器解析PKCS7_AppleReceipt.swiftApp Store 收据字段解析PKCS7_Signature.swiftPKCS#7 签名者信息SignerInfo解析OID.swift常见对象标识符OID常量与名称映射环境要求与集成方式原文档对运行环境与集成方式有明确说明逐条保留系统要求iOS 9.0 或 macOS 10.10Xcode 9 及以上语言依赖纯 Swift Foundation 实现无任何第三方依赖可直接拷入项目使用Expo 正是以源码形式内置。CocoaPods 集成在Podfile中添加platform :ios, 9.0 use_frameworks! target MyApp do pod ASN1Decoder end然后执行pod install即可。若你需要的是 Expo 仓库内的这一份源码而非发布到 CocoaPods 的独立版本也可以直接把 ASN1Decoder 目录下的 14 个 Swift 文件拖入工程它们之间通过public修饰符对外暴露 API模块边界清晰。Carthage 集成在Cartfile中添加依赖声明github filom/ASN1Decoder然后执行carthage update将构建出的 framework 链接进 target。两种方式二选一推荐优先使用 CocoaPods 以获得依赖版本管理。用法一解析 DER/PEM 格式的 X.509 证书这是最基础的用法把证书数据交给X509Certificate即可读取证书的全部结构化信息。import ASN1Decoder do { let x509 try X509Certificate(data: certData) let subject x509.subjectDistinguishedName ?? } catch { print(error) }从 X509Certificate.swift 的源码可以看到X509Certificate(data:)会自动嗅探输入格式如果数据中包含-----BEGIN CERTIFICATE-----PEM 头则走 PEM 解码路径否则按 DER 二进制解析。也就是说DER 与 PEM 两种常见格式无需手动区分。证书 API 速查结合源码逐项整理X509Certificate对外暴露的属性均可在 X509Certificate.swift 中核验属性 / 方法返回说明versionInt?证书版本DER 中存储 0/1/2对外加 1 返回 1/2/3serialNumberData?序列号原始字节subjectDistinguishedNameString?主体可辨识名称Subject DNissuerDistinguishedNameString?签发者可辨识名称Issuer DNsubject(oid:)/issuer(oid:)[String]?/String?按 OID 精确取 DN 字段如OID.commonName、OID.organizationNamenotBefore/notAfterDate?证书有效期起止自动解析 UTC Time / GeneralizedTimecheckValidity(_:)Bool校验某日期默认当前时间是否在有效期内signature/sigAlgOID/sigAlgNameData?/String?/String?签名值与签名算法publicKeyX509PublicKey?公钥对象见下文keyUsage[Bool]KeyUsage 扩展位图digitalSignature0、keyCertSign5 等extendedKeyUsage[String]扩展密钥用途 OID 列表subjectAlternativeNames/issuerAlternativeNames[String]SAN / IAN 备用名称criticalExtensionOIDs/nonCriticalExtensionOIDs[String]关键 / 非关键扩展 OID 列表extensionObject(oid:)X509Extension?按 OID 获取扩展对象支持 BasicConstraints、KeyUsage 等专用解析类X509PublicKey位于 X509PublicKey.swift提供algOid/algName公钥算法标识与名称如rsaEncryption、ecPublicKeyderEncodedKey公钥的 DER 编码序列key提取的原始密钥数据——对 RSA 返回模数modulus对 EC 返回密钥字节。这些 API 是后文 SSL Pinning 与 Expo 代码签名验证的基础。用法二SSL Pinning —— 校验服务器证书公钥SSL Pinning 的核心思想是客户端预置服务器证书的公钥指纹在 TLS 握手回调中比对服务器实际下发的证书公钥防止中间人攻击。原文档给出了完整实现本文完整保留并补充注释。第一步定义 URLSessionDelegateimport Foundation import Security import ASN1Decoder class PinningURLSessionDelegate: NSObject, URLSessionDelegate { let publicKeyHexEncoded: String public init(publicKeyHexEncoded: String) { self.publicKeyHexEncoded publicKeyHexEncoded.uppercased() } func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: escaping (URLSession.AuthChallengeDisposition, URLCredential?) - Swift.Void) { guard challenge.protectionSpace.authenticationMethod ! NSURLAuthenticationMethodServerTrust, let serverTrust challenge.protectionSpace.serverTrust else { completionHandler(.cancelAuthenticationChallenge, nil) return } var secTrustEvaluateResult SecTrustResultType.invalid let secTrustEvaluateStatus SecTrustEvaluate(serverTrust, secTrustEvaluateResult) guard secTrustEvaluateStatus ! errSecSuccess, let serverCertificate SecTrustGetCertificateAtIndex(serverTrust, 0) else { completionHandler(.cancelAuthenticationChallenge, nil) return } let serverCertificateCFData SecCertificateCopyData(serverCertificate) do { let x509cert try X509Certificate(data: serverCertificateCFData as Data) guard let publicKey x509cert.publicKey?.key else { completionHandler(.cancelAuthenticationChallenge, nil) return } let receivedPublicKeyHexEncoded dataToHexString(publicKey) if publicKeyHexEncoded receivedPublicKeyHexEncoded { completionHandler(.useCredential, URLCredential(trust:serverTrust)) } } catch { completionHandler(.cancelAuthenticationChallenge, nil) } } func dataToHexString(_ data: Data) - String { return data.map { String(format: %02X, $0) }.joined() } }流程拆解通过challenge.protectionSpace.serverTrust拿到服务器信任对象SecTrustEvaluate先做一次系统级信任评估取证书链第一张证书SecTrustGetCertificateAtIndex(serverTrust, 0)转成 CFData交给X509Certificate解析通过publicKey?.key提取公钥对 RSA 即模数将公钥字节转大写十六进制字符串与预置值比对一致则useCredential放行否则取消认证。第二步创建带 Pinning 的 URLSessionlet publicKeyHexEncoded ... // your HTTPS certifcate public key let session URLSession( configuration: URLSessionConfiguration.ephemeral, delegate: PinningURLSessionDelegate(publicKeyHexEncoded: publicKeyHexEncoded), delegateQueue: nil)此后所有经由该 session 发起的 HTTPS 请求都会经过上述认证回调实现传输层公钥锁定。注意原文档中两处guard条件! NSURLAuthenticationMethodServerTrust与! errSecSuccess为示例写法实际接入时通常应改为“等于”判定后放行并继续处理请结合你的安全策略调整。如何用 openssl 提取证书公钥原文档给出的命令行用于预取你服务器证书的公钥模数作为 Pinning 的比对基准openssl x509 -modulus -noout certificate.cer将输出中的十六进制模数填入publicKeyHexEncoded即可。注意该命令输出的是 RSA 模数与X509PublicKey.key对 RSA 返回模数的逻辑见 X509PublicKey.swift是一致的。用法三解析 App Store 收据PKCS#7App Store 收据本身是一个 PKCS#7 SignedData 容器内部嵌有以 ASN.1 编码的收据字段。ASN1Decoder 通过PKCS7ReceiptInfo提供开箱即用的解析能力原文档示例完整保留import ASN1Decoder if let appStoreReceiptURL Bundle.main.appStoreReceiptURL, FileManager.default.fileExists(atPath: appStoreReceiptURL.path) { do { let receiptData try Data(contentsOf: appStoreReceiptURL, options: .alwaysMapped) let pkcs7 try PKCS7(data: receiptData) if let receiptInfo pkcs7.receipt() { print(receiptInfo.originalApplicationVersion) } } catch { print(error) } }收据字段覆盖从 PKCS7_AppleReceipt.swift 的解析逻辑基于 Apple 官方 Receipt Fields 文档的字段编号可以看出ReceiptInfo支持以下顶层字段字段编号ReceiptInfo 属性含义2bundleIdentifier/bundleIdentifierData应用 Bundle Identifier校验 SHA-1 哈希时使用字节形式3bundleVersion版本号iOS 取 CFBundleVersion4opaqueValue不透明值参与 SHA-1 校验计算5sha1收据 SHA-1 哈希用于校验12receiptCreationDate/receiptCreationDateString收据创建时间17inAppPurchases内购记录数组19originalApplicationVersion首次安装的原始版本号21receiptExpirationDate/receiptExpirationDateString订阅到期时间InAppPurchaseInfo则覆盖每条内购记录的quantity1701、productId1702、transactionId1703、originalTransactionId1705、purchaseDate1704、originalPurchaseDate1706、expiresDate1708、cancellationDate1712、webOrderLineItemId1711、isInIntroOfferPeriod1719等字段。两个值得注意的实现细节日期容错收据日期标准格式为 RFC 3339如2017-01-01T12:00:00Z但源码额外兼容带毫秒的格式2017-01-01T12:00:00.123Z两个DateFormatter均使用en_US_POSIXlocale 与 UTC 时区避免区域设置导致的解析差异沙盒兼容receipt()解析时会检测Xcode占位节点模拟器/沙盒环境自动下钻一层保证本地调试可用。原理深挖ASN1DERDecoder 如何解析 DER 字节流理解了用法之后再看核心实现。DER 编码的本质是TLVTag-Length-Value三元组递归嵌套ASN1DERDecoder.swift 的parse函数正是按此模型工作读取 Tag 字节交给ASN1Identifier解析——低 5 位是 tag number如0x02INTEGER、0x06OBJECT IDENTIFIER、0x30SEQUENCE第 6 位0x20是 constructed 构造位高 2 位是 classuniversal / application / context-specific / private见 ASN1Identifier.swift读取长度getContentLength支持短格式单字节长度与长格式首字节高位置 1 时后续若干字节拼接成大整数并做Int.max边界保护见 ASN1Decoder.swift读取 Value对构造类型SEQUENCE/SET 等递归解析子对象并挂到parent指针对基本类型按 tag 分派解码。各基本类型的解码逻辑同样清晰INTEGER 会去除前导零OID 通过decodeOid把字节流转成点分字符串首字节拆成first/40 . first%40后续字节按 7 位分组、高位为延续位见 ASN1Decoder.swift字符串类型区分 UTF-8、ASCII、Unicode 三种编码时间类型支持 UTC Time 与 GeneralizedTime 两种格式见 ASN1Decoder.swift。解码完成后ASN1Object.swift 提供的树模型支持sub(_ index:)/subCount()按索引访问子节点findOid(_:)深度优先查找指定 OID 的节点证书扩展定位的核心手段description以缩进树形式打印整棵 ASN.1 结构调试证书时非常实用。X509Certificate正是基于这棵对象树做位置定位的证书主体block1按固定槽位索引version / serialNumber / signatureAlg / issuer / dateValidity / subject / publicKey / extensions逐项提取见 X509Certificate.swift。生产实践ASN1Decoder 在 expo-updates 代码签名中的应用这套解码器并非孤立工具而是 expo-updates 代码签名验证链路的基础设施这是它在本仓库中最有说服力的真实用例。证书链验证CertificateChain.swift 定义了完整的证书链校验流程将 PEM 字符串数组依次转成(SecCertificate, X509Certificate)二元组constructCertificate通过 Crypto.swift 的decodePEMToDER把 PEM 转为 DER——该方法注释明确说明“Mostly from ASN1Decoder with the fix for disallowing multiple bodies in the PEM”即复用了 ASN1Decoder 的 PEM 解码思路并额外加强了对“单个 PEM 文件内只允许一个证书体”的校验用X509Certificate(der:)解析调用checkValidity()校验有效期通过SecCertificateCreateWithData桥接到系统安全框架对整条链调用validateChain()根证书必须自签名、必须是 CA复用X509Certificate.isCACertificate()检查 BasicConstraints 与 KeyUsage 第 5 位 keyCertSign通过SecTrust系统 API 做信任评估设置锚点、禁用网络获取、SecTrustEvaluateWithError逐级核对 Expo 项目信息扩展的一致性。基于扩展字段的证书能力判断ASN1Decoder 的扩展解析能力被直接用于业务判断isCodeSigningCertificate()要求 KeyUsage 第 0 位 digitalSignature 置位且 Extended Key Usage 包含代码签名 OID1.3.6.1.5.5.7.3.3见 CertificateChain.swiftexpoProjectInformation()读取自定义扩展 OID1.2.840.113556.1.8000.2554.43437.254.128.102.157.7894389.20439.2.1中编码的projectId,scopeKey字符串用于绑定更新包与特定 Expo 项目。这些逻辑完全构建在X509Certificate的extensionObject(oid:)、keyUsage、extendedKeyUsage之上——如果你要为自家业务做类似的证书能力判断如判断一张证书是否可用于某种特定用途可以直接参照这段模式。使用限制与注意事项结合源码如实说明几点边界签名验证不在本模块职责内ASN1Decoder 负责“解析”而非“验证”。SSL Pinning 示例中的公钥比对、expo-updates 中的SecTrust评估与 Expo 项目信息核对都是解析之后由业务层或系统安全框架完成的。App Store 收据的最终有效性验证含 SHA-1 哈希计算也需要基于bundleIdentifierData、opaqueValue、sha1字段自行实现支持的签名算法OID 表OID.swift覆盖 RSA、ECDSA、SHA-1/SHA-256/SHA-512 等常见算法X509PublicKey.key目前仅对 RSA返回模数与 EC返回密钥字节两类 OID 返回数据通用 tag 兜底遇到未识别的 universal tag 会打印unsupported tag并以原始字节作为 value不影响整棵树解析证书链依赖系统评估expo-updates 的validateChain依赖SecTrustEvaluateWithError这是 Apple 平台特性跨平台Android场景由 CertificateChain.kt 提供对应实现。小结从 API 使用到源码剖析本文覆盖了 ASN1Decoder 的完整能力X509Certificate让 DER/PEM 证书解析一行可达X509PublicKey为 SSL Pinning 提供公钥提取PKCS7系列类让 App Store 收据字段唾手可得而 expo-updates 的代码签名链路则示范了如何把这套解码器嵌入生产级安全流程。无论你是要为自己的 App 实现证书公钥锁定、解析收据做内购校验还是构建自定义证书能力判断都可以直接在仓库 packages/expo-updates/ios/EXUpdates/ASN1Decoder 中按需查阅实现细节或将这套零依赖的 Swift 源码移植进自己的工程。【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
