仕様書

意味

[106] User-Agent: や navigator.userAgent は、次のような目的で用いられています。

[120] 既定User-Agent値 (default `User-Agent` value) は、 User-Agent: ヘッダーに使う利用者エージェント定義の値です >>119。 この値は HTTP-network-or-cache fetch で User-Agent: ヘッダーに設定されるほか、 navigator.userAgent でも使われます。

HTTP

[46] HTTP では User-Agent: ヘッダーの値として利用者エージェントの識別情報を記述できます。

JavaScript

[51] 利用者エージェントは、 navigator互換性モード (navigator compatibility mode) を持ちます。 Chrome、Gecko、WebKit のいずれかです。 >>29

[35] Navigator オブジェクトには次のメンバー (特記がない限りIDL属性) があります。 これらは仕様書上は NavigatorID インターフェイス (NoInterfaceObject) と呼ばれています。 >>29

[86] navigator.appVersion は、 Web互換性と fingerprinting 防止のため、 次の値を返すべきです。

[85] navigator.platform は、 Web互換性と fingerprinting 防止のため、 次の値を返すべきです。

[66] navigator.platform が Windows であるかどうかは、 endings の挙動に影響します。

[97] navigator.oscpu は、 Web互換性と fingerprinting 防止のため、 次の値を返すべきです。

利用者エージェント値の命名規則

[55] スマートフォン (タブレットを含みません。) として動作する利用者エージェントは、 値に Mobile が含まれることが期待されてます >>79。

[53] テレビとして動作する利用者エージェントは、 値に TV が含まれることが期待されています >>122。

[103] Web互換性のため利用者エージェントは Webブラウザーであるか否かに関わらず 「Webブラウザーらしい」 利用者エージェント値を使わなければなりません。

[105] 一方で利用者エージェント値が Webブラウザーかどうかで場合分けするサーバーも存在するため、 そのすべての機能を利用するためには、 「Webブラウザーらし」くない利用者エージェント値を使うこともできなければなりません。

• [20] Mozilla での UA 名の指針
  • [32] user-agent string
    • http://www.mozilla.org/build/revised-user-agent-strings.html (原文)
    • http://jt.mozilla.gr.jp/build/revised-user-agent-strings.html (和訳)
• [21] J-Sky Web/技術資料 ユーザーエージェントについて http://www.dp.j-phone.com/jsky/user.html
• [22] iモード対応HTMLの考え方 http://www.nttdocomo.co.jp/mc-user/i/tag/s2.html
• [23] NTT東日本:Lモード http://www.ntt-east.co.jp/Lmode/06_contents/02_tsukuri.html から入手できる技術条件説明書 http://www.ntt-east.co.jp/Lmode/06_contents/pdf/cp_gijutsu2_2.exe
• [24] Monazilla http://members.jcom.home.ne.jp/monazilla/document/oyster_subjecttxt.html
• [25] DOLIB 1.00 http://kage.monazilla.org/system_DOLIB100.html
• [60] au 技術情報 http://www.au.kddi.com/ezfactory/tec/spec/4_4.html

[64] 端末属性通知プロトコルの標準提案 (2002-09-05 20:59:22 +09:00 版) http://www.mcf.to/eia/news/0909protocol.html

User-Agent: 欄詐称問題

[36] HTTP 要求頭欄の User-Agent: では、伝統的に Mozilla を名乗る人達が多いです。

• [37] User-Agent: Mozilla/4.0 (compatible; ・・・)

のように compatible と名乗るのはまだ良い方で、 Mozilla と区別出来ない UA を送りつける UA もいます。

[28] >>36 最近でも使われてるブラウザーでいうと、 BBB が Mozilla/2 を名乗るけど compatible を含めないとか。

[38] かつて Mozilla が市場独占に近い状態だった (ほんとか?) 頃に、 UA: を見て Mozilla と非 Mozilla で処理を分けていたサーバーが少なくなかったんで、 非 Mozilla UA がこれに対抗するため Mozilla を名乗ったという伝説が ありますが、真偽は定かじゃありません。知ってたら教えて下さい。

