WiFi QRコードの形式|スキャンで接続できる仕組み

公開ツールWiFi QRコード生成ツール

目次
  1. スキャンするだけで接続できる理由
  2. QRの中に入っている文字列: フィールドの構造
  3. ツールを使わずに自分で確認する方法
  4. 特殊文字のエスケープ: ここが一番よく壊れます
  5. ステルスネットワークとパスワードなしのネットワーク
  6. よくつまずくポイント
  7. まとめ
  8. よくある質問

カフェやオフィスの壁に貼られたQRコードをカメラで映すと、パスワードを聞かれることもなくWiFiにつながります。魔法のように見えますが、QRの中に入っているのは、決まった形式の短い文字列1行だけです。

その1行が WIFI:T:WPA;S:ネットワーク名;P:パスワード;; という形です。この記事では、各フィールドが何を意味するのか、名前やパスワードに ; や : が混ざったときに接続が壊れるのはなぜかを解説します。

まとめ ① QRの中には WIFI:T:暗号化方式;S:ネットワーク名;P:パスワード;; の1行が平文のまま入っています。 ② 名前・パスワードに \ ; , : " が含まれる場合は、その文字の前にバックスラッシュを付けます。 ③ ステルスネットワークは H:true; を追加します。フィールドの順序が変わっても意味は同じです。

スキャンするだけで接続できる理由

QRコードは絵ではなく、文字を入れる器です。中にウェブアドレスが入っていればブラウザが開き、連絡先の形式が入っていればアドレス帳への保存画面が出ます。

WiFiも同じ仕組みです。スキャナーが WIFI: で始まる文字列を見つけると、「このネットワークに接続しますか」というバナーを表示し、人の代わりに名前とパスワードを入力してくれます。

ここから重要な事実が1つ導かれます。パスワードはQRの中に平文で入っています。印刷して貼ってあるWiFi QRは、パスワードを書いた紙とセキュリティレベルが同じです。

QRの中に入っている文字列: フィールドの構造

この形式はIETF RFCのような公式標準ではなく、QRライブラリであるZXingが文書化したあと、各プラットフォームがそれに従って実装した事実上の標準です。基本形は次のとおりです。

WIFI:T:WPA;S:mynetwork;P:mypass;;

読み方は単純です。WIFI: で始まり、そのあとに キー:値; が続き、全体が ; でもう一度閉じられて、末尾が ;; になります。

キー意味例
T暗号化方式。WEP · WPA · WPA2-EAP · nopassWPA
Sネットワーク名(SSID)。必須mynetwork
Pパスワード。nopass の場合は無視されますmypass
Hステルスネットワークなら truetrue

企業向け認証(WPA2-EAP)のときだけ、E(EAP方式) · I(ID) · A(匿名ID) · PH2(第2段階方式)のフィールドが追加で使われます。家庭や店舗向けのQRには出てきません。

フィールドの順序は決まっていません。そのため、あるジェネレーターは WIFI:S:...;T:WPA; と書き、別のジェネレーターは WIFI:T:WPA;S:...; と書きますが、どちらも同じ意味です。WiFi QRコード生成ツールでは T を先に書いています。

ツールを使わずに自分で確認する方法

すでに貼ってあるQRの原文を読む

カメラの標準アプリで映すとすぐに接続バナーが出てしまい、原文が見えないことがあります。そんなときは、読み取ったテキストをそのまま表示するQRリーダーアプリでスキャンすると、WIFI:T:WPA;S:... の文字列が丸ごと表示されます。

接続できないときの原因を探すには、これが一番の近道です。名前が途中で切れていないか、H フィールドが抜けていないかが目で確認できます。

Androidには逆向きの機能もあります。接続中のWiFiを開いて共有を押すと、そのネットワークのQRコードが作られます。ただしメニューの位置や名前はメーカーやAndroidのバージョンによって変わるので、見当たらない場合は下記のように文字列を自分で組み立てればOKです。

文字列を手で組み立てる

