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

# MediaTailor 구성 별칭 문제 해결 가이드
<a name="configuration-aliases-troubleshooting"></a>

AWS Elemental MediaTailor 는 일반적인 구성 별칭 문제 및 오류 시나리오에 대한 체계적인 문제 해결 지침을 제공합니다.

## 구성 별칭 검증 오류
<a name="configuration-alias-validation-errors"></a>

구성 별칭이 누락되거나 유효하지 않은 경우 MediaTailor는 문제를 식별하는 데 도움이 되도록 특정 오류 응답을 반환합니다.

**일반적인 오류 시나리오**  
다음 표에서는 일반적인 구성 별칭 오류와 해결 단계를 설명합니다.


| 오류 | 원인 | 해결 방법 | 
| --- | --- | --- | 
| HTTP 400: 잘못된 플레이어 파라미터 별칭 | ConfigurationAliases에서 플레이어 파라미터 값을 찾을 수 없음 | 플레이어 파라미터 값이 해당 ConfigurationAliases 매핑에 키로 존재하는지 확인 | 
| HTTP 400: 필수 구성 별칭 누락 | 해당 ConfigurationAliases 항목 없이 사용되는 도메인 변수 | 필요한 모든 별칭 매핑을 사용하여 누락된 플레이어 파라미터를 ConfigurationAliases에 추가 | 
| HTTP 400: 구성 검증 실패 | ConfigurationAliases 구조의 형식이 잘못되었거나 불완전함 | JSON 구조를 검증하고 모든 도메인 변수에 해당 별칭이 있는지 확인합니다. | 
| URLs의 빈 문자열 대체 | 도메인이 아닌 변수 별칭을 찾을 수 없음 | 누락된 별칭 매핑 추가 또는 ConfigurationAliases에 기본값 제공 | 

**검증 체크리스트**  
다음 체크리스트를 사용하여 구성 별칭 설정을 검증합니다.

1. **도메인 변수 적용 범위:** URLs 있는지 확인합니다. ConfigurationAliases 

1. **별칭 완전성:** 가능한 모든 플레이어 파라미터 값이 별칭 매핑에 키로 포함되어 있는지 확인합니다.

1. **JSON 구조:** ConfigurationAliases JSON의 형식이 올바르게 지정되고 중첩되었는지 확인

1. **파라미터 이름 지정:** 모든 플레이어 파라미터가 `player_params.` 접두사를 사용하는지 확인

1. **값 일관성:** 별칭 값이 의도한 용도에 맞는지 확인(URLs, 프로필 이름 등)

## 구성 별칭 확인 디버깅
<a name="configuration-alias-debugging"></a>

이 체계적인 접근 방식을 따라 구성 별칭 해결 문제를 디버깅합니다.

**Step-by-step 디버깅 방법론**  
다음 단계에 따라 구성 별칭 문제를 식별하고 해결합니다.

**구성 별칭 디버깅 절차**

1. **구성 구조 확인:** 재생 구성에 올바른 형식의 ConfigurationAliases가 포함되어 있는지 확인합니다.

   ```
   {
       "ConfigurationAliases": {
           "player_params.example_param": {
               "alias1": "value1",
               "alias2": "value2"
           }
       }
   }
   ```

1. **플레이어 파라미터 형식 확인:** 세션 초기화에 올바른 형식의 플레이어 파라미터가 포함되어 있는지 확인합니다.

   ```
   {
       "playerParams": {
           "example_param": "alias1"
       }
   }
   ```

1. **별칭 매핑 검증:** 플레이어 파라미터 값("alias1")이 ConfigurationAliases 매핑에 키로 존재하는지 확인합니다.

1. **간단한 구성으로 테스트:** 최소한의 구성으로 시작하여 문제를 격리합니다.

1. **오류 응답 모니터링:** 특정 검증 메시지에 대한 MediaTailor 오류 응답 확인

1. **해결된 URLs 확인:** 최종 해결된 URLs 유효하고 액세스 가능한지 확인

## 구성 별칭 모범 사례
<a name="configuration-alias-best-practices"></a>

다음 모범 사례를 따라 안정적인 구성 별칭 구현을 보장합니다.

**보안 고려 사항**  
구성 별칭을 사용할 때 다음 보안 조치를 구현합니다.
+ **입력 검증:** 별칭 확인에 사용하기 전에 모든 플레이어 파라미터 값을 검증합니다.
+ **별칭 값 삭제: **별칭 값에 예상 문자 및 형식만 포함되는지 확인합니다.
+ **도메인 제한:** 도메인 별칭을 신뢰할 수 있고 제어된 도메인으로 제한
+ **액세스 제어:** 권한 있는 직원으로만 구성 수정 제한

**성능 최적화**  
다음 권장 사항을 사용하여 구성 별칭 성능을 최적화합니다.
+ **별칭 수 최소화:** 처리 오버헤드를 줄이기 위해 필요한 별칭만 사용
+ **효율적인 이름 지정:** 별칭 및 파라미터에 명확하고 일관된 이름 지정 규칙 사용
+ **기본값:** 일반적인 사용 사례에 적합한 기본 별칭 제공
+ **구성 캐싱:** MediaTailor의 구성 캐싱을 활용하여 성능 향상

**유지 관리 및 모니터링**  
다음 방법을 사용하여 안정적인 구성 별칭 작업을 유지합니다.
+ **정기적인 검증:** 모든 별칭 매핑이 최신이고 작동하는지 정기적으로 검증합니다.
+ **오류 모니터링:** 누락되거나 잘못된 별칭과 관련된 HTTP 400 오류 모니터링
+ **설명서:** 모든 별칭 매핑 및 용도에 대한 명확한 설명서 유지
+ **테스트 절차:** 모든 별칭 조합에 대한 포괄적인 테스트 구현