UserAgentでOAuth2のTokenを取得するベスト・プラクティス

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

• 戻る

目次 †

概要 †

UserAgent?でOAuth2のTokenを取得するベスト・プラクティス
（UserAgent?から、直接、Resource ServerのWebAPIにアクセスする）

詳細 †

SPA †

SPA : Single Page Application

Implicitが使用できる。 †

• Implicitグラント種別

• Implicit Flow

Hybridでセキュリティが強化される。 †

• codeやtokenのscope（認可された権限）を変える。
  ※ Financial API (FAPI)では、token：参照系、code：更新系などとなっている。

• 入手したcodeはClientのServer側にポストして使用する。
  ※ Publicクライアントにclient_id、client_secretを持たせてはダメなので。

Financial API (FAPI)も策定中。 †

スマホ †

前提条件 †

• （セキュリティ的懸念から）認可リクエストを、外部Webブラウザを経由してのみ行う。
  プラットフォームによっては、外部Webブラウザ相当のUXを向上させる仕組みが用意されている。

• codeとtokenが、「Private-Use URL Scheme上書き攻撃」などから保護されない可能性がある。

Implicitは使用できない。 †

• Implicitグラント種別

• Implicit Flow

Hybridも使用できない。 †

OAuth PKCEを適切に利用する。 †

• これにより「Private-Use URL Scheme上書き攻撃」などから保護される。

• 入手したcodeはClientのServer側にポストしてアクセストークン・リクエストする。
  ※ Publicクライアントにclient_id、client_secretを持たせてはダメなので。

response_typeにcodeやtokenを利用できる可能性。 †

• Private-Use URI Scheme Redirection以外にも、
  プラットフォームによっては、よりセキュアなプロセス間通信方法がある。

• これを利用することで、codeとtokenが完全に保護されるのであれば、
  response_typeにcodeやtokenを利用することもできるかも。

• Authorization Code
  • Authorization Codeグラント種別
  • Authorization Code Flow

• Implicit
  • Implicitグラント種別
  • Implicit Flow

• Hybrid Flow

Financial API (FAPI)も策定中。 †

Financial API (FAPI) †

• 金融向け規格なので、前述よりさらにセキュリティ・レベルが強化される。
• 現時点では、まだドラフト段階だが、スマホ、SPA、共に、この規格の導入を検討してイイ。

参考 †

仕様 †

スマホ向けベストプラクティス (RFC 8252 ... OAuth 2.0 for Native Apps) †

認可コード横取り攻撃への対抗策 (RFC 7636 ... OAuth PKCE) †

OSSコンソーシアム †

• UserAgent?でOAuth2のTokenを取得するベスト・プラクティス
  https://www.osscons.jp/joavafb1i-537/#_537

• Single Sign-On user experience with OAuth PKCE by Open棟梁 and Cordova.
  https://www.osscons.jp/jobgbko8n-537/#_537

OAuth PKCE利用時の構成図 †

スマホのOAuth PKCE認証フローは複雑で忘れ易く、
開発環境の構築時も「どうするんだっけ？」と一苦労するのでメモ。

Client（UserAgent?）は、

1. OAuth PKCEの認可リクエスト ～ 認可レスポンスで、codeを入手
2. codeをClient（Server）にpostしてアクセストークン・リクエスト（PKCE）
3. Client（Server）経由でaccess_tokenを受け取り、
4. access_tokenを使用してResource Serverにリソースをリクエスト

※ よくよく見ると、Cordovaと外部ブラウザでSessionが違うので、
　stateもcode_verifierもCordova側で生成・保持しておく必要がある。

※ また、code_challengeは、Server側でcode_verifierを受け取り、
ハッシュ関数（plain or S256）を選択して生成する必要がある。

---

Tags: :IT国際標準, :認証基盤, :クレームベース認証, :OAuth