Retour aux guides

Écrire un tag Wi-Fi sur Android : l'enregistrement WSC expliqué

Un tag NFC Wi-Fi est un unique enregistrement MIME NDEF de type application/vnd.wfa.wsc. Voici ce qu'il contient, comment Android le construit et les points de vigilance.

Publié

Introduction

Un tag Wi-Fi Android est un enregistrement NDEF unique de type MIME application/vnd.wfa.wsc. À l'intérieur se trouvent le nom de votre réseau, le type de sécurité et le mot de passe, regroupés dans le format Wi-Fi Simple Configuration (WSC). Voici ce que contient cet enregistrement, comment Android le construit et où il cesse de fonctionner.

Qu'est-ce que l'enregistrement application/vnd.wfa.wsc

L'enregistrement WSC est un enregistrement MIME NDEF, et sa charge utile n'est pas du texte. C'est une suite d'entrées balise/valeur et, comme l'a résumé un bricoleur qui a construit le tag à la main avec un lecteur PN532, « not a simple one (i.e. some implicit lengths) ». La plupart des gens laissent donc une application ou une bibliothèque l'encoder.

La spécification décrit trois façons d'utiliser le format : un Password Token, un Configuration Token et un Connection Handover. Un tag que vous collez sur un mur est un Configuration Token. Il transmet les identifiants d'un registrar du réseau à un appareil qui veut le rejoindre, afin que le téléphone se connecte directement.

Ce que contient l'identifiant

Tout ce dont le téléphone a besoin se trouve dans un seul bloc d'identifiants. D'après la documentation ndeflib du format WSC, ces champs sont obligatoires :

ChampCe qu'il contient
Network IndexObsolète, toujours 1 pour la rétrocompatibilité
SSIDLe nom du réseau
Authentication TypeLa manière dont les appareils prouvent qu'ils peuvent se connecter
Encryption TypeLe chiffrement utilisé
Network KeyLe mot de passe
MAC AddressL'adresse de l'appareil qui rejoint le réseau, ou une adresse de diffusion

Un bloc d'extension constructeur est facultatif. Les entrées WSC supplémentaires le sont aussi.

Les champs de type sont des indicateurs binaires (bit flags), il est donc utile d'en connaître les valeurs si vous lisez un jour un dump hexadécimal :

RéglageValeur
Ouvert0x0001
WPA2-Personal0x0020
WPA et WPA2 mixtes (version 2.0 et ultérieures)0x0022
Chiffrement : aucun0x0001
Chiffrement : AES0x0008
Chiffrement : TKIP et AES mixtes0x000C

WEP et TKIP seul sont signalés comme obsolètes dans la même documentation. Un Configuration Token complet, dans l'exemple de ndeflib, est encodé sur 139 octets : vérifiez donc la capacité NDEF de votre tag avant d'écrire.

Comment Android construit et lit l'enregistrement

Le guide des bases du NFC d'Android indique que les données NDEF sont contenues dans un message comportant un ou plusieurs enregistrements, et que chaque enregistrement doit être bien formé pour son type. Depuis Android 4.1 (API level 16), NdefRecord.createMime() existe pour que vous n'ayez pas à assembler les enregistrements MIME à la main. Google recommande d'utiliser cette fonction auxiliaire dès que possible pour éviter les erreurs.

Le type MIME est ce qui rend le tag utile. Le système de distribution des tags d'Android associe le type d'un enregistrement TNF_MIME_MEDIA à un intent ACTION_NDEF_DISCOVERED, qui est l'intent de plus haute priorité. Pour un tag Wi-Fi, ce type est application/vnd.wfa.wsc. La documentation précise aussi que l'enregistrement sur lequel vous voulez agir doit être le premier du message que vous écrivez : gardez donc l'enregistrement Wi-Fi en premier et ne le placez pas derrière une URL.

La documentation Android ne détaille pas d'exemple Wi-Fi, considérez donc la disposition des octets comme le travail de l'encodeur que vous utilisez. Si vous écrivez le vôtre, testez-le avec un tag écrit par une application éprouvée.

Avant d'en écrire un

Le Configuration Token contient des identifiants non chiffrés. Toute personne qui peut toucher le tag, ou le lire avec n'importe quelle application de lecture NFC, peut voir le mot de passe. Placez le tag sur un réseau invité, jamais sur votre réseau principal, et changez le mot de passe si un tag disparaît. C'est aussi la configuration raisonnable pour un tag Wi-Fi d'accueil dans une location.

N'écrivez des tags que pour des réseaux qui vous appartiennent ou que vous gérez. C'est aussi simple que cela.

Que se passe-t-il quand un iPhone le touche

Un iPhone se comporte différemment. La documentation Apple sur la lecture de tags en arrière-plan indique que le système inspecte le message NDEF à la recherche d'un enregistrement URI, de type bien connu U. Elle énumère ensuite les schémas d'URL pris en charge, comme les liens web, l'e-mail, le téléphone et les SMS. Les enregistrements d'identifiants Wi-Fi ne figurent pas sur la page.

Le bricoleur cité plus haut a testé son tag et a indiqué qu'il « does not work on an iPhone ». Nous détaillons cela dans pourquoi un iPhone ne se connecte pas automatiquement avec le même tag. Si vos invités ont les deux types de téléphones, ajoutez un QR code Wi-Fi à côté du tag, comme expliqué dans NFC ou QR code.

Conclusion

Un tag Wi-Fi est un unique enregistrement MIME avec un bloc d'identifiants compact et non chiffré. La distribution des tags d'Android l'oriente selon le type MIME, et les iPhone n'y réagissent pas. Pour essayer, écrivez un tag avec NFCore sur iPhone ou Android, puis scannez-le à nouveau pour voir le type d'enregistrement et la charge utile.

Foire aux questions

Quel type MIME utilise un tag NFC Wi-Fi ?

Il utilise application/vnd.wfa.wsc, un enregistrement MIME NDEF qui transporte des données Wi-Fi Simple Configuration.

Le mot de passe Wi-Fi est-il chiffré sur le tag ?

Non. Un Configuration Token contient des identifiants non chiffrés : toute personne pouvant lire le tag peut lire le mot de passe. Utilisez un réseau invité.

Puis-je écrire l'enregistrement WSC à la main ?

Vous le pouvez, mais la charge utile est un ensemble d'entrées type-longueur-valeur avec des longueurs implicites. Utilisez une bibliothèque ou une application qui le construit pour vous.

Le tag fonctionnera-t-il sur un iPhone ?

Pas pour se connecter au Wi-Fi. La lecture de tags en arrière-plan recherche un enregistrement URI, et un tag avec un enregistrement WSC a été signalé comme ne fonctionnant pas sur un iPhone.