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

# MediaTailor 파라미터 문제 해결 가이드
<a name="parameter-troubleshooting"></a>

AWS Elemental MediaTailor 는 문자 제한, URL 인코딩 문제 및 구성 별칭 오류를 포함하여 MediaTailor의 일반적인 파라미터 관련 문제를 해결하기 위한 지침을 제공합니다.

## 문자 제한 오류
<a name="parameter-character-restriction-errors"></a>

지원되지 않는 문자가 포함된 파라미터 값은 오류 또는 예기치 않은 동작을 일으킬 수 있습니다.

**일반적인 증상**  
다음 증상은 문자 제한 문제를 나타낼 수 있습니다.
+ 매니페스트 URLs에 나타나지 않는 파라미터
+ 세션 초기화 중 HTTP 400 오류
+ 잘리거나 손상된 파라미터 값
+ 잘못된 URLs

**해결 단계**  
문자 제한 오류를 해결하려면: 

1. 지원되지 않는 문자에 대한 파라미터 값 검토: `:`, `?`, `&`, `=`, `%` `/` 

1. 특수 문자에 적절한 URL 인코딩 적용( 참조[MediaTailor 파라미터 참조 및 제한 사항](parameter-comprehensive-reference.md))

1. `%%%` 또는와 같은 이중 문자를 사용하지 마세요. `==` 

1. 전체 URLs 사용할 수 없는 경우 대체 파라미터 형식을 고려하세요.

**Example URL 인코딩 예제**  
를 사용하는 대신:   

```
manifest.redirect_url=https://example.com/path?param=value
```
URL 인코딩 형식 사용:   

```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```

## 길이 제한 오류
<a name="parameter-length-limitation-errors"></a>

길이 제한을 초과하는 파라미터는 잘리거나 오류가 발생할 수 있습니다.

**길이 제한**  
다음 길이 제한이 적용됩니다([MediaTailor 파라미터 참조 및 제한 사항](parameter-comprehensive-reference.md)자세한 내용은 참조).
+ 매니페스트 쿼리 파라미터(총): 2,000자
+ ADS 파라미터 이름: 10,000자
+ ADS 파라미터 값: 25,000자
+ ADS URLs: 25,000자

**해결 전략**  
길이 제한을 처리하려면: 

1. 가능한 경우 더 짧은 파라미터 이름과 값을 사용합니다.

1. 큰 파라미터 값을 여러 개의 작은 파라미터로 분할

1. 구성 별칭을 사용하여 짧은 별칭을 더 긴 값에 매핑( 참조[MediaTailor 구성 별칭 개요](configuration-aliases-overview.md))

1. 파라미터 참조와 함께 대용량 데이터에 외부 스토리지 사용 고려

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

구성 별칭 문제로 인해 HTTP 400 오류 또는 예기치 않은 파라미터 값이 발생할 수 있습니다.

**일반적인 구성 별칭 오류**  
구성 별칭에서 일반적으로 발생하는 오류는 다음과 같습니다.
+ HTTP 400 오류: 누락되거나 잘못된 별칭 값
+ 도메인 변수가 올바르게 해결되지 않음
+ 플레이어 파라미터가 별칭 값으로 대체되지 않음

**해결 체크리스트**  
구성 별칭 오류를 해결하려면: 

1. 모든 도메인 변수가 로 정의되었는지 확인 `ConfigurationAliases`

1. 플레이어 파라미터 변수가 `player_params.` 접두사를 사용하는지 확인

1. 별칭이 지정된 값 목록이 중요한 URLs(`VideoContentSourceUrl`, `AdSegmentUrlPrefix`, `ContentSegmentUrlPrefix`)의 도메인 변수에 대해 완전한지 확인합니다.

1. 세션 초기화 요청이 유효한 별칭 값을 지정하는지 확인

1. ConfigurationAliases 파라미터의 JSON 구조 검증

자세한 문제 해결 지침은 섹션을 참조하세요[MediaTailor 구성 별칭 문제 해결 가이드](configuration-aliases-troubleshooting.md).

**Example 구성 별칭 검증**  
구성에 필요한 모든 별칭이 포함되어 있는지 확인합니다.  

```
"ConfigurationAliases": {
    "player_params.origin_domain": {
        "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
        "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
        // Must include all possible values used in session initialization
    }
}
```

## 파라미터 처리 흐름 문제
<a name="parameter-processing-flow-issues"></a>

파라미터 처리 흐름을 이해하면 파라미터 전달 및 변환 문제를 해결하는 데 도움이 됩니다.

**파라미터 처리 순서**  
MediaTailor는 다음 순서로 파라미터를 처리합니다.

1. 세션 초기화 파라미터 검증

1. 구성 별칭 확인(해당하는 경우)

1. 파라미터 필터링(ADS vs 오리진 vs 매니페스트)

1. URL 인코딩 및 형식 지정

1. URLs에 대한 파라미터 애플리케이션

**파라미터 흐름 디버깅**  
파라미터 처리 문제를 디버깅하려면: 

1. 세션 초기화 시 파라미터가 올바르게 지정되었는지 확인

1. 구성 별칭이 예상 값으로 확인되는지 확인

1. 파라미터가 올바른 URLs)에 나타나는지 확인

1. URL 인코딩이 올바르게 적용되었는지 확인

**Example 파라미터 흐름 예제**  
세션 초기화:   

```
POST master.m3u8
{
    "playerParams": {"origin_domain": "pdx"},
    "manifestParams": {"test": "123"}
}
```
별칭 확인 및 처리 후:   
+ 오리진 요청: `https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ 매니페스트 URL: `/v1/master/.../index.m3u8?aws.sessionId=session&test=123`

## 보안 고려 사항 및 모범 사례
<a name="parameter-security-considerations-troubleshooting"></a>

MediaTailor는 파라미터 처리를 위한 보안 조치를 구현하여 일반적인 보안 문제를 방지합니다.

**보안 조치**  
MediaTailor는 다음과 같은 보안 조치를 구현합니다.

1. 데이터베이스 팽창을 방지하기 위한 입력 크기 제한

1. 사용자 입력의 적절한 인코딩 및 삭제

1. 응답 손상을 방지하기 위한 입력의 URL 인코딩

**모범 사례**  
안전한 파라미터 처리를 위해 다음 모범 사례를 따르세요.
+ 전송하기 전에 클라이언트 측의 파라미터 값 검증
+ 구성 별칭을 사용하여 가능한 파라미터 값 제한
+ 파라미터에 민감한 정보를 포함하지 마세요.
+ 파라미터 사용량에서 비정상적인 패턴 모니터링
+ 파라미터 값을 권장 길이 제한 이내로 유지