ガイドに戻る

AndroidでWi-Fi用NFCタグを書き込む:WSCレコードを解説

Wi-Fi用のNFCタグは、application/vnd.wfa.wsc タイプのNDEF MIMEレコード1つで構成されます。その中身、AndroidがレコードをどのO作るか、注意点を解説します。

公開日

はじめに

AndroidのWi-Fiタグは、MIMEタイプが application/vnd.wfa.wsc のNDEFレコード1つです。その中には、ネットワーク名、セキュリティの種類、パスワードがWi-Fi Simple Configuration(WSC)形式で格納されています。ここでは、このレコードに何が入っているのか、Androidがどのように作るのか、そしてどこで使えなくなるのかを説明します。

application/vnd.wfa.wsc レコードとは

WSCレコードはNDEFのMIMEレコードで、ペイロードはテキストではありません。タグと値のエントリが連なったもので、PN532リーダーを使って手作業でタグを作った愛好家は、「単純なものではない(つまり、暗黙の長さがある)」と述べています。そのため、ほとんどの人はアプリやライブラリにエンコードを任せています。

仕様では、この形式の3つの使い方が説明されています。Password Token、Configuration Token、Connection Handover です。壁に貼るタグは Configuration Token にあたります。ネットワークのレジストラから、接続したい端末へ認証情報を渡すもので、スマートフォンは直接接続できます。

認証情報の中身

スマートフォンが必要とする情報は、すべて1つの認証情報ブロックに入っています。ndeflibのWSC形式のドキュメントによると、次のフィールドが必須です。

フィールド内容
Network Index非推奨。後方互換性のため常に1
SSIDネットワーク名
Authentication Type端末が接続資格を示す方法
Encryption Type使用する暗号方式
Network Keyパスワード
MAC Address接続する端末のアドレス、またはブロードキャストアドレス

ベンダー拡張ブロックは任意です。WSCの追加エントリも同様です。

タイプのフィールドはビットフラグなので、16進ダンプを読むことがあるなら、値を知っておくと役立ちます。

設定値
オープン0x0001
WPA2-Personal0x0020
WPAとWPA2の混在(バージョン2.0以降)0x0022
暗号化:なし0x0001
暗号化:AES0x0008
暗号化:TKIPとAESの混在0x000C

同じドキュメントでは、WEPとTKIPのみの設定は非推奨とされています。ndeflibの例にある完全なConfiguration Tokenは139オクテットにエンコードされるため、書き込む前にタグのNDEF容量を確認してください。

Androidがレコードを作成・読み取る仕組み

AndroidのNFC基本ガイドによると、NDEFデータは1つ以上のレコードを含むメッセージに格納され、各レコードはそのタイプに対して正しい形式でなければなりません。Android 4.1(APIレベル16)以降は NdefRecord.createMime() があり、MIMEレコードを手作業で組み立てる必要はありません。Googleは、ミスを避けるため、可能な限りこのヘルパーを使うことを推奨しています。

タグを役立つものにするのはMIMEタイプです。Androidのタグディスパッチシステムは、TNF_MIME_MEDIA レコードのタイプを、最も優先度の高い ACTION_NDEF_DISCOVERED インテントに対応付けます。Wi-Fiタグの場合、そのタイプは application/vnd.wfa.wsc です。また、処理させたいレコードは、書き込むメッセージの先頭のレコードにする必要があるとも書かれています。Wi-Fiのレコードを先頭に置き、URLの後ろに埋もれさせないでください。

AndroidのドキュメントにはWi-Fiの例がないため、バイト配列の構成は使用するエンコーダーの役割と考えてください。自分で実装する場合は、動作が確認されているアプリで書き込んだタグと比較してテストしましょう。

書き込む前に

Configuration Tokenには暗号化されていない認証情報が入っています。タグにタッチできる人や、NFCリーダーアプリで読み取れる人なら、誰でもパスワードを見られます。タグはメインのネットワークではなく、必ずゲスト用ネットワークに使い、タグを紛失したらパスワードを変更してください。これは、民泊でのWi-Fiウェルカムタグにも適した設定です。

書き込むのは、自分が所有または管理しているネットワークのタグだけにしてください。それだけです。

iPhoneでタッチするとどうなるか

iPhoneの動作は異なります。Appleのバックグラウンドタグ読み取りのドキュメントによると、システムはNDEFメッセージの中からURIレコード(Well-knownタイプ U)を探します。そして、対応するURLスキームとして、Webリンク、メール、電話、SMSなどを挙げています。Wi-Fiの認証情報レコードはそのページに載っていません。

先ほどの愛好家は自作のタグを試し、「iPhoneでは動作しない」と報告しています。詳しくは、同じタグでiPhoneが自動接続できない理由で説明しています。お客様がどちらの種類のスマートフォンも使う場合は、NFCとQRコードの比較で紹介しているように、タグの横にWi-Fi用のQRコードも置いてください。

まとめ

Wi-FiタグはMIMEレコード1つで、コンパクトで暗号化されていない認証情報ブロックを持ちます。AndroidのタグディスパッチはMIMEタイプでこれを振り分けますが、iPhoneは反応しません。試すには、iPhoneまたはAndroidのNFCoreでタグを書き込み、読み取り直してレコードタイプとペイロードを確認してください。

よくある質問

Wi-Fi用のNFCタグはどのMIMEタイプを使いますか?

application/vnd.wfa.wsc を使います。Wi-Fi Simple Configurationのデータを運ぶNDEF MIMEレコードです。

タグ上のWi-Fiパスワードは暗号化されていますか?

いいえ。Configuration Tokenには暗号化されていない認証情報が入っているため、タグを読み取れる人なら誰でもパスワードを読み取れます。ゲスト用ネットワークを使ってください。

WSCレコードを手作業で書けますか?

可能ですが、ペイロードは暗黙の長さを持つType-Length-Valueエントリの集まりです。ライブラリや、作成してくれるアプリを使ってください。

iPhoneでもタグは動作しますか?

Wi-Fiへの接続としては動作しません。バックグラウンドタグ読み取りはURIレコードを探します。また、WSCレコードのタグはiPhoneで動作しなかったという報告があります。