Authorizationエンドポイント

クライアントがユーザーをAuthorizationエンドポイントへリダイレクトさせ、ユーザーの認証・認可を得るためのエンドポイントです。
ユーザーの認証状態・認可状態を判定し、適切なページへリダイレクトさせ、認可コードを返す機能を提供します。

リクエスト

URL： https://auth.login.yahoo.co.jp/yconnect/v2/authorization
サポートするHTTPメソッド： GET/POST
authorization： なし

リクエストパラメーター

パラメーター	必須	説明	入力値（サンプル）
response_type	○	code という固定文字列を指定してください。	`code`
client_id	○	アプリケーション登録時に発行したClient IDを指定してください。	`dj00zaiZpPXNYeG5tRXJVVlLSZzP uWNvbnN1bWVyc2VjcmV0Jng9ZWU-`
redirect_uri	○	アプリケーション登録時に設定したフルURL（もしくはカスタムURIスキーム）を指定してください。事前に登録されているクライアントのリダイレクト URI 値のひとつに正確に一致している必要があります。
bail		bail=1 を指定すると同意画面で「同意しない」ボタンをクリックした際にcodeパラメーターを付加せずにredirect_uriへリダイレクトさせます。指定しない場合はYahoo!トップへ遷移します。
scope	○	UserInfo APIから取得できる属性情報を指定できます。複数選択する場合はスペース区切りで指定します。 openid ：（必須）ユーザー識別子を返却します。 profile ：姓名・生年・性別を返却します。 email ：メールアドレスと確認済みフラグを返却します。 address ：ユーザー登録住所情報を返却します。	`openid%20address%20profile` ※URLエンコードが必要です。
state		CSRF対策として、同一のセッションであることを確認するために利用します。リクエストごとにアプリケーション側で生成した十分な長さのランダムな文字列を指定してください。
nonce		リプレイアタック対策のパラメーターです。リクエストごとにアプリケーション側で生成した十分な長さのランダムな文字列を指定してください。指定したnonce値はID Tokenに含まれて返却されます。ID Tokenの使い回しを防止するために、nonce値を検証し、同じID Tokenが二度以上使用されていないことを確認してください。 nonceの値は十分な不規則性がなければいけません。
display		ログイン画面、同意画面で表示するページ種類を指定する場合に利用します。指定されていない場合にはpageが初期値となります。 page：UserAgentに適した形でページを表示 touch：スマートフォン版ページを表示 popup：ポップアップ版ページを表示 inapp：ネイティブアプリ版ページを表示	`page`
prompt		ユーザーに強制させたいアクションを指定します。複数指定する場合はスペース区切りにします。 consent：同意画面を強制表示します。ユーザー情報へのアクセスすることの同意確認をとりたい時に利用します。 login：ログインまたはパスワード再確認画面を強制表示します。ユーザーが既にYahoo! JAPAN上でログイン状態の場合でも再認証を要求したい時に利用します。 select_account：ID切り替え画面を強制表示します。 none：ログインや同意などの画面を非表示にしたい時に利用します。ユーザーがYahoo!上でログイン状態でなかった場合、データアクセスに対して過去に同意済みでなかった場合はエラーパラメーターが返却されます。このアクションについては他のアクションと組み合わせて利用ができません。	`login`
max_age		最大認証経過時間を指定します。指定された秒数よりも認証日時が経過していた場合は再認証が必要です。	`3600`
code_challenge		認可コード横取り攻撃対策（PKCE）のパラメーターです。code_verifierから生成した値を指定してください。 code_verifierおよびcode_challengeの生成方法は下記をご確認ください。 https://tools.ietf.org/html/rfc7636#page-8	`E9Melhoa2OwvFrEMTJguCH aoeK1t8URWbuGJSstw-cM`
code_challenge_method		認可コード横取り攻撃対策（PKCE）のパラメーターです。code_challengeの生成方法に応じた値を指定してください。 plain(デフォルト)：code_verifierと同じ値の場合 S256：code_verifierをSHA256でハッシュ化し、Base64URLエンコードした値の場合セキュリティ上の観点から、S256での実装が難しい場合でのみplainを指定してください。	`S256`

リクエストサンプル

GET /yconnect/v2/authorization?
response_type=code
&client_id=dj0zaiZpPXNYeG5tRXJKUVVlLSZzPWNvbnN1bWVyc2VjcmV0Jng9ZWU-
&redirect_uri=https%3A%2F%2Fexample.org%2Fcb
&scope=openid%20profile
&state=af0ifjsldkj HTTP/1.1

レスポンス

正常レスポンス

パラメーター名	必須	概要	返却値（サンプル）
code	※	認可コード（8Byteの固定長文字列） ※ユーザーが同意した場合のみ返却されます。	`SxlOBeZQ`
state	※	リクエスト時に指定されたstate値 ※Authorizationリクエスト時のstateが指定されている場合に返却されます。 CSRF対策として、リクエスト時に指定したstate値とレスポンスで取得したstate値の一致を確認してください。	`af0ifjsldkj`

レスポンスサンプル

HTTP/1.1 302 Found
Location: https://example.org/cb?
    code=SxlOBeZQ
    &state=af0ifjsldkj

エラーレスポンス

パラメーター名	必須	概要	返却値（サンプル）
state	※	リクエスト時に指定されたstate値 ※Authorizationリクエスト時のstateが指定されている場合に返却されます。	`af0ifjsldkj`
error	○	エラーコード詳細は下記をご確認ください。 https://openid.net/specs/openid-connect-core-1_0.html#AuthError	`invalid_request`
error_description	○	エラー概要	`Unsupported%20response_type%20value`
error_code	○	エラー判定用コード	`1000`

レスポンスサンプル

HTTP/1.1 302 Found
Location: https://example.org/cb?
    state=af0ifjsldkj
    &error=invalid_request
    &error_description=Unsupported%20response_type%20value
    &error_code=1000

Authorizationエンドポイント

リクエスト

リクエストパラメーター

リクエストサンプル

レスポンス

正常レスポンス

レスポンスサンプル

エラーレスポンス

レスポンスサンプル

Yahoo! ID連携 v2

利用のルール

開発のヒント

サービス一覧