What is Matter and what's the QR for?

Matter is the cross-vendor smart-home standard from the Connectivity Standards Alliance (CSA, formerly Zigbee Alliance), with founding backing from Apple, Google, Amazon, Samsung, and a long list of device makers. A Matter device works with any Matter-capable hub regardless of brand: an iPhone in HomeKit, a Google Nest Hub, an Amazon Echo, a Samsung SmartThings hub. The QR on the back of the device (or in the box, or on the rating label) is the onboarding code. Your phone's smart-home app scans it and the device gets commissioned into your Matter fabric, assigned an operational credential, joined to your network, and made addressable by every other Matter controller you have.

What's encoded inside the QR?

A Matter onboarding QR uses the MT: URI scheme followed by a Base38-encoded payload. Decoded, the payload contains: version (3 bits), vendor ID (16 bits, CSA-assigned per manufacturer), product ID (16 bits, manufacturer-assigned per model), custom-flow indicator (2 bits), discovery capabilities (8 bits: BLE / IP / soft AP / Wi-Fi PAF), discriminator (12 bits, used during discovery to disambiguate multiple unpaired devices), and a 27-bit passcode (the secret used in the PASE, Password-Authenticated Session Establishment, handshake). Optional TLV fields can extend the payload with serial numbers and rendezvous information.

Is it dangerous if someone photographs my Matter QR?

It depends on whether the device is already commissioned. Before commissioning: yes, somewhat. Whoever has the QR plus physical proximity (BLE range, or on the same Wi-Fi/Thread network) can commission the device into THEIR Matter fabric, locking you out until you factory-reset it. After commissioning: no. The QR's passcode is only used during the initial PASE handshake; once the device is paired, it's burned and the device only accepts operational credentials issued by your fabric. So the safe practice is: peel off and store the QR sticker before letting strangers (movers, repair people, AirBnB guests) into the home, or commission the device IMMEDIATELY when it's unboxed so the window is short.

How is a Matter QR different from a Wi-Fi QR?

Different layer, different purpose. A Wi-Fi QR (WIFI: scheme) tells your phone to join a specific Wi-Fi network, SSID, security type, password. A Matter QR (MT: scheme) tells your smart-home app to add a specific device to your home, vendor, model, discriminator, pairing passcode. The Matter device will then independently join Wi-Fi or Thread using credentials your hub passes to it during commissioning. They serve different layers of the same setup flow.

What about Thread Border Routers and Matter-over-Thread devices?

Many Matter devices (door locks, contact sensors, motion sensors, low-power bulbs) use Thread as their network instead of Wi-Fi. Thread is a low-power mesh radio. The Matter onboarding QR is the same regardless, vendor / product / discriminator / passcode. The commissioning hub (your Apple TV, Google Hub, Echo Hub) acts as a Thread Border Router, joining the device to your Thread network and exposing it on your Matter fabric so it's addressable from any controller in the home.

Normes · Mise en service d'appareils Matter

Codes QR de mise en service d'appareils Matter

Lorsque vous scannez le QR au dos d'une ampoule connectée, d'une prise connectée, d'un capteur de contact ou d'une serrure portant le logo Matter, votre téléphone exécute une poignée de main en cinq étapes qui ajoute l'appareil à votre domicile. Le QR transporte tout ce dont votre hub a besoin pour trouver cet appareil précis, le fournisseur, le modèle, un discriminateur par appareil et un code d'appairage à usage unique, ainsi qu'une liste des moyens d'atteindre l'appareil sur les ondes (BLE, Wi-Fi, Thread). Voici ce qui est encodé, ce qui fuite, et pourquoi le QR compte d'une manière que les QR Wi-Fi n'ont pas.

Inspecter un QR Matter → Toutes les normes →

Quelle est la norme

Matter est publié par la Connectivity Standards Alliance (CSA), anciennement Zigbee Alliance, avec le soutien fondateur d'Apple, Google, Amazon, Samsung, Comcast et une longue liste de fabricants d'appareils. Matter 1.0 est sorti en octobre 2022 ; Matter 1.4 est la version actuelle début 2026, avec l'ajout depuis la 1.0 des caméras, de la gestion de l'énergie, des chargeurs de véhicules électriques et des appareils de gestion de l'eau. La spécification couvre le protocole de la couche applicative, la sécurité, la mise en service et le format d'intégration par QR.

Le format du QR d'appairage fait partie de la Matter Core Specification, section « Onboarding Payload ». Il existe trois formes de la même charge utile :

