Spécifications de l'accessoire réseau Localiser mon appareil

v1.3

La spécification des accessoires du réseau Localiser mon appareil (FMDN) définit une approche chiffrée de bout en bout pour le suivi des appareils Bluetooth Low Energy (BLE) baliseurs. Cette page décrit FMDN en tant qu'extension de la spécification Association express. Les fournisseurs doivent activer cette extension s'ils disposent d'appareils compatibles avec FMDN et s'ils souhaitent activer le suivi de la position pour ces appareils.

Remarque :Si vous souhaitez intégrer la spécification des accessoires Localiser mon appareil, envoyez un formulaire de proposition d'appareil. Plus d'informations sur les étapes d'intégration et la certification seront bientôt disponibles.

Spécification GATT

Une caractéristique d'attributs génériques (GATT) supplémentaire doit être ajoutée au service Fast Pair avec la sémantique suivante:

Caractéristique du service d'association express	Chiffré	Autorisations	UUID
Actions des balises	Non	Lire, écrire et envoyer des notifications	FE2C1238-8366-4814-8EB0-01DE32100BEA

Tableau 1:Caractéristiques du service Fast Pair pour les FMDN

Authentification

Les opérations requises par cette extension sont effectuées en tant qu'opérations d'écriture, sécurisées par un mécanisme de défi-réponse. Avant d'effectuer une opération, le chercheur doit effectuer une opération de lecture à partir de la caractéristique du tableau 1, ce qui génère une mémoire tampon au format suivant:

Octet	Type de données	Description	Valeur
0	uint8	Numéro de version majeure du protocole	0x01
1 - 8	tableau d'octets	Nonce aléatoire unique	varie

Chaque opération de lecture doit générer un nonce différent, et un nonce ne doit être valide que pour une seule opération. Le nonce doit être invalidé même si l'opération a échoué.

Le Seeker calcule ensuite une clé d'authentification à usage unique à utiliser dans une requête d'écriture ultérieure. La clé d'authentification est calculée comme décrit dans les tableaux 2 à 5. Selon l'opération demandée, le demandeur prouve qu'il connaît une ou plusieurs des clés suivantes:

• Clé de compte: clé de compte Fast Pair de 16 octets, comme défini dans la spécification Fast Pair.

• Clé de compte propriétaire: le fournisseur choisit l'une des clés de compte existantes comme clé de compte propriétaire la première fois qu'un demandeur accède à la caractéristique Actions sur les balises. La clé de compte propriétaire choisie ne peut pas être modifiée tant que le fournisseur n'a pas été réinitialisé. Le fournisseur ne doit pas supprimer la clé de compte propriétaire lorsqu'il n'a plus d'emplacements de clé de compte disponibles.

  • Les fournisseurs qui acceptent déjà le FMDN lorsqu'ils sont associés pour la première fois (ou qu'ils le prennent en charge lors de l'association après une réinitialisation selon la configuration d'usine) choisissent la première clé de compte, car il s'agit de la seule clé de compte existante lorsque le Seeker lit l'état du provisionnement lors de l'association.

  • Les fournisseurs qui bénéficient de la prise en charge de la FMDN après avoir été associés (par exemple, via une mise à jour du micrologiciel) peuvent choisir n'importe quelle clé de compte existante. Il est raisonnable de choisir la première clé de compte utilisée pour lire l'état de provisionnement à partir de la caractéristique des actions de balise après la mise à jour du micrologiciel, en supposant que l'utilisateur qui a effectué la mise à jour est le propriétaire actuel du fournisseur.

• Clé d'identité éphémère (EIK): clé de 32 octets choisie de manière aléatoire par le chercheur lors du processus de provisionnement de la FMDN. Cette clé permet de dériver des clés cryptographiques utilisées pour chiffrer de bout en bout les rapports de localisation. Le chercheur ne le révèle jamais au backend.

• Clé de récupération: définie en tant que SHA256(ephemeral identity key || 0x01), tronquée aux huit premiers octets. La clé est stockée sur le backend, et le demandeur peut l'utiliser pour récupérer l'EIK, à condition que l'utilisateur donne son consentement en appuyant sur un bouton de l'appareil.

• Clé de sonnerie: définie comme SHA256(ephemeral identity key || 0x02), tronquée aux huit premiers octets. La clé est stockée dans le backend et le chercheur ne peut l'utiliser que pour faire sonner l'appareil.

• Clé de protection contre le suivi indésirable: définie en tant que SHA256(ephemeral identity key || 0x03), tronquée aux huit premiers octets. La clé est stockée dans le backend et le Seeker ne peut l'utiliser que pour activer le mode de protection contre le suivi indésirable.

Opérations

Le format des données écrites dans la caractéristique est indiqué dans les tableaux 2 à 5. Chacune de ces opérations est abordée plus en détail plus loin dans cette section.

Octet	Type de données	Description	Valeur
0	uint8	ID de données	0 x 00: lire les paramètres de la balise 0x01: Lire l'état de provisionnement 0x02: Définir la clé d'identité éphémère 0x03: effacer la clé d'identité éphémère
1	uint8	Longueur des données	varie
2 - 9	tableau d'octets	Clé d'authentification unique	Les 8 premiers octets de HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
10 - var	tableau d'octets	Données supplémentaires	0 x 00: N/A 0x01: n/a 0x02: 32 octets correspondant à la clé d'identité éphémère, chiffrée AES-ECB-128 avec la clé de compte. Si le fournisseur dispose déjà d'une clé d'identité éphémère définie, envoyez également les huit premiers octets de SHA256(current ephemeral identity key || the last nonce read from the characteristic). 0x03: les 8 premiers octets de SHA256(ephemeral identity key || the last nonce read from the characteristic)

Tableau 2:Demande de provisionnement de balise.

Octet	Type de données	Description	Valeur
0	uint8	ID de données	0x04: Lire la clé d'identité éphémère avec le consentement de l'utilisateur
1	uint8	Longueur des données	0x08
2 à 9	tableau d'octets	Clé d'authentification unique	Les huit premiers octets de HMAC-SHA256(recovery key, protocol major version number || the last nonce read from the characteristic || data ID || data length)

