DeviceCheck 两位状态和 token 在 45 天后是否仍有效
数据小陈
结论:DeviceCheck 持久化的两位状态,没有公开规则说“最后一次生成 token 后 N 天过期”。45 天没生成 token,并不代表 bits 已被重置。先要处理的是 token 本身。DeviceCheck token 一次性、短时有效,45 天前留下的 token 基本不能再用了。设备端每次要 query/update 时都应重新生成 token,服务端再用新 token 调 query_two_bits / update_two_bits。新 token 调用仍失败,再按错误码检查设备、开发者账号或环境,不要一上来就认定 bits 过期。
为什么容易混淆
DeviceCheck 里有两样东西容易混在一起,另外还要和 App Attest 区分开:
device_token:由DCDevice.current.generateToken生成,交给服务端调用 Apple 的 DeviceCheck API。它是一次性、短时有效的凭证,不适合缓存后反复使用。- 两位
bits:用update_two_bits写入,用query_two_bits读取,按“设备 + 开发者账号”关联。Apple 公开文档没有说明 bits 的 TTL,也没有“多久不活动就重置”的规则。 - App Attest 是另一套机制:attestation/assertion 的生命周期跟 DeviceCheck 的两位状态不是一回事,不能直接把 App Attest token 的规则套到 DeviceCheck bits 上。
推荐处理步骤
- 设备端每次要查询或更新 bits 时,重新调用
generateToken,不要使用 45 天前保存的 token。 - 服务端用新 token 调
update_two_bits;如果只是核对状态,先调query_two_bits,再决定是否更新。 - 如果
update_two_bits报 token 无效,先确认 token 是否新鲜、base64 编码是否正确、JWT 是否有效、timestamp是否为毫秒、transaction_id是否唯一。 - 如果新 token 仍然失败,再检查设备是否支持 DeviceCheck、是否属于同一开发者账号、是否在正确的 Apple 环境调用。不要仅凭旧 token 失败就判断 bits 已过期。
设备端生成新 token 示例:
import DeviceCheck
func fetchDeviceCheckToken(completion: @escaping (Result<String, Error>) -> Void) {
guard DCDevice.current.isSupported else {
completion(.failure(NSError(domain: "DeviceCheck", code: -1, userInfo: [NSLocalizedDescriptionKey: "DeviceCheck not supported"])))
return
}
DCDevice.current.generateToken { data, error in
if let error = error {
completion(.failure(error))
} else if let data = data {
completion(.success(data.base64EncodedString()))
} else {
completion(.failure(NSError(domain: "DeviceCheck", code: -2, userInfo: [NSLocalizedDescriptionKey: "Empty token"])))
}
}
}
服务端更新两位状态示例(JWT 生成略,需按 Apple DeviceCheck 要求签名):
curl -X POST "https://api.devicecheck.apple.com/v1/update_two_bits" -H "Authorization: Bearer $DEVICECHECK_JWT" -H "Content-Type: application/json" -d '{"device_token":"<fresh_base64_token>","transaction_id":"<uuid>","timestamp":1730000000000,"bit0":true,"bit1":false}'
注意事项
- 不要把
device_token当设备标识持久化;它只适合短期使用。 - bits 没有公开 TTL,不等于 Apple 承诺永久保留。对关键业务要设计降级、重试和本地/服务端兜底状态。
- 用户抹掉设备、恢复备份、换机、开发者账号或环境不一致时,可能影响查询结果;失败时先区分 token 问题和状态问题。
- 若要在生产确认 45 天后是否仍保留,最稳妥的是用新 token 先
query_two_bits看返回的 bits 和更新时间,再用update_two_bits验证写入。
备注:内容仅供参考。
