将品牌应用于托管登录页面 - Amazon Cognito
选择品牌体验并分配风格

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将品牌应用于托管登录页面

您可能需要在身份验证服务和应用程序之间提供一致的用户体验。您可以通过 AWS SDK 中的自定义表单和后端 API 操作或托管登录来实现此目标。托管登录和经典托管用户界面是应用程序中提供用户池身份验证的组件的 Web 前端。要将托管身份验证服务与应用程序 UX 同步，您有两个自定义选项：品牌设计器和托管 UI 品牌。您可以在 Amazon Cognito 控制台和用户池 API 操作中选择自己的首选体验。

品牌设计师

品牌设计器是最新的用户池用户界面体验（托管登录）的最新自定义选项。品牌设计器是一个用于管理登录资产和样式的无代码可视化编辑器，以及一组 API 操作，用于对大量配置选项进行编程配置。使用域名和托管登录配置的用户池会自动呈现登录页面的品牌设计师版本。

托管用户界面（经典）品牌推广

托管用户界面（经典）品牌体验有两个选项：使用固定的样式选项修改层叠样式表 (CSS) 文件，以及添加自定义徽标图片。您可以在 Amazon Cognito 控制台中或通过设置 UICustomization API 操作来设置这些选项。在该服务推出时，Amazon Cognito只有这个选项。使用域名和托管用户界面品牌版本配置的用户池会自动呈现登录页面的经典版本。您的功能计划也可能仅支持托管用户界面。

选择品牌体验并分配风格

在 Amazon Cognito 控制台中，新用户池默认为托管登录品牌体验。您在托管登录可用之前设置的用户池将具有托管用户界面（经典）品牌。您可以在托管登录和托管用户界面品牌之间切换。当您更改品牌版本时，Amazon Cognito 会立即将更改应用于您的用户池域的用户互动页面。借助托管登录和托管用户界面，您的用户池可以为每个应用程序客户端设置一种样式。

每个应用程序客户端可以有不同的品牌风格，但是用户池域可以提供托管登录或托管用户界面。样式是应用于应用程序客户端的一组自定义设置。您可以为每个用户池设置一个自定义域和一个前缀域。您可以为自定义域名和前缀域名分配不同的品牌版本。但是，如果您还有自定义域，则前缀域无法完全正常运行，.well-knownOIDC 发现端点仅提供自定义域路径。在具有此配置的用户池中，您只能将前缀域用于不需要端点发现 (openid-configuration) 的操作。由于用户池的这些属性，您可以有效地为每个用户池选择一个品牌版本。

在将域设置为托管登录品牌版本的用户池中，您可以为应用程序客户端分配样式。样式是一组视觉设置，由图像文件、显示选项、CSS 值组成。当您为应用程序客户端分配样式时，Amazon Cognito 会立即将您的更新推送到您的用户交互式登录页面。Amazon Cognito 使用您选择的品牌版本和您对其应用的自定义来呈现您的用户交互式页面。

更新和删除样式

创建样式时，将其链接到应用程序客户端。要更改应用程序客户端的样式分配，必须先删除原始样式。目前，您无法在样式之间复制设置。您必须以编程方式执行此操作。要在样式和应用程序客户端之间复制设置，请DescribeManagedLoginBranding通过 API 操作获取样式的设置，然后使用CreateManagedLoginBranding或应用这些设置UpdateManagedLoginBranding。您无法更改应用程序客户端的指定样式，只能删除原始样式并设置新的样式。有关使用 API 和 SDK 操作管理样式的更多信息，请参阅用于托管登录品牌的 API 和 SDK 操作。

注意

创建或更新品牌风格的程序化请求的请求大小必须不超过 2 MB。如果您的请求大于此限制，请将您的请求分成多个UpdateManagedLoginBranding请求，请求的参数组不超过最大请求大小。这些请求不会导致将未指定的参数设置为默认值，因此您可以发送部分请求，而不会对现有设置产生任何影响。

您可以从托管登录菜单中删除 Amazon Cognito 控制台中的样式。在 “样式” 下，选择要删除的样式，然后选择 “删除样式”。

简而言之，为域名分配品牌的过程包括以下步骤。

  1. 创建域名并设置品牌版本。

  2. 创建品牌风格并将其分配给应用程序客户端。

为应用程序客户端分配样式

  1. 在用户池的域名菜单中，创建一个域名并将品牌版本设置为托管登录。

  2. 导航至 “托管登录” 菜单。在 “样式” 下，选择 “创建样式”。

  3. 选择要为其分配样式的应用程序客户端，或者创建一个新的应用程序客户端。

  4. 要开始配置品牌设置，请选择 La unch 品牌设计器。

主题