Tableau 3:Demande de récupération de la clé de provisionnement du balise.

Octet	Type de données	Description	Valeur
0	uint8	ID de données	0x05: sonnerie 0x06: Lire l'état de sonnerie
1	uint8	Longueur des données	varie
2 - 9	tableau d'octets	Clé d'authentification unique	Les 8 premiers octets de HMAC-SHA256(ring key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
10 - var	tableau d'octets	Données supplémentaires	0x05: 4 octets indiquant l'état de la sonnerie, la durée de la sonnerie et le volume de la sonnerie. 0x06: N/A

Tableau 4:requête de sonnerie.

Octet	Type de données	Description	Valeur
0	uint8	ID de données	0x07: Activer le mode de protection contre le suivi indésirable 0x08: Désactiver le mode de protection contre le suivi indésirable
1	uint8	Longueur des données	varie
2 - 9	tableau d'octets	Clé d'authentification unique	Les 8 premiers octets de 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	tableau d'octets	Données supplémentaires	0x07: 1 octet d'indicateurs de contrôle (facultatif) 0x08: les 8 premiers octets de SHA256(ephemeral identity key || the last nonce read from the characteristic)

Tableau 5:Requête de protection contre le suivi indésirable.

Les écritures réussies déclenchent des notifications, comme indiqué dans le tableau 6.

Les notifications avec un ID de données autre que 0x05: Modification de l'état de la sonnerie doivent être envoyées avant la fin de la transaction d'écriture qui déclenche la notification, c'est-à-dire avant l'envoi d'un PDU de réponse pour la requête d'écriture.

Octet	Type de données	Description	Valeur
0	uint8	ID de données	0 x 00: lire les paramètres de la balise 0x01: Lire l'état de provisionnement 0x02: Définir la clé d'identité éphémère 0x03: Clé d'identité éphémère claire 0x04: Lire la clé d'identité éphémère avec le consentement de l'utilisateur 0x05: Modification de l'état de la sonnerie 0x06: Lire l'état de sonnerie 0x07: Activer le mode de protection contre le suivi indésirable 0x08: Désactiver le mode de protection contre le suivi indésirable
1	uint8	Longueur des données	varie
2 - 9	tableau d'octets	Authentification	Détaillé par opération
10 - var	tableau d'octets	Données supplémentaires	0x00: 8 octets indiquant la puissance de transmission, la valeur d'horloge, la méthode de chiffrement et les fonctionnalités de sonnerie, AES-ECB-128 chiffré avec la clé de compte (avec remplissage à zéro) 0x01: 1 octet indiquant l'état de provisionnement, suivi de l'ID éphémère actuel (20 ou 32 octets), le cas échéant 0x04: 32 octets correspondant à la clé d'identité éphémère, chiffrée AES-ECB-128 avec la clé de compte 0x05: 4 octets indiquant le nouvel état et le déclencheur du changement 0x06: trois octets indiquant les composants en sonnerie active et le nombre de décisecondes restantes pour la sonnerie D'autres ID de données utilisent des données supplémentaires vides

Tableau 6:Réponse du service Beacon.

Le tableau 7 liste les codes d'erreur GATT possibles renvoyés par les opérations.

Code	Description	Remarques
0x80	Non authentifiés	Est renvoyé en réponse à une requête d'écriture en cas d'échec de l'authentification (y compris si un ancien nonce a été utilisé).
0x81	Valeur non valide	Est renvoyé lorsqu'une valeur non valide est fournie ou que les données reçues présentent un nombre d'octets inattendu.
0x82	Aucun consentement de l'utilisateur	Renvoie en réponse à une requête d'écriture avec l'ID de données 0x04: Lire la clé d'identité éphémère avec le consentement de l'utilisateur lorsque l'appareil n'est pas en mode association.

Tableau 7:codes d'erreur GATT

Lire le paramètre de la balise

Le chercheur peut interroger le fournisseur sur les paramètres du balise en effectuant une opération d'écriture sur la caractéristique consistant en une requête de la table 2 avec l'ID de données 0x00. Le fournisseur vérifie que la clé d'authentification unique fournie correspond à l'une des clés de compte stockées sur l'appareil.

Si la validation échoue, le fournisseur renvoie une erreur non authentifiée.

En cas de réussite, le fournisseur envoie une réponse de la table 6 avec l'ID de données 0x00. Le fournisseur crée le segment de données comme suit:

Octet	Type de données	Description	Valeur
0	uint8	Puissance calibrée	Puissance calibrée telle que reçue à 0 m (valeur comprise dans la plage [-100, 20]). Représenté sous la forme d'un entier signé, avec une résolution de 1 dBm.
1 à 4	uint32	Valeur d'horloge	Valeur de l'horloge actuelle en secondes (big endian).
5	uint8	Sélection de courbes	Courbe elliptique utilisée pour le chiffrement: 0 x 00 (par défaut): SECP160R1 0x01: SECP256R1 (nécessite une publicité étendue)
6	uint8	Composants	Nombre de composants pouvant sonner: 0x00: indique que l'appareil ne peut pas sonner. 0x01: indique qu'un seul composant peut sonner. 0x02: indique que deux composants, les écouteurs gauche et droit, peuvent sonner indépendamment. 0x03: indique que trois composants, les écouteurs gauche et droit et l'étui, peuvent sonner indépendamment.
7	uint8	Fonctionnalités de sonnerie	Les options acceptées sont les suivantes: 0x00: Sélection du volume de sonnerie non disponible. 0x01: sélection du volume de sonnerie disponible. Si elle est définie, le fournisseur doit accepter et gérer trois niveaux de volume, comme indiqué dans la section Fonctionnement de la sonnerie.
8-15	tableau d'octets	Marge intérieure	Remplissage par zéro pour le chiffrement AES.

Les données doivent être chiffrées avec la méthode AES-ECB-128 à l'aide de la clé de compte utilisée pour authentifier la requête.

Le segment d'authentification est défini comme étant les huit premiers octets de HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data after encryption || 0x01).

Lire l'état de provisionnement de la balise

Le demandeur peut interroger le fournisseur pour connaître l'état de provisionnement de la balise en effectuant une opération d'écriture sur la caractéristique correspondant à une requête du tableau 2 avec l'ID de données 0x01. Le fournisseur vérifie que la clé d'authentification à usage unique fournie correspond à l'une des clés de compte stockées sur l'appareil.

Si la validation échoue, le fournisseur renvoie une erreur non authentifiée.

En cas de réussite, le fournisseur envoie une réponse de la table 6 avec l'ID de données 0x01. Le fournisseur crée le segment de données comme suit:

Octet	Type de données	Description	Valeur
0	uint8	État de provisionnement	Un masque de bits ayant les valeurs suivantes: Bit 1 (0x01): défini si une clé d'identité éphémère est définie pour l'appareil. Bit 2 (0x02): défini si la clé d'authentification à usage unique fournie correspond à la clé du compte propriétaire.
1 à 20 ou 32	tableau d'octets	Identifiant éphémère actuel	20 ou 32 octets (selon la méthode de chiffrement utilisée) indiquant l'ID éphémère actuel diffusé par le balise, le cas échéant.

Le segment d'authentification est défini comme les huit premiers octets de HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01).

Définir une clé d'identité éphémère

Pour provisionner un fournisseur non provisionné en tant que balise FMDN ou modifier la clé d'identité éphémère d'un fournisseur déjà provisionné, le chercheur effectue une opération d'écriture sur la caractéristique consistant en une requête de la table 2 avec l'ID de données 0x02. Le Fournisseur vérifie que:

• La clé d'authentification à usage unique fournie correspond à la clé du compte propriétaire.
• Si un hachage d'une clé d'identité éphémère a été fourni, la clé d'identité éphémère hachée correspond à la clé d'identité éphémère actuelle.
• Si aucun hachage d'une clé d'identité éphémère n'a été fourni, vérifiez que le fournisseur n'a pas déjà été provisionné en tant que balise FMDN.

Si la validation échoue, le fournisseur renvoie une erreur non authentifiée.

En cas de réussite, la clé d'identité éphémère est récupérée par AES-ECB-128 en la déchiffrant à l'aide de la clé de compte correspondante. La clé doit être conservée sur l'appareil. À partir de ce moment-là, le fournisseur doit commencer à diffuser des trames FMDN. La nouvelle clé d'identité éphémère prend effet immédiatement après la fin de la connexion BLE. Le fournisseur envoie une réponse du tableau 6 avec l'ID de données 0x02.

Le segment d'authentification est défini comme les huit premiers octets de HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01).

Effacer la clé d'identité éphémère

Pour désprovisionner la partie balise du fournisseur, le chercheur effectue une opération d'écriture sur la caractéristique, qui consiste en une requête de la table 2 avec l'ID de données 0x03. Le Fournisseur vérifie que:

• La clé d'authentification à usage unique fournie correspond à la clé du compte propriétaire.
• La clé d'identité éphémère hachée correspond à la clé d'identité éphémère actuelle.

Si le fournisseur n'est pas provisionné en tant que balise FMDN ou si la validation échoue, une erreur non authentifiée est renvoyée.

En cas de réussite, le fournisseur oublie la clé et cesse de diffuser des trames FMDN. Le fournisseur envoie une notification du tableau 6 avec l'ID de données 0x03. Le segment d'authentification est défini comme les huit premiers octets de HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01).

