MediaTailor 파라미터 문제 해결 - AWS Elemental MediaTailor
문자 제한 오류길이 제한 오류구성 별칭 오류파라미터 처리 흐름 문제보안 고려 사항 및 모범 사례

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

MediaTailor 파라미터 문제 해결

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

문자 제한 오류

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

일반적인 증상

다음 증상은 문자 제한 문제를 나타낼 수 있습니다.

  • 매니페스트 URLs에 나타나지 않는 파라미터

  • 세션 초기화 중 HTTP 400 오류

  • 잘리거나 손상된 파라미터 값

  • 잘못된 URLs

해결 단계

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

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

  2. 특수 문자에 적절한 URL 인코딩 적용( 참조MediaTailor 파라미터 참조 및 제한 사항)

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

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

예 URL 인코딩 예제

를 사용하는 대신: 

manifest.redirect_url=https://example.com/path?param=value

URL 인코딩 형식 사용: 

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

길이 제한 오류

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

길이 제한

다음 길이 제한이 적용됩니다(MediaTailor 파라미터 참조 및 제한 사항자세한 내용은 참조).

  • 매니페스트 쿼리 파라미터(총): 2,000자

  • ADS 파라미터 이름: 10,000자

  • ADS 파라미터 값: 25,000자

  • ADS URLs: 25,000자

해결 전략

길이 제한을 처리하려면:

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

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

  3. 구성 별칭을 사용하여 짧은 별칭을 더 긴 값에 매핑( 참조MediaTailor 구성 별칭 및 동적 변수 교체)

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

구성 별칭 오류

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

일반적인 구성 별칭 오류

구성 별칭에서 일반적으로 발생하는 오류는 다음과 같습니다.

  • HTTP 400 오류: 별칭 값이 누락되었거나 유효하지 않음

  • 도메인 변수가 올바르게 해결되지 않음

  • 플레이어 파라미터가 별칭 값으로 대체되지 않음

해결 체크리스트

구성 별칭 오류를 해결하려면:

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

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

  3. 모든 플레이어 파라미터에 대해 별칭이 지정된 값 목록이 완전한지 확인합니다.

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

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

자세한 문제 해결 지침은 섹션을 참조하세요MediaTailor 구성 별칭 문제 해결.

예 구성 별칭 검증

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

"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
    }
}

파라미터 처리 흐름 문제

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

파라미터 처리 순서

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

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

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

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

  4. URL 인코딩 및 형식 지정

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

파라미터 흐름 디버깅

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

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

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

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

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

예 파라미터 흐름 예제

세션 초기화: 

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

보안 고려 사항 및 모범 사례

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

보안 조치

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

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

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

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

모범 사례

안전한 파라미터 처리를 위해 다음 모범 사례를 따르세요.

  • 전송하기 전에 클라이언트 측의 파라미터 값 검증

  • 구성 별칭을 사용하여 가능한 파라미터 값 제한

  • 파라미터에 민감한 정보를 포함하지 마세요.

  • 파라미터 사용량에서 비정상적인 패턴 모니터링

  • 파라미터 값을 권장 길이 제한 이내로 유지