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

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

関連記事

ワークフローの一覧を使い分けるには(スマートフォン版)

このCookbookでは、以前に公開した「ワークフローの一覧を使い分けるには(改訂版)」に関して、お問い合わせいただいた内容を追加してスマートフォン画面でワークフローの一覧の検索条件を付与する方法をご …

no image

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

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

no image

画面操作方法によって画面アイテムの入力チェックを切り替える方法

このCookBookでは、IM-FormaDesignerの入力チェックプログラムで、画面の操作方法に応じた入力チェックを設定する方法を紹介します。 この方法は、以下の製品で作成したアプリケーションや …

no image

Solr の Docker を作成する。

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

no image

スクリプト開発モデルで作成した1つのページソースを複数の画面で利用する

このCookBookでは、任意のスクリプト開発モデルプログラムをコールして部分ページソース挿入を行う方法を紹介します。 部分ページソース挿入は<imart type=”include”>タ …

RSSRSSRSSRSS