將品牌套用到受管登入頁面 - Amazon Cognito

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

將品牌套用到受管登入頁面

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

品牌設計師

品牌設計工具是最新使用者集區 UI 體驗、受管登入的最新自訂選項。品牌設計工具是適用於受管登入資產和樣式的無程式碼視覺化編輯器,以及一組 API 操作,用於大量組態選項的程式設計組態。您使用網域和受管登入設定的使用者集區會自動轉譯您登入頁面的品牌設計版本。

託管 UI (傳統) 品牌

託管 UI (傳統) 品牌體驗有兩個選項:使用一組固定樣式選項修改層疊樣式表 (CSS) 檔案,以及新增自訂標誌影像。您可以在 Amazon Cognito 主控台或使用 SetUICustomization API 操作設定這些選項。服務啟動時,Amazon Cognito 只有此選項。您使用網域和託管 UI 品牌版本設定的使用者集區會自動轉譯登入頁面的傳統版本。您的功能計劃可能也僅支援託管 UI。

選擇品牌體驗並指派樣式

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

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

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

更新和刪除樣式

當您建立樣式時,您可以將其連結至應用程式用戶端。若要變更應用程式用戶端的樣式指派,您必須先刪除原始樣式。目前,您無法在樣式之間複製設定。您必須以程式設計方式執行此操作。若要在樣式和應用程式用戶端之間複寫設定,請使用 DescribeManagedLoginBranding API 操作取得樣式的設定,並使用 CreateManagedLoginBrandingUpdateManagedLoginBranding 套用。您無法變更應用程式用戶端的指派樣式,您只能刪除原始 並設定新的樣式。如需使用 API 和 SDK 操作管理樣式的詳細資訊,請參閱 受管登入品牌 API 和 SDK 操作

注意

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

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

從高階來看,將品牌指派給網域的程序包含下列步驟。

  1. 建立網域並設定品牌版本

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

將樣式指派給應用程式用戶端
  1. 在使用者集區的網域功能表中,建立網域並將品牌版本設定為受管登入

  2. 導覽至受管登入選單。在樣式下,選擇建立樣式

  3. 選擇您要為其指派樣式的應用程式用戶端,或建立新的應用程式用戶端

  4. 若要開始設定您的品牌設定,請選擇啟動品牌設計工具