Lire la clé d'identité éphémère avec le consentement de l'utilisateur

Cette option n'est disponible que pour récupérer une clé perdue, car elle n'est stockée localement que par le chercheur. Par conséquent, cette fonctionnalité n'est disponible que lorsque l'appareil est en mode association ou pendant une durée limitée après qu'un bouton physique a été enfoncé sur l'appareil (ce qui constitue le consentement de l'utilisateur).

Le chercheur doit stocker la clé de récupération dans le backend pour pouvoir récupérer la clé en texte clair, mais il ne stocke pas la clé EIK elle-même.

Pour lire l'EIK, le chercheur effectue une opération d'écriture sur la caractéristique, qui consiste en une requête de la table 3 avec l'ID de données 0x04. Le fournisseur vérifie que:

• La clé de récupération hachée correspond à la clé de récupération attendue.
• L'appareil est en mode de récupération EIK.

Si la validation échoue, le fournisseur renvoie une erreur non authentifiée.

Si l'appareil n'est pas en mode association, le fournisseur renvoie une erreur "Aucun consentement de l'utilisateur".

En cas de réussite, le fournisseur envoie une réponse de la table 6 avec l'ID de données 0x04.

Le segment d'authentification est défini comme étant les huit premiers octets de HMAC-SHA256(recovery key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01).

Fonctionnement de la sonnerie

Le demandeur peut demander au fournisseur de diffuser un son en effectuant une opération d'écriture sur la caractéristique, qui consiste en une requête de la table 4 avec l'ID de données 0x05. Le fournisseur crée le segment de données comme suit:

Octet	Type de données	Description	Valeur
0	uint8	Fonctionnement de la sonnerie	Un masque de bits ayant les valeurs suivantes: Bit 1 (0x01): Sonnerie droite Bit 2 (0x02): Sonnerie de l'écouteur gauche Bit 3 (0x04): anneaux 0xFF: sonner tous les composants 0x00: Arrêter la sonnerie
1 - 2	uint16	Délai avant expiration	Délai avant expiration en décimales. Ne doit pas être égal à zéro et ne doit pas dépasser l'équivalent de 10 minutes. Le fournisseur utilise cette valeur pour déterminer la durée pendant laquelle le téléphone doit sonner avant de se couper. Le délai avant expiration remplace celui déjà en vigueur si un composant de l'appareil sonne déjà. Si l'opération de sonnerie est définie sur 0x00, le délai avant expiration est ignoré.
3	uint8	Volume	0x00: valeur par défaut 0x01: Faible 0x02: Moyen 0 x 03: Élevée La signification exacte de ces valeurs dépend de l'implémentation.

À la réception de la demande, le fournisseur vérifie que:

• La clé d'authentification à usage unique fournie correspond à la clé de l'anneau.
• L'état demandé correspond aux composants qui peuvent sonner.

Si le fournisseur n'est pas provisionné en tant que balise FMDN ou si la validation échoue, une erreur non authentifiée est renvoyée. Toutefois, si le fournisseur a activé la protection contre le suivi indésirable et que l'indicateur d'authentification de l'appel manqué a été activé pour la requête de protection contre le suivi indésirable déclenchée, le fournisseur doit ignorer cette vérification. Les données d'authentification doivent toujours être fournies par le chercheur, mais elles peuvent être définies sur une valeur arbitraire.

Lorsqu'une sonnerie commence ou se termine, une notification est envoyée, comme indiqué dans le tableau 6 avec l'ID de données 0x05. Le contenu de la notification est défini comme suit:

Octet	Type de données	Description	Valeur
0	uint8	État de la sonnerie	0x00: démarré 0x01: échec du démarrage ou de l'arrêt (tous les composants demandés sont hors de portée) 0x02: Arrêté (expiration du délai d'attente) 0x03: Arrêté (appui sur le bouton) 0x04: Arrêté (requête GATT)
1	uint8	Composants de sonnerie	Masque de bits des composants qui sonnent activement, comme défini dans la requête.
2 à 3	uint16	Délai avant expiration	Durée restante de la sonnerie en décisecondes. Si l'appareil a cessé de sonner, 0x0000 doit être renvoyé.

