OAuth 2.0では、アプリケーションはユーザーデータの限られたサブセットへのアクセスが許可されています。 これらはスコープと呼ばれます（Liferayスコープと混同しないでください）。スコープは二通りの方法で作成されます。
-
管理者による、スコープに対するサービスアクセスポリシーの作成。
-
開発者による、JAX-RSエンドポイントの作成。フォルトでは、スコープはJAX-RSエンドポイントでサポートされているHTTP動詞に基づいて生成されます。 特別なアノテーションがこの動作を無効にして、特定のスコープを登録します。
JSONWSサービスのスコープの作成
スコープを作成する最も一般的な方法は 、OAUTH2_という名前をプレフィックスとするサービスアクセスポリシーを作成することです。この命名規則により、ポリシーはスコープとしてOAuthアプリケーション設定画面に表示されます。
たとえば、Emailメールアドレスを取得するためにアプリケーションがユーザーのプロフィール情報にアクセスする必要があるとします。アプリケーションにこの情報へのアクセスを許可するには、[コントロールパネル] → [設定] → *[サービスアクセスポリシー]*の順に選択し、以下に示すポリシーを作成します。
このポリシーはデフォルトのポリシーではなく、UserServiceにある1つのメソッドへのアクセスのみを許可することに注意してください。これはService Builderによって生成されたJSONWS Webサービスです。インストール先で利用可能なすべてのサービスのリストをこのURLで表示できます。
http://[host]:[port]/api/jsonws/
ポリシーを作成し、OAUTH2_プレフィックスを付けて名前を付けると、OAuth 2管理の*[スコープ]*タブに表示されます。
そして、選択をしてアプリケーションを保存します。
JAX-RSサービスのスコープの作成
Liferay OAuth2の特別なアノテーションやプロパティがない場合、標準のOSGi JAX-RSアプリケーションはLiferay OAuth2ランタイムによって検査され、スコープはアプリケーションでサポートされているHTTP動詞に基づいて導出されます。
開発者がさらに細かく制御する場合は、JAX-RSアプリケーションをoauth2.scopechecker.type=annotationsプロパティに登録して、Liferay OAuth2プロバイダースコープAPIバンドルからエクスポートされたcom.liferay.oauth2.provider.scope.RequiresScopeを使って、エンドポイントリソースメソッドまたはクラス全体に以下のようにアノテーションを付けることができます。
@RequiresScope("scopeName")
デプロイされると、これがOAuth 2.0設定のスコープになります。
認可ページの作成
この手順はオプションです。ユーザーは自分のアカウントへのアクセスを許可するためのインターフェースが必要で、インターフェースは自動的に提供されます。ただし、ページをカスタマイズしたい場合は、サイトに認可ページを作成できます。
-
[コントロールパネル] → [システム設定] → [セキュリティ] → *[OAuth2]へ行きます。左側にある[画面の承認]*というラベルの付いた一番下の項目をクリックします。
-
2つのデフォルトが表示されます。一番目にあるのが承認ページへのURLです。デフォルトでは、
/group/guest/authorize-oauth2-applicationです。これはデフォルトサイトのURLとauthorize-oauth2-applicationと呼ばれるサイト上のページに対応します。 -
デフォルトサイトの名前とURLをカスタマイズした場合は、次にそのサイトで作成するページとURLが一致するように、ここで適切な変更を加えます。*[保存]*をクリックします。
-
サイトの*[ビルド]* → *[ページ]*画面に行きます。
ボタンをクリックして、 *[プライベートページ]*を選択します。これにより、ユーザーは強制的にログインします。
-
フルページアプリケーションの種類を選択します。
-
ページに手順2で設定したものと同じ名前を付けます。
-
*[次のメニューにこのページを追加する]*というラベルの付いたボックスのチェックを外します。このページがサイトナビゲーションに表示されないようにします。
-
次に表示されるページで、フレンドリーURLが手順2で設定したURLと一致していることを確認します。
-
*[フルページアプリケーション]内にある、[OAuth2にポートレットを認可する]*を選択します。
-
*[保存]*をクリックします。
ユーザーはデフォルトまたは今回設計したUIを使用して、認可プロセスを進めることができます。これでUIが完成し、スコープが分かったので、次はアプリケーションで認可プロセスを実行します。