v1.3
Спецификация аксессуаров для сети Портала поиска (FHN) определяет подход со сквозным шифрованием для отслеживания устройств Bluetooth с низким энергопотреблением (BLE), передающих сигналы. В этой статье описывается, как FHN расширяет спецификацию Быстрого подключения. Поставщикам следует включить это расширение, если у них есть устройства, совместимые с FHN, и они хотят включить для них отслеживание местоположения.
Спецификация GATT
В сервис быстрого подключения необходимо добавить дополнительную характеристику GATT со следующей семантикой:
| Характеристика сервиса быстрого подключения | Зашифровано | Разрешения | UUID |
|---|---|---|---|
| Действия с маячками | Нет | Чтение, запись и уведомления | FE2C1238-8366-4814-8EB0-01DE32100BEA |
Таблица 1. Характеристики сервиса "Быстрое подключение" для FHN.
Аутентификация
Операции, необходимые для этого расширения, выполняются как операции записи, защищенные механизмом "запрос-ответ". Перед выполнением любой операции Искатель должен выполнить операцию чтения из характеристики в таблице 1, которая приводит к созданию буфера в следующем формате:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Номер основной версии протокола | 0x01 |
| 1–8 | массив байтов | Одноразовый случайный одноразовый номер | varies |
Каждая операция чтения должна приводить к созданию нового одноразового кода, который будет действителен только для одной операции. Одноразовый код должен быть аннулирован, даже если операция не удалась.
Затем Искатель вычисляет одноразовый ключ аутентификации, который будет использоваться в последующем запросе на запись. Ключ аутентификации рассчитывается, как описано в таблицах 2–5. В зависимости от запрашиваемой операции Искатель подтверждает знание одного или нескольких из следующих ключей:
Ключ аккаунта. 16-байтовый ключ аккаунта для быстрого подключения, как определено в спецификации быстрого подключения.
Ключ аккаунта-владельца. Поставщик выбирает один из существующих ключей аккаунта в качестве ключа аккаунта-владельца, когда Искатель впервые обращается к характеристике Beacon Actions. Выбранный ключ аккаунта-владельца нельзя изменить, пока не будет выполнен сброс настроек поставщика. Поставщик не должен удалять ключ аккаунта-владельца, если у него закончились свободные слоты для ключей аккаунтов.
Поставщики, которые уже поддерживают FHN при первом подключении (или при подключении после сброса настроек), выбирают первый ключ аккаунта, потому что это единственный ключ аккаунта, который существует, когда Искатель считывает состояние инициализации во время подключения.
Поставщики, которые получают поддержку FHN после того, как они уже подключены (например, через обновление встроенного ПО), могут выбрать любой существующий ключ аккаунта. Разумно выбрать первый ключ аккаунта, который используется для чтения состояния инициализации из характеристики действий маяка после обновления встроенного ПО, при условии, что пользователь, выполнивший обновление, является текущим владельцем Поставщика.
Временный ключ идентификации (EIK). 32-байтовый ключ, который случайным образом выбирается Искателем при инициализации FHN. Этот ключ используется для получения криптографических ключей, которые используются для сквозного шифрования отчетов о местоположении. Искатель никогда не передает его на сервер.
Ключ восстановления: определяется как
SHA256(ephemeral identity key || 0x01), усеченный до первых 8 байт. Ключ хранится на сервере, и Искатель может использовать его, чтобы восстановить EIK, если пользователь даст согласие, нажав кнопку на устройстве.Ключ кольца определяется как
SHA256(ephemeral identity key || 0x02), усеченный до первых 8 байт. Ключ хранится на сервере, и Искатель может использовать его только для того, чтобы позвонить на устройство.Ключ защиты от слежения. Определяется как
SHA256(ephemeral identity key || 0x03), усеченный до первых 8 байтов. Ключ хранится на сервере, и Искатель может использовать его только для активации режима защиты от нежелательного слежения.
Операции
Формат данных, записываемых в характеристику, приведен в таблицах 2–5. Каждая из этих операций подробно описана ниже.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных |
|
| 1 | uint8 | Размер сообщения | varies |
| 2–9 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce
read from the characteristic || data ID || data length || additional data) |
| 10 - var | массив байтов | Дополнительные данные |
|
Таблица 2. Запрос на инициализацию маячка.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x04: чтение временного ключа идентификации с согласия пользователя |
| 1 | uint8 | Размер сообщения | 0x08 |
| 2–9 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(recovery key, protocol major version number || the last nonce
read from the characteristic || data ID || data length) |
Таблица 3. Запрос на восстановление ключа инициализации маяка.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных |
|
| 1 | uint8 | Размер сообщения | varies |
| 2–9 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(ring key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data) |
| 10 - var | массив байтов | Дополнительные данные |
|
Таблица 4. Запрос на звонок.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных |
|
| 1 | uint8 | Размер сообщения | varies |
| 2–9 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(unwanted tracking protection key, protocol major version number
|| the last nonce read from the characteristic || data ID || data length ||
additional data) |
| 10 - var | массив байтов | Дополнительные данные |
|
Таблица 5. Запросы на защиту от нежелательного отслеживания.
При успешной записи активируются уведомления, перечисленные в таблице 6.
Уведомления с идентификатором данных, отличным от 0x05: Ring state change, должны отправляться до завершения транзакции записи, которая активирует уведомление, то есть до отправки PDU ответа на запрос записи.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных |
|
| 1 | uint8 | Размер сообщения | varies |
| 2–9 | массив байтов | Аутентификация | Подробные сведения по операциям |
| 10 - var | массив байтов | Дополнительные данные |
|
Таблица 6. Ответ сервиса маяков.
В таблице 7 перечислены возможные коды ошибок GATT, возвращаемые операциями.
| Код | Описание | Примечания |
|---|---|---|
| 0x80 | требуется аутентификация | Возвращается в ответ на запрос записи, если аутентификация не удалась (в том числе если использовался старый одноразовый код). |
| 0x81 | Недопустимое значение. | Возвращается, если указано недопустимое значение или полученные данные имеют непредвиденное количество байтов. |
| 0x82 | Нет согласия пользователя | Возвращается в ответ на запрос записи с идентификатором данных 0x04: чтение временного идентификационного ключа с согласия пользователя, когда устройство не находится в режиме подключения. |
Таблица 7. Коды ошибок GATT.
Считывание параметра маячка
Искатель может запросить у Поставщика параметры маячка, выполнив операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x00. Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с каким-либо из ключей аккаунта, хранящихся на устройстве.
Если проверка не пройдена, поставщик возвращает ошибку аутентификации.
В случае успеха поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x00. Поставщик создает сегмент данных следующим образом:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Калиброванная мощность | Калиброванная мощность, полученная на расстоянии 0 м (значение в диапазоне [-100, 20]). Представлено в виде целого числа со знаком и разрешением 1 дБм. |
| 1–4 | uint32 | Значение часов | Текущее значение времени в секундах (от старшего к младшему). |
| 5 | uint8 | Выбор кривой | Эллиптическая кривая, используемая для шифрования:
|
| 6 | uint8 | Компоненты | Количество компонентов, способных звонить:
|
| 7 | uint8 | Возможности звонков | Доступны следующие варианты:
|
| 8-15 | массив байтов | Поля | Нулевое заполнение для шифрования по алгоритму AES. |
Данные должны быть зашифрованы по алгоритму AES-ECB-128 с помощью ключа аккаунта, используемого для аутентификации запроса.
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data after
encryption || 0x01).
Чтение статуса инициализации маячка
Искатель может запросить у Поставщика статус инициализации маяка, выполнив операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x01. Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с каким-либо из ключей аккаунта, хранящихся на устройстве.
Если проверка не пройдена, поставщик возвращает ошибку аутентификации.
В случае успеха Поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x01. Поставщик создает сегмент данных следующим образом:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Состояние инициализации | Битовая маска со следующими значениями:
|
| 1–20 или 32 | массив байтов | Текущий временный идентификатор | 20 или 32 байта (в зависимости от используемого метода шифрования), указывающие на текущий временный идентификатор, который передает маячок, если он задан для устройства. |
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data || 0x01).
Как задать временный ключ идентификации
Чтобы инициализировать неинициализированное устройство-поставщик в качестве маячка сети "Найти устройство" или изменить временный ключ идентификации уже инициализированного устройства-поставщика, устройство-искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x02. Поставщик подтверждает, что:
- Предоставленный одноразовый ключ аутентификации совпадает с ключом аккаунта-владельца.
- Если был предоставлен хеш временного ключа идентификации, то хешированный временный ключ идентификации совпадает с текущим временным ключом идентификации.
- Если хеш временного ключа идентификации не был предоставлен, убедитесь, что поставщик не был подготовлен как маячок FHN.
Если проверка не пройдена, поставщик возвращает ошибку аутентификации.
В случае успеха временный ключ идентификации восстанавливается путем расшифровки AES-ECB-128 с использованием соответствующего ключа аккаунта. Ключ должен храниться на устройстве, и с этого момента Поставщик должен начать передавать кадры FHN. Новый временный ключ идентификации начинает действовать сразу после завершения подключения BLE. Поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x02.
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || 0x01).
Очистить временный ключ идентификации
Чтобы отменить инициализацию маячка Поставщика, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x03. Поставщик подтверждает, что:
- Предоставленный одноразовый ключ аутентификации совпадает с ключом аккаунта-владельца.
- Хешированный временный ключ идентификации совпадает с текущим временным ключом идентификации.
Если Поставщик не инициализирован как маячок FHN или проверка не удалась, возвращается ошибка аутентификации.
В случае успеха Поставщик удаляет ключ и прекращает трансляцию фреймов FHN. Поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x03. Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account
key, protocol major version number || the last nonce read from the
characteristic || data ID || data length || 0x01).
Чтение временного ключа идентификации с согласия пользователя
Этот вариант доступен только для восстановления утерянного ключа, поскольку ключ хранится только локально на устройстве Искателя. Поэтому эта возможность доступна, только когда устройство находится в режиме подключения или в течение ограниченного времени после нажатия физической кнопки на устройстве (что означает согласие пользователя).
Искатель должен хранить запасной ключ на сервере, чтобы иметь возможность восстановить ключ в виде открытого текста, но не хранит сам EIK.
Чтобы прочитать EIK, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 3 с идентификатором данных 0x04. Поставщик подтверждает, что:
- Хешированный запасной ключ совпадает с ожидаемым.
- Устройство находится в режиме восстановления EIK.
Если проверка не пройдена, поставщик возвращает ошибку аутентификации.
Если устройство не находится в режиме подключения, поставщик возвращает ошибку No User Consent (Нет согласия пользователя).
В случае успеха поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x04.
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(recovery key, protocol major version number || the last nonce read
from the characteristic || data ID || data length || additional data || 0x01).
Операция с кольцом
Искатель может попросить Поставщика воспроизвести звук, выполнив операцию записи в характеристику, состоящую из запроса из таблицы 4 с идентификатором данных 0x05. Поставщик создает сегмент данных следующим образом:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Операция с кольцом | Битовая маска со следующими значениями:
|
| 1–2 | uint16 | Время ожидания | Время ожидания в децисекундах. Значение не должно быть равно нулю и не должно превышать 10 минут. Поставщик использует это значение, чтобы определить, как долго должен звучать сигнал, прежде чем он будет отключен. Если какой-либо компонент устройства уже звонит, время ожидания переопределяет уже действующее. Если для параметра ring operation задано значение 0x00, время ожидания игнорируется. |
| 3 | uint8 | Громкость |
|
Получив запрос, Поставщик проверяет следующее:
- Предоставленный одноразовый ключ аутентификации совпадает с ключом кольца.
- Запрошенное состояние соответствует компонентам, которые могут звонить.
Если Поставщик не инициализирован как маячок FHN или проверка не удалась, возвращается ошибка аутентификации. Однако если у поставщика включена защита от слежения от нежелательного отслеживания, а в запросе на ее активацию был установлен флаг пропуска аутентификации звонка, поставщик должен пропустить эту проверку. Данные аутентификации по-прежнему должны предоставляться Искателем, но им может быть присвоено произвольное значение.
Когда звонок начинается или заканчивается, отправляется уведомление, как указано в таблице 6, с идентификатором данных 0x05. Содержание уведомления:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Состояние вызова |
|
| 1 | uint8 | Компоненты звонка | Битовая маска компонентов, которые активно звонят, как определено в запросе. |
| 2–3 | uint16 | Время ожидания | Оставшееся время звонка в децисекундах. Если устройство перестало звонить, должно быть возвращено значение 0x0000. |
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(ring
key, protocol major version number || the nonce used to initiate the ringing
command || data ID || data length || additional data || 0x01).
Если устройство уже находится в запрошенном состоянии звонка, когда получен запрос на звонок или его прекращение, поставщик должен отправить уведомление с состоянием звонка или 0x00: Started или 0x04: Stopped (запрос GATT) соответственно. Этот запрос переопределяет параметры существующего состояния, чтобы можно было продлить продолжительность звонка.
Если у Поставщика есть физическая кнопка (или включено сенсорное управление), нажатие на нее должно отключать звонок.
Как узнать, звонит ли маячок
Чтобы получить состояние звонка маячка, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 4 с идентификатором данных 0x06. Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с ключом кольца.
Если поставщик не инициализирован как маячок FHN или проверка не пройдена, поставщик возвращает ошибку аутентификации.
В случае успеха поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x06. Поставщик создает сегмент данных следующим образом:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Компоненты звонка | Компоненты, которые активно звонят, как определено в запросе на звонок. |
| 1–2 | uint16 | Время ожидания | Оставшееся время звонка в децисекундах. Если устройство не звонит, должно возвращаться значение 0x0000. |
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256 (ring
key, protocol major version number || the last nonce read from the
characteristic || data ID || data length || additional data || 0x01).
Режим защиты от слежения
Режим защиты от нежелательного отслеживания позволяет любому клиенту идентифицировать устройства, используемые для злоупотреблений, без связи с сервером. По умолчанию Поставщик должен менять все идентификаторы, как описано в разделе Смена идентификаторов. Сервис "Портал поиска" может передавать запрос на активацию режима защиты от нежелательного слежения через сеть Портала поиска. В результате поставщик временно использует фиксированный MAC-адрес, что позволяет клиентам обнаруживать устройство и предупреждать пользователя о возможном нежелательном отслеживании.
Чтобы включить или отключить режим защиты от нежелательного отслеживания, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 5 с идентификатором данных 0x07 или 0x08 соответственно.
При включении режима защиты от слежения
Поставщик создает сегмент данных следующим образом:
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Флаги управления |
Параметры действуют, только пока не отключен режим защиты от слежения. |
Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с ключом защиты от слежения. Если поставщик не инициализирован как маячок FHN или проверка не пройдена, возвращается ошибка аутентификации.
Когда активирован режим защиты от слежения, маячок должен снизить частоту ротации частного MAC-адреса до одного раза в 24 часа. Рекламируемый временный идентификатор должен продолжать меняться, как обычно. Тип фрейма должен быть задан как 0x41. Состояние также отражено в разделе Хешированные флаги.
При отключении режима защиты от слежения
Поставщик подтверждает, что:
- Предоставленный одноразовый ключ аутентификации совпадает с ключом защиты от нежелательного отслеживания.
- Хешированный временный ключ идентификации совпадает с текущим временным ключом идентификации.
Если поставщик не инициализирован как маячок FHN или проверка не пройдена, поставщик возвращает ошибку аутентификации.
Когда режим защиты от нежелательного отслеживания отключен, маячок должен снова начать менять MAC-адрес с обычной частотой, синхронизированной с изменением эфемерного идентификатора. Тип фрейма должен быть установлен обратно на 0x40. Статус также отражен в разделе hashed flags.
В случае успеха Поставщик отправляет ответ из таблицы 6 с идентификатором данных 0x07 или 0x08.
Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(unwanted tracking protection key, protocol major version number ||
the last nonce read from the characteristic || data ID || data length ||
0x01).
Точный поиск
В этом разделе подробно описаны процессы и дополнительные операции, необходимые для точного поиска. Здесь действуют те же правила для характеристики GATT и аутентификации, что и в разделе спецификации GATT. Точный поиск – необязательная функция.
Тип точного поиска зависит от технологий определения расстояния, которые поддерживаются на устройствах, участвующих в поиске. Поддерживаемые технологии определения расстояния можно найти в спецификации Определение расстояния: последовательность и полезная нагрузка внеполосных сообщений. В следующих разделах рассказывается, как работает точный поиск в зависимости от используемой технологии определения расстояния.
Процесс точного поиска
В этом разделе рассматривается обмен сообщениями FHNA для точного поиска. На рисунке 1 показан поток сообщений, а в абзацах ниже подробно описано каждое сообщение.
Рис. 1.
Типичный обмен сообщениями при точном поиске
Устройство-инициатор – это устройство, на котором установлено приложение "Портал поиска" и на котором была запущена функция точного поиска. Инициатор – это устройство, которое пытается найти другое устройство.
Устройство-ответчик – это устройство, которое пытается найти устройство-инициатор.
Инициатор отправляет ответчику запрос на определение расстояния, в котором перечисляет технологии, которые он хочет использовать. Устройство-ответчик отправит ответное уведомление Ranging Capability Response, содержащее информацию о том, какие технологии определения расстояния поддерживаются и каковы их возможности. Ответчик предоставит только ту информацию, которую запросил инициатор. Список возможностей будет отсортирован по приоритету технологии определения расстояния, которую предпочитает устройство-ответчик. Первой в списке будет указана технология с наивысшим приоритетом.
Затем устройство-инициатор отправит сообщение о конфигурации дальнометрии, в котором определит конфигурацию для каждой технологии дальнометрии, которую оно хочет использовать. Получив это сообщение, устройство-ответчик должно начать измерение расстояния с помощью подходящих технологий, используя предоставленные конфигурации. Устройство-ответчик отправит уведомление с ответом о конфигурации дальнометрии, в котором будет указано, успешно ли запущена каждая отдельная технология дальнометрии. Для успешного сеанса дальнометрии некоторые технологии требуют запуска на обоих устройствах, а другие – только на инициаторе. Однако в последнем случае ответчик должен отправить ответ об успешном выполнении. Подробную информацию о поведении конкретных технологий определения расстояния можно найти в следующих разделах.
Когда устройство-инициатор будет готово остановить сеанс точного поиска, оно отправит устройству-ответчику сообщение об остановке дальнометрии, в котором будет указано, какие технологии дальнометрии должны прекратить работу. Устройство-ответчик отправит уведомление Stop Ranging Response, которое означает, что измерение расстояния с помощью запрошенных технологий успешно остановлено.
Если канал связи FHNA BLE GATT отключится во время сеанса точного поиска, но некоторые технологии определения расстояния продолжат работать, на отвечающем устройстве будет запущен механизм тайм-аута, чтобы оно не определяло расстояние бесконечно. Подробности зависят от конкретного случая.
Обратите внимание, что порядок операций на отвечающем устройстве может меняться. Например, устройство-ответчик должно быть способно обрабатывать несколько запросов на определение расстояния подряд или даже прямую операцию настройки определения расстояния без предшествующего запроса.
Операции точного поиска
В таблице 8 показаны операции FHNA, определенные в этом документе и необходимые для точного поиска. В каждом подразделе описывается сообщение FHNA для каждой из операций, а содержимое поля Дополнительные данные относится к спецификации Определение расстояния: последовательность внеполосных сообщений и полезная нагрузка.
| Операция | Идентификатор данных | Описание |
|---|---|---|
| Запрос на определение расстояния | 0x0A | Операция запроса возможностей, которая будет отправлена устройством-инициатором устройству-ответчику. В данных этой операции будут перечислены все технологии определения расстояния, о которых инициатор хочет узнать от устройства-ответчика. |
| Ответ о возможностях дальнометрии | 0x0A | Это ответ на запрос возможностей определения расстояния. Она содержит информацию о возможностях каждой поддерживаемой технологии определения расстояния, запрошенной инициатором. |
| Конфигурация определения расстояния | 0x0B | Операция Ranging Configuration содержит конфигурации для технологий определения расстояния, которые устройство-инициатор хочет использовать для определения расстояния до устройства-ответчика. |
| Ответ на запрос конфигурации измерения расстояния | 0x0B | Это ответ на операцию настройки дальномера. Он содержит данные о том, удалось ли устройству-ответчику начать измерение расстояния с помощью запрошенных технологий на основе предоставленной конфигурации. |
| RFU | 0x0C | Операция с этим идентификатором данных не используется и зарезервирована для использования в будущем. |
| Остановить измерение расстояния | 0x0D | Операция Stop Ranging, отправленная устройством-инициатором, содержит информацию о том, какие технологии определения расстояния устройство-ответчик должно прекратить использовать. |
| Остановить ответ на определение расстояния | 0x0D | Это ответ на операцию "Остановить определение расстояния". Содержит данные о том, была ли остановка определенной технологии измерения расстояния успешной. |
Таблица 8. Операции точного поиска.
Операция запроса возможностей определения расстояния
В таблице 9 описано сообщение Ranging Capability Request.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x0A – запрос на определение расстояния. |
| 1 | uint8 | Размер сообщения | изменяется |
| 2 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data). |
| 10 | массив байтов | Дополнительные данные | Сообщение Ranging Capability Request, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка). |
Таблица 9. Запрос на определение расстояния.
Операция ответа на запрос о возможностях измерения расстояния
В таблице 10 описано сообщение Ranging Capability Response.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x0A: ответ о возможности дальнометрии |
| 1 | uint8 | Размер сообщения | изменяется |
| 2 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data || 0x01). |
| 10 | массив байтов | Дополнительные данные | Сообщение Ranging Capability Response, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка). |
Таблица 10. Ответ о возможностях определения расстояния.
Операция настройки дальномера
В таблице 11 описано сообщение о конфигурации измерения расстояния.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x0B – задать конфигурацию определения расстояния |
| 1 | uint8 | Размер сообщения | изменяется |
| 2 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data). |
| 10 | массив байтов | Дополнительные данные | Сообщение Ranging Configuration, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка). |
Таблица 11. Конфигурация определения расстояния.
Операция Ranging Configuration Response
В таблице 12 описано сообщение Ranging Configuration Response.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x0B – ответ на запрос о настройке дальнометрии |
| 1 | uint8 | Размер сообщения | изменяется |
| 2 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data || 0x01). |
| 10 | массив байтов | Дополнительные данные | Сообщение Ranging Configuration Response, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка). |
Таблица 12. Ответ на запрос конфигурации дальномера.
Остановить операцию определения расстояния
В таблице 13 описано сообщение Stop Ranging.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x0D – остановка измерения расстояния. |
| 1 | uint8 | Размер сообщения | изменяется |
| 2 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(ключ аккаунта, номер основной версии протокола || последний одноразовый код, считанный из характеристики || идентификатор данных || длина данных). |
| 10 | массив байтов | Дополнительные данные | Сообщение Stop Ranging, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка). |
Таблица 13. Остановка измерения расстояния.
Остановить операцию ответа на запрос диапазона
В таблице 14 описано сообщение Stop Ranging Response.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Идентификатор данных | 0x0D – ответ на остановку измерения расстояния. |
| 1 | uint8 | Размер сообщения | изменяется |
| 2 | массив байтов | Одноразовый ключ аутентификации | Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data || 0x01). |
| 10 | массив байтов | Дополнительные данные | Сообщение Stop Ranging Response, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка). |
Таблица 14. Ответ на запрос об остановке измерения расстояния.
Защита от нежелательного отслеживания с помощью точного поиска
Когда активирован режим защиты от слежения от нежелательного отслеживания, как описано в разделе "Защита от слежения от нежелательного отслеживания", тот же процесс, который применяется для пропуска проверок аутентификации для сообщений о звонках, также применяется для всех сообщений точного поиска, определенных в этом документе для устройств, которые поддерживают эту функцию.
Особенности технологии определения расстояния для точного поиска
В этом разделе содержатся сведения, относящиеся к технологии определения расстояния.
Особенности сверхширокополосной связи (СШП)
Сведения о СШП.
Уровень точности поиска
При точном поиске с использованием СШП вы увидите расстояние до устройства и направление к нему. Интервал измерения расстояния должен быть не менее 240 мс, а для оптимальной работы – 96 мс.
Идентификаторы конфигурации
Данные конфигурации, передаваемые по внешнему каналу для СШП, не содержат полного набора доступных настраиваемых параметров, необходимых для запуска сеанса измерения расстояния. Некоторые параметры неявно выбираются по идентификатору конфигурации.
Каждый идентификатор конфигурации – это набор предопределенных параметров конфигурации СШП, которые описаны в общедоступной документации. Для точного поиска устройство-ответчик должно поддерживать идентификатор конфигурации 6 и, при необходимости, идентификатор конфигурации 3.
Инициатор и ответчик СШП
В случае с точным поиском устройство, указанное в этом документе как инициатор, будет ответчиком СШП, а устройство, указанное как ответчик, – инициатором СШП. Это связано с тем, что инициатор СШП потребляет меньше энергии, чем ответчик, а ответчик в большинстве случаев является периферийным устройством с ограниченным зарядом батареи.
Это означает, что в сообщении Ranging Capability Response устройство-ответчик должно указать, что оно поддерживает роль инициатора СШП.
Другие параметры, связанные с СШП
- Должен поддерживаться канал 9.
- Для оптимального ведения рекомендуется интервал измерения расстояния 96 мс, в противном случае должна поддерживаться задержка 240 мс.
- Для экономии заряда батареи рекомендуется использовать интервал в 1 мс, но также поддерживается интервал в 2 мс.
- Чип СШП должен соответствовать стандарту FIRA v1.2 + P-STS.
- BPRF является обязательным, а HPRF – рекомендуемым, но необязательным. Поддерживаемый или выбранный режим определяется поддерживаемым или выбранным индексом преамбулы.
- Тип безопасности сеанса: P-STS.
- Необходимо включить скачкообразную перестройку частоты.
Особенности BLE Channel Sounding (CS)
Сведения о BLE CS.
Уровень точности поиска
При точном поиске с использованием технологии CS будет определяться только расстояние, а направление – нет.
Требуется связь между устройствами
Сеансы точного поиска с использованием Channel Sounding не будут работать, если устройства не связаны. Между инициатором и ответчиком должна быть установлена связь. Эта спецификация не предусматривает способа создания связи между устройствами. Разработчик должен сам установить связь между устройствами.
Требования для отдельных стран
Для определения расстояния в Портале поиска оба устройства должны поддерживать следующую конфигурацию 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 (если антенн больше одной) | Идентификатор антенны + 0xFD + 0xFE |
| Max_TX_Power | >= 8 дБм |
| ADV_TX_Power | Такая же, как мощность передачи для LE ACL |
| Data_Length_Extension (DLE – 251 байт) | Поддерживается |
| PCT_Tone_Quality | Поддерживается |
| Phase_Coherence_across_Subevents | Поддерживается |
| RX_Power_Level_Consistency_across_Subevents (PCT Magnitude) | Поддерживается |
Таблица 15. Обязательные настройки для CS.
Требуются следующие элементы управления мощностью передачи:
- Устройство должно поддерживать функцию управления мощностью передачи BT 5.2 на канале LE ACL.
- Мощность передачи должна оставаться неизменной в рамках одной процедуры CS, даже если есть несколько дополнительных событий.
- При переходе от одной процедуры CS к другой мощность передачи должна соответствовать базовой мощности передачи LE ACL.
Все аппаратное обеспечение должно пройти калибровку, чтобы исключить систематическое смещение или ошибку из-за радиочастотных схем или маршрутизации.
Требуется действие со стороны отвечающего (CS)
В отличие от СШП, где оба устройства должны явно вызывать API для начала и окончания измерения расстояния, при использовании CS только инициатор должен запустить измерение расстояния, вызвав стек Bluetooth. Остальная часть инициализации на стороне ответчика происходит внутриполосно с помощью Bluetooth. Это означает, что при получении сообщения о настройке дальнометрии или об остановке дальнометрии для CS отвечающей стороне не нужно ничего делать, если BT включен, кроме как ответить уведомлением о настройке дальнометрии. Устройство-ответчик может использовать эти сообщения как триггер для обновления интерфейса, если у него есть экран. В противном случае сообщения могут использоваться для визуальной обратной связи о состоянии устройства, например для мигания светодиодов.
RTT в сети Wi-Fi NAN
Сведения о Wi-Fi NAN RTT.
Уровень точности поиска
При использовании Wi-Fi NAN RTT в качестве технологии определения расстояния в сеансах точного поиска будут выполняться только измерения расстояния. Направление в настоящее время не указывается.
BLE RSSI
Сведения о BLE RSSI.
Уровень точности поиска
Сеансы точного поиска, в которых используется только BLE RSSI, не смогут получить информацию о расстоянии или направлении, поскольку BLE RSSI не является точной технологией определения расстояния. Вместо этого пользователь увидит подсказку, указывающую, что устройство находится близко или далеко.
Рекламируемые фреймы
После инициализации поставщик должен передавать фреймы FHN не реже одного раза в две секунды. Если передаются фреймы быстрого подключения, поставщик должен чередовать фреймы FHN с обычными объявлениями быстрого подключения. Например, каждые две секунды Поставщик должен передавать семь объявлений быстрого подключения и одно объявление FHN.
Мощность передачи Bluetooth для объявлений FHN должна быть не менее 0 дБм.
Фрейм FHN содержит открытый ключ, который используется для шифрования отчетов о местоположении любым поддерживающим клиентом, который вносит вклад в краудсорсинговую сеть. Доступны два типа ключей эллиптической кривой: 160-битный ключ, который подходит для устаревших фреймов BLE 4, и 256-битный ключ, для которого требуется BLE 5 с расширенными возможностями рекламы. Используемая кривая определяется реализацией поставщика.
Структура фрейма FHN выглядит следующим образом:
| Октет | Значение | Описание |
|---|---|---|
| 0 | 0x02 | Длина |
| 1 | 0x01 | Значение типа данных Flags |
| 2 | 0x06 | Данные о флагах |
| 3 | 0x18 или 0x19 | Длина |
| 4 | 0x16 | Значение типа данных сервиса |
| 5 | 0xAA | 16-битный UUID сервиса |
| 6 | 0xFE | … |
| 7 | 0x40 или 0x41 | Тип фрейма FHN с индикацией режима защиты от слежения от нежелательного отслеживания |
| 8..27 | 20-байтовый временный идентификатор; | |
| 28 | Хешированные пометки |
Таблица 16. Фрейм FHN, поддерживающий 160-битную кривую.
В таблице 17 показаны смещения байтов и значения для 256-битной кривой.
| Октет | Значение | Описание |
|---|---|---|
| 0 | 0x02 | Длина |
| 1 | 0x01 | Значение типа данных Flags |
| 2 | 0x06 | Данные о флагах |
| 3 | 0x24 или 0x25 | Длина |
| 4 | 0x16 | Значение типа данных сервиса |
| 5 | 0xAA | 16-битный UUID сервиса |
| 6 | 0xFE | … |
| 7 | 0x40 или 0x41 | Тип фрейма FHN с индикацией режима защиты от слежения от нежелательного отслеживания |
| 8..39 | 32-байтовый временный идентификатор; | |
| 40 | Хешированные пометки |
Таблица 17. Фрейм FHN, поддерживающий 256-битную кривую.
Вычисление временного идентификатора (EID)
Случайное число генерируется с помощью шифрования AES-ECB-256 следующей структуры данных с временным ключом идентификации:
| Октет | Поле | Описание |
|---|---|---|
| 0–10 | Поля | Значение = 0xFF |
| 11 | K | Показатель степени периода ротации |
| 12–15 | TS[0]...TS[3] | Счетчик времени маяка в 32-битном формате big-endian. Младшие биты K очищаются. |
| 16–26 | Поля | Значение = 0x00 |
| 27 | K | Показатель степени периода ротации |
| 28–31 | TS[0]...TS[3] | Счетчик времени маяка в 32-битном формате big-endian. Младшие биты K очищаются. |
Таблица 18. Создание псевдослучайного числа.
Результатом этого вычисления является 256-битное число, обозначаемое как r'.
Для остальных вычислений используются SECP160R1 или SECP256R1. Определения кривых приведены в документе SEC 2: Recommended Elliptic Curve Domain Parameters, в котором определены параметры Fp, n и G, упомянутые ниже.
r' проецируется на конечное поле Fp путем вычисления r = r' mod n.
Наконец, вычислите R = r * G – точку на кривой, представляющую используемый открытый ключ. Маяк передает Rx, то есть координату x точки R, в качестве временного идентификатора.
Хешированные флаги
Поле хешированных флагов рассчитывается следующим образом (биты указываются от наиболее значимого к наименее значимому):
- Биты 0–4: зарезервированы (установлены на нули).
- Биты 5–6 указывают на уровень заряда батареи устройства:
- 00: индикация уровня заряда батареи не поддерживается
- 01: нормальный уровень заряда батареи;
- 10: низкий уровень заряда батареи;
- 11 – критически низкий уровень заряда батареи (скоро потребуется замена батареи);
- Бит 7 равен 1, если маячок находится в режиме защиты от слежения, и 0 в противном случае.
Чтобы получить окончательное значение этого байта, он подвергается операции XOR с наименее значимым байтом SHA256(r).
Обратите внимание, что r должно соответствовать размеру кривой. Если представление короче 160 или 256 бит, добавьте нули в качестве старших битов. Если представление длиннее 160 или 256 бит, усеките старшие биты.
Если маячок не поддерживает индикацию уровня заряда батареи и не находится в режиме защиты от слежения, этот байт можно полностью исключить из объявления.
Шифрование с помощью EID
Чтобы зашифровать сообщение m, наблюдатель (прочитав Rx с маяка) должен сделать следующее:
- Выберите случайное число
sвFp, как описано в разделе Вычисление EID. - Вычисли
S = s * G. - Вычислите
R = (Rx, Ry), подставив значения в уравнение кривой и выбрав произвольное значениеRyиз возможных результатов. - Вычислите 256-битный ключ AES
k = HKDF-SHA256((s * R)x), где(s * R)x– координатаxрезультата умножения кривой. Соль не указана. - Пусть
URxиLRx– верхние и нижние 80 битRxсоответственно в формате big-endian. Аналогичным образом определитеUSxиLSxдляS. - Вычисли
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и убедитесь, что оно совпадает со значениемURx, предоставленным наблюдателем. - Вычислите
S = (Sx, Sy), подставив значения в уравнение кривой и выбрав произвольное значениеSyиз возможных результатов. - Вычислите
k = HKDF-SHA256((r * S)x), где(r * S)x– координатаxрезультата умножения кривой. - Вычисли
nonce = LRx || LSx. - Вычисли
m = AES-EAX-256-DEC(k, nonce, m’, tag).
Ротация идентификаторов
Для передачи фреймов FHN необходимо использовать разрешаемый (RPA) или неразрешаемый (NRPA) BLE-адрес. RPA требуется для устройств LE Audio (LEA) и рекомендуется для других устройств, за исключением тегов локатора, которые не используют связывание.
Объявление быстрого подключения, объявление сети "Найти устройство" и соответствующие адреса BLE должны меняться одновременно. В среднем ротация должна происходить каждые 1024 секунды. Точный момент, когда маячок начинает передавать новый идентификатор, должен выбираться случайным образом в пределах этого окна.
Рекомендуемый подход к рандомизации времени ротации заключается в том, чтобы установить его на следующее ожидаемое время ротации (если рандомизация не применялась) плюс положительный рандомизированный временной коэффициент в диапазоне от 1 до 204 секунд.
Когда устройство находится в режиме защиты от слежения от нежелательного отслеживания, BLE-адрес объявления FHN должен быть фиксированным, а RPA для необнаруживаемого объявления FP (например, Быстрого подключения) должен постоянно меняться. Для разных протоколов можно использовать разные адреса.
Восстановление после отключения питания
Расшифровка временного идентификатора тесно связана со значением часов на момент показа рекламы, поэтому важно, чтобы поставщик мог восстановить значение часов в случае сбоя питания. Рекомендуется, чтобы Поставщик записывал текущее значение часов в энергонезависимую память не реже одного раза в день, а при загрузке проверял, есть ли в ней значение, с которого можно начать инициализацию. Резолверы временного идентификатора будут выполнять разрешение в течение периода времени, достаточного для учета как разумного отклонения часов, так и этого типа восстановления после потери питания.
Поставщики должны стремиться минимизировать расхождения, поскольку время на их устранение ограничено. Необходимо реализовать хотя бы один дополнительный метод синхронизации часов (объявление [необнаруживаемых фреймов Быстрого подключения](
locator-tag) или потока сообщений.
Рекомендации по реализации быстрого подключения
В этом разделе описываются особенности реализации быстрого подключения на устройствах, поддерживающих FHN.
Рекомендации по использованию брелоков-трекеров
- Если поставщик был подключен, но FHN не был инициализирован в течение 5 минут (или если беспроводное обновление было применено, когда устройство подключено, но FHN не инициализирован), поставщик должен вернуться к заводской конфигурации и очистить сохраненные ключи аккаунта.
- После подключения поставщик не должен менять MAC-адрес, пока не будет настроена сеть FHN или не пройдет пять минут.
- Если временный ключ идентификации удален с устройства, на нем должен быть выполнен сброс настроек, а также удалены сохраненные ключи аккаунта.
- Поставщик должен отклонять обычные попытки подключения по Bluetooth и принимать только запросы на быстрое подключение.
- Поставщик должен предусмотреть механизм, позволяющий пользователям временно отключать рекламу без сброса настроек устройства (например, нажатием комбинации кнопок).
- После отключения питания устройство должно передавать фреймы быстрого подключения, невидимые для других устройств, до следующего вызова параметров чтения маячка. Это позволяет Искателю обнаружить устройство и синхронизировать часы, даже если произошел значительный сдвиг часов.
- При рекламе невидимых фреймов быстрого подключения индикаторы пользовательского интерфейса должны быть отключены.
- Видимые фреймы быстрого подключения не должны рекламироваться, пока поставщик настроен для FHN.
- Поставщик не должен раскрывать идентифицирующую информацию (например, имена или идентификаторы) без аутентификации.
Рекомендации для устройств Bluetooth Classic
В этом разделе описываются особенности классических устройств Bluetooth, поддерживающих FHN.
Инициализация FHN для уже подключенных устройств
Поставщик не всегда инициализируется для FHN при подключении к Искателю, но через некоторое время после этого. В этом случае у Поставщика может не быть актуального MAC-адреса BLE, необходимого для установки подключения GATT. Поставщик должен поддерживать хотя бы один из следующих способов получения Искателем его BLE-адреса, когда он уже подключен:
- Поставщик может периодически передавать данные аккаунта для быстрого подключения, которые позволяют Искателю найти его BLE-адрес с помощью BLE-сканирования.
Этот подход подходит для поставщиков, которые не реализуют поток сообщений. - Поставщик может передавать эти данные через поток сообщений быстрого подключения по классическому Bluetooth.
Этот подход подходит для поставщиков, которые не объявляют фреймы быстрого подключения при подключении к искателю через Bluetooth.
Поддержка обоих подходов повышает вероятность того, что пользователь сможет подготовить устройство к работе с сетью "Найти устройство".
Поток сообщений быстрого подключения
Поставщик может реализовать поток сообщений быстрого подключения и использовать его, чтобы уведомлять Искателя об информации об устройстве. Реализация потока сообщений позволяет использовать определенные функции, описанные в этом разделе.
Поставщик должен отправлять сообщения с информацией об устройстве один раз при каждом установлении потока сообщений.
Версия встроенного ПО (код информации об устройстве 0x09) и возможность отслеживания
Когда обновление встроенного ПО добавляет поддержку FHN на Поставщике, подключенный Искатель может уведомить об этом пользователя и предложить инициализировать Поставщика. В противном случае пользователю придется вручную перейти к списку устройств Bluetooth, чтобы начать настройку FHN.
Для этого Поставщик должен использовать свойство версии встроенного ПО (код 0x09), чтобы передать строковое значение, представляющее версию встроенного ПО. Кроме того, Поставщик должен поддерживать протокол, который позволяет Искателю узнавать об изменениях в возможностях, связанных с обновлением встроенного ПО.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Событие с информацией об устройстве | 0x03 |
| 1 | uint8 | Версия встроенного ПО | 0x09 |
| 2–3 | uint16 | Размер дополнительных данных | varies |
| var | массив байтов | Строка с версией | varies |
Таблица 19. Событие "Информация об устройстве": обновлена версия встроенного ПО.
Если поставщик включил поддержку отслеживания FHN, то, получив запрос на обновление возможностей (0x0601), он должен ответить, как показано в таблице 20.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Событие синхронизации возможностей устройства | 0x06 |
| 1 | uint8 | Отслеживание в сети "Найти устройство" | 0x03 |
| 2–3 | uint16 | Размер дополнительных данных | 0x0007 |
| 4 | uint8 | Статус инициализации FHN | 0x00, если не инициализировано; 0x01, если инициализировано любым аккаунтом |
| 5–10 | массив байтов | Текущий MAC-адрес BLE устройства. | varies |
Таблица 20. Событие синхронизации возможностей устройства: добавлена возможность отслеживания.
Текущий временный идентификатор (код информации об устройстве 0x0B)
Поставщик может использовать текущий временный идентификатор (код 0x0B), чтобы сообщить текущий EID и значение часов, когда Поставщик инициализируется для FHN, чтобы синхронизировать Искатель в случае дрейфа часов (например, из-за разряженной батареи). В противном случае Искатель инициирует более дорогое и менее надежное подключение.
| Октет | Тип данных | Описание | Значение |
|---|---|---|---|
| 0 | uint8 | Событие с информацией об устройстве | 0x03 |
| 1 | uint8 | Текущий временный идентификатор | 0x0B |
| 2–3 | uint16 | Размер дополнительных данных | 0x0018 или 0x0024 |
| 4—7 | массив байтов | Значение часов | Пример: 0x13F9EA80. |
| 8–19 или 31 | массив байтов | Текущий EID | Пример: 0x1122334455667788990011223344556677889900 |
Таблица 21. Событие "Информация об устройстве": синхронизация часов
Сбросить настройки
Если устройство поддерживает сброс настроек, то после его выполнения Поставщик должен прекратить передачу маячков и удалить временный ключ идентификации и все сохраненные ключи аккаунтов, включая ключ аккаунта владельца.
После сброса настроек (вручную или программно) Поставщик не должен сразу начинать объявлять о Быстром подключении, чтобы процесс подключения не запускался сразу после того, как пользователь удалит устройство.
Защита от нежелательного отслеживания
Сертифицированные устройства FHN также должны соответствовать требованиям, указанным в версии реализации кросс-платформенной спецификации для обнаружения нежелательных трекеров геолокации (DULT).
Рекомендации по обеспечению соответствия сети "Найти устройство" спецификации DULT:
- Любое устройство, совместимое с сетью поиска устройств, должно быть зарегистрировано в Nearby Device Console, а функция Find Hub должна быть активирована.
- Устройство должно реализовывать сервис Accessory Non-Owner и характеристику, определенную в версии спецификации DULT, включая операции Accessory Information и Non-owner controls.
- В течение периода обратной совместимости, как определено в спецификации DULT, в рекламном фрейме, как определено в этом документе, изменений нет.
- Режим защиты от слежения от нежелательного отслеживания, описанный в этом документе, соответствует состоянию "separated" (отделено) в спецификации DULT.
- Рекомендации по реализации кодов операций Accessory Information:
- Get_Product_Data должна возвращать идентификатор модели, предоставленный консолью, дополненный нулями до 8 байт. Например, идентификатор модели 0xFFFFFF возвращается как 0x0000000000FFFFFF.
- Значения Get_Manufacturer_Name и Get_Model_Name должны совпадать с указанными в консоли.
- Get_Accessory_Category может возвращать общее значение "Трекер местоположения", если другие категории не подходят для типа устройства.
- Get_Accessory_Capabilities должен указывать на поддержку звонка, а также на поиск идентификатора BLE.
- Get_Network_ID должен возвращать идентификатор Google (0x02).
- Рекомендации по реализации кода операции Get_Identifier:
- Операция должна возвращать действительный ответ только в течение пяти минут после того, как пользователь активировал режим идентификации, нажав определенную комбинацию кнопок. Визуальный или звуковой сигнал должен указывать пользователю, что поставщик вошел в этот режим. Инструкции по активации этого режима для конкретной модели должны быть предоставлены Google в качестве требования для сертификации и не менее чем за 10 дней до любого обновления или изменения инструкций.
- Ответ состоит из первых 10 байтов текущего временного идентификатора и первых 8 байтов
HMAC-SHA256(recovery key, the truncated current ephemeral identifier).
- Рекомендации по реализации идентификатора через NFC:
- В качестве URL укажите
find-my.googleapis.com/lookup. - В качестве параметра
eиспользуйте тот же ответ, что и для Get_Identifier, в шестнадцатеричной кодировке. - В качестве параметра
pidиспользуйте тот же ответ, что и для Get_Product_Data, в шестнадцатеричной кодировке.
- В качестве URL укажите
- Устройство должно быть оснащено динамиком и поддерживать функцию звонка. Согласно спецификации DULT, динамик должен издавать звук с пиковой громкостью не менее 60 фон, как определено в ISO 532-1:2017.
- Рекомендации по реализации кода операции Sound_Start:
- Команда должна запустить звонок на всех доступных компонентах.
- Используйте максимально поддерживаемую громкость.
- Рекомендуемая продолжительность звонка – 12 секунд.
- В тегах локатора должен быть предусмотрен механизм, позволяющий пользователям временно останавливать рекламу без сброса настроек устройства (например, нажатие комбинации кнопок).
- Инструкции по отключению должны быть опубликованы в интернете. Ссылку на них необходимо предоставить Google для сертификации и не позднее чем за 10 дней до любого обновления или изменения инструкций.
- URL должен поддерживать локализацию. В зависимости от клиента язык будет указан либо в параметре запроса ("hl=en"), либо в HTTP-заголовке accept-language.
Рекомендации по использованию переключаемых протоколов
- Одновременно можно использовать только один протокол. Убедитесь, что на устройстве одновременно может работать не более одной сети. Это требование необходимо для того, чтобы конфиденциальные пользовательские данные не смешивались при использовании разных протоколов.
- Рекомендуется добавить в устройство функцию жесткой перезагрузки, которая позволит пользователю заново настроить устройство в другой сети.
- Процесс обновления устройства для работы в сети должен быть удобным для пользователя и одинаковым для всех сетей. Пользователь должен иметь возможность выбрать сеть, не отдавая предпочтения одной из них. Этот процесс должен быть одобрен командой Google.
Обновления встроенного ПО
Процесс и распространение беспроводных обновлений должны управляться партнером с помощью собственного рабочего процесса мобильного или веб-приложения.
Функция быстрого подключения поддерживает отправку пользователю уведомлений о доступных беспроводных обновлениях. Чтобы использовать этот механизм:
- Последняя версия встроенного ПО должна быть обновлена в Nearby Device Console.
- В Nearby Device Console должно быть задано сопутствующее приложение. Оно должно поддерживать намерение обновления встроенного ПО.
- Поставщик должен реализовать характеристику GATT Версия встроенного ПО.
Чтобы предотвратить отслеживание, доступ к характеристике Версия встроенного ПО должен быть ограничен. Искатель сначала считывает состояние инициализации и предоставляет ключ аутентификации, как определено в этой спецификации, и только после этого считывает версию встроенного ПО. Это будет сделано через то же подключение. Если попытка прочитать версию встроенного ПО была предпринята, но поставщик не связан или аутентифицированная операция не была успешно завершена через то же подключение, поставщик должен вернуть ошибку аутентификации.
Совместимость
Для работы сети Портала поиска требуется включить сервисы геолокации и Bluetooth. Необходимо подключение к интернету и сотовой сети. Доступно в некоторых странах на устройствах с Android 9 и более поздних версий для пользователей, достигших необходимого возраста.
Журнал изменений
| Версия FHN | Дата | Комментарий |
|---|---|---|
| v1 | Первый выпуск спецификации FHN для раннего доступа. | |
| Версия 1.1 | Feb 2023 |
|
| Версия 1.2 | Апрель 2023 г. |
|
| v1.3 | Декабрь 2023 г. |
|