Le segment d'authentification est défini comme les huit premiers octets de HMAC-SHA256(ring key, protocol major version number || the nonce used to initiate the ringing command || data ID || data length || additional data || 0x01).

Si l'appareil est déjà à l'état d'appel demandé lors de la réception d'une demande d'appel ou d'arrêt de la sonnerie, le fournisseur doit envoyer une notification avec un état de sonnerie, ou une notification de type 0x00: démarrée ou 0x04: arrêtée (requête GATT), respectivement. Cette requête remplace les paramètres de l'état existant afin que la durée de la sonnerie puisse être étendue.

Si le fournisseur dispose d'un bouton physique (ou si le capteur tactile est activé), ce bouton doit arrêter la sonnerie si vous appuyez dessus pendant que la sonnerie est active.

Remarque :Pour les fournisseurs qui incluent la détection de port sur la tête, nous vous recommandons de vérifier que l'appareil n'est pas porté sur la tête avant de sonner au volume maximal. Si la détection de port d'écouteurs n'est pas prise en charge ou n'est pas fiable, augmentez progressivement le volume (afin que l'utilisateur ait le temps d'arrêter la sonnerie ou de retirer ses écouteurs).

Remarque :Le fournisseur doit continuer à sonner, quel que soit l'état de la connexion de l'utilisateur qui a demandé la sonnerie. Cela permet d'éviter que l'appareil arrête de sonner, car la connexion est perdue, car le client s'éloigne trop de l'appareil. L'appareil ne peut alors pas être trouvé, car il a cessé de sonner et est trop éloigné du client pour qu'il puisse demander à nouveau de sonner.

Obtenir l'état de sonnerie du beacon

Pour obtenir l'état de sonnerie du beacon, le Seeker effectue une opération d'écriture sur la caractéristique, qui consiste en une requête de la table 4 avec l'ID de données 0x06. Le fournisseur vérifie que la clé d'authentification à usage unique fournie correspond à la clé de l'anneau.

Si le fournisseur n'est pas provisionné en tant que balise FMDN ou si la validation échoue, le fournisseur renvoie une erreur non authentifiée.

En cas de réussite, le fournisseur envoie une réponse de la table 6 avec l'ID de données 0x06. Le fournisseur crée le segment de données comme suit:

Octet	Type de données	Description	Valeur
0	uint8	Composants de sonnerie	Composants en sonnerie active, comme défini dans la requête de sonnerie.
1 - 2	uint16	Délai avant expiration	Temps restant avant la sonnerie, en décimales. Notez que si l'appareil ne sonne pas, 0x0000 doit être renvoyé.

Le segment d'authentification est défini comme étant les huit premiers octets de HMAC-SHA256 (ring key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01).

Mode de protection contre le suivi indésirable

Le mode de protection contre le suivi indésirable permet à tout client d'identifier les appareils abusifs sans communication avec le serveur. Par défaut, le fournisseur doit alterner tous les identifiants, comme décrit dans la section Rotation des ID. Le service Localiser mon appareil peut transmettre une demande d'activation du mode Protection contre le suivi indésirable via le réseau Localiser mon appareil. Ainsi, le service oblige le fournisseur à utiliser temporairement une adresse MAC fixe, ce qui permet aux clients de détecter l'appareil et d'avertir l'utilisateur d'un éventuel suivi indésirable.

Pour activer ou désactiver le mode de protection contre le suivi indésirable de la balise, le demandeur effectue une opération d'écriture sur la caractéristique. Il s'agit d'une requête provenant de la table 5 avec l'ID de données 0x07 ou 0x08, respectivement.

Lors de l'activation du mode de protection contre le suivi indésirable

Le fournisseur crée le segment de données comme suit:

Octet	Type de données	Description	Valeur
0	uint8	Indicateurs de contrôle	0x01: ignorer l'authentification du sonnerie. Lorsque ce paramètre est défini, les requêtes de sonnerie ne sont pas authentifiées en mode Protection contre le suivi indésirable. Si aucun indicateur n'est défini (c'est-à-dire que l'octet ne contient que des zéros), il est possible d'omettre complètement la section de données et d'envoyer une section de données vide. Les indicateurs ne sont en vigueur que jusqu'à ce que le mode de protection contre le suivi indésirable soit désactivé.

Le fournisseur vérifie que la clé d'authentification à usage unique fournie correspond à la clé de protection contre le suivi indésirable. Si le fournisseur n'est pas provisionné en tant que balise FMDN ou si la validation échoue, une erreur non authentifiée est renvoyée.

Lorsque le mode de protection contre le suivi indésirable est activé, la balise doit réduire la fréquence de rotation de l'adresse privée MAC à une fois toutes les 24 heures. L'identifiant éphémère annoncé doit continuer à tourner comme d'habitude. Le type d'image doit être défini sur 0x41. L'état est également reflété dans la section Flags hachés.

