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

# 관리형 로그인 페이지에 브랜딩 적용
<a name="managed-login-branding"></a>

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

**참고**  
브랜딩 스타일을 생성하거나 업데이트하는 프로그래밍 방식의 요청은 요청 크기가 2MB 이하여야 합니다. 요청이 이 제한보다 크면 최대 `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)