1. OAuth 2.0 認証を実現して
Dropbox に繋いでみた
Lightning Talk @ dstn HUB, April 2014
株式会社アプレッソ
開発部 開発1G 陳映融

2. 簡単な自己紹介
• 2014年1月 アプレッソに入社 （まだピチ
ピチ？）
• 台湾出身 （寒いのは苦手）
• 日本語でおｋ （いま発表しているわけだし）
2

3. OAuth 2.0 認証って？
• OAuth（オー オース）
– Web サービスと連携するための認証
– 連携対象のリソースへのアクセス認可も扱う
⇒ Web サービスの API のアクセス認証
• OAuth 2.0 ＝ 次世代の OAuth
– その仕組みはちょっと複雑なので…
3

4. OAuth 2.0 認証の仕組みを
寸劇風で説明します！
※ Authorization Code Grant Flowの場合

5. 登場人物
• SP：サービスプロバイダ
• AS@SP：認証サーバ（authorization
server）
• RS@SP：リソースサーバ（resource
server）
• DEV：開発者
• APP：アプリ
• USER：利用者＝リソースの所有者
5

6. シーン０～本番前
• 開発者がサービスプロバイダにアプリ登
録
SP さん、紹介するよ～
うちの新人のAPP ちゃんだ！
APP です。今後ともよろしく
お願いします。 m(_ _)m
お、よろしく！APP さんの
IDカードを発行するから、
無くさないようにしまってね
～
IDカード：クライアント識別用のIDと秘密
鍵
6

7. シーン１～認証開始
• ユーザがアプリに仕事を依頼
APP ちゃん、あとで用事を
頼みたいけど、先に SP さ
ん
の所に行ってくれない？
はい、お安いご用
です。行ってきま
す。
7

8. シーン２～認証コードリクエスト
• アプリが認証サーバに認証コードをリク
エスト
USER さんに用事を頼まれまし
た。
ロッカーの合鍵引換証をくださ
い。
IDカードを拝見します。
USER さんに連絡して確認を取
るから、少々ちょっとお待ちを。
ロッカー合鍵引換証：認証コード、リソース（ロッ
カー）のアクセス（合鍵）を引き換えるための一時
的認可
8

9. • ユーザにログインして、アプリのアクセ
スを承認してもらう
シーン３～ユーザ承認
USER さん、APP さんに
用事を依頼したのは間違
いないですか？
はい、間違いないです。
大丈夫です。ボクのロッ
カーを APP ちゃんに使わ
せてください。
では、USER さんのロッ
カーを APP さんに使わせ
て大丈夫でしょうか？
ロッカー：ウェブサービス上に
ある、
ユーザが所有しているリソース 9

10. シーン４～認証コード発行
• 認証サーバが認証コードを発行
ありがとうございます。
USER さんに確認を取れたので、
引換証を発行します。
10

11. シーン５～アクセストークン発行
• アプリが認証コードをアクセストークン
に交換
USER さんのロッカーですね。
IDカードを確認させてくださ
い。
USER さんのロッ
カーの合鍵をくださ
い。
合鍵引換証あります。
はい、IDカード
はここにありま
す。
うん、問題ないです
ね。はい、合鍵です。
11

12. シーン６～認証完了
• アプリが許可されたリソースにアクセス
さて、仕事はじめますか。
12

13. 早速、OAuth2.0認証用の
スクリプトを見てみましょう！

14. アクセストークン取得スクリプト
※HTTPトリガーに登録しておく
（リダイレクトURIとして使用）
14

15. アクセストークン取得の流れ
【変数代入】
リクエストの識別情報用の実行IDを取得して、スクリプト変数に保存する。
15

16. アクセストークン取得の流れ
【外部アプリケーション起動】
ブラウザ起動して、認証サーバにリクエスト送信する。
パラメータ：
・client_id = クライアントID
・redirect_uri = リダイレクトURI
・state = リクエスト・レスポンス同定用情報（実行ID）
16

17. アクセストークン取得の流れ
【繰り返し（条件指定）】
認証コードのレスポンスが処理されて、
一時ファイルが作成されるまで待つ
17

18. アクセストークン取得の流れ
（HTTPトリガー発火）
スクリプトパラメータ：
・code = 認証コード
・state = リクエスト・レスポンス
同定用情報（実行ID）
18

19. アクセストークン取得の流れ
【変数代入】
リクエスト・レスポンス同定用情報
（実行ID）を保存先ファイル名に
設定する。
19

20. アクセストークン取得の流れ
【マッピング】【CSVファイル書き込み】
認証コードを一時ファイルに保存する。
20

21. アクセストークン取得の流れ
【繰り返し（条件指定）】
ファイルが作成されたのでループ終了。
21

22. アクセストークン取得の流れ
【CSVファイル読み取り】【マッピング】
認証コード一時ファイルから認証コードを抽出して、スクリプト変数に保存。
22

23. アクセストークン取得の流れ
【POST実行】
認証コードでアクセストークンを取得する。
パラメータ：
・code = 認証コード
・client_id = クライアントID
・client_secret = クライアント秘密鍵
・redirect_uri = リダイレクト先URI（確認用）
23

24. アクセストークン取得の流れ
【マッピング】【CSVファイル書き込み】
レスポンスからアクセストークンを抽出して、ファイルに保存する。
24

25. アクセストークン取得の流れ
【ファイル/ディレクトリ削除】
認証コードの一時ファイルを削除する。
25

26. （おまけ）
Dropboxの連携スクリプト

27. リソースへのアクセス例
【CSVファイル読み取り】
ファイルからアクセストークンを読み取る。
【変数代入】
アクセストークンをスクリプトに設定する。
【GET実行】
/account/info ⇒ アカウント情報を取得する
/files ⇒ファイルをダウンロードする
27