CookBook

OAuth2.0 の アクセストークンを Box から取得する方法

投稿日:

このクックブックでは、OAuth2.0 の アクセストークンを Box から取得する方法を説明します。

intra-mart Accel Platformでは、OAuth2.0 の アクセストークンをユーザ毎に取得・保存する機能が備わっています。主な機能は以下のとおりです。

  • 初回のアクセストークン取得に必要な、認可要求に関する一連の画面や処理を共通化して提供
  • アクセストークンの有効期限が切れていた場合、リフレッシュトークンを利用して自動的にアクセストークンを更新

これにより、開発者は、OAuth2.0 関連の面倒な実装をすることなく、外部のサービスが提供する様々な Web API へのアクセスを簡単に作成することが可能となります。

今回は、Box のファイル一覧を取得することを例として、詳細な手順を説明します。
また、Google Drive™ の OAuth2.0 については他にクックブックがあります。詳細はこちらを参照してください。

完成サンプル

以下の完成サンプルをダウンロードしてご活用ください。

 

e builder プロジェクト : im_cookbook_127124.zip
imm ファイル : im_cookbook_127124_oauth_client_box-1.0.0.imm

なお、ベースURLである以下の部分は、環境に合わせて適宜変更してください。
http://localhost:8080/imart

レシピ

概要

Box側の手順

  • 手順1. アプリケーション登録 - OAuth 2.0 クライアント ID の作成

intra-mart Accel Platform側の手順

  • 手順2. OAuthプロバイダ設定の作成。(/conf/oauth-provider-config/*.xmlの作成)
  • 手順3. OAuthRequestProcessorFactory を作成
  • 手順4. 動作確認用サンプルの作成

Box側の手順

手順1. OAuth 2.0 クライアント ID の作成

最初に OAuth 2.0 クライアント ID を作成します。

OAuth 2.0を利用したBoxのAPIアクセス方法に関する詳細は、Box Developers | Cloud Content Management APIs を参照してください。

1. CREATE NEW BOX APP にアクセスします。

CREATE NEW BOX APP

2. Enterprise Integration を選択します。

3. Standard OAuth 2.0 (User Authentication) を選択します。

4. アプリケーション名を入力します(何でも構いません)。

5. View Your App をクリックします。

6. 「Client ID」と「Client Secret」をメモしておきます。

7. Redirect URI を http://localhost:8080/imart/oauth/redirect に設定します(http://localhost:8080/imart は環境に応じて変更してください)。


intra-mart Accel Platform側の手順

手順2. OAuthプロバイダ設定の作成。(/conf/oauth-provider-config/*.xmlの作成)

e Builder のモジュールプロジェクト内に「OAuthプロバイダ設定ファイル」を作成します。
OAuthプロバイダ設定ファイルには、外部連携アプリケーションで利用するOAuthプロバイダの情報を設定します。
詳しくは、 設定ファイルリファレンスを参照してください。

src/main/conf/oauth-provider-config/im_cookbook_127124_oauth_client_box.xml

行数 説明
18 先ほど取得した「クライアントID」を設定します。
19 先ほど取得した「クライアント シークレット」を設定します。
20 スコープを設定します。今回は、Box 上のファイルを参照する為のスコープを設定します。なお、Box が公開しているスコープ一覧は、以下を参照してください。OAuth 2 Scopes

手順3. OAuthRequestProcessorFactory を作成

src/main/java/jp/co/intra_mart/cookbook/im_cookbook_127124/oauth/client/service/processor/impl/BoxConstants.java

src/main/resources/META-INF/services/jp.co.intra_mart.system.oauth.client.service.processor.OAuthRequestProcessorFactory

src/main/java/jp/co/intra_mart/cookbook/im_cookbook_127124/oauth/client/service/processor/impl/BoxOAuthRequestProcessorFactory.java

手順6. 動作確認用サンプルの作成

Box 上のファイル一覧を表示するJSPを作成します。

src/main/webapp/im_cookbook_127124_oauth_client_box/box_items.jsp

行数 説明
19 Box の ファイル一覧を取得為のURIを指定します。Box API の詳細は、こちら を参照してください。
22〜23 OAuthClientServiceを使う事で、アクセストークンが簡単に取得可能となります。

動作確認

1. intra-mart Accel Platformにログインします。

ここでは、サンプルユーザ「ueda」でログインします。

2. 右上のユーティリティメニューより、[個人設定] - [外部連携アプリケーション]を選択します。

3. 「Box API - im_cookbook_127124」を [許可] します。

4. Box アカウントでログインします。

5. サービスを許可します。


6. サンプル画面「box_items.jsp」にアクセスします。

http://localhost:8080/imart/im_cookbook_127124_oauth_client_box/box_items.jsp にアクセスします。

この Box ユーザは、Box Drive にファイルが存在しないようです。
試しに、Box Drive にファイルを2つアップロードしてみます。

再度、http://localhost:8080/imart/im_cookbook_127124_oauth_client_box/box_items.jsp にアクセスします。
ファイルの一覧が取得できました。

まとめ

この CookBook では、OAuth2.0 の アクセストークンを Box から取得する方法を紹介しました。

Box 以外でも、OAuth 2.0 対応の認可サーバであれば、この CookBook と同様の方法でアクセストークンを取得することが可能です。
お客様の用途にあわせて是非ご活用ください。

-CookBook
-,

執筆者:


comment

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

関連記事

no image

デバッグサーバ起動時に出力されるコンソールの情報をファイル出力する方法

このCookBookでは、e Builder でデバッグサーバの利用時にコンソールに出力された内容を、別途指定したファイルに出力する方法について紹介しています。 完成イメージ 1. 指定したファイルに …

no image

IM-BIS アクション設定の「条件」の書き方

このCookbookでは、アクション設定の条件式の書き方を説明します。 この方法により入力値に応じてアクション設定の外部連携や入力モード変換などのイベントの実行をコントロールすることができます。 完成 …

no image

Docker Swarm を利用して Resin のクラスタリングを構築する。

この CookBook では、Docker Swarm を利用して Resin のクラスタリングを構築する手順について紹介しています。 Docker Swarm を利用することで、複数マシンにまたがっ …

no image

【ViewCreator】検索にヒットした件数を取得する関数の作り方。

このCookBookでは、ViewCreatorで検索にヒットした件数を取得する関数の作り方についてご紹介します。 ユーザ定義関数についての詳細は下記のドキュメントを参照してください。 ViewCre …

no image

Payara の Docker を作成する。

この CookBook では、Payara の Docker の作成手順について紹介しています。 レシピ ベースイメージの作成 Payara の Docker イメージを作成します 実行します 1. …

まだデータがありません。

RSSRSSRSSRSS