Zurück zu den Anleitungen

WLAN-Tag unter Android schreiben: Der WSC-Record erklärt

Ein WLAN-NFC-Tag besteht aus einem einzigen NDEF-MIME-Record vom Typ application/vnd.wfa.wsc. Hier erfährst du, was darin steckt, wie Android ihn aufbaut und worauf du achten solltest.

Veröffentlicht

Einleitung

Ein WLAN-Tag für Android ist ein einzelner NDEF-Record mit dem MIME-Typ application/vnd.wfa.wsc. Darin stecken Netzwerkname, Sicherheitstyp und Passwort, verpackt im Format Wi-Fi Simple Configuration (WSC). Hier erfährst du, was dieser Record enthält, wie Android ihn aufbaut und wo er nicht mehr funktioniert.

Was der Record application/vnd.wfa.wsc ist

Der WSC-Record ist ein NDEF-MIME-Record, und seine Nutzdaten sind kein Text. Es ist eine Folge von Tag/Wert-Einträgen. Ein Hobbybastler, der das Tag mit einem PN532-Reader von Hand gebaut hat, beschrieb es so: "not a simple one (i.e. some implicit lengths)". Deshalb überlassen die meisten das Kodieren einer App oder Bibliothek.

Die Spezifikation beschreibt drei Einsatzarten des Formats: Password Token, Configuration Token und Connection Handover. Ein Tag, das du an die Wand klebst, ist ein Configuration Token. Es übermittelt Zugangsdaten vom Registrar eines Netzwerks an ein Gerät, das beitreten möchte, sodass sich das Smartphone direkt verbinden kann.

Was im Credential steckt

Alles, was das Smartphone braucht, liegt in einem einzigen Credential-Block. Laut der ndeflib-Dokumentation zum WSC-Format sind diese Felder Pflicht:

FeldWas es enthält
Network IndexVeraltet, aus Gründen der Abwärtskompatibilität immer 1
SSIDDer Netzwerkname
Authentication TypeWie Geräte nachweisen, dass sie beitreten dürfen
Encryption TypeDas verwendete Verschlüsselungsverfahren
Network KeyDas Passwort
MAC AddressDie Adresse des Enrollees oder eine Broadcast-Adresse

Ein Vendor-Extension-Block ist optional. Das gilt auch für zusätzliche WSC-Einträge.

Die Typfelder sind Bit-Flags. Die Werte sind gut zu kennen, falls du einmal einen Hex-Dump liest:

EinstellungWert
Offen0x0001
WPA2-Personal0x0020
WPA und WPA2 gemischt (ab Version 2.0)0x0022
Verschlüsselung: keine0x0001
Verschlüsselung: AES0x0008
Verschlüsselung: TKIP und AES gemischt0x000C

WEP und reines TKIP sind in derselben Dokumentation als veraltet markiert. Ein vollständiger Configuration Token im ndeflib-Beispiel wird zu 139 Oktetten kodiert. Prüfe also die NDEF-Kapazität deines Tags, bevor du schreibst.

Wie Android den Record aufbaut und liest

Der NFC-Grundlagenleitfaden von Android besagt, dass NDEF-Daten in einer Nachricht liegen, die einen oder mehrere Records enthält, und dass jeder Record für seinen Typ wohlgeformt sein muss. Seit Android 4.1 (API-Level 16) gibt es NdefRecord.createMime(), damit du MIME-Records nicht von Hand zusammensetzen musst. Google empfiehlt, wo immer möglich diesen Helfer zu verwenden, um Fehler zu vermeiden.

Der MIME-Typ macht das Tag erst nützlich. Das Tag-Dispatch-System von Android ordnet den Typ eines TNF_MIME_MEDIA-Records einem ACTION_NDEF_DISCOVERED-Intent zu, dem Intent mit der höchsten Priorität. Bei einem WLAN-Tag ist dieser Typ application/vnd.wfa.wsc. Laut Dokumentation sollte außerdem der Record, auf den reagiert werden soll, der erste Record in der geschriebenen Nachricht sein. Setze den WLAN-Record also an den Anfang und vergrabe ihn nicht hinter einer URL.

Die Android-Dokumentation zeigt kein WLAN-Beispiel, daher ist das Byte-Layout Aufgabe des Encoders, den du verwendest. Wenn du selbst einen schreibst, teste ihn mit einem Tag, das eine bewährte App geschrieben hat.

Bevor du eines schreibst

Der Configuration Token enthält unverschlüsselte Zugangsdaten. Jeder, der das Tag antippen oder mit einer beliebigen NFC-Reader-App auslesen kann, sieht das Passwort. Nutze das Tag für ein Gastnetzwerk, niemals für dein Hauptnetz, und ändere das Passwort, wenn ein Tag verloren geht. Das ist auch die sinnvolle Einrichtung für ein WLAN-Willkommens-Tag in einer Ferienwohnung.

Beschreibe nur Tags für Netzwerke, die dir gehören oder die du verwaltest. So einfach ist das.

Was passiert, wenn ein iPhone es antippt

Ein iPhone verhält sich anders. In Apples Dokumentation zum Lesen von Tags im Hintergrund steht, dass das System die NDEF-Nachricht auf einen URI-Record prüft, einen Well-known-Typ U. Danach werden die unterstützten URL-Schemata aufgelistet, etwa Weblinks, E-Mail, Telefon und SMS. WLAN-Credential-Records stehen nicht auf der Seite.

Der Bastler von oben testete sein Tag und berichtete, dass es "does not work on an iPhone". Die Details findest du in Warum ein iPhone sich mit demselben Tag nicht automatisch ins WLAN einwählt. Wenn deine Gäste beide Arten von Smartphones nutzen, lege neben das Tag einen WLAN-QR-Code, wie in NFC vs. QR-Code beschrieben.

Fazit

Ein WLAN-Tag ist ein einzelner MIME-Record mit einem kompakten, unverschlüsselten Credential-Block. Das Tag-Dispatch von Android leitet ihn anhand des MIME-Typs weiter, iPhones reagieren nicht darauf. Zum Ausprobieren schreibst du ein Tag mit NFCore auf dem iPhone oder auf Android und liest es danach wieder aus, um Record-Typ und Nutzdaten zu sehen.

Häufig gestellte Fragen

Welchen MIME-Typ verwendet ein WLAN-NFC-Tag?

Es verwendet application/vnd.wfa.wsc, einen NDEF-MIME-Record, der Wi-Fi-Simple-Configuration-Daten enthält.

Ist das WLAN-Passwort auf dem Tag verschlüsselt?

Nein. Ein Configuration Token enthält unverschlüsselte Zugangsdaten, daher kann jeder, der das Tag lesen kann, auch das Passwort lesen. Nutze ein Gastnetzwerk.

Kann ich den WSC-Record von Hand schreiben?

Das geht, aber die Nutzdaten bestehen aus Type-Length-Value-Einträgen mit impliziten Längen. Nutze besser eine Bibliothek oder eine App, die ihn für dich aufbaut.

Funktioniert das Tag auf einem iPhone?

Nicht als WLAN-Beitritt. Das Lesen von Tags im Hintergrund sucht nach einem URI-Record, und ein Tag mit WSC-Record funktionierte laut Bericht auf einem iPhone nicht.