기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
관리형 로그인 페이지에 브랜딩 적용
인증 서비스와 애플리케이션 간에 일관된 사용자 환경을 제공할 수 있습니다. 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 콘솔에서 스타일을 삭제합니다. 스타일에서 삭제할 스타일을 선택하고 스타일 삭제를 선택합니다.
높은 수준에서 도메인에 브랜딩을 할당하는 프로세스는 다음 단계로 구성됩니다.
-
브랜딩 스타일을 생성하고 앱 클라이언트에 할당합니다.
앱 클라이언트에 스타일을 할당하려면
-
사용자 풀의 도메인 메뉴에서 도메인을 생성하고 브랜딩 버전을 관리형 로그인으로 설정합니다.
-
관리형 로그인 메뉴로 이동합니다. 스타일에서 스타일 생성을 선택합니다.
-
스타일을 할당할 앱 클라이언트를 선택하거나 새 앱 클라이언트를 생성합니다.
-
브랜딩 설정 구성을 시작하려면 브랜딩 디자이너 시작을 선택합니다.