OAuth 2.0 セットアップガイド

OAuth 2.0とは何ですか? 

OAuth 2.0 認可フレームワークを使用すると、リソース所有者と HTTP サービス間の承認を管理することによってリソース所有者に代わって、またはサードパーティアプリケーションが自身に代わってアクセスを取得します。 詳細な仕様に関してはこちらをご参照ください。 

Community OAuth 2.0 スキームはAuthorization Code Grantをサポートしています。

OAuth 2.0 フロー表現

OAuth 2.0 がコミュニティのSSO全体の仕組み(以下の図のステップ #1 ～ 3)にどう組み込まれるのかを理解するために、まずは シングル サインオン (SSO): はじめにをご参照ください。

1. コミュニティ が、ユーザーを認可URL（Authorization URL）へリダイレクトする。その際、Redirect URI、Client ID、Scopeを添付したGETでリダイレクトされる。
2. サーバ はユーザーを認可し同意・許可を取得する。
3. サーバ はユーザーを認可コード(Authorization Code)と共にコミュニティのRedirect URIへ送り返す。
4. コミュニティは、TokenURLへAccess Tokenをリクエストする。その際、リクエストはAuthorization Code、Redirect URI、Client ID、Client SecretをパラメータとしたJSON形式でPOST(application/x-www-form-urlencoded) で送る。
5. コミュニティはUser Info URLへProfile data を、Access Token, Client IDをパラメータとしたGETでリクエストする。さらにPass Token in Authorization Bearer オプションが有効の場合は、Authorization BearerのヘッダとしてAccess Tokenが必要。

Profile Dataを取得した後、コミュニティシングルサインオン の#ステップ3 が始まります。

コミュニティで OAuth 2.0 を設定する方法

サーバー設定

• 次のエンドポイントを使用して OAuth 2.0 互換サーバーをセットアップします。
  • 認可エンドポイント（Authorizaiton Endpoint）
  • アクセストークンエンドポイント（Access Token Endpoint）
  • ユーザー情報エンドポイント（User Info Endpoint）

コミュニティ設定

1. Control に管理者としてログインします
2. Integration  > SSO > OAuth 2.0　へと進む
3. 次のフィールドを入力します。
   1. 認可URL（Authorization URL）* 
   2. クライアントID（Client ID）*
   3. クライアントシークレット（Client Secret）*
   4. 発行者（Issuer）*
   5. トークンURL（Token Url）*
   6. ユーザー情報の URL（User Info Url）*
   7. 範囲（Scope）
   8. 認可ベアラーのパストークン（Pass Token in Authorization Bearer）
      * 必須フィールドを示します
4. Installを押します

設定をインストールしたら、エンド ユーザーに対して SSO を有効にする前に、SSO テスト機能を使用して、すべてが期待どおりに動作していることを確認することをお勧めします。