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

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

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

認証サービスとアプリケーションの間で一貫したユーザーエクスペリエンスを提供できます。この目標は、 AWS SDK のカスタムフォームとバックエンド API オペレーション、またはマネージドログインを使用して達成できます。マネージドログインとクラシックホスト UI は、ユーザープールで認証を提供するアプリケーションのコンポーネントのウェブフロントエンドです。マネージド認証サービスをアプリケーション UX と同期するには、ブランドデザイナーとホストされた UI ブランドという 2 つのカスタマイズオプションがあります。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 つのプレフィックスドメインを設定できます。カスタムドメインとプレフィックスドメインに異なるブランドバージョンを割り当てることができます。ただし、カスタムドメインも存在する場合、プレフィックスドメインは完全には機能しません。OIDC .well-known 検出エンドポイントにはカスタムドメインパスのみが表示されます。プレフィックスドメインは、この設定でユーザープール内のエンドポイント検出 (openid-configuration) を必要としないオペレーションにのみ使用できます。ユーザープールのこれらのプロパティにより、ユーザープールごとに 1 つのブランドバージョンを効果的に選択できます。

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

スタイルの更新と削除

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

注記

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

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

大まかに言うと、ドメインにブランドを割り当てるプロセスは、次のステップで構成されます。

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

  2. ブランドスタイルを作成し、アプリクライアントに割り当てます。

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

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

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

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

  4. ブランド設定の設定を開始するには、ブランドデザイナーを起動を選択します。

トピック