マネージドログインページにブランディングを適用する - Amazon Cognito
ブランディングエクスペリエンスを選択してスタイルを割り当てる

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

マネージドログインページにブランディングを適用する

認証サービスとアプリケーションの間で一貫したユーザーエクスペリエンスを提供できます。この目標は、 AWS SDK のカスタムフォームとバックエンド API オペレーション、またはマネージドログインを使用して達成できます。マネージドログインとクラシックのホストされた UI は、ユーザープールによる認証を提供するアプリケーションコンポーネントのウェブフロントエンドです。マネージド認証サービスをアプリケーション UX と同期するには、2 つのカスタマイズオプションとして、ブランディングエディタとホステッド UI ブランディングがあります。Amazon Cognito コンソールとユーザープール API オペレーションで、好みのエクスペリエンスを選択できます。

ブランディングエディタ

ブランディングエディタは、最新のユーザープール UI エクスペリエンスであるマネージドログイン用の最新のカスタマイズオプションです。ブランディングエディタは、マネージドログインのアセットおよびスタイル用のノーコードビジュアルエディタであり、一連の API オペレーションを使用して多くの設定オプションをプログラムで設定できます。ユーザープールをドメインとマネージドログインを使用して設定すると、ログインページのブランディングデザイナーバージョンが自動的にレンダリングされます。

ホステッド UI (クラシック) ブランディング

ホストテッド UI (クラシック) ブランディングエクスペリエンスには、固定されたスタイルオプションセットを使用してカスケーディングスタイルシート (CSS) ファイルを変更するオプションと、カスタムロゴイメージを追加するオプションの 2 つがあります。これらのオプションは、Amazon Cognito コンソールまたは SetUICustomization API オペレーションで設定できます。サービスを開始した時点では、Amazon Cognito にはこのオプションしかありませんでした。ユーザープールをドメインとホステッド UI ブランディングバージョンで設定すると、ログインページのクラシックバージョンが自動的にレンダリングされます。機能プランによっては、ホストされた UI のみをサポートする場合があります。

注記

ブランディングエディタとクラシックブランディングエクスペリエンスは、ホストされた認証サービスのビジュアルプロパティを変更します。現在、複数の言語のいずれかにローカライズする場合を除き、マネージドログインページに表示されるテキストを変更することはできません。ローカライズの詳細については、「マネージドログインのローカリゼーション」を参照してください。

ブランディングエクスペリエンスを選択してスタイルを割り当てる

Amazon Cognito コンソールでは、新しいユーザープールにデフォルトでマネージドログインのブランディングエクスペリエンスが適用されます。マネージドログインが利用可能になる前に設定したユーザープールには、ホステッド UI (クラシック) ブランディングが適用されます。マネージドログインブランディングとホステッド UI ブランディングは切り替えることができます。ブランディングバージョンを変更すると、Amazon Cognito は、その変更をユーザープールドメインのユーザーインタラクティブページに直ちに反映します。マネージドログインとホステッド UI を使用すると、ユーザープールはアプリケーションクライアントごとに独自のスタイルを持つことができます。

アプリケーションクライアントごとに独自のブランディングスタイルを持つことができますが、ユーザープールドメインは、マネージドログインまたはホステッド UI のいずれかとして機能します。スタイルは、アプリケーションクライアントに適用される一連のカスタマイズ設定です。ユーザープールごとに 1 つのカスタムドメインと 1 つのプレフィックスドメインを設定できます。カスタムドメインとプレフィックスドメインに異なるブランディングバージョンを割り当てることができます。ただし、カスタムドメインを同時に設定している場合、プレフィックスドメインは完全には機能しません。.well-known OIDC 検出エンドポイントは、カスタムドメインパスのみを提示します。プレフィックスドメインは、この設定のユーザープールでは、エンドポイント検出 (openid-configuration) を必要としないオペレーションにのみ使用できます。ユーザープールのこれらの特性により、ユーザープールごとに 1 つのブランディングバージョンを効果的に選択できます。

マネージドログインのブランディングバージョンに設定されているドメインがユーザープールにあると、ユーザープール内のアプリケーションクライアントにスタイルを割り当てることができます。スタイルは、イメージファイル、表示オプション、CSS 値で構成される一連のビジュアル設定です。アプリケーションクライアントにスタイルを割り当てると、Amazon Cognito はすぐに更新内容をユーザーインタラクティブログインページにプッシュします。選択したブランディングバージョンとこれに適用したカスタマイズが、ユーザーインタラクティブページに反映されます。

スタイルの更新と削除

スタイルを作成したら、アプリケーションクライアントにスタイルをリンクします。アプリケーションクライアントのスタイル割り当てを変更するには、まず元のスタイルを削除する必要があります。現在、スタイル間で設定をコピーすることはできません。この操作は、プログラムで行う必要があります。スタイルとアプリケーションクライアント間で設定をレプリケートするには、DescribeManagedLoginBranding API オペレーションを使用してスタイルの設定を取得し、CreateManagedLoginBranding または UpdateManagedLoginBranding を使用して適用します。アプリケーションクライアントの割り当て済みスタイルを変更することはできません。元のスタイルを削除して新しいスタイルを設定することのみができます。API および SDK オペレーションを使用したスタイルの管理の詳細については、「マネージドログインのブランディングの API および SDK オペレーション」を参照してください。

注記

ブランディングスタイルを作成または更新するプログラムリクエストは、リクエストサイズが 2 MB 以下である必要があります。リクエストがこの制限より大きい場合は、リクエストを複数の UpdateManagedLoginBranding リクエストに分割し、最大リクエストサイズを超えないパラメータのグループにします。これらのリクエストでは、指定していないパラメータがデフォルトに設定されることはないため、既存の設定に影響を与えずに、部分的なリクエストを送信できます。

スタイルを削除するには、Amazon Cognito コンソールの [マネージドログイン] メニューを使用します。[スタイル] で削除するスタイルを選択し、[スタイルを削除] を選択します。

ドメインにブランディングを割り当てるプロセスは、以下のステップに要約されます。

  1. ドメインを作成し、ブランディングバージョンを設定します。

  2. ブランディングスタイルを作成してアプリケーションクライアントに割り当てます。

アプリケーションクライアントにスタイルを割り当てるには

  1. ユーザープールの [ドメイン] メニューでドメインを作成し、[ブランディングバージョン] を [マネージドログイン] に設定します。

  2. [マネージドログイン] メニューに移動します。[スタイル] で、[スタイルを作成] を選択します。

  3. スタイルを割り当てる先のアプリケーションクライアントを選択するか、新しいアプリケーションクライアントを作成します。

  4. ブランディング設定の構成を開始するには、[ブランディングエディタを起動] を選択します。

トピック