本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將品牌套用到受管登入頁面
<a name="managed-login-branding"></a>

您可能想要在身分驗證服務和應用程式之間提供一致的使用者體驗。您可以使用 AWS SDK 中的自訂表單和後端 API 操作，或使用受管登入來完成此目標。受管登入和傳統託管 UI 是應用程式元件的 Web 前端，可提供使用者集區的身分驗證。若要將受管身分驗證服務與應用程式 UX 同步，您有兩個自訂選項：品牌編輯器和託管 UI 品牌。您可以在 Amazon Cognito 主控台和使用者集區 API 操作中選擇您偏好的體驗。

**品牌編輯器**  
[品牌編輯器](managed-login-brandingeditor.md)是最新使用者集區 UI 體驗、[受管登入](cognito-user-pools-managed-login.md)的最新自訂選項。品牌編輯器是適用於受管登入資產和樣式的無程式碼視覺化編輯器，以及一組適用於大量組態選項的程式設計組態 API 操作。您使用[網域](cognito-user-pools-assign-domain.md)和受管登入設定的使用者集區會自動轉譯登入頁面的品牌設計工具版本。

**託管 UI （傳統） 品牌**  
[託管 UI （傳統） 品牌體驗](hosted-ui-classic-branding.md)有兩個選項：使用一組固定樣式選項修改層疊樣式表 (CSS) 檔案，以及新增自訂標誌影像。您可以在 Amazon Cognito 主控台或使用 [SetUICustomization](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_SetUICustomization.html) API 操作設定這些選項。服務啟動時，Amazon Cognito 只有此選項。您使用[網域](cognito-user-pools-assign-domain.md)和託管 UI 品牌版本設定的使用者集區會自動轉譯登入頁面的傳統版本。您的[功能計劃](cognito-sign-in-feature-plans.md)可能也僅支援託管 UI。

**注意**  
品牌編輯器和傳統品牌體驗會修改託管身分驗證服務的視覺化屬性。目前，您無法修改顯示在受管登入頁面上的文字，除了將當地語系化套用至多種語言之一。如需當地語系化的詳細資訊，請參閱 [受管登入當地語系化](cognito-user-pools-managed-login.md#managed-login-localization)。

## 選擇品牌體驗並指派樣式
<a name="managed-login-branding-choose"></a>

在 Amazon Cognito 主控台中，新使用者集區預設為**受管登入**品牌體驗。您在受管登入可用之前設定的使用者集區將具有**託管 UI （傳統）** 品牌。您可以在受管登入和託管 UI 品牌之間切換。當您變更**品牌版本**時，Amazon Cognito 會立即將變更套用至使用者集區網域的使用者互動頁面。使用受管登入和託管 UI，您的使用者集區可以具有每個應用程式用戶端的樣式。

每個應用程式用戶端可以有不同的品牌*樣式*，但使用者集區網域提供受管登入或託管 UI。樣式是套用至應用程式用戶端的一組自訂設定。您可以為每個使用者集區設定一個[自訂網域](cognito-user-pools-add-custom-domain.md)和一個[字首網域](cognito-user-pools-assign-domain-prefix.md)。您可以將不同的品牌版本指派給自訂網域和字首網域。不過，當您也有自訂網域時，字首網域無法完全運作，OIDC `.well-known` 探索端點*只會*顯示自訂網域路徑。對於使用此組態的使用者集區中不需要端點探索 (`openid-configuration`) 的操作，您只能使用字首網域。由於使用者集區的這些屬性，您可以有效地為每個使用者集區選擇一個品牌版本。

您可以將樣式指派給使用者集區中的應用程式用戶端，其中網域設定為受管登入品牌版本。樣式是由影像檔案、顯示選項、CSS 值組成的一組視覺化設定。當您將樣式指派給應用程式用戶端時，Amazon Cognito 會立即將您的更新推送到您的使用者互動登入頁面。Amazon Cognito 會使用您選擇的品牌版本和您已套用的自訂來轉譯使用者互動頁面。

### 更新和刪除樣式
<a name="managed-login-branding-update"></a>

建立樣式時，您可以將其連結至應用程式用戶端。若要變更應用程式用戶端的樣式指派，您必須先刪除原始樣式。目前，您無法在樣式之間複製設定。您必須以程式設計方式執行此操作。若要在樣式和應用程式用戶端之間複寫設定，請使用 [DescribeManagedLoginBranding](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_DescribeManagedLoginBranding.html) API 操作取得樣式的設定，並使用 [CreateManagedLoginBranding](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateManagedLoginBranding.html) 或 [UpdateManagedLoginBranding](https://docs.aws.amazon.com/) 套用。您無法變更應用程式用戶端的指派樣式，只能刪除原始樣式並設定新的樣式。如需使用 API 和 SDK 操作管理樣式的詳細資訊，請參閱 [受管登入品牌 API 和 SDK 操作](managed-login-brandingeditor.md#branding-designer-api)。

**注意**  
建立或更新品牌樣式的程式設計請求，其請求大小不得超過 2 MB。如果您的請求大於此限制，請將您的請求分成多個參數群組`UpdateManagedLoginBranding`的請求，但不超過請求大小上限。這些請求不會導致未指定的參數設為預設值，因此您可以傳送部分請求，而不會影響現有的設定。

您可以從**受管登入**功能表中刪除 Amazon Cognito 主控台中的樣式。在**樣式**下，選擇您要刪除的樣式，然後選擇**刪除樣式**。

在高階，將品牌指派給網域的程序包含下列步驟。

1. [建立網域並設定品牌版本](cognito-user-pools-assign-domain.md)。

1. 建立品牌樣式並將其指派給應用程式用戶端。

**將樣式指派給應用程式用戶端**

1. 在使用者集區的**網域**功能表中，建立網域並將**品牌版本**設定為**受管登入**。

1. 導覽至**受管登入**功能表。在**樣式**下，選擇**建立樣式**。

1. 選擇您要為其指派樣式的應用程式用戶端，或建立新的[應用程式用戶端](user-pool-settings-client-apps.md)。

1. 若要開始設定品牌設定，請選擇**啟動品牌編輯器**。

**Topics**
+ [選擇品牌體驗並指派樣式](#managed-login-branding-choose)
+ [品牌編輯器和自訂受管登入](managed-login-brandingeditor.md)
+ [自訂託管 UI （傳統） 品牌](hosted-ui-classic-branding.md)