Code QR avec le préfixe MT: suivi d'un blob encodé en Base38. C'est ce que la plupart des applications préfèrent parce que c'est plus rapide.
Code d'appairage manuel, une chaîne numérique à 11 chiffres pour les cas où le QR est endommagé ou l'appareil trop petit pour un QR. Vous pouvez le saisir.
Étiquette NFC portant la même charge utile Base38. Moins courante sur les appareils grand public, mais de plus en plus utilisée sur les serrures connectées où l'appairage par contact est plus ergonomique.

Les trois encodent les mêmes champs avec le même modèle de confiance, ils sont interchangeables du point de vue de la mise en service.

Ce qu'il y a réellement dans le QR

La charge utile Base38 qui suit le préfixe MT: se décode en une structure binaire compacte. Les champs obligatoires :

Version (3 bits)

Toujours 0 pour les appareils actuels. Réservé aux futures révisions du protocole.

ID de fournisseur (16 bits)

Identifiant attribué par la CSA au fabricant. Chaque organisation membre reçoit un identifiant de fournisseur unique ; 0xFFF1–0xFFF4 sont réservés aux tests / au développement. Notre scanner résout l'identifiant de fournisseur dans le registre de la CSA lorsqu'il est connu.

ID de produit (16 bits)

Identifiant attribué par le fabricant au modèle spécifique. Combiné à l'identifiant de fournisseur, il identifie de manière unique une référence (par exemple « Eve Energy 2e génération »).

Flux personnalisé (2 bits)

0 = mise en service standard (il suffit d'appairer), 1 = action de l'utilisateur requise (par exemple, appuyer d'abord sur un bouton de l'appareil), 2 = flux personnalisé (étapes de configuration spécifiques au fabricant). Détermine l'interface qu'affiche l'application de votre hub.

Capacités de découverte (8 bits)

Un masque de bits indiquant comment l'appareil peut être découvert dans son état non mis en service : BLE (le plus courant), IP sur le réseau (déjà sur votre Wi-Fi ou Ethernet, rare pour le matériel grand public), Soft-AP (l'appareil héberge un réseau Wi-Fi temporaire), Wi-Fi PAF (découverte par Public Action Frame, plus récente).

Discriminateur (12 bits)

Un court identifiant que l'appareil diffuse lors de la découverte afin que votre hub puisse choisir le bon appareil non mis en service lorsque plusieurs sont à portée BLE. Non secret, c'est le signal « c'est celui que je viens de déballer ».

Code d'accès (27 bits)

