最初の画面パラメーター
エンドユーザーのために希望する最初の画面体験をカスタマイズするための認証 (Authentication) パラメーターのセットです。
first_screen: ユーザーが最初に見る画面を指定します。identifier: サインインまたはサインアップフォームが受け入れる識別子タイプを指定します。login_hint: ユーザーのメールアドレスまたはユーザー名で識別子フィールドを埋めます。（これは OIDC 標準パラメーターです）
first_screen
first_screen パラメーターは、ユーザーが Logto のサインインページにリダイレクトされたときに最初に見る画面を決定する主要なパラメーターです。デフォルトでは、ユニバーサルサインインフォームが表示されます。このパラメーターを使用して、アプリケーションの要件に基づいて最初の画面をカスタマイズします。サポートされている値は次のとおりです：
sign_in: サインインフォームを表示します。（デフォルト）register: サインアップフォームを表示します。reset_password: パスワードリセットフォームを表示します。single_sign_on: エンタープライズ SSO サインインフォームを表示します。（有効な SSO プロバイダーを決定するためにメールアドレスが求められます）identifier:sign-in: 識別子特定のサインインフォームを表示します。識別子タイプはidentifierパラメーターを使用して指定できます。複数の識別子サインイン方法が有効な場合に便利です。identifier:register: 識別子特定のサインアップフォームを表示します。識別子タイプはidentifierパラメーターを使用して指定できます。複数の識別子サインアップ方法が有効な場合に便利です。
例えば、ユーザーを直接エンタープライズ SSO サインインフォームに送信する場合：
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=single_sign_on'
identifier
identifier パラメーターは、サインインまたはサインアップフォームが受け入れる識別子タイプを指定するために使用されます。このパラメーターは、first_screen パラメーターが identifier:sign-in、identifier:register、または reset_password に設定されている場合にのみ適用されます。サポートされている値は：username、email、および phone です。複数の識別子タイプを許可するために、空白で複数の値を区切ります。
例えば、ユーザーを直接メールまたは電話番号のサインアップページに送信する場合：
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:register&identifier=email phone'
このパラメーターで指定されたすべての識別子タイプは、Logto コンソールのサインインまたはサインアップ設定で有効にする必要があります。
サポートされていないまたは無効な識別子タイプは無視されます。指定された識別子がすべてサポートされていない場合、デフォルトのサインイン体験設定が使用されます。
login_hint
標準の OpenID Connect 仕様 で定義されている login_hint パラメーターは、ユーザーの識別子（メール、電話番号、またはユーザー名など）でサインインフォームを事前に入力するために使用されます。Logto では、他のサインイン画面パラメーターと組み合わせてユーザー体験を向上させることができます。このパラメーターは、ユーザーの識別子を事前に収集するカスタムの事前認証フォームがある場合に特に便利で、サインイン時に再入力をスキップできます。
例えば、収集したメールアドレスをサインインフォームに事前入力する場合：
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:sign_in&identifier=email&login_hint=[email protected]
SDK サポート
サポートされている Logto SDK では、signIn メソッドを呼び出す際にパラメーターを設定できます：
logtoClient.signIn({
redirectUri: 'https://your-app.com/callback',
firstScreen: 'identifier:register',
identifier: ['email', 'phone'],
loginHint: '[email protected]',
});