Lorsque vous désactivez le mode de protection contre le suivi indésirable

Le Fournisseur vérifie que:

• La clé d'authentification unique fournie correspond à la clé de protection contre le suivi indésirable.
• La clé d'identité éphémère hachée correspond à la clé d'identité éphémère actuelle.

Si le fournisseur n'est pas provisionné en tant que balise FMDN ou si la validation échoue, il renvoie une erreur non authentifiée.

Lorsque le mode de protection contre le suivi indésirable est désactivé, la balise doit recommencer à faire tourner l'adresse MAC à un rythme normal, synchronisée avec la rotation de l'identifiant éphémère. Le type de frame doit être rétabli sur 0x40. L'état est également reflété dans la section Options hachées.

En cas de réussite, le fournisseur envoie une notification de la table 6 avec l'ID de données 0x07 ou 0x08.

Le segment d'authentification est défini comme les huit premiers octets de HMAC-SHA256(unwanted tracking protection key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01).

Cadres annoncés

Après le provisionnement, le fournisseur doit diffuser des trames FMDN au moins une fois toutes les deux secondes. Si des frames Association express sont annoncées, le fournisseur doit entrelacer les trames FMDN dans les annonces Association express standards. Par exemple, toutes les deux secondes, le fournisseur doit diffuser sept annonces Fast Pair et une annonce FMDN.

Remarque :Il est recommandé d'annoncer les trames FMDN même lorsque l'appareil est en mode d'économie d'énergie, car cela permet de le retrouver en cas de perte. Pour certains appareils, il est possible qu'il ne soit pas possible de diffuser des annonces lorsque l'appareil est éteint en raison des conséquences sur l'autonomie de la batterie. Dans ce cas, il est vivement recommandé de réactiver régulièrement l'appareil et de diffuser des annonces pendant une courte période (par exemple, toutes les 10 minutes et pendant 10 secondes).

Le frame FMDN contient une clé publique utilisée pour chiffrer les rapports de localisation par n'importe quel client compatible qui contribue au réseau de crowdsourcing. Deux types de clés à courbe elliptique sont disponibles: une clé 160 bits qui s'adapte aux anciens trames BLE 4 ou une clé 256 bits qui nécessite BLE 5 avec des fonctionnalités publicitaires étendues. L'implémentation du fournisseur détermine la courbe utilisée.

Remarque :L'utilisation de clés 256 bits signifie que les téléphones plus anciens qui ne sont pas compatibles avec le BLE 5 ne peuvent pas analyser ni signaler les appareils publicitaires, ce qui réduit la taille du réseau.

Un frame FMDN est structuré comme suit :

Octet	Valeur	Description
0	0x02	Longueur
1	0x01	Indique la valeur du type de données
2	0x06	Données d'indicateurs
3	0x18 ou 0x19	Longueur
4	0x16	Valeur du type de données de service
5	0xAA	UUID du service 16 bits
6	0xFE	…
7	0x40 ou 0x41	Type de trame FMDN avec indication du mode de protection contre le suivi indésirable
8..27		Identifiant éphémère de 20 octets
28		Drapeaux hachés

Tableau 8:trame FMDN compatible avec une courbe 160 bits.

Le tableau 9 indique les décalages d'octets et les valeurs pour une courbe de 256 bits.

Octet	Valeur	Description
0	0x02	Longueur
1	0x01	Indique la valeur du type de données
2	0x06	Données d'indicateurs
3	0x24 ou 0x25	Longueur
4	0x16	Valeur du type de données de service
5	0xAA	UUID du service 16 bits
6	0xFE	…
7	0x40 ou 0x41	Type de trame FMDN avec indication du mode de protection contre le suivi indésirable
8..39		Identifiant éphémère de 32 octets
40		Drapeaux hachés

Tableau 9:Trame FMDN acceptant une courbe de 256 bits.

Calcul de l'identifiant éphémère (EID)

Un nombre aléatoire est généré par le chiffrement AES-ECB-256 de la structure de données suivante avec la clé d'identité éphémère:

Octet	Champ	Description
0 à 10	Marge intérieure	Valeur = 0xFF
11	K	Exposant de la période de rotation
12 – 15	TS[0]...TS[3]	Compteur de temps de la balise, au format big-endian 32 bits Les K bits les plus faibles sont effacés.
16 - 26	Marge intérieure	Valeur = 0x00
27	K	Exposant de la période de rotation
28 - 31	TS[0]...TS[3]	Compteur de temps du signal, au format big-endian 32 bits. Les bits les plus bas de K sont effacés.

Tableau 10:Construction d'un nombre pseudo-aléatoire.

Remarque:On suppose que l'appareil dispose d'un compteur de temps 32 bits en secondes.

Remarque:L'exposant de la période de rotation est fixe et défini sur 10, ce qui correspond à 1 024 secondes.

Le résultat de ce calcul est un nombre de 256 bits, noté r'.

Pour le reste du calcul, SECP160R1 ou SECP256R1 sont utilisés pour les opérations cryptographiques de courbe elliptique. Consultez les définitions des courbes dans la section SEC 2 : Recommended Elliptic Curve Domain Parameters (SECTION 2 : Paramètres de domaine de courbe elliptique recommandés), qui définit Fp, n et G, référencés ci-dessous.

r' est désormais projeté sur le champ fini Fp en calculant r = r' mod n. Enfin, calculez R = r * G, qui est un point sur la courbe représentant la clé publique utilisée. Le balise annonce Rx, qui est la coordonnée x de R, comme identifiant éphémère.

Options hachées

Le champ d'indicateurs hachés est calculé comme suit (les bits sont référencés du plus significatif au moins significatif):

• Bits 0 à 4: réservés (définis sur zéro).
• Les bits 5 et 6 indiquent le niveau de batterie de l'appareil comme suit :
  • 00: Indication du niveau de batterie non prise en charge
  • 01: Niveau de batterie normal
  • 10: niveau de batterie faible
  • 11: Niveau de batterie très faible (batterie bientôt remplacée)
