暗黙的なフロー

最初のリクエスト

認証プロセスを開始するには、アプリケーションは次の形式でユーザーのブラウザーを認証エンドポイント <Space service URL>/oauth/auth にリダイレクトする必要があります。

例:

Space からアクセストークンを取得するには、アプリケーションは承認リクエストで次のパラメーターの値を指定する必要があります。

response_type

OAuth 2.0 リクエストの許可タイプを指定します。値を token に設定します。

状態

現在のアプリケーション状態の識別子。例: アプリケーション内の現在のユーザーの位置に関する情報を含むローカルストレージオブジェクトのキーにすることができます。

redirect_uri

Space からの応答を処理できるアプリケーション内の URI。これは、アプリケーションの登録時に指定された URI の 1 つである必要があります。

request_credentials

ユーザーにログインを要求するかどうかを決定するパラメーター。以下の値が有効です。

• skip — アプリケーションが匿名アクセスを許可する場合に使用します。

  • ユーザーがすでに Space にログインしている場合、ユーザーにはアプリケーションへのアクセスが許可されます。

  • ユーザーが Space にログインしておらず、ゲストアカウントが禁止されていない場合、ユーザーにはゲストとしてアプリケーションへのアクセスが許可されます。

  • ユーザーが Space にログインしておらず、ゲストアカウントが禁止されている場合、ユーザーはログインページにリダイレクトされます。

• silent — skip と同じですが、どの場合でもユーザーをアプリケーションにリダイレクトします。ゲストアカウントが禁止されている場合、ユーザーは認証エラーが発生してアプリケーションにリダイレクトされます。

• required — ユーザーを Space からログアウトし、ログインページにリダイレクトします。アプリケーションのログアウト要求に対する応答として使用します。

• default — アプリケーションが匿名アクセスを許可しない場合に使用します。

  • ユーザーがすでに Space にログインしている場合、ユーザーにはアプリケーションへのアクセスが許可されます。

  • ユーザーが Space にログインしていない場合、ユーザーはログインページにリダイレクトされます。

client_id

Space に登録されているアプリケーションの ID。クライアント ID を取得するには、 管理→ アプリケーションに移動し、リストからアプリケーションを選択します。

範囲

Space 内の特定のリソースにアクセスするために必要な権限の Space 区切りのリスト。

権限スコープの形式の詳細については、こちらを参照します。

ハンドル応答

クライアントサービスは、redirect_uri として指定された URL で Space からの応答を処理できる必要があります。応答パラメーターは、URL のハッシュ記号の後に渡されます。その結果、これらのパラメーターはサーバーに送信されず、悪意のある者によって傍受されることはありません。リソース所有者がアクセス要求を許可すると、Space はアクセストークンを発行し、application/x-www-form-urlencoded 形式を使用してリダイレクト URI のフラグメントコンポーネントに次のパラメーターを追加することによって、それをアプリケーションに配信します。

ハンドルエラー応答

リダイレクト URI が欠落している、無効である、不一致であるためにリクエストが失敗した場合、またはアプリケーション識別子が欠落しているか無効である場合、Space サーバーはリソース所有者にエラーを通知し、ブラウザーを無効なリダイレクト URI に自動的にリダイレクトしません。

リソース所有者がアクセス要求を拒否した場合、またはリダイレクト URI の欠落または無効以外の理由で要求が失敗した場合、認可サーバーは application/x-www-form-urlencoded 形式を使用してリダイレクト URI のフラグメントコンポーネントに次のパラメーターを追加することでアプリケーションに通知します。

エラー

以下からの単一の ASCII [USASCII] エラーコード:

• invalid_request — Space への承認リクエストに必須のパラメーターがないか、無効なパラメーター値が含まれているか、パラメーターが複数回含まれているか、形式が不正です。

• unauthorized_client — サービスの redirect_URI が間違っているか、見つかりません。

• access_denied — リソース所有者または Space がリクエストを拒否しました。

• unsupported_response_type — パラメーター response_type が欠落しているか、値が無効です。

• invalid_scope — パラメーターのスコープが欠落しているか、承認が要求されるスコープが、アプリケーションに登録および承認されているアクセス許可と一致しません。

error_description

追加情報を提供する人間が読める ASCII [USASCII] テキスト。アプリケーション開発者が何が課題になったのかを理解できます。