[39] ReGet とか IRIA とか wget とかの download 専門家達は一部サーバー管理者から 迫害されているので、 UA: を見て締め出されていて、それに対抗するために 詐称機能 (というか、 UA: を自由に設定できる機能) があります。 昔は既定値が Mozilla とかだったりすることも少なくなかったみたいですが、 最近はちゃんと自分の名前を名乗ってるっぽいです。

• [41] ちなみに、 WinIE1 はちゃんと Microsoft Internet Explorer と名乗っていました。 Mozilla compatible と詐称するようになったのは 2 からです。
• [42] Mac関連ネタを凄い勢いで翻訳スレ2 http://pc.2ch.net/test/read.cgi/mac/1035938842/347-351 Safari の Gecko 詐称についての開発者の釈明 (の和訳) あり

UA sniffing

[47] Webブラウザーには不具合や制約があって、 著者がスクリプトからWebブラウザーを判定して対処せざるを得ないことがあります >>29。

[48] そのような判定は、既知の現在の版を判定するものとするべきです。 将来の版や未知の版は、仕様書に適合するものと仮定するべきです。 >>29

[49] この情報は、 fingerprinting vector です。 利用者エージェントは、できるだけ少ない情報にとどめることが強く望まれています (strongly urged) 。 >>29

[50] 実際のところ、規格違反の文字列を使う例や詐称により実際の情報が注釈内に押し込まれている例が多すぎることから、仕様に基づいた parser を作って前半(名前)・後半(版)を見て処理を云々というのは現実的でなく、そうした処理をする多くの実装 (CGI script やサーバーなど。) は正規表現を使って処理しています。確かにこれが最も現実的な方法でしょう。

[57] ブラウザ判別では"Gecko"を調べてください - Web標準普及プロジェクト http://www.mozilla.gr.jp/standards/webtips1005.html

[58] RFC2936 HTTP MIME 型取扱器判別

[34] 機能の有無の判定には、 UA sniffing を使うべきではありません。 近年導入されたほとんどの機能には、それぞれの機能の判定方法が用意されています。 特定の Webブラウザーであるかどうかではなく、特定の機能が利用可能かどうかを判定するべきです。

[127] 版番号検知の失敗事案: バージョニングの失敗, 年問題

[129] Opera 10は「Opera 1」に間違えられる? | スラド IT, 2024-01-25T08:07:53.000Z https://it.srad.jp/story/08/12/26/0047250/

利用者エージェント名の一覧

[20] HTTP で User-Agent:欄に実際に使われている名前についての 情報源:

• [21] http://www.dais.is.tohoku.ac.jp/logs/agentgripes.html
• [22] IW:YukiWiki:UserAgent
• [23] http://inhand.jp/index.cgi?action=viewnews&id=99
• [5] WikiUserAgentList
• [6] :: 偽られたUA :: http://pc3.2ch.net/test/read.cgi/hp/1015925179/
• [7] あなたの User-Agent 教えてください http://pc.2ch.net/test/read.cgi/php/990173593/
• [8] User-Agent統計 http://www2.startshop.co.jp/~68user/cgi-bin/view-browser.cgi
• [9] 偽装UAを熱烈に募集し、まとめてみたページ http://members.tripod.co.jp/g_ua/
• [10] NN 1.22 = Mozilla/1.22 (Windows; I; 32bit)

[11] HTTP じゃないですけど、最近の Mew はこんなのをつけるらしいです。

 User-Agent: Mew/3.1.53 Emacs/21.2.93 (i386-mingw-nt4.0.1381) Mule/5.0
  =?iso-2022-jp?B?KBskQjgtTFobKEIp?= Meadow/1.99 Alpha4
  =?iso-2022-jp?B?KBskQkU0GyhCKQ==?=

設定次第, かもしれません。 Kazu さんのは従来通り X-Mailer: だし。

で、この例のように encoded-word を生で使っていると、例えば "=" は tspecials ですから、 HTTP や usefor-article の構文に照らして不当です。

もっとも、現時点で電子メイルにおける User-Agent: 欄の定義は存在しない以上, 非構造欄だとか, そうでなくても tspecials も使えるんだとか, そういう主張はできなくもないですが。

