ユーザーエージェントについての調査
kamimiそもそもUser Agentとは
User-Agent リクエストヘッダーは、サーバーやネットワークピアがアプリケーション、オペレーティングシステム、ベンダーや、リクエストしているユーザーエージェントのバージョン等を識別できるようにする特性文字列
「特別そう設定されていない限り、各リクエストにUser-Agentフィールドを付与して送るべき」
A user agent SHOULD send a User-Agent field in each request
unless specifically configured not to do so.
「送信者は、生成される製品識別子を必要なものだけに制限すべき。
送信者は、製品に含まれる広告やその他の非本質的な情報
の識別子を生成してはならない。
バージョン識別子ではない（つまり、連続した
同じ製品名のバージョンは、以下の点だけが異なる必要があります。
製品識別子の製品バージョン部分)product-version は、生成すべきでない。」
A sender SHOULD limit generated product identifiers to what is
necessary to identify the product; a sender MUST NOT generate
advertising or other nonessential information within the product
identifier. A sender SHOULD NOT generate information in
product-version that is not a version identifier (i.e., successive
versions of the same product name ought to differ only in the
product-version portion of the product identifier).
kamimiUser Agentを用いた処理
- User-Agentを用いたブラウザの判別
ユーザーエージェントを調べるのが良いことはめったにありません。問題を解決するには、もっと良い、もっと広く互換性のある方法が見つかるはずです。
- 例えば、モバイル端末かどうかを判別したい場合
要するに、モバイル端末を検出するには、ユーザーエージェント文字列のどこかに文字列 “Mobi” があるかどうかを探すことをお勧めします
- ただし、その理由がタッチ可能な端末かどうかであれば、以下を使用すべき
Navigator.maxTouchPoints を使用しましょう。
kamimiUser-Agentの固定化とUser Agent Client Hints の使用
-
Chromeでは、User-Agentの文字列を固定化することで、この文字列の使用することをなくそうとしている
-
理由は以下の通り
- HTTP リクエストのたびに、ブラウザに関する多くの情報が何もしなくても公開されること
- 時間とともに長く複雑になり、エラーが起こりやすい文字列の解析が必要になること
kamimiiOSアプリにおけるUser-Agent
- 自分で実験してみたところ、以下の通り
iOSアプリからのリクエストの場合
'user-agent': 'ReadingAndDeletingCookies/1 CFNetwork/1312 Darwin/20.5.0',
iOSアプリ内ブラウザ（WKWebView）
'user-agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148',
- その他のアプリからのリクエストに含まれるUser-Agent
WKWebViewのUser-Agentの設定方法
- 方法はいくつかある（SwiftUIにおいて使うのは太字のものだけではないか）
- UserDefaultsにセットする
- WKWebViewのカスタムUAにセットする
- デフォルトのUAの後ろにカスタム文字列を付ける
- Interface Builderで設定する
WKWebViewのカスタムUAにセットする
webView.customUserAgent = "ProvidingACustomUserAgent"
User-Agentはこうなる
'user-agent': 'ProvidingACustomUserAgent'
デフォルトのUAの後ろにカスタム文字列を付ける
let config = WKWebViewConfiguration()
config.applicationNameForUserAgent = "ProvidingACustomUserAgent"
let webView = WKWebView(frame: .zero, configuration: config)
User-Agentはこうなる
'user-agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) ProvidingACustomUserAgent'
User-Agentの設定をWKWebViewで何もしなかった場合
'user-agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148'
デフォルトのUAの後ろにカスタム文字列を付ける方法
kamimiWAFとUser-Agent
-
WAF側の設定でUser-Agent文字列で、アクセス制御を行う場合もある
-
そもそもWAFとは
WAF（Web アプリケーションファイアウォール）とは、Web アプリケーションの通信をフィルター、監視、ブロックするためのソフトウェアまたは、ハードウェアのセキュリティ対策
- AWS WAFにおける、User-Agent文字列のルール設定
kamimiAPI設計観点から見たUser-Agent
- REST APIが、User-Agentの設定を強制することは珍しい
- もしそれが設定されていないことに対してエラーコードを返すなら、400 Bad Requestでエラーの詳細を返すべきではないか