• Le bit 7 est défini sur 1 si la balise est en mode de protection contre le suivi indésirable, et sur 0 dans le cas contraire.

Pour produire la valeur finale de cet octet, il est mis au point (xor) avec l'octet le moins significatif (SHA256(r)).

Notez que r doit être aligné sur la taille de la courbe. Ajoutez des zéros en tant que bits les plus significatifs si sa représentation est inférieure à 160 ou 256 bits, ou les bits les plus significatifs doivent être tronqués si sa représentation est supérieure à 160 ou 256 bits.

Si la balise n'est pas compatible avec l'indication du niveau de la batterie et qu'elle n'est pas en mode de protection contre le suivi indésirable, elle est autorisée à omettre complètement cet octet de la publicité.

Chiffrement avec EID

Remarque :Les détails suivants sur le chiffrement et le déchiffrement avec des EID ne sont inclus que pour compléter la spécification. Seul le demandeur les implémente, pas le fournisseur.

Pour chiffrer un message m, un observateur (ayant lu Rx à partir de la balise) procède comme suit:

1. Choisissez un nombre aléatoire s dans Fp, comme défini dans la section Calcul EID.
2. Calculez S = s * G.
3. Calculer la fonction R = (Rx, Ry) par substitution dans l'équation de la courbe et choisir une valeur Ry arbitraire parmi les résultats possibles.
4. Calculez la clé AES 256 bits k = HKDF-SHA256((s * R)x), où (s * R)x est la coordonnée x du résultat de la multiplication de la courbe. Le sel n'est pas spécifié.
5. Supposons que URx et LRx représentent respectivement les 80 bits supérieurs et inférieurs de Rx, au format big-endian. De même, définissez USx et LSx pour S.
6. Calculez nonce = LRx || LSx.
7. Calculez (m’, tag) = AES-EAX-256-ENC(k, nonce, m).
8. Envoyer (URx, Sx, m’, tag) au propriétaire, éventuellement via un service distant non approuvé.

Déchiffrement de valeurs chiffrées avec EID

Le client du propriétaire, qui possède l'EIK et l'exposant de la période de rotation, déchiffre le message comme suit:

1. Donnée URx, permet d'obtenir la valeur du compteur de temps de la balise sur laquelle URx est basé. Pour ce faire, le client du propriétaire peut calculer les valeurs Rx des valeurs du compteur de durée de la balise pour le passé récent et le futur.
2. Étant donné la valeur du compteur de temps de la balise sur laquelle URx est basée, calculez la valeur prévue de r, comme défini dans la section Calcul de l'EID.
3. Calculez R = r * G et vérifiez qu'il correspond à la valeur de URx fournie par le viseur.
4. Calculez S = (Sx, Sy) par substitution dans l'équation de la courbe et en sélectionnant une valeur Sy arbitraire parmi les résultats possibles.
5. Calculez k = HKDF-SHA256((r * S)x), où (r * S)x est la coordonnée x du résultat de la multiplication de la courbe.
6. Calculez nonce = LRx || LSx.
7. Calculez m = AES-EAX-256-DEC(k, nonce, m’, tag).

Rotation des ID

Une adresse BLE résoluble (RPA) ou non résoluble (NRPA) doit être utilisée pour les trames FMDN publicitaires. La RPA est requise pour les appareils LE Audio (LEA) et recommandée pour les autres appareils, à l'exception des balises de localisation qui n'utilisent pas de liaison.

L'annonce à Association express, l'annonce FMDN et les adresses BLE correspondantes doivent alterner en même temps. La rotation doit avoir lieu en moyenne toutes les 1 024 secondes. Le moment précis auquel la balise commence à diffuser le nouvel identifiant doit être aléatoire pendant la période.

L'approche recommandée pour randomiser la durée de rotation consiste à la définir sur la prochaine date de rotation anticipée (si aucune randomisation n'a été appliquée) et sur un facteur de temps aléatoire positif compris entre 1 et 204 secondes.

Lorsque l'appareil est en mode de protection contre le suivi indésirable, l'adresse BLE de l'annonce FMDN doit être fixe, mais la RPA pour l'annonce non détectable de l'association express (comme l'association express) doit continuer à tourner. Il est acceptable d'utiliser des adresses différentes pour les différents protocoles.

Récupération après une perte de courant

La résolution de l'identifiant éphémère est fortement liée à sa valeur d'horloge au moment de la publicité. Il est donc important que le fournisseur puisse récupérer sa valeur d'horloge en cas de perte de courant. Il est recommandé que le fournisseur écrive sa valeur d'horloge actuelle dans la mémoire non volatile au moins une fois par jour, et qu'au démarrage, le fournisseur vérifie la NVM pour voir s'il existe une valeur à partir de laquelle l'initialiser. Les résolveurs de l'identifiant éphémère implémenteraient la résolution sur une période suffisante pour permettre à la fois une dérive de l'horloge raisonnable et ce type de récupération en cas de perte de courant.

Les fournisseurs doivent tout de même faire tout leur possible pour minimiser les dérives de l'horloge, car la période de résolution est limitée. Au moins une méthode de synchronisation d'horloge supplémentaire doit être mise en œuvre (annoncer des trames de combinaison express non visibles ou implémentation du flux de messages).

Consignes d'implémentation de Fast Pair

Cette section décrit les aspects particuliers de l'implémentation de Fast Pair sur les fournisseurs compatibles avec FMDN.

Consignes spécifiques aux tags de localisation

