JICS2017_HS10_OAuth2_ritou

Transcript

1. 1 OAuth 2.0 基礎 ritou JICS 2017

2. 2 Ryo Ito • Evangelist @ OpenID Foundation Japan •

   Engineer @ mixi, Inc. XFLAG Studio • ritou @ Twitter, facebook, github

3. 3 本日の内容 • 概要 • OAuth 2.0とは? • OAuth 2.0の登場人物

   • ユースケース • 仕様 • プロトコルフロー解説 • Authorization Code Grant

4. 4 概要

5. 5 OAuth 2.0とは? あるサービスが持つリソースに対し、 別のサービスがリソースオーナーの許可を得 てアクセスするためのしくみ

6. 6 OAuth 2.0の登場人物 • Resource Owner • サービスのエンドユーザーやサービスそのもの •Client :

   リソースアクセスを行うサービス • Webサービス、モバイルアプリケーション等 • Resource Server :リソースアクセスを提供する • Authorization Server : アクセス許可を与える

7. 7 OAuth 2.0のユースケース • 登場人物である４者が存在(重複しても良い) • リソースアクセスに対し、リソースオーナーの許 可が求められる •HTTPリクエスト等でリソースアクセスが提供さ れる

8. 8 OAuth 2.0のユースケース(1) ブログサービスからSNSに自動投稿 • Resource Owner : SNSのユーザー •

   Client : ブログサービス • Resource / Authorization Server : SNS SNSが提供する機能をそのまま利用

9. 9 OAuth 2.0のユースケース(2) イベントサービスにSNSアカウントでログイン • Resource Owner : SNSのユーザー •

   Client : イベントサービス • Resource / Authorization Server : SNS プロフィール情報閲覧機能を認証用途で利用

10. 10 OAuth 2.0のユースケース(3) SNSが機能毎にモバイルアプリケーションを提供 • Resource Owner : SNSのユーザー、SNS •

    Client : SNSのモバイルアプリケーション • Resource / Authorization Server : SNS SNSが提供する機能を個別に利用

11. 11 RFCs @ IETF OAuth WG

12. 12 基本となる２つの仕様 • RFC 6749 The OAuth 2.0 Authorization Framework

    • リソースアクセスの許可を得るまでの処理 • RFC 6750 The OAuth 2.0 Authorization Framework: Bearer Token Usage • Bearer Tokenを用いたリソースアクセス

13. 13 その他の仕様 • OAuth 2.0 + Identity Layer = OpenID

    Connect • ユースケースごとのプロファイル • OpenID Foundation : FAPI WG

14. 14 【PR】@IT デジタルID最新動向 連載開始

15. 15 プロトコルフロー解説

16. 16 取り上げるユースケース ブログサービスからSNSに自動投稿 • Resource Owner : SNSのユーザー • Client

    : ブログサービス • Resource / Authorization Server : SNS

17. 17 実例 : はてなブログとfacebook はてなブログからFacebookに自動投稿 • Resource Owner : Facebookのユーザー

    • Client : はてなブログ • Resource / Authorization Server : Facebook

18. 18 アクセス許可の流れ

19. 19 リソースアクセスに対する許可要求

20. 20 0. Client Registration はてなブログはFacebookに対して記事共有を求めるため、 事前に手続きを済ませる • Client Type :

    "confidential" • CredentialsをWebサーバーで管理 • Client Credentials • Client ID : 識別子 • Client Secret : 秘密鍵のようなもの

21. 21 Authorization Code Grant(Flow)

22. 22 1. Authorization Request GET /authorize? response_type=code& client_id=s6BhdRkqt3& state=xyz& redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fc

    b HTTP/1.1 Host: server.example.com Authorization Code Grantを利用

23. 23 1. Authorization Request GET /authorize? response_type=code& client_id=s6BhdRkqt3& state=xyz& redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fc

    b HTTP/1.1 Host: server.example.com Clientの識別子と戻り先

24. 24 1. Authorization Request GET /authorize? response_type=code& client_id=s6BhdRkqt3& state=xyz& redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fc

    b HTTP/1.1 Host: server.example.com CSRF対策として セッションに紐付いた値 を指定

25. 25 Authorization Code Grant(Flow)

26. 26 2. Authorization Response HTTP/1.1 302 Found Location: https://client.example.com/cb? code=SplxlOBeZQQYbYS6WxSbIA&

    state=xyz 戻り先に クエリパラメータを付与

27. 27 2. Authorization Response HTTP/1.1 302 Found Location: https://client.example.com/cb? code=SplxlOBeZQQYbYS6WxSbIA&

    state=xyz CSRF対策の値を引回す

28. 28 2. Authorization Response HTTP/1.1 302 Found Location: https://client.example.com/cb? code=SplxlOBeZQQYbYS6WxSbIA&

    state=xyz

29. 29 Authorization Code Grant(Flow)

30. 30 3. Access Token Request POST /token HTTP/1.1 Host: server.example.com

    Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW Content-Type: application/x-www-form-urlencoded grant_type=authorization_code& code=SplxlOBeZQQYbYS6WxSbIA& redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb Authorization Code Grantを利用

31. 31 3. Access Token Request POST /token HTTP/1.1 Host: server.example.com

    Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW Content-Type: application/x-www-form-urlencoded grant_type=authorization_code& code=SplxlOBeZQQYbYS6WxSbIA& redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb Client Credentials を指定

32. 32 3. Access Token Request POST /token HTTP/1.1 Host: server.example.com

    Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW Content-Type: application/x-www-form-urlencoded grant_type=authorization_code& code=SplxlOBeZQQYbYS6WxSbIA& redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb 取得したAuthorization Codeと戻り先を指定

33. 33 Authorization Code Grant(Flow)

34. 34 4. Access Token Response {"access_token":"2YotnFZFEjr1zCsicMWpAA", "token_type":"Bearer", "expires_in":3600, "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA", "example_parameter":"example_value"}

    RFC6750で定義されてい る Bearer Token であることを示す

35. 35 4. Access Token Response {"access_token":"2YotnFZFEjr1zCsicMWpAA", "token_type":"Bearer", "expires_in":3600, "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA", "example_parameter":"example_value"}

    Access Tokenの値と 有効期限

36. 36 4. Access Token Response {"access_token":"2YotnFZFEjr1zCsicMWpAA", "token_type":"Bearer", "expires_in":3600, "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA", "example_parameter":"example_value"}

    Access Tokenの値を更新 (再取得)するための Refresh Token

37. 37 リソースアクセス実行

38. 38 Accessing Protected Resources GET /resource HTTP/1.1 Host: server.example.com Authorization:

    Bearer 2YotnFZFEjr1zCsicMWpAA

39. 39 scopeについて • リソースの範囲、提供する機能を示すもの

40. 40 scopeについて • Authorization/Resouce Server 側が定義、実装 • 例 : SNS

    • プロフィール情報の閲覧 • 友人へのメッセージ送信 •範囲は細かく指定できる方が良い •Resource Ownerへの見せ方も重要 •「(Client)があなたのプロフィール情報へのアク セスを要求しています。許可しますか？」

41. 41 scopeについて • Client が用途に合わせて選択し、Authorization Request に含む • 必要以上に幅広い scope

    を要求すべきではない • ❌プロフィール情報を利用した占いサービスが友人と のダイレクトメッセージの閲覧権限を要求

42. 42 ここまでのまとめ • OAuth 2.0は様々なユースケースに適用可能 • 最も一般的な実装例を用いてプロトコルフローを 紹介した •scopeは重要

43. 43 ここからは「OpenID Connectについて」