Le secret partagé utilisé dans la poignée de main PASE. Le téléphone prouve à l'appareil qu'il possède ce code d'accès sans l'envoyer en clair sur les ondes. Une fois la mise en service terminée, le code d'accès n'est plus utile. Plage : de 1 à 99 999 998 (certaines valeurs sont interdites par la spécification afin d'éviter les codes trivialement devinables comme 11111111).

Extension TLV (facultative, variable)

Des champs facultatifs peuvent étendre la charge utile avec le numéro de série de l'appareil, les informations de rendez-vous et d'autres attributs spécifiés par le fabricant. La plupart des appareils grand public l'omettent.

La poignée de main de mise en service (pourquoi la conception du code d'accès compte)

Le flux de mise en service de Matter est PASE → CASE :

Découverte. Votre téléphone diffuse des balayages BLE (ou écoute sur le Wi-Fi local) ; l'appareil non mis en service se signale avec son discriminateur. Votre téléphone fait correspondre le discriminateur du QR.
PASE, établissement de session authentifié par mot de passe. Le téléphone et l'appareil exécutent une poignée de main SPAKE2+ à l'aide du code d'accès de 27 bits. Une fois SPAKE2+ terminé, les deux parties disposent d'une clé de session partagée, et le code d'accès lui-même n'a jamais transité sur les ondes.
Attestation. L'appareil présente un certificat d'attestation d'appareil (DAC) signé par une racine reconnue par la CSA. Votre hub vérifie qu'il s'agit d'un véritable appareil Matter certifié avec l'identifiant de fournisseur/produit déclaré.
Identifiants réseau. Votre hub transmet à l'appareil les identifiants du réseau opérationnel (mot de passe Wi-Fi OU identifiants du réseau Thread) nécessaires pour communiquer réellement.
CASE, établissement de session authentifié par certificat. Votre réseau délivre à l'appareil un certificat opérationnel. À partir de là, chaque contrôleur du réseau s'authentifie auprès de l'appareil via CASE ; le code d'accès du QR est mort.

La propriété clé : le code d'accès du QR est une authentification éphémère, pas une identité à long terme. Une fois un appareil mis en service, jetez l'autocollant du QR dans un tiroir (ou décollez-le et déchiquetez-le). La remise en service nécessite soit un accès physique pour réinitialiser l'appareil en usine, SOIT la coopération du réseau existant pour ouvrir une nouvelle fenêtre de mise en service.

Modèle de menace : photographier le QR d'un appareil non appairé

Particularité de Matter, le QR est opérationnellement significatif AVANT la mise en service. À comparer aux autres catégories :

Un QR Wi-Fi divulgue un mot de passe, mais rejoindre le réseau est une action « faible » : l'attaquant doit être physiquement à portée.
Un QR de carte d'embarquement divulgue une référence de réservation, mais l'attaquant a besoin du nom de famille du passager et d'un canal distinct.
Un QR Matter + une proximité physique (BLE / même Wi-Fi) = mise en service complète. L'attaquant peut revendiquer l'appareil dans SON réseau, vous excluant jusqu'à une réinitialisation d'usine. Pour une serrure connectée, c'est un incident grave.

Scénarios réels où cela compte :

Déménageurs, réparateurs, hôtes AirBnB ayant une ligne de vue sur des appareils déballés mais non appairés.
Retours / ventes de produits reconditionnés où un appareil est renvoyé au fabricant ou à un acheteur d'une place de marché avec l'autocollant QR intact et l'appareil non réinitialisé en usine.
Photos de boîtes d'appareils neufs publiées sur les réseaux sociaux (la publication « je viens de recevoir ma serrure Matter ! » avec le QR visible).
Installations publiques (éclairage connecté commercial, chambres d'hôtel) où le QR est fixé au luminaire et accessible à toute personne disposant du BLE.

Défense : mettez l'appareil en service dès que vous le déballez (cela ferme la fenêtre), puis décollez et déchiquetez l'autocollant. Pour les appareils déjà déployés dans des espaces partagés / publics, assurez-vous que l'appareil est mis en service sur un réseau, ce qui empêche un nouvel appairage sans réinitialisation d'usine.

Ce que notre scanner vous montre

Déposez un QR Matter (image, collage ou caméra) dans notre scanner. Le verdict affiche :

Version, actuellement toujours 0.
ID de fournisseur, et le nom du fabricant résolu lorsqu'il s'agit d'un fournisseur connu enregistré auprès de la CSA.
ID de produit, et l'indice de classe d'appareil si nous pouvons le résoudre.
Flux personnalisé, standard / action utilisateur / personnalisé.
Capacités de découverte, les radios que l'appareil accepte d'utiliser pour la découverte.
Discriminateur, l'identifiant de découverte (non secret).
Code d'accès, masqué par défaut (champ sensible révélé d'une pression). Utile pour saisir le code d'appairage manuel si votre QR n'est pas lisible, dangereux si le QR n'est pas le vôtre.

Nous ne contactons PAS votre hub et ne tentons aucune mise en service. Le décodage est local ; seules les métadonnées parviennent à notre serveur pour la classification de sécurité.

Avant de mettre en service un appareil Matter inconnu

Savez-vous qui a expédié cet appareil ? Si vous l'avez acheté d'occasion ou s'il était déjà installé à votre arrivée, faites une réinitialisation d'usine avant la mise en service. Le réseau du propriétaire précédent peut encore détenir des identifiants.
L'identifiant de fournisseur correspond-il à la marque sur la boîte ? Les appareils Matter contrefaits utilisent des identifiants de fournisseur de test (0xFFF1–0xFFF4) parce qu'une véritable adhésion à la CSA coûte de l'argent. Notre scanner signale les identifiants de fournisseur de test.
L'indicateur de flux personnalisé est-il celui que vous attendiez ? Un appareil qui exige un flux personnalisé (indicateur = 2) alors que la boîte indique « scannez pour appairer » est anormal.
Effectuez-vous la mise en service dans un lieu de confiance ? Des voisins à portée BLE peuvent rivaliser pour revendiquer un appareil non mis en service. Faites la mise en service chez vous, pas dans un café, idéalement avec le Wi-Fi désactivé et seulement le BLE actif afin que la découverte soit sans ambiguïté.
Après la mise en service, décollez et rangez l'autocollant. Le code d'accès est mort, mais le discriminateur ainsi que les informations sur le fournisseur et le produit suffisent à un attaquant pour énumérer les appareils du domicile.

À voir aussi

Inspecter un QR de mise en service Matter

Déposez le QR (image, collage ou caméra). Le verdict affiche le fournisseur, le produit, le discriminateur, les capacités et un code d'accès masqué. Nous ne communiquons pas avec votre hub et ne tentons aucune mise en service : le décodage est local et les métadonnées sont la seule chose qui parvient au classificateur de sécurité.

Ouvrir le scanner →