• Si le fournisseur a été associé, mais que le FMDN n'a pas été provisionné dans les cinq minutes (ou si une mise à jour OTA a été appliquée alors que l'appareil est associé, mais qu'il n'a pas été provisionné avec FMDN), le fournisseur doit rétablir sa configuration d'usine et effacer les clés de compte stockées.
• Une fois le fournisseur associé, il ne doit pas modifier son adresse MAC tant que FMDN n'est pas provisionné ou après cinq minutes.
• Si la clé d'identité éphémère est effacée de l'appareil, celui-ci doit effectuer une réinitialisation d'usine et effacer également les clés de compte stockées.
• Le fournisseur doit rejeter les tentatives d'association Bluetooth normales et n'accepter que l'association Fast Pair.
• Le fournisseur doit inclure un mécanisme permettant aux utilisateurs de suspendre temporairement la publicité sans réinitialiser l'appareil (par exemple, en appuyant sur une combinaison de boutons).
• Après une perte de courant, l'appareil doit diffuser des trames Fast Pair non détectables jusqu'à la prochaine invocation de read beacon parameters (Lire les paramètres du balise). Cela permet au chercheur de détecter l'appareil et de synchroniser l'horloge, même en cas de dérive importante de l'horloge.
• Lorsque vous annoncez des cadres Fast Pair non détectables, les indications de l'UI ne doivent pas être activées.
• Les trames en Association express détectables ne doivent pas être annoncées lorsque le fournisseur est provisionné pour FMDN.
• Le fournisseur ne doit pas exposer d'informations d'identification de manière non authentifiée (par exemple, des noms ou des identifiants).

Consignes spécifiques aux appareils Bluetooth classiques

Cette section décrit certains aspects particuliers des appareils Bluetooth classiques compatibles avec FMDN.

Provisionnement FMDN des appareils déjà associés

Le fournisseur n'est pas toujours provisionné pour FMDN lors de l'association avec le chercheur, mais un certain temps après. Dans ce cas, le fournisseur ne dispose peut-être pas d'une adresse MAC BLE à jour, qui est requise pour établir une connexion GATT. Le fournisseur doit prendre en charge au moins l'une des méthodes suivantes pour que le chercheur puisse obtenir son adresse BLE lorsqu'il est déjà associé:

• Le fournisseur peut diffuser régulièrement les données du compte Association express qui permettent au demandeur de trouver son adresse BLE par le biais d'une analyse BLE.
  Cette approche convient aux fournisseurs qui n'implémentent pas le flux de messages.
• Le fournisseur peut fournir ces données via le flux de messages Fast Pair via le Bluetooth classique.
  Cette approche convient aux fournisseurs qui n'annoncent pas de trames Fast Pair lorsqu'ils sont connectés au chercheur via Bluetooth.

La compatibilité avec les deux approches augmente les chances que l'utilisateur puisse provisionner l'appareil pour FMDN.

Flux de messages Fast Pair

Le fournisseur peut implémenter le flux de messages Fast Pair et l'utiliser pour informer le chercheur des informations sur l'appareil. La mise en œuvre du flux de messages active certaines fonctionnalités décrites dans cette section.

Le fournisseur doit envoyer des messages d'informations sur l'appareil chaque fois que le canal RFCOMM du flux de messages est établi.

Version du micrologiciel (code d'information sur l'appareil 0x09) et fonctionnalité de suivi

Lorsqu'une mise à jour du micrologiciel ajoute la compatibilité FMDN au fournisseur, un demandeur connecté peut en informer l'utilisateur et lui proposer de le provisionner. Sinon, l'utilisateur doit accéder manuellement à la liste des appareils Bluetooth pour lancer le provisionnement FMDN.

Pour ce faire, le fournisseur doit utiliser la propriété "Version du micrologiciel" (code 0x09) pour indiquer une valeur de chaîne représentant la version du micrologiciel. De plus, le fournisseur doit prendre en charge le protocole qui permet au chercheur de connaître les modifications de capacité dues aux mises à jour du micrologiciel.

Octet	Type de données	Description	Valeur
0	uint8	Événement d'informations sur l'appareil	0x03
1	uint8	Version du micrologiciel	0x09
2 à 3	uint16	Longueur des données supplémentaires	varie
variable	tableau d'octets	Chaîne de version	varie

Tableau 11:Événement d'informations sur l'appareil: version du micrologiciel mise à jour.

Lorsqu'il reçoit une requête de mise à jour des fonctionnalités (0x0601), si le fournisseur a activé la prise en charge du suivi des numéros de téléphone mobile, il doit répondre comme indiqué dans le tableau 12.

Octet	Type de données	Description	Valeur
0	uint8	Événement de synchronisation des fonctionnalités de l'appareil	0x06
1	uint8	Suivi FMDN	0x03
2 à 3	uint16	Longueur des données supplémentaires	0x0007
4	uint8	État du provisionnement de l'FMDN	0x00 si non provisionné ; 0x01 si provisionné par un compte
5 - 10	tableau d'octets	Adresse MAC BLE actuelle de l'appareil	varie

Tableau 12:Événement de synchronisation des fonctionnalités de l'appareil: fonctionnalité de suivi ajoutée.

Identifiant éphémère actuel (code d'informations sur l'appareil 0x0B)

