관리형 로그인 페이지에 브랜딩 적용 - Amazon Cognito

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

관리형 로그인 페이지에 브랜딩 적용

인증 서비스와 애플리케이션 간에 일관된 사용자 환경을 제공할 수 있습니다. AWS SDK에서 사용자 지정 양식 및 백엔드 API 작업을 사용하거나 관리형 로그인을 사용하여이 목표를 달성할 수 있습니다. 관리형 로그인 및 클래식 호스팅 UI는 사용자 풀로 인증을 제공하는 애플리케이션의 구성 요소에 대한 웹 프런트 엔드입니다. 관리형 인증 서비스를 애플리케이션 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를 제공합니다. 스타일은 앱 클라이언트에 적용되는 사용자 지정 설정 세트입니다. 사용자 풀당 사용자 지정 도메인 하나와 접두사 도메인 하나를 설정할 수 있습니다. 사용자 지정 도메인과 접두사 도메인에 다른 브랜딩 버전을 할당할 수 있습니다. 그러나 사용자 지정 도메인도 있는 경우 접두사 도메인이 완전히 작동하지 않습니다. .well-known OIDC 검색 엔드포인트에는 사용자 지정 도메인 경로 있습니다. 이 구성의 사용자 풀에서 엔드포인트 검색(openid-configuration)이 필요하지 않은 작업에만 접두사 도메인을 사용할 수 있습니다. 이러한 사용자 풀 속성으로 인해 사용자 풀당 하나의 브랜딩 버전을 효과적으로 선택할 수 있습니다.

도메인이 관리형 로그인 브랜딩 버전으로 설정된 사용자 풀의 앱 클라이언트에 스타일을 할당할 수 있습니다. 스타일은 이미지 파일, 표시 옵션, CSS 값으로 구성된 시각적 설정 세트입니다. 앱 클라이언트에 스타일을 할당하면 Amazon Cognito는 사용자 대화형 로그인 페이지에 업데이트를 즉시 푸시합니다. Amazon Cognito는 선택한 브랜딩 버전과 사용자가 적용한 사용자 지정으로 사용자-대화형 페이지를 렌더링합니다.

스타일 업데이트 및 삭제

스타일을 생성할 때 이를 앱 클라이언트에 연결합니다. 앱 클라이언트에 대한 스타일 할당을 변경하려면 먼저 원래 스타일을 삭제해야 합니다. 현재는 스타일 간에 설정을 복사할 수 없습니다. 프로그래밍 방식으로이 작업을 수행해야 합니다. 스타일 및 앱 클라이언트 간에 설정을 복제하려면 DescribeManagedLoginBranding API 작업을 사용하여 스타일 설정을 가져와서 CreateManagedLoginBranding 또는 UpdateManagedLoginBranding을 사용하여 적용합니다. 앱 클라이언트의 할당된 스타일은 변경할 수 없습니다. 원본만 삭제하고 새 스타일을 설정할 수 있습니다. API 및 SDK 작업을 사용한 스타일 관리에 대한 자세한 내용은 섹션을 참조하세요관리형 로그인 브랜딩을 위한 API 및 SDK 작업.

참고

브랜딩 스타일을 생성하거나 업데이트하는 프로그래밍 방식의 요청은 요청 크기가 2MB 이하여야 합니다. 요청이이 제한보다 큰 경우 최대 UpdateManagedLoginBranding 요청 크기를 초과하지 않는 파라미터 그룹에 대한 여러 요청으로 요청을 분류합니다. 이러한 요청으로 인해 지정되지 않은 파라미터가 기본값으로 설정되지 않으므로 기존 설정에 영향을 주지 않고 부분 요청을 보낼 수 있습니다.

관리형 로그인 메뉴에서 Amazon Cognito 콘솔에서 스타일을 삭제합니다. 스타일에서 삭제할 스타일을 선택하고 스타일 삭제를 선택합니다.

높은 수준에서 도메인에 브랜딩을 할당하는 프로세스는 다음 단계로 구성됩니다.

  1. 도메인을 생성하고 브랜딩 버전을 설정합니다.

  2. 브랜딩 스타일을 생성하고 앱 클라이언트에 할당합니다.

앱 클라이언트에 스타일을 할당하려면
  1. 사용자 풀의 도메인 메뉴에서 도메인을 생성하고 브랜딩 버전을 관리형 로그인으로 설정합니다.

  2. 관리형 로그인 메뉴로 이동합니다. 스타일에서 스타일 생성을 선택합니다.

  3. 스타일을 할당할 앱 클라이언트를 선택하거나 새 앱 클라이언트를 생성합니다.

  4. 브랜딩 설정 구성을 시작하려면 브랜딩 디자이너 시작을 선택합니다.