• [12] Comments on AgentGripes http://web.archive.org/web/20011019120517/http://www.dais.is.tohoku.ac.jp/logs/comment.html#reqheaader
• [13] UA じゃなくて Server: の方ですが、 Zope の例: Server: Zope/(Zope 2.5.1 (source release, python 2.1, linux2), python 2.1.3, freebsd4) ZServer/1.1b1。面白い例でしょ? 文法違反だけど。
• [14] なんと、 IW:Google:"UserAgent 一覧" (日本語) でIW:YukiWiki:UserAgent を6位に抑えて 3位!
• [31] 2003-08-29 11:48:17 +00:00 >>14: ほんとだ! すごいじゃん。内容ないのに(w
• [16] WWW Agents List http://www.kmc.gr.jp/~ranran/tips/www-agents.html

• [43] Some Gripes on User-Agent http://www.dais.is.tohoku.ac.jp/logs/agentgripes.html UA の実例が一杯。

[63] The ELinks Manual (Petr Baudis, Jonas Fonseca Madsen, Miciah Dashiel Butler Masters 著, 2007-03-18 16:03:15 +09:00 版) http://elinks.or.cz/documentation/manual.html#useragent

プライバシー

[17] 利用者エージェントの識別情報は、 fingerprinting vector です。

セキュリティー

[91] User-Agent: の値は fingerprinting に使われることがあり >>83、注意が必要です。

[15] Security や privacy を理由に、 UA: 欄や Serverが送られることに懸念を示す人がいます。

確かに個々の場合において問題が発生する可能性はあるでしょう。 (例えば UA: 欄に特定の文字列が入っていたら攻撃する人がいるとか。)

しかし一般論として、例えばこれらの情報を送らないことで安全性が向上するということはありません。

[16] >>15 わざわざソースから削って出力させなくするような人もいるらしいですが、安全性の向上を狙っているならはっきり言って無駄なことです。

[30] RFC 7231 はソフトウェアの情報を示すことによって既知のセキュリティーホールを攻撃される危険性があるとしつつも、 実際にはソフトウェアの版に関わらず攻撃される虞があることをも指摘しています >>33。

歴史

[27] User-Agent:, Navigator の歴史の項も参照。

[68] Chrome 11 におけるユーザーエージェント文字列の変更 - Google Japan Developer Relations Blog ( (2011-06-07 20:00:25 +09:00 版)) http://googledevjp.blogspot.com/2011/06/chrome-11.html

[69] Bug 690287 – Tracking bug for UA sniffers failing to handle a two-digit version ( (2011-10-04 08:13:27 +09:00 版)) https://bugzilla.mozilla.org/show_bug.cgi?id=690287

[70] Request Headers in the HTTP protocol ( (2001-11-29 11:01:38 +09:00 版)) http://www.w3.org/Protocols/HTTP/HTRQ_Headers.html#user-agent

[71] Gecko user agent string reference - MDN ( (2012-07-06 00:45:55 +09:00 版)) https://developer.mozilla.org/en/Gecko_user_agent_string_reference

[72] Chrome for Android User-Agent - Google Chrome Mobile — Google Developers ( (2012-06-28 19:56:53 +09:00 版)) https://developers.google.com/chrome/mobile/docs/user-agent

[73] IE10 のユーザー エージェント文字列が更新されました - IEBlog 日本語 - Site Home - MSDN Blogs ( (2012-07-17 03:51:15 +09:00 版)) http://blogs.msdn.com/b/ie_ja/archive/2012/07/16/ie10-user-agent-string-update.aspx

[74] OperaのUAは以後ずっとOpera/9.80になります - by edvakf in hatena ( (2012-07-17 03:56:00 +09:00 版)) http://d.hatena.ne.jp/edvakf/20090527/1243449333

[75] Changes in Opera’s user agent string format - Dev.Opera ( (2012-07-17 03:56:23 +09:00 版)) http://dev.opera.com/articles/view/opera-ua-string-changes/

[76] Google ウェブマスター向け公式ブログ: スマートフォン版 Googlebot-Mobile の導入について ( (2012-07-18 14:36:02 +09:00 版)) http://googlewebmastercentral-ja.blogspot.jp/2011/12/googlebot-mobile.html

[79] Chrome for Android User-Agent - Google Chrome Mobile — Google Developers ( (2012-06-28 19:56:53 +09:00 版)) https://developers.google.com/chrome/mobile/docs/user-agent

[81] Gecko user agent string reference - HTTP | MDN ( (2014-06-16 13:25:45 +09:00 版)) https://developer.mozilla.org/en-US/docs/Web/HTTP/Gecko_user_agent_string_reference

[117] Introduce default `User-Agent` value for usage by HTML · whatwg/fetch@d9a8ac1 (2016-03-09 15:25:13 +09:00 版) https://github.com/whatwg/fetch/commit/d9a8ac12a33ab6a35826179dc3e8d88d4e06c66d

[118] Let Fetch define the default User-Agent value · whatwg/html@026aa96 (2016-03-09 15:25:41 +09:00 版) https://github.com/whatwg/html/commit/026aa966c944ce0f1180bc906646c00a3f7ebcbb

[59] is_bot property is not implemented well · Issue #35 · selwin/python-user-agents (2017-09-26 17:49:22 +09:00) https://github.com/selwin/python-user-agents/issues/35

[61] Microsoft Edge for iOS and Android: What developers need to know - Microsoft Edge Dev BlogMicrosoft Edge Dev Blog (2017-10-08 22:17:27 +09:00) https://blogs.windows.com/msedgedev/2017/10/05/microsoft-edge-ios-android-developer/

[62] ソフトウェアの互換性と僕らの"User-Agent"文字列問題|Rui Ueyama|note (2017-11-16 12:53:54 +09:00) https://note.mu/ruiu/n/n577ff5814b5c

[65] Document BlobPropertyBag "endings", or keep pushing to remove? · Issue #46 · w3c/FileAPI (2017-12-02 00:04:44 +09:00) https://github.com/w3c/FileAPI/issues/46

[67] Release Notes for Safari Technology Preview 46 | WebKit (2017-12-21 10:51:56 +09:00) https://webkit.org/blog/8042/release-notes-for-safari-technology-preview-46/

[77] Browser detection using the user agent - HTTP | MDN (2017-12-15 03:30:09 +09:00) https://developer.mozilla.org/en-US/docs/Web/HTTP/Browser_detection_using_the_user_agent

[78] javascript - What is the list of possible values for navigator.platform as of today? - Stack Overflow (2018-02-25 16:59:58 +09:00) https://stackoverflow.com/questions/19877924/what-is-the-list-of-possible-values-for-navigator-platform-as-of-today

[80] 801614 - navigator.platform returns on Gonk]] (2018-02-25 17:02:53 +09:00) https://bugzilla.mozilla.org/show_bug.cgi?id=801614

