PAYATHON 2026

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 上。

推荐处理步骤

  1. 设备端每次要查询或更新 bits 时,重新调用 generateToken,不要使用 45 天前保存的 token。
  2. 服务端用新 token 调 update_two_bits;如果只是核对状态,先调 query_two_bits,再决定是否更新。
  3. 如果 update_two_bits 报 token 无效,先确认 token 是否新鲜、base64 编码是否正确、JWT 是否有效、timestamp 是否为毫秒、transaction_id 是否唯一。
  4. 如果新 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 验证写入。

备注:内容仅供参考。