制限事項
この設定では、次の制約事項にご留意ください:- 有効なOAuth 2.0/OIDCパラメーターのみが受け付けられます。
- すべてのIdPがアップストリームパラメーターに対応しているわけではありません。実装を進める前に、特定のIdPと確認してください。
- IdPは、アップストリームパラメーターに対応していません。
静的パラメーター
ユーザーがログインする際、パラメーターの標準セットをIdPに送信するため、静的パラメーターを用いて接続を設定します。 静的パラメーターを設定するには、Auth0 の接続の作成または接続の更新エンドポイントを呼び出し、オプション
オブジェクトでupstream_params
オブジェクトをIdPに送信したいパラメーターとともに渡します。
例:WordPress
WordPressでは、その認証エンドポイントに任意のblog
パラメーターを渡せ、ユーザーがログインした際、特定のブログへのアクセスを自動的に要求します。詳細は、WordPressのOAuth 2.0ドキュメンテーションをお読みください。
この例に従うのであれば、稼働中のWordPressソーシャル接続が必要になります。
接続を取得する
Management APIの接続の取得エンドポイントを呼び出し、options
オブジェクトの既存の値を取得します:
options
オブジェクトは、次のようになります:
接続を更新する(静的)
既存のオプション
オブジェクトをコピーし、blog
フィールドを次の属性としてupstream_params
オブジェクトを追加します:
options
オブジェクトを次の通りにして呼び出します:
blog=myblog.wordpress.com
が含まれるようになります。
動的パラメーター
動的パラメーターを用い、接続を設定し、ログイン時にユーザーに特定の値の一連のパラメーターをIdPに送信します。 動的パラメーターを設定するには、Auth0 Management APIの接続の作成または接続の更新エンドポイントを呼び出し、オプション
オブジェクトでupstream_params
オブジェクトをIdPに送信したいパラメーターとともに渡し、エイリアス
属性にマッピングされるパラメーターのフィールドを指定します。
後ほどXの例で再び説明しますが、オプション
オブジェクトの一例を掲載します:
利用可能なフィールド
エイリアス
属性に利用可能なフィールドは以下の通りです:
acr_values
オーディエンス
client_id
表示する
id_token_hint
login_hint
max_age
prompt
resource
response_mode
response_type
ui_locales
例:X
Xにより、任意のscreen_name
のパラメーターをOAuth認証エンドポイントに渡せます。screen_name
パラメーターがログイン画面のユーザーネーム入力ボックスを指定の値で事前入力します。詳細については、「XのAPIリファレンス」をお読みください。
この例に従うのであれば、稼働中のTwitterソーシャル接続が必要になります。
接続を取得する
Management APIの接続の取得エンドポイントを呼び出し、options
オブジェクトの既存の値を取得します:
options
オブジェクトは、次のようになります:
接続を更新する(動的)
既存のオプション
オブジェクトをコピーし、screen_name
フィールドを次の属性としてupstream_params
オブジェクトを追加し、alias
属性をlogin_hint
に設定します:
options
オブジェクトを次の通りにして呼び出します:
ログインエンドポイントを呼び出す
Authentication APIのログインエンドポイントをユーザーのために呼び出す際、login_hint
パラメーターにメールアドレスを渡せます:
screen_name
パラメーターとして渡されます。