v1.3
“查找中心”网络 (FHN) 配件规范定义了一种端到端加密方法,用于跟踪信标低功耗蓝牙 (BLE) 设备。本页面介绍了 FHN 作为“快速配对”规范的扩展。 如果提供商拥有与 FHN 兼容的设备,并且愿意为这些设备启用位置信息跟踪功能,则应启用此扩展。
GATT 规范
应向快速配对服务添加一个具有以下语义的额外通用属性 (GATT) 特征:
| 快速配对服务特征 | 已加密 | 权限 | UUID |
|---|---|---|---|
| 信标操作 | 否 | 读取、写入和通知 | FE2C1238-8366-4814-8EB0-01DE32100BEA |
表 1:FHN 的快速配对服务特征。
身份验证
此扩展程序所需的操作会作为写入操作执行,并由质询-响应机制提供安全保障。在执行任何操作之前,Seeker 应从表 1 中的特征执行读取操作,从而生成以下格式的缓冲区:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 协议主要版本号 | 0x01 |
| 1 - 8 | 字节数组 | 一次性随机数 | 视情况而定 |
每个读取操作都应生成不同的 Nonce,并且单个 Nonce 应仅对单个操作有效。即使操作失败,也必须使 Nonce 失效。
然后,Seeker 会计算一个一次性身份验证密钥,以便在后续写入请求中使用。身份验证密钥的计算方法如表 2 至表 5 中所述。根据所请求的操作,Seeker 会证明其知道以下一个或多个密钥:
账号密钥:16 字节的快速配对账号密钥,如快速配对规范中所定义。
所有者账号密钥:当 Seeker 首次访问信标操作特征时,Provider 会选择一个现有账号密钥作为所有者账号密钥。在提供方恢复出厂设置之前,无法更改所选的所有者账号密钥。当提供商用完免费账号密钥槽位时,不得移除所有者账号密钥。
如果提供方在首次配对时已支持 FHN(或在恢复出厂设置后配对时支持 FHN),则会选择第一个账号密钥,因为这是在配对期间寻觅方读取配置状态时唯一存在的账号密钥。
在已配对后获得 FHN 支持的提供程序(例如,通过固件更新)可以选择任何现有账号密钥。在固件更新后,选择用于从信标操作特征中读取配置状态的第一个账号密钥是合理的,前提是执行更新的用户是提供方的当前所有者。
临时身份密钥 (EIK):Seeker 在执行 FHN 配置流程时随机选择的 32 字节密钥。此密钥用于派生加密密钥,这些加密密钥用于对位置报告进行端到端加密。Seeker 绝不会向后端透露该信息。
恢复密钥:定义为
SHA256(ephemeral identity key || 0x01),截断为前 8 个字节。该密钥存储在后端,只要用户通过按下设备上的按钮表示同意,Seeker 就可以使用该密钥恢复 EIK。环键:定义为
SHA256(ephemeral identity key || 0x02),截断为前 8 个字节。该密钥存储在后端,Seeker 只能使用它来响铃设备。不当跟踪保护密钥:定义为
SHA256(ephemeral identity key || 0x03),截断为前 8 个字节。该密钥存储在后端,搜寻器只能使用它来激活不明追踪保护模式。
操作
写入特征的数据格式如表 2 至表 5 所示。本部分稍后将更详细地讨论每项操作。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID |
|
| 1 | uint8 | 数据长度 | 视情况而定 |
| 2 - 9 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(account key, protocol major version number || the last nonce
read from the characteristic || data ID || data length || additional data) 的前 8 个字节 |
| 10 - var | 字节数组 | 其他数据 |
|
表 2:信标配置请求。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x04:在征得用户同意的情况下读取临时身份密钥 |
| 1 | uint8 | 数据长度 | 0x08 |
| 2 - 9 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(recovery key, protocol major version number || the last nonce
read from the characteristic || data ID || data length) 的前 8 个字节 |
表 3:信标配置密钥恢复请求。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID |
|
| 1 | uint8 | 数据长度 | 视情况而定 |
| 2 - 9 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(ring key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data) 的前 8 个字节 |
| 10 - var | 字节数组 | 其他数据 |
|
表 4:响铃请求。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID |
|
| 1 | uint8 | 数据长度 | 视情况而定 |
| 2 - 9 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(unwanted tracking protection key, protocol major version number
|| the last nonce read from the characteristic || data ID || data length ||
additional data) 的前 8 个字节 |
| 10 - var | 字节数组 | 其他数据 |
|
表 5:不必要的跟踪保护请求。
成功写入会触发通知,如表 6 中所列。
数据 ID 不是 0x05:响铃状态更改的通知应在触发通知的写入事务完成之前(即在发送写入请求的响应 PDU 之前)发送。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID |
|
| 1 | uint8 | 数据长度 | 视情况而定 |
| 2 - 9 | 字节数组 | 身份验证 | 按操作详细说明 |
| 10 - var | 字节数组 | 其他数据 |
|
表 6:信标服务响应。
表 7 列出了操作可能返回的 GATT 错误代码。
| 代码 | 说明 | 备注 |
|---|---|---|
| 0x80 | 未通过身份验证 | 在身份验证失败(包括使用了旧 Nonce 的情况)时,作为对写入请求的响应返回。 |
| 0x81 | 值无效 | 在提供的任何值无效或收到的数据具有意外字节数时返回。 |
| 0x82 | 未征得用户同意 | 当设备未处于配对模式时,系统会返回此错误,以响应数据 ID 为 0x04:在征得用户同意的情况下读取临时身份密钥的写入请求。 |
表 7:GATT 错误代码。
读取信标的参数
Seeker 可以通过对特征执行写入操作来向 Provider 查询信标的参数,该特征由表 2 中数据 ID 为 0x00 的请求组成。提供方会验证提供的一次性身份验证密钥是否与存储在设备上的任何账号密钥匹配。
如果验证失败,提供方会返回未通过身份验证错误。
成功后,提供方会发送通知,其中包含表 6 中的响应(数据 ID 为 0x00)。提供商按如下方式构建数据细分:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 校准后的功率 | 在 0 米处接收到的校准功率(值在 [-100, 20] 范围内)。表示为带符号整数,分辨率为 1 dBm。 |
| 1 - 4 | uint32 | 时钟值 | 当前时钟值(以秒为单位,大端序)。 |
| 5 | uint8 | 曲线选择 | 用于加密的椭圆曲线:
|
| 6 | uint8 | 组件 | 可响铃的组件数量:
|
| 7 | uint8 | 响铃功能 | 支持的选项包括:
|
| 8-15 | 字节数组 | 内边距 | AES 加密的零填充。 |
数据应使用用于对请求进行身份验证的账号密钥进行 AES-ECB-128 加密。
身份验证段定义为 HMAC-SHA256(account key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data after
encryption || 0x01) 的前 8 个字节。
读取信标的预配状态
Seeker 可以通过对特征执行写入操作来向 Provider 查询信标的配置状态,该特征由表 2 中数据 ID 为 0x01 的请求组成。提供方会验证提供的一次性身份验证密钥是否与设备上存储的任何账号密钥匹配。
如果验证失败,提供方会返回未通过身份验证错误。
成功后,提供方会发送通知,其中包含表 6 中数据 ID 为 0x01 的响应。提供商按如下方式构建数据细分:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 预配状态 | 具有以下值的位掩码:
|
| 1 - 20 或 32 | 字节数组 | 当前临时标识符 | 20 或 32 字节(取决于所使用的加密方法),表示信标通告的当前临时 ID(如果已为设备设置)。 |
身份验证段定义为 HMAC-SHA256(account key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data || 0x01) 的前 8 个字节。
设置临时身份密钥
如需将未配置的提供方配置为 FHN 信标,或更改已配置的提供方的临时身份密钥,搜索方会对特征执行写入操作,该特征由表 2 中数据 ID 为 0x02 的请求组成。提供商会验证:
- 提供的一次性身份验证密钥与所有者账号密钥匹配。
- 如果提供了临时身份密钥的哈希,则经过哈希处理的临时身份密钥与当前临时身份密钥匹配。
- 如果未提供临时身份密钥的哈希,请验证提供方是否尚未预配为 FHN 信标。
如果验证失败,提供方会返回未通过身份验证错误。
如果成功,系统会使用匹配的账号密钥通过 AES-ECB-128 解密来恢复临时身份密钥。该密钥应保留在设备上,并且从此时起,提供方应开始广播 FHN 帧。新的临时身份密钥会在 BLE 连接终止后立即生效。提供方使用表 6 中的响应(数据 ID 为 0x02)进行通知。
身份验证段定义为 HMAC-SHA256(account key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || 0x01) 的前 8 个字节。
清除临时身份密钥
如需取消配置提供方的信标部分,寻找方会对特征执行写入操作,该操作由表 2 中数据 ID 为 0x03 的请求组成。提供商会验证:
- 提供的一次性身份验证密钥与所有者账号密钥匹配。
- 经过哈希处理的临时身份密钥与当前临时身份密钥匹配。
如果提供方未预配为 FHN 信标或验证失败,则会返回未通过身份验证错误。
成功后,提供方会忘记密钥并停止通告 FHN 帧。提供者会使用表 6 中的响应(数据 ID 为 0x03)进行通知。身份验证段定义为 HMAC-SHA256(account
key, protocol major version number || the last nonce read from the
characteristic || data ID || data length || 0x01) 的前 8 个字节。
在征得用户同意的情况下读取临时身份密钥
此选项仅适用于恢复丢失的密钥,因为密钥仅由 Seeker 存储在本地。因此,只有当设备处于配对模式时,或者在按下设备上的实体按钮(表示用户同意)后的一段有限时间内,此功能才可用。
Seeker 必须将恢复密钥存储在后端,以便能够恢复明文密钥,但它不会存储 EIK 本身。
如需读取 EIK,Seeker 会对特征执行写入操作,该操作由表 3 中数据 ID 为 0x04 的请求组成。提供方会验证:
- 经过哈希处理的恢复密钥与预期的恢复密钥一致。
- 设备处于 EIK 恢复模式。
如果验证失败,提供方会返回未通过身份验证错误。
如果设备未处于配对模式,提供方会返回“No User Consent”(用户未同意)错误。
成功后,提供方会发送通知,其中包含表 6 中数据 ID 为 0x04 的响应。
身份验证段定义为 HMAC-SHA256(recovery key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data || 0x01) 的前 8 个字节。
响铃操作
Seeker 可以通过对特征执行写入操作来请求 Provider 播放声音,该操作由表 4 中数据 ID 为 0x05 的请求组成。 提供商按如下方式构建数据细分:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 响铃操作 | 具有以下值的位掩码:
|
| 1 - 2 | uint16 | 超时 | 超时时长(以分秒为单位)。不得为零,且不得大于 10 分钟。 提供方使用此值来确定在静音之前应响铃多长时间。如果设备的任何组件已在响铃,则此超时会覆盖已生效的超时。 如果响铃操作设置为 0x00,则系统会忽略超时。 |
| 3 | uint8 | 音量 |
|
收到请求后,提供方会验证:
- 提供的一次性身份验证密钥与响铃密钥匹配。
- 请求的状态与可响铃的组件相匹配。
如果提供方未预配为 FHN 信标或验证失败,则会返回未通过身份验证错误。不过,如果提供方已启用“跟踪保护”功能,并且触发不明追踪保护请求时开启了“跳过响铃身份验证”标志,则提供方应跳过该检查。身份验证数据仍应由 Seeker 提供,但可以设置为任意值。
当响铃开始或结束时,系统会发送一条通知(如表 6 所示),其数据 ID 为 0x05。通知的内容定义如下:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 响铃状态 |
|
| 1 | uint8 | 响铃组件 | 正在响铃的组件的位掩码,如请求中所定义。 |
| 2 - 3 | uint16 | 超时 | 剩余响铃时间(以分秒为单位)。如果设备已停止响铃,则应返回 0x0000。 |
身份验证段定义为 HMAC-SHA256(ring
key, protocol major version number || the nonce used to initiate the ringing
command || data ID || data length || additional data || 0x01) 的前 8 个字节。
如果设备在收到响铃或停止响铃请求时已处于请求的响铃状态,则提供方应发送响铃状态或 0x00:已开始或 0x04:已停止(GATT 请求)的通知。 此请求会覆盖现有状态的参数,以便延长响铃时长。
如果提供方具有实体按钮(或已启用触控感应),则在响铃期间按下该按钮应会停止响铃功能。
获取信标的响铃状态
为了获取信标的响铃状态,Seeker 会对特征执行写入操作,该操作由表 4 中数据 ID 为 0x06 的请求组成。提供方会验证提供的一次性身份验证密钥是否与响铃密钥匹配。
如果提供方未预配为 FHN 信标,或者验证失败,提供方会返回未通过身份验证错误。
成功后,提供方会发送通知,其中包含表 6 中数据 ID 为 0x06 的响应。提供商按如下方式构建数据细分:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 响铃组件 | 正在响铃的组件,如响铃请求中所定义。 |
| 1 - 2 | uint16 | 超时 | 剩余响铃时间(以分秒为单位)。请注意,如果设备未响铃,则应返回 0x0000。 |
身份验证段定义为 HMAC-SHA256 (ring
key, protocol major version number || the last nonce read from the
characteristic || data ID || data length || additional data || 0x01) 的前 8 个字节。
恶意跟踪保护模式
“不明跟踪保护”模式旨在让任何客户端都能在不与服务器通信的情况下识别滥用设备。默认情况下,提供商应按照身份轮替中的说明轮替所有标识符。“查找中心”服务可通过“查找中心”网络转发不明跟踪保护模式激活请求。这样,该服务会使提供方暂时使用固定的 MAC 地址,从而使客户端能够检测到设备并警告用户可能存在不必要的跟踪。
如需激活或停用信标的不明跟踪保护模式,Seeker 会对特征执行写入操作,该操作由表 5 中数据 ID 分别为 0x07 或 0x08 的请求组成。
启用跟踪保护模式时
提供商按如下方式构建数据细分:
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 控制标志 |
这些标志仅在停用“跟踪保护”模式之前有效。 |
提供方会验证提供的一次性身份验证密钥是否与不明跟踪保护密钥匹配。如果提供方未预配为 FHN 信标或验证失败,则会返回未通过身份验证错误。
当启用不明跟踪保护模式时,信标应将 MAC 私有地址轮替频率降低到每 24 小时一次。通告的临时标识符应照常轮替。帧类型应设置为 0x41。该状态也会反映在经过哈希处理的标志部分中。
停用“跟踪保护”模式时
提供商会验证:
- 提供的一次性身份验证密钥与不明追踪保护密钥匹配。
- 经过哈希处理的临时身份密钥与当前临时身份密钥匹配。
如果提供方未预配为 FHN 信标或验证失败,提供方会返回未通过身份验证错误。
停用“跟踪保护”模式后,信标应再次开始以正常速率轮替 MAC 地址,并与临时标识符轮替保持同步。帧类型应设置回 0x40。该状态也会反映在经过哈希处理的标志部分中。
成功后,提供方会发送通知,其中包含表 6 中数据 ID 为 0x07 或 0x08 的响应。
身份验证段定义为 HMAC-SHA256(unwanted tracking protection key, protocol major version number ||
the last nonce read from the characteristic || data ID || data length ||
0x01) 的前 8 个字节。
精准查找
本部分详细介绍了精准查找所需的流程和额外操作。此处也适用 GATT 规范部分中定义的 GATT 特征和身份验证规则。精准查找功能是可选的。
精准查找的类型取决于参与精准查找的设备所支持的测距技术类型。如需了解支持的测距技术,请参阅测距:带外消息序列和载荷规范。后续部分将探讨根据所使用的测距技术,可以预期获得什么样的精准查找体验。
精准查找流程
本部分将探讨精准查找的 FHNA 消息流。图 1 显示了消息流,段落更详细地说明了每条消息。
图 1
典型的精准查找消息流
发起方设备是指安装了“查找中心”应用并从中启动了“精准查找”功能的设备。发起方是尝试查找其他设备的设备。
响应方设备是发起方设备尝试查找的设备。
发起方设备会向响应方设备发送测距功能请求消息,其中会列出它希望从响应方设备了解的测距技术。响应方设备将回复测距功能响应通知,其中包含有关支持哪些测距技术及其功能的信息。响应方将仅包含发起方请求的信息。功能列表将根据响应方设备偏好的测距技术的优先级进行排序,列表中排在第一位的优先级最高。
然后,发起方设备会发送测距配置消息,其中会定义它要使用的每种测距技术的配置。收到此消息后,响应方设备必须使用提供的配置开始针对适用技术进行测距。响应方设备将发回测距配置响应通知,其中包含每种测距技术是否成功启动的结果。某些测距技术必须在发起方和响应方设备上同时启动,才能成功进行测距会话,而对于其他测距技术,只需在发起方设备上启动即可,但响应方设备仍必须针对此类技术回复成功结果。如需详细了解特定测距技术的行为,请参阅后续部分。
当发起方设备准备好停止精准查找会话时,它会向响应方发送“停止测距”消息,指明哪些测距技术必须停止测距。响应方设备将回复“停止测距响应”通知,表明它已成功停止使用请求的测距技术进行测距。
如果 FHNA BLE GATT 通信通道在精准查找会话期间断开连接,但某些测距技术仍在测距,则响应方设备将实现超时机制,以确保不会无限期测距。具体细节取决于每个用例。
请注意,响应方设备不得假定操作顺序始终相同。例如,响应方设备必须能够连续处理多个测距功能请求操作,甚至能够直接处理测距配置操作,而无需事先发出功能请求。
精准查找操作
表 8 显示了本文档中定义的精准查找所需的 FHNA 操作。每个子部分都定义了每项操作的 FHNA 消息,而附加数据字段内容则引用测距:带外消息序列和载荷规范。
| 操作 | 数据 ID | 说明 |
|---|---|---|
| 测距功能请求 | 0x0A | 发起方设备将向响应方设备发送的功能请求操作。此操作的数据内容将列出发起方希望从响应方设备了解的所有测距技术。 |
| 测距功能响应 | 0x0A | 这是对测距功能请求操作的通知响应。其中包含发起方请求的每种受支持测距技术的功能信息。 |
| 产品阵容配置 | 0x0B | 测距配置操作包含发起方设备希望与响应方设备开始测距的测距技术配置。 |
| 测距配置响应 | 0x0B | 这是对测距配置操作的通知响应。其中包含有关响应方设备是否已根据提供的配置成功开始使用请求的测距技术进行测距的数据。 |
| RFU | 0x0C | 具有此数据 ID 的操作未使用,并预留以供将来使用。 |
| 停止测距 | 0x0D | 发起方设备发送的“停止测距”操作包含有关响应方设备必须停止使用哪些测距技术进行测距的信息。 |
| 停止测距响应 | 0x0D | 这是对“停止测距”操作的通知响应。它包含特定测距技术的停止操作是否成功的数据。 |
表 8:精准查找操作。
测距功能请求操作
表 9 定义了测距功能请求消息。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x0A - 测距功能请求操作 |
| 1 | uint8 | 数据长度 | 不定 |
| 2 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(账号密钥、协议主要版本号 || 从特征中读取的最后一个 Nonce || 数据 ID || 数据长度 || 额外数据)的前 8 个字节。 |
| 10 | 字节数组 | 其他数据 | 测距:带外消息序列和载荷规范中定义的测距功能请求消息(标头和载荷) |
表 9:测距功能请求。
测距功能响应操作
表 10 定义了测距功能响应消息。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x0A:测距功能响应 |
| 1 | uint8 | 数据长度 | 不定 |
| 2 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(账号密钥、协议主要版本号 || 从特征中读取的最后一个 Nonce || 数据 ID || 数据长度 || 附加数据 || 0x01)的前 8 个字节。 |
| 10 | 字节数组 | 其他数据 | 测距:带外消息序列和载荷规范中定义的测距功能响应消息(标头和载荷) |
表 10:测距功能响应。
测距配置操作
表 11 定义了测距配置消息。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x0B - 设置测距配置 |
| 1 | uint8 | 数据长度 | 不定 |
| 2 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(账号密钥、协议主要版本号 || 从特征中读取的最后一个 Nonce || 数据 ID || 数据长度 || 额外数据)的前 8 个字节。 |
| 10 | 字节数组 | 其他数据 | 测距:带外消息序列和载荷规范中定义的测距配置消息(标头和载荷) |
表 11:测距配置。
测距配置响应操作
表 12 定义了测距配置响应消息。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x0B - 设置测距配置响应 |
| 1 | uint8 | 数据长度 | 不定 |
| 2 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(账号密钥、协议主要版本号 || 从特征中读取的最后一个 Nonce || 数据 ID || 数据长度 || 附加数据 || 0x01)的前 8 个字节。 |
| 10 | 字节数组 | 其他数据 | 测距:带外消息序列和载荷规范中定义的测距配置响应消息(标头和载荷) |
表 12:测距配置响应。
停止测距操作
表 13 定义了“停止测距”消息。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x0D - 测距停止 |
| 1 | uint8 | 数据长度 | 不定 |
| 2 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(账号密钥、协议主要版本号 || 从特征中读取的最后一个 Nonce || 数据 ID || 数据长度)的前 8 个字节。 |
| 10 | 字节数组 | 其他数据 | 测距:带外消息序列和载荷规范中定义的停止测距消息(标头和载荷) |
表 13:停止测距。
停止测距响应操作
表 14 定义了“停止测距响应”消息。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 数据 ID | 0x0D - 测距停止响应 |
| 1 | uint8 | 数据长度 | 不定 |
| 2 | 字节数组 | 一次性身份验证密钥 | HMAC-SHA256(账号密钥、协议主要版本号 || 从特征中读取的最后一个 Nonce || 数据 ID || 数据长度 || 附加数据 || 0x01)的前 8 个字节。 |
| 10 | 字节数组 | 其他数据 | 测距:带外消息序列和载荷规范中定义的停止测距响应消息(标头和载荷) |
表 14:停止测距响应。
通过精确查找功能防范恶意追踪
当启用有害跟踪保护模式时(如“有害跟踪保护”部分所述),对于想要支持此功能的设备,适用于跳过响铃消息身份验证检查的相同流程也适用于本文档中定义的所有精准查找消息。
精准查找功能的测距技术详情
本部分包含测距技术特有的详细信息。
超宽带 (UWB) 详情
UWB 专属详情。
精准查找级别
使用 UWB 作为测距技术的精准查找会话应该会同时显示距离和方向信息。测距间隔至少需要为 240 毫秒,最好为 96 毫秒,以获得最佳引导效果。
配置 ID
为 UWB 交换的带外配置数据不包含 UWB 启动 UWB 测距会话所需的完整可用可配置参数集。某些参数由所选配置 ID 隐式选择。
每个配置 ID 都是一组预定义的 UWB 配置参数,这些参数已公开记录。对于精准查找用例,响应方设备必须支持配置 ID 6,并可选择支持配置 ID 3。
UWB 发起方和响应方
对于精准查找用例,本文档中称为“发起方设备”的设备将是 UWB 响应方,而本文档中称为“响应方设备”的设备将是 UWB 发起方。这是因为 UWB 发起方设备比 UWB 响应方设备消耗更少的电量,并且在大多数情况下,响应方设备将是电池电量有限的外围设备。
这意味着,响应方设备需要在测距功能响应消息中指明其支持作为 UWB 发起方角色。
其他 UWB 相关参数
- 必须支持频道 9。
- 为获得最佳引导效果,建议使用 96 毫秒的测距间隔,否则必须支持 240 毫秒。
- 建议将时隙时长设为 1 毫秒,以节省电池电量,但也支持 2 毫秒。
- UWB 芯片必须至少符合 FIRA v1.2 + P-STS 标准。
- BPRF 是强制性的,HPRF 是推荐的,但可选。支持或选择的模式由支持或选择的前导码索引决定。
- 会话安全类型:P-STS。
- 必须启用跳频。
BLE 信道探测 (CS) 规范
BLE CS 专属详情。
精准查找级别
使用 CS 作为测距技术的精准查找会话将仅提供距离测量,目前不提供方向性。
设备之间需要绑定
如果设备未绑定,则使用 Channel Sounding 的精准查找会话将无法正常运行。发起方设备和响应方设备之间必须已建立绑定关系。此规范未提供在设备之间创建绑定的方法。而是由用例的开发者在设备之间建立这种绑定。
CS 专属要求
两台设备都必须支持以下 CS 配置,才能进行“查找中心”CS 测距:
| 参数 | 要求 |
|---|---|
| T_FCS | <= 80 微秒 |
| T_IP1/T_IP2 | <= 40 微秒 |
| T_PM | <= 10 微秒 |
| T_SW | <= 2 微秒 |
| Num_Config_Supported | >= 2 |
| Max_Antenna_Paths_Supported | >= 2 |
| FAE = 0 | 支持 |
| CS_SYNC_Antenna_Selection(如果天线数量 > 1) | 天线标识符 + 0xFD + 0xFE |
| Max_TX_Power | >= 8 dBm |
| ADV_TX_Power | 与 LE ACL 的 TX 功率相同 |
| Data_Length_Extension(DLE - 251 字节) | 支持 |
| PCT_Tone_Quality | 支持 |
| Phase_Coherence_across_Subevents | 支持 |
| RX_Power_Level_Consistency_across_Subevents (PCT Magnitude) | 支持 |
表 15:CS 必需配置。
需要以下 TX 功率控制:
- 设备应支持 LE ACL 链路上的 BT 5.2 TX 功率控制功能
- 在单个 CS 过程中,即使有多个子事件,TX 功率也应保持不变。
- 在不同的 CS 过程之间,TX 功率应遵循基本 LE ACL TX 功率。
所有硬件都需要经过适当的校准阶段,以确保不会因射频前端电路或布线而出现系统性偏移或误差。
需要响应方针对 CS 采取行动
与 UWB 不同,在 UWB 中,两个设备都需要明确调用 UWB 启动测距和停止测距 API,而对于 CS,只有发起方设备需要通过调用蓝牙堆栈来启动 CS 测距,响应方端的其余初始化操作则使用蓝牙 (BT) 在带内进行。这意味着,在收到 CS 的测距配置消息或停止测距消息后,如果 BT 已启用,响应方无需执行任何操作,只需回复测距配置响应消息通知即可。响应方设备可能会使用这些消息作为触发器来更新界面(如果存在屏幕),或者无论是否有屏幕,都可用于提供有关设备状态的视觉反馈,例如使设备 LED 闪烁。
Wi-Fi NAN RTT
Wi-Fi NAN RTT 具体详情。
精准查找级别
使用 Wi-Fi NAN RTT 作为测距技术的精准查找会话只会测量距离,目前不提供方向。
BLE RSSI
BLE RSSI 具体详情。
精准查找级别
由于 BLE RSSI 不是一种精确的测距技术,因此仅使用 BLE RSSI 作为测距技术的精准查找会话将无法获取距离或方向信息。而是会看到指示设备距离远近的提示。
通告的帧
配置完成后,提供方应至少每 2 秒广播一次 FHN 帧。如果通告了快速配对帧,提供方应在常规快速配对通告中交错 FHN 帧。例如,提供方应每两秒广播七个快速配对通告和一个 FHN 通告。
FHN 广播的传导蓝牙发射功率应设置为至少 0 dBm。
FHN 帧包含一个公钥,任何支持该公钥并为众包网络做出贡献的客户端都会使用该公钥来加密位置报告。有两种类型的椭圆曲线密钥可用:适合旧版 BLE 4 帧的 160 位密钥,或需要具有扩展通告功能的 BLE 5 的 256 位密钥。提供方的实现决定了使用哪条曲线。
FHN 帧的结构如下。
| 八位字节 | 值 | 说明 |
|---|---|---|
| 0 | 0x02 | 长度 |
| 1 | 0x01 | 标志数据类型值 |
| 2 | 0x06 | 标志数据 |
| 3 | 0x18 或 0x19 | 长度 |
| 4 | 0x16 | 服务数据数据类型值 |
| 5 | 0xAA | 16 位服务 UUID |
| 6 | 0xFE | … |
| 7 | 0x40 或 0x41 | 带有不必要的跟踪保护模式指示的 FHN 帧类型 |
| 8..27 | 20 字节临时标识符 | |
| 28 | 经过哈希处理的标志 |
表 16:支持 160 位曲线的 FHN 帧。
表 17 显示了 256 位曲线的字节偏移量和值。
| 八位字节 | 值 | 说明 |
|---|---|---|
| 0 | 0x02 | 长度 |
| 1 | 0x01 | 标志数据类型值 |
| 2 | 0x06 | 标志数据 |
| 3 | 0x24 或 0x25 | 长度 |
| 4 | 0x16 | 服务数据数据类型值 |
| 5 | 0xAA | 16 位服务 UUID |
| 6 | 0xFE | … |
| 7 | 0x40 或 0x41 | 带有不必要的跟踪保护模式指示的 FHN 帧类型 |
| 8.39 | 32 字节临时标识符 | |
| 40 | 经过哈希处理的标志 |
表 17:支持 256 位曲线的 FHN 帧。
临时标识符 (EID) 计算
通过使用临时身份密钥对以下数据结构进行 AES-ECB-256 加密,生成一个随机数:
| 八位字节 | 字段 | 说明 |
|---|---|---|
| 0 - 10 | 内边距 | 值 = 0xFF |
| 11 | K | 轮替周期指数 |
| 12 - 15 | TS[0]…TS[3] | 信标时间计数器,采用 32 位大端序格式。最低 K 位会被清除。 |
| 16 - 26 | 内边距 | 值 = 0x00 |
| 27 | K | 轮替周期指数 |
| 28 - 31 | TS[0]…TS[3] | 信标时间计数器,采用 32 位大端序格式。最低 K 位会被清除。 |
表 18:伪随机数的构造。
此计算的结果是一个 256 位数字,表示为 r'。
在其余计算中,SECP160R1 或 SECP256R1 用于椭圆曲线加密操作。请参阅 SEC 2:推荐的椭圆曲线域参数中的曲线定义,其中定义了下文引用的 Fp、n 和 G。
现在,通过计算 r = r' mod n,将 r' 投影到有限域 Fp。
最后,计算 R = r * G,它是曲线上表示所用公钥的点。信标会通告 Rx(R 的 x 坐标)作为其临时标识符。
经过哈希处理的标志
哈希标志字段的计算方式如下(位从最高有效位到最低有效位进行引用):
- 位 0-4:预留(设为 0)。
- 第 5-6 位表示设备的电池电量,如下所示:
- 00:不支持电池电量指示
- 01:电池电量正常
- 10:电池电量低
- 11:电池电量极低(需要尽快更换电池)
- 如果信标处于“防范不明追踪”模式,则位 7 设置为 1,否则设置为 0。
为了生成此字节的最终值,它会与 SHA256(r) 的最低有效字节进行异或运算。
请注意,r 应与曲线的大小保持一致。如果其表示形式短于 160 位或 256 位,则添加零作为最高有效位;如果其表示形式长于 160 位或 256 位,则应截断最高有效位。
如果信标不支持电池电量指示,并且未处于不明跟踪保护模式,则可以从通告中完全省略此字节。
使用 EID 进行加密
如需加密消息 m,观察者(已从信标读取 Rx)将执行以下操作:
- 在
Fp中选择一个随机数s,如 EID 计算部分中所定义。 - 计算
S = s * G。 - 通过在曲线方程中代入并从可能的结果中选择任意
Ry值来计算R = (Rx, Ry)。 - 计算 256 位 AES 密钥
k = HKDF-SHA256((s * R)x),其中(s * R)x是曲线乘法结果的x坐标。未指定盐。 - 假设
URx和LRx分别是Rx的高 80 位和低 80 位(采用大端格式)。以类似的方式,为S定义USx和LSx。 - 计算
nonce = LRx || LSx。 - 计算
(m’, tag) = AES-EAX-256-ENC(k, nonce, m)。 - 将
(URx, Sx, m’, tag)发送给所有者,可能通过不可信的远程服务。
解密使用 EID 加密的值
所有者的客户端拥有 EIK 和轮替周期指数,它会按如下方式解密消息:
- 给定
URx,获取URx所基于的信标时间计数器值。 这可以通过所有者的客户端计算最近过去和不久将来的信标时间计数器值的Rx值来实现。 - 根据
URx所基于的信标时间计数器值,计算r的预期值(如 EID 计算部分中所定义)。 - 计算
R = r * G,并验证其是否与 sighter 提供的URx值匹配。 - 通过在曲线方程中代入并从可能的结果中选择任意
Sy值来计算S = (Sx, Sy)。 - 计算
k = HKDF-SHA256((r * S)x),其中(r * S)x是曲线乘法结果的x坐标。 - 计算
nonce = LRx || LSx。 - 计算
m = AES-EAX-256-DEC(k, nonce, m’, tag)。
ID 轮替
必须使用可解析 (RPA) 或不可解析 (NRPA) 的 BLE 地址来通告 FHN 帧。LE 音频 (LEA) 设备必须使用 RPA,其他设备也建议使用 RPA,但不使用绑定的定位器标签除外。
快速配对通告、FHN 通告和相应的 BLE 地址应同时轮替。轮替应平均每 1024 秒发生一次。信标开始通告新标识符的确切时间点必须在窗口内随机选择。
建议的轮换时间随机化方法是,将轮换时间设置为下一个预期轮换时间(如果未应用随机化),再加上一个 1 到 204 秒范围内的正随机化时间因子。
当设备处于“不明追踪保护”模式时,FHN 通告的 BLE 地址应保持固定,但 FP 不可检测通告(例如“快速配对”)的 RPA 必须不断轮替。可以为不同的协议使用不同的地址。
从断电中恢复
解析临时标识符与通告时的时钟值密切相关,因此,如果断电,提供程序能够恢复其时钟值非常重要。建议提供方每天至少将其当前时钟值写入非易失性存储器一次,并且在启动时,提供方检查 NVM 以查看是否存在要从中初始化的值。临时标识符的解析器会在足够长的时间范围内实现解析,以便同时允许合理的时钟漂移和这种类型的断电恢复。
提供商仍应尽一切努力最大限度地减少时钟偏移,因为解析时间窗口有限。应至少实现一种额外的时钟同步方法(通告 [不可检测到的快速配对帧](
locator-tag)或实现消息流。
快速配对实现指南
本部分介绍了在支持 FHN 的提供方上实现快速配对的特殊方面。
定位追踪器具体指南
- 如果提供方已配对,但 FHN 未在 5 分钟内配置(或者在设备已配对但未配置 FHN 的情况下应用了 OTA 更新),则提供方应还原到其出厂配置并清除存储的账号密钥。
- 配对后,提供方不应更改其 MAC 地址,直到 FHN 预配完成或 5 分钟过去。
- 如果从设备中清除了临时身份密钥,则设备应执行恢复出厂设置,并清除存储的账号密钥。
- 提供方应拒绝正常的蓝牙配对尝试,仅接受快速配对。
- 提供方必须包含一种机制,让用户无需将设备恢复出厂设置即可暂时停止通告(例如,按组合键)。
- 断电后,设备应通告不可检测到的快速配对帧,直到下次调用读取信标参数。这样,即使发生明显的时钟偏移,Seeker 也能检测到设备并同步时钟。
- 通告不可检测到的快速配对帧时,不应启用界面指示。
- 当提供方已针对 FHN 进行配置时,不应广播可检测到的快速配对帧。
- 提供方不应以未经身份验证的方式公开任何身份信息(例如名称或标识符)。
针对传统蓝牙设备的具体准则
本部分介绍了支持 FHN 的传统蓝牙设备的特殊方面。
已配对的设备的 FHN 配置
提供方在与寻觅方配对时,并不总是会为 FHN 进行配置,而是在配对后一段时间才进行配置。在这种情况下,提供方可能没有建立 GATT 连接所需的最新 BLE MAC 地址。提供方必须支持以下至少一种方式,以便发现方在已配对的情况下获取其 BLE 地址:
- 提供方可以定期通告快速配对账号数据,以便发现方通过 BLE 扫描找到其 BLE 地址。
此方法适用于未实现消息流的提供方。 - 提供方可以通过传统蓝牙通过快速配对消息流提供此数据。
此方法适用于在通过蓝牙连接到 Seeker 时不通告快速配对帧的 Provider。
同时支持这两种方法可提高用户为 FHN 配置设备的机会。
快速配对消息流
提供方可以实现快速配对消息流,并使用它向寻找方通知设备信息。实现消息流可启用本部分所述的某些功能。
提供方应在每次建立消息流时发送一次设备信息消息。
固件版本(设备信息代码 0x09)和跟踪功能
当固件更新为提供方添加 FHN 支持时,已连接的寻觅方可以通知用户,并提供配置选项。否则,用户必须手动前往蓝牙设备列表,才能启动 FHN 配置。
为此,提供方应使用固件版本属性(代码 0x09)来报告表示固件版本的字符串值。此外,提供方应支持让寻觅方了解因固件更新而发生的功能变化的协议。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 设备信息事件 | 0x03 |
| 1 | uint8 | 固件版本 | 0x09 |
| 2 - 3 | uint16 | 附加数据长度 | 视情况而定 |
| var | 字节数组 | 版本字符串 | 视情况而定 |
表 19:设备信息事件:更新后的固件版本。
收到功能更新请求 (0x0601) 后,如果提供方已启用对 FHN 跟踪的支持,则应按照表 20 所示进行响应。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 设备功能同步事件 | 0x06 |
| 1 | uint8 | FHN 追踪 | 0x03 |
| 2 - 3 | uint16 | 附加数据长度 | 0x0007 |
| 4 | uint8 | FHN 预配状态 | 如果未配置,则为 0x00;如果由任何账号配置,则为 0x01 |
| 5 - 10 | 字节数组 | 设备的当前 BLE MAC 地址 | 视情况而定 |
表 20:设备功能同步事件:添加了跟踪功能。
当前临时标识符(设备信息代码 0x0B)
提供方可以使用当前临时标识符(代码 0x0B)报告当前 EID 和时钟值(当提供方已针对 FHN 进行配置时),以便在时钟漂移(例如,由于电池电量耗尽)时同步 Seekers。 否则,Seeker 会为此发起费用更高且可靠性更低的连接。
| 八位字节 | 数据类型 | 说明 | 值 |
|---|---|---|---|
| 0 | uint8 | 设备信息事件 | 0x03 |
| 1 | uint8 | 当前临时标识符 | 0x0B |
| 2 - 3 | uint16 | 附加数据长度 | 0x0018 或 0x0024 |
| 4 - 7 | 字节数组 | 时钟值 | 示例:0x13F9EA80 |
| 8 - 19 或 31 | 字节数组 | 当前 EID | 示例: 0x1122334455667788990011223344556677889900 |
表 21:设备信息事件:时钟同步。
恢复出厂设置
对于支持恢复出厂设置的设备:如果执行了恢复出厂设置,提供方必须停止信标,并清除临时身份密钥和所有存储的账号密钥(包括所有者的账号密钥)。
恢复出厂设置(手动或通过程序)后,提供方不应立即开始广播快速配对,以防止在用户删除设备后立即启动配对流程。
恶意追踪防范
经过认证的 FHN 设备还必须满足检测不需要的位置信息追踪器 (DULT) 跨平台规范实现版本中的要求。
与 FHN 相关且符合 DULT 规范的相关指南:
- 任何与 FHN 兼容的设备都必须在“附近的设备控制台”中注册,并启用“查找中心”功能。
- 设备必须实现 DULT 规范实现版本中定义的配件非所有者服务和特征,包括配件信息操作和非所有者控件。
- 在 DULT 规范中定义的向后兼容期内,本文档中定义的通告帧不会发生任何变化。
- 本文档中定义的“有害跟踪防护模式”对应于 DULT 规范定义的“分离状态”。
- 有关实现配件信息操作码的指南:
- Get_Product_Data 应返回控制台提供的模型 ID,并用零填充以满足 8 字节要求。例如,模型 ID 0xFFFFFF 会返回为 0x0000000000FFFFFF。
- Get_Manufacturer_Name 和 Get_Model_Name 应与控制台中提供的值一致。
- 如果没有其他类别更适合设备类型,Get_Accessory_Category 可以返回通用“位置信息跟踪器”值。
- Get_Accessory_Capabilities 必须指明支持响铃以及 BLE 标识符查找。
- Get_Network_ID 应返回 Google 的标识符 (0x02)。
- 有关实现 Get_Identifier 操作码的准则:
- 在用户激活“识别”模式(需要组合按键)后,该操作应仅在 5 分钟内返回有效响应。应通过视觉或音频信号向用户指示提供方已进入该模式。您必须向 Google 提供该模式的具体启用说明,这是获得认证的必要条件,并且您必须在对说明进行任何更新或修改之前至少提前 10 天提供。
- 响应的构造方式为:当前临时标识符的前 10 个字节,后跟
HMAC-SHA256(recovery key, the truncated current ephemeral identifier)的前 8 个字节。
- 通过 NFC 实现标识符的准则:
- 使用
find-my.googleapis.com/lookup作为网址。 - 作为
e参数,请使用与为 Get_Identifier 构建的响应相同的响应(十六进制编码)。 - 作为
pid参数,请使用与为 Get_Product_Data 构建的响应相同的响应(十六进制编码)。
- 使用
- 设备必须包含发声器并支持响铃功能。根据 DULT 规范,发声器必须发出峰值响度至少为 60 方(根据 ISO 532-1:2017 定义)的声音。
- Sound_Start 操作码的实现指南:
- 该命令应触发所有可用组件响铃。
- 应使用支持的最大音量。
- 建议的响铃时长为 12 秒。
- 定位器标签必须包含一种机制,让用户无需将设备恢复出厂设置即可暂时停止通告(例如,按组合按钮)。
- 停用说明必须记录在公开网址中,并作为认证要求提供给 Google,且至少在对说明进行任何更新或修改之前 10 天提供。
- 网址应支持本地化。根据客户端的不同,语言将作为查询参数(“hl=en”)或使用“accept-language”HTTP 标头提供。
可切换协议指南
- 一次只能使用一种协议。确保设备上同时运行的网络不超过一个。此要求旨在确保不同协议之间的敏感用户数据不会混杂在一起。
- 建议在设备中加入硬重置工作流程,以便用户使用其他网络重新设置设备。
- 将设备更新到网络的过程应简单易用,并且在不同网络之间保持一致。用户必须能够选择要使用的网络,而不会偏向其中一个网络。此流程需要获得 Google 团队的批准。
固件更新
OTA 更新的过程和分发应由合作伙伴使用自己的移动或 Web 应用工作流进行管理。
快速配对支持向用户发送通知,告知其有可用的 OTA 更新。如需使用此机制,请执行以下操作:
- 最新固件版本应在 Nearby Device Console 中更新。
- 应在“附近的设备”控制台中设置配套应用。它应支持固件更新 intent。
- 提供方应实现固件修订版本 GATT 特征。
为防止跟踪,应限制对固件修订版本特征的访问。Seeker 将首先读取配置状态并提供身份验证密钥(如本规范中所定义),然后才会读取固件修订版本。此操作将通过同一连接完成。如果尝试读取固件修订版本,但提供程序未绑定,也未通过同一连接成功完成经过身份验证的操作,则提供程序应返回未经身份验证的错误。
兼容性
如要使用“查找中心”网络,必须开启位置信息服务和蓝牙。 需要移动网络服务或互联网连接。适用于 Android 9 及更高版本,并且仅限部分国家/地区内符合年龄要求的用户使用。
更新日志
| FHN 版本 | 日期 | 评论 |
|---|---|---|
| v1 | FHN 规范的初始版本,供抢先体验。 | |
| v1.1 | 2023 年 2 月 |
|
| v1.2 | 2023 年 4 月 |
|
| v1.3 | 2023 年 12 月 |
|