新しく作るときは、上記の形式どおりに1行書けば済みます。名前が Cafe-Guest、パスワードが Example1234、WPA方式なら次のようになります。

WIFI:T:WPA;S:Cafe-Guest;P:Example1234;;

この1行をQRコードに変えれば完成です。ただし、名前やパスワードに特殊文字がある場合は下記のエスケープを自分で処理する必要があり、1文字でも間違えてもQRの見た目は正常に見えるため、間違いに気づきにくいという難点があります。

WiFi QRコード生成ツールで確認する。 名前・パスワード・暗号化方式を入力すると、QRコードと一緒に完成した文字列がそのまま画面に表示されるので、エスケープがどう適用されたかを目で照合できます。

WiFi QRコード生成ツール

インストールや会員登録なしでブラウザ内でQRを作成でき、入力したネットワーク名とパスワードはサーバーに送信されません。

特殊文字のエスケープ: ここが一番よく壊れます

; はフィールドを区切るデリミタです。そのため、ネットワーク名が Example;Cafe なのにそのまま書くと、スキャナーは名前を Example までしか読まず、後ろの Cafe を未知のフィールドとして扱ってしまいます。

ルールは1つです。次の5つの文字は前にバックスラッシュを付けます: \ ; , : "

元の値QR内に書かれる形
Example;CafeExample\;Cafe
Pass:1234Pass\:1234
a\ba\\b
"quoted"\"quoted\"

手で変換するときは順序に注意が必要です。; を先に \; に変え、そのあとバックスラッシュを \\ に変えると、たった今入れたエスケープまで再度エスケープされて値が壊れます。バックスラッシュを先に処理するか、文字列を1回だけ走査して5文字を同時に置換してください。

規格に書かれた例外も1つあります。名前やパスワードが16進数として読める文字(0~9、A~F)だけで構成されている場合 — CAFE のような名前がそれです — は、値を二重引用符で囲むよう案内されています。WiFi QRコード生成ツールはこの引用符を自動では付けず、5文字のエスケープのみを処理するため、そうした名前であれば実際の端末で一度スキャンして接続できるか確認しておくと確実です。

ステルスネットワークとパスワードなしのネットワーク

SSIDを隠したルーターは名前をブロードキャストしないため、端末は「その名前のネットワークがある」ことを前もって知ることができません。そのため、QRに H:true; を入れてステルスネットワークだと伝える必要があります。

値は正確に true でなければなりません。規格の文書には、H フィールドが古いバージョン(ZXing 4.7.8 · Barcode Scanner 3.4.0以下)でEAPの第2段階方式の指定用に誤って使われていたことがあり、真偽値以外の値が入ってくるとそちらとして解釈される、という後方互換の説明が付いています。

パスワードのないオープンネットワークは T:nopass と書き、P フィールドを省略します。WiFi QRコード生成ツールで「パスワードなし(オープン)」を選ぶとパスワード入力欄が消え、生成される文字列からも P が省かれます。

よくつまずくポイント

症状確認すること
スキャンしても接続バナーが出ないWIFI: の接頭辞と末尾の ;; があるか
名前が途中で切れて接続に失敗する; : をエスケープしたか
ステルスルーターなのに一覧で見つからないH:true; が入っているか
パスワードは合っているのに認証で弾かれるT の値が実際の暗号化方式と同じか
QRは機能するが誰でも接続できてしまう印刷物はパスワードを書いたのと同じ

規格で定義されている T の値は WEP · WPA · WPA2-EAP · nopass の4つです。WPA3専用の値はなく、WiFi QRコード生成ツールでもWPA・WPA2・WPA3を1つの項目にまとめて T:WPA と書いています。最新のルーターで問題なくつながるかは、実際の端末で一度スキャンして確認するのが一番確実です。

