メインコンテンツまでスキップ

認証 (Authentication) パラメーター

標準的な OIDC サインインフローでは、クライアントアプリケーションが認証リクエストを開始し、ユーザーを Logto がホストするユニバーサルサインイン体験のウェブページへリダイレクトします。サインイン体験の設定に基づき、ユーザーはさまざまな識別子、認証方法、サードパーティのソーシャルまたはエンタープライズ SSO コネクターを使ってサインインまたはサインアップできます。

Logto は、以下のような標準 OIDC パラメーターもサポートしています：

  • login_hint: ユーザー識別子のヒントを提供（例：メールアドレス／ユーザー名の事前入力）
  • ui_locales: サインイン UI や関連メールを含む、現在のインタラクションの実行時言語を制御します。
  • acr_values と max_age: 特定の保証レベル（urn:logto:acr:1fa または urn:logto:acr:mfa）や最大認証 (Authentication) 年齢でステップアップ認証 (Authentication) をリクエストします。

標準の OIDC 認証 (Authentication) パラメーター に加え、Logto 独自のカスタム認証 (Authentication) パラメーターも導入しており、エンドユーザー向けのサインイン体験を柔軟にカスタマイズできます。

これは、異なるユーザーセグメントごとに特定のサインインフローを強制したい場合に特に有用です。以下のようなシナリオが含まれますが、これらに限定されません：

新規ユーザーのダイレクトサインアップ​

ターゲットを絞った登録キャンペーンでは、新規ユーザーをデフォルトのサインインフォームをスキップして直接サインアップページに誘導し、シームレスなオンボーディング体験を実現できます。

使用例：First screen パラメーター → first_screen=register

ホームページからのメール事前入力サインアップ​

ホームページのヒーローセクションにメールサインアップ入力欄が目立つ形で表示され、素早いユーザー登録を促すケースがよくあります。ユーザーがメールアドレスを入力し「今すぐ始める」ボタンをクリックすると、これらのパラメーターを使ってサインアップページへメール欄を事前入力した状態でリダイレクトし、登録プロセスをスムーズにします。

この方法は、サブスクリプションフォームや他のメール収集シナリオでも、サインアップフローの摩擦を減らしたい場合に有効です。

使用例：First screen パラメーター → first_screen=identifier:sign_up&identifier=email&[email protected]

ホームページに埋め込まれたメールサインアップフィールド

新規ユーザーが新しいパスワードを設定する必要がある場合、直接リンクを送信し、メール欄を事前入力した状態でパスワードリセットページへリダイレクトできます。

使用例：First screen パラメーター → first_screen=reset_password

インスタントソーシャルログイン​

サイト上にソーシャルメディアサインインボタンを直接配置している場合、これらのパラメーターを使ってデフォルトのサインインフォームをスキップし、ユーザーが選択したソーシャルプロバイダーで直接認証 (Authentication) できます。

使用例：Direct sign-in パラメーター → direct_sign_in=social:google

エンタープライズ顧客向けダイレクト SSO サインイン​

複数のエンタープライズクライアント向け製品の場合、これらのパラメーターを使って、特定の SSO プロバイダーでサインインする専用ボタンを表示し、ユニバーサルサインインフォームをスキップして各組織にシームレスな体験を提供できます。

使用例：Direct sign-in パラメーター → direct_sign_in=sso:1234567890

ウェブサイトやダイアログへのサインアップフォーム埋め込み​

シームレスなユーザー体験のため、認証 (Authentication) フォーム全体をウェブサイトやモーダルダイアログに直接埋め込み、適切なタイミングで自然にサインアップやサインインへ誘導できます。

  • ユーザーがソーシャルサインインボタン（例：「Google で続ける」）をクリックした場合、direct sign-in パラメーターを使って即座にソーシャルプロバイダーへリダイレクトします。
  • ユーザーがメールアドレスを入力しサインアップボタンをクリックした場合、first screen パラメーターを使ってメール事前入力状態でサインアップページへリダイレクトします。

上記の認証 (Authentication) パラメーターを組み合わせることで、Logto の安全な認証 (Authentication) 基盤を活用しつつ、ウェブサイトのコンテキストやブランディングを維持し、スムーズでプロフェッショナルなユーザー体験を実現できます。

ウェブサイトやダイアログに埋め込まれたサインアップフォーム

サイトごとに異なるサインイン方法の表示​

製品が社内チームと一般消費者、または異なる組織の両方に提供されている場合、サインイン体験を用途に応じてカスタマイズできます。例えば：

  • 社内ツールでは、メール／ユーザー名とパスワードによるサインインのみを表示。
  • 一般向けページでは、Google ログインを含むすべてのサインインオプションを提供。

使用例：ウェブサイトの種類に応じて異なる first screen または direct sign-in 設定を利用。

引き続き、first screen のカスタマイズや direct sign-in 体験の有効化に役立つ認証 (Authentication) パラメーターについて詳しく学んでください。

ログインまたは登録フォームを安全にサイトへ埋め込む方法

顧客のオンボーディング体験を向上させるちょっとした工夫