Le fournisseur peut utiliser l'identifiant éphémère actuel (code 0x0B) pour signaler l'EID et la valeur de l'horloge actuels lorsque le fournisseur est provisionné pour FMDN, afin de synchroniser le chercheur en cas de dérive de l'horloge (par exemple, en raison d'une batterie déchargée). Dans le cas contraire, le chercheur lance une connexion plus coûteuse et moins fiable à cette fin.

Octet	Type de données	Description	Valeur
0	uint8	Événement d'informations sur l'appareil	0x03
1	uint8	Identifiant éphémère actuel	0 x 0 octets
2 à 3	uint16	Longueur de données supplémentaire	0x0018 ou 0x0024
4 - 7	tableau d'octets	Valeur de l'horloge	Exemple: 0x13F9EA80
8 - 19 ou 31	tableau d'octets	EID actuel	Exemple : 0x1122334455667788990011223344556677889900

Tableau 13:Événement "Informations sur l'appareil" : synchronisation de l'horloge.

Rétablir la configuration d'usine

Pour les appareils compatibles avec la réinitialisation d'usine: si une réinitialisation d'usine est effectuée, le fournisseur doit arrêter la balise et effacer la clé d'identité éphémère et toutes les clés de compte stockées, y compris la clé de compte du propriétaire.

Après une réinitialisation (manuelle ou programmatique) de la configuration d'usine, le fournisseur ne doit pas commencer à promouvoir l'association express immédiatement, afin d'empêcher le flux d'association de démarrer immédiatement après la suppression de l'appareil par l'utilisateur.

Prévention du suivi indésirable

Les appareils FMDN certifiés doivent également répondre aux exigences de la version d'implémentation de la spécification multiplate-forme pour la détection des localisations indésirables (DULT).

Consignes spécifiques à la FMDN pour être conforme à la spécification DULT:

• Tout appareil compatible avec la FMDN doit être enregistré dans la console des appareils à proximité et la fonctionnalité "Localiser mon appareil" doit être activée.
• L'appareil doit implémenter le service et la caractéristique de non-propriétaire d'accessoire définis dans la version d'implémentation de la spécification DULT, y compris les opérations Informations sur l'accessoire et les commandes de non-propriétaire.
• Pendant la période de rétrocompatibilité, telle que définie dans la spécification DULT, aucune modification n'est apportée au frame annoncé, tel que défini dans ce document.
• Le "mode de protection contre le suivi indésirable" défini dans ce document correspond à l'état "séparé" défini par les spécifications DULT.
• Consignes d'implémentation des opcodes Informations sur l'accessoire :
  • Get_Product_Data doit renvoyer l'ID de modèle fourni par la console, avec des zéros pour remplir les 8 octets requis. Par exemple, l'ID de modèle 0xFFFFFF est renvoyé sous la forme 0x0000000000FFFFFF.
  • Get_Manufacturer_Name et Get_Model_Name doivent correspondre aux valeurs fournies dans la console.
  • Get_Accessory_Category peut renvoyer la valeur générique "Location Tracker" si aucune autre catégorie ne correspond mieux au type d'appareil.
  • Get_Accessory_Capabilities doit indiquer la compatibilité avec la sonnerie et la recherche d'identifiants BLE.
  • Get_Network_ID doit renvoyer l'identifiant de Google (0x02).
• Consignes pour implémenter le code d'opération Get_Identifier :
  • L'opération ne doit renvoyer une réponse valide que pendant cinq minutes après que l'utilisateur a activé le mode "identification", ce qui nécessite une combinaison d'appuis sur des boutons. Un signal visuel ou audio doit indiquer à l'utilisateur que le fournisseur est passé en mode. Les instructions spécifiques au modèle pour activer ce mode doivent être fournies à Google pour la certification et au moins 10 jours avant toute mise à jour ou modification des instructions.
  • La réponse est constituée des 10 premiers octets de l'identifiant éphémère actuel, suivis des 8 premiers octets de HMAC-SHA256(recovery key, the truncated current ephemeral identifier).
• Consignes d'implémentation de l'identifiant via NFC :
  • En tant qu'URL, utilisez find-my.googleapis.com/lookup.
  • Pour le paramètre e, utilisez la même réponse que celle créée pour Get_Identifier, encodé en hexadécimal.
  • Pour le paramètre pid, utilisez la même réponse que celle créée pour Get_Product_Data, encodé en hexadécimal.
• Consignes d'implémentation de l'opcode Sound_Start :
  • La commande doit déclencher la sonnerie dans tous les composants disponibles.
  • Le volume maximal accepté doit être utilisé.
  • La durée recommandée pour la sonnerie est de 12 secondes.
• Les tags de localisation doivent inclure un mécanisme permettant aux utilisateurs d'arrêter temporairement la publicité sans rétablir la configuration d'usine de l'appareil (par exemple, en appuyant sur une combinaison de boutons).
  • Les instructions de désactivation doivent être documentées dans une URL accessible au public et fournies à Google comme exigence de certification et au moins 10 jours avant toute mise à jour ou modification des instructions.
  • L'URL doit être compatible avec la localisation. En fonction du client, la langue est fournie soit sous la forme d'un paramètre de requête ("hl=en"), soit à l'aide de l'en-tête HTTP "accept-language".

Consignes concernant les protocoles commutables

• Un seul protocole doit être utilisé à la fois. Assurez-vous qu'un seul réseau ne peut fonctionner simultanément sur l'appareil. Cette exigence est nécessaire pour s'assurer qu'il n'y a pas de mélange de données utilisateur sensibles entre différents protocoles.
• Il est recommandé d'intégrer un workflow de réinitialisation matérielle à l'appareil, qui permet à un utilisateur de reconfigurer un appareil avec un autre réseau.
• Le processus de mise à jour d'un appareil sur un réseau doit être convivial et équitable entre les réseaux. Un utilisateur doit pouvoir choisir le réseau qu'il souhaite utiliser sans donner la préférence à l'un des réseaux. Ce flux doit être approuvé par l'équipe Google.

Mises à jour du micrologiciel

Le processus et la distribution des mises à jour OTA doivent être gérés par le partenaire à l'aide de son propre workflow d'application mobile ou Web.

Compatibilité

Le réseau Localiser mon appareil nécessite l'activation des services de localisation et de la connexion Bluetooth. Nécessite une connexion au réseau mobile ou à Internet. Fonctionne sous Android 9 ou version ultérieure, dans certains pays et pour les utilisateurs à partir d'un certain âge.

Journal des modifications

Version FMDN	Date	Commentaire
v1		Version initiale de la spécification FMDN en accès anticipé.
v1.1	Feb 2023	Ajout d'une indication en texte clair du mode de protection contre le suivi indésirable. Ajout d'une option permettant d'ignorer l'authentification des requêtes de sonnerie en mode Protection contre le suivi indésirable.
v1.2	Avr. 2023	Mise à jour de la définition de la liste de contrôle d'accès d'un propriétaire. Ajout d'une recommandation pour la récupération en cas de perte de courant dans les balises de localisation. Ajout d'une clarification concernant la randomisation des adresses MAC. Clarification concernant la rotation des adresses MAC en mode Protection contre le suivi indésirable. Ajout d'une consigne concernant la possibilité de désactiver une balise de localisation.
v1.3	Déc. 2023	Ajout d'une clarification sur les informations d'identification exposées par les balises de localisation. Ajout d'une exigence pour implémenter les spécifications de prévention du suivi indésirable. Ajout de consignes pour les appareils de protocole commutables.