[82] 777710 - Remove platform and OS identifiers from B2G UA (2018-02-25 17:05:31 +09:00) https://bugzilla.mozilla.org/show_bug.cgi?id=777710

[84] 777633 - Cannot view a video on mobile youtube on Firefox OS - vnd.youtube is not a registered protocol (2018-02-25 17:06:06 +09:00) https://bugzilla.mozilla.org/show_bug.cgi?id=777633

[89] Navigator.oscpu - Web APIs | MDN (2018-02-25 17:31:57 +09:00) https://developer.mozilla.org/en-US/docs/Web/API/Navigator/oscpu

[101] User Agent Strings - Google Chrome (2018-02-25 19:33:02 +09:00) https://developer.chrome.com/multidevice/user-agent

[102] Android Developers Blog: Android Browser User-Agent Issues (2018-02-23 21:23:55 +09:00) https://android-developers.googleblog.com/2010/12/android-browser-user-agent-issues.html

[123] www.bestbuy.com - Firefox is an unsupported browser · Issue #115507 · webcompat/web-bugs · GitHub, 2023-01-02T11:07:34.000Z https://github.com/webcompat/web-bugs/issues/115507

[124] 1805967 - Freeze `rv:` segment in the User Agent string to `rv:109.0` to avoid erroneous IE11 detection, 2023-01-02T11:08:11.000Z https://bugzilla.mozilla.org/show_bug.cgi?id=1805967