用途:CryptoTokenKit 技能用于构建安全令牌和智能卡集成,覆盖令牌驱动扩展、智能卡会话、令牌支持的钥匙串项、证书认证,以及 iOS/iPadOS 26+ 的 NFC 智能卡访问。
主要能力:提供 macOS 的驱动/令牌/会话类、扩展 Info.plist、PIN 认证、底层 APDU 会话、令牌支持的钥匙串查询、NFC 槽生命周期和证书要求;也覆盖 PIV 选择与签名、BER/紧凑 TLV 解析、通用令牌驱动、命令链、大响应、安全 PIN 操作、配置、槽监控与注册等扩展模式。
使用方式:macOS 智能卡令牌扩展向登录与钥匙串服务暴露硬件支持的密钥和证书;应用在令牌存在时通过 Security.framework 查询令牌支持的项;iOS/iPadOS 26+ 应用可创建临时 NFC 智能卡槽并通过 TKSmartCard 通信。结构化发送需包裹在 withSession 中,原始传输需在每条路径配对 beginSession 和 endSession。平台检查需用 guard 处理 TKSmartCardSlotManager.default,iOS/iPadOS 26+ 还需检查 manager.isNFCSupported()。
限制:API 存在不代表可访问,扩展点、授权、硬件和运行时支持都会影响。登录/钥匙串解锁令牌扩展流程仅限 macOS,TKSmartCardSlotManager.default 可能为 nil,NFC 智能卡槽创建要求 iOS/iPadOS 26+。需检查每个 APDU 状态字,令牌移除后持久引用失效并须处理 errSecItemNotFound,NFC 会话在所有路径都要结束,避免盲目重试 PIN 或破坏性命令。