まとめ

  • QRの中には WIFI:T:...;S:...;P:...;; の1行が平文で入っており、スキャナーがそれを読んで代わりに接続してくれます。
  • 構造は キー:値; の繰り返しで、最後に ; がもう1つ付いて ;; で終わります。
  • \ ; , : " の5文字は前にバックスラッシュを付け、置換はバックスラッシュから処理します。
  • ステルスネットワークは H:true;、オープンなら T:nopass で P は省略します。
  • フィールドの順序は関係ないので、ジェネレーターごとに順序が違っても同じQRとして動作します。
  • パスワードが平文で入るため、来客用にはゲストネットワークを別に用意するのが安全です。
WiFi QRコード生成ツール

インストールや会員登録なしでブラウザ内でQRを作成でき、入力したネットワーク名とパスワードはサーバーに送信されません。

よくある質問

QRコードの中のパスワードは暗号化されていますか?

いいえ。P: の後にパスワードがそのまま書かれており、QRリーダーアプリで読み取れば人の目にもそのまま見えます。QR画像をメッセージアプリで送ることは、パスワードをそのまま送るのと同じだと考えてください。お客様に開放する用途であれば、ルーターのゲストネットワークを別途作成し、そのパスワードでQRコードを作るほうが安全です。

iPhoneとAndroidの両方で使えますか?

文字列の形式自体はプラットフォーム共通です。標準のカメラアプリがこの形式を認識すれば接続バナーが表示され、認識できなければ何の反応もありません。対応状況は機種やOSのバージョンによって異なるため、実際に一度かざして確認するのが確実です。認識しない場合は、QRリーダーアプリで原文を読み取り、名前とパスワードを手動で入力すれば接続できます。

パスワードを変えたらQRコードも作り直す必要がありますか?

はい。QRコードは作成時の文字列をそのまま保持した静的な画像なので、ルーターのパスワードを変えるとQRコード内の値は古い値のままです。スキャンしても認証で弾かれるため、新しい値で作り直して印刷物を差し替える必要があります。

入力したSSIDとパスワードはサーバーに送信されますか?

いいえ。QRコードの生成はすべてブラウザ内で処理され、入力したネットワーク名とパスワードがサーバーに送信されたり保存されたりすることはありません。「PNGダウンロード」も、ブラウザが生成した画像データをそのままファイルとして保存する仕組みです。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. ワードクラウドで一番大きい単語が1位でない理由ワードクラウドで最も大きく表示された単語が、実際の出現頻度1位とは限らない理由を、ストップワードの除外・文字サイズの線形な比率・配置アルゴリズムの順に解説します。手元で頻度を確認する方法も紹介します。
  2. ブレインストーミングのキーワード組み合わせ数と重複する確率2語・3語のキーワード組み合わせが何通りになるかを順列の公式で計算し、同じ組み合わせが思ったより早く出る「誕生日のパラドックス」の確率、発想を広げる5ステップのネーミング手順を解説します。
  3. 名刺サイズの国別規格まとめ|px換算の公式も解説韓国90×50mm、米国89×51mm、日本91×55mmなど国ごとに異なる名刺サイズを一覧で比較。ISO/IEC 7810 ID-1との関係や、mmからpxへの換算公式、ブラウザで名刺画像を作る方法まで解説します。
  4. cron式の読み方 5フィールドの順序と記号、日と曜日の注意点cron式は分・時・日・月・曜日の5フィールドで順序が固定です。各記号の読み方と、日と曜日を同時に指定したときORで解釈される落とし穴を整理しました。
  5. cron式の読み方:5フィールドで実行日時を判断cron式の5つのフィールドが「*」や範囲・リスト・間隔の各記法で何に一致するのか、曜日の0と7がどちらも日曜日になる理由、日と曜日を同時に指定したときにORで判定される仕組みを例で確認できます。
  6. EAN-13チェックデジットの計算方法と880の意味EAN-13の13桁目は、前12桁から計算するチェックデジットです。1と3を掛けて手計算で検算する手順と、先頭880が原産地ではなく番号を発行したGS1の会員機関を示すことを整理しました。

関連ツール