다음을 통해 공유

콘텐츠 보호 시나리오 기반 마이그레이션 지침

  • 아티클

마이그레이션 가이드 로고

마이그레이션 2단계

중요

V2 API 사용 중단이 Azure Media Services의 사용 중지와 일치하기 때문에 더 이상 Azure Media Service v2에서 v3으로 마이그레이션할 필요가 없습니다. 자세한 내용은 Azure Media Services 사용 중지 가이드 를 참조하세요.

이 문서에서는 v2 API에서 새 Azure Media Services v3 API로 콘텐츠 보호 사용 사례를 마이그레이션하는 방법에 대한 세부 정보 및 지침을 제공합니다.

v3 API에서 콘텐츠 보호

구체적인 단계는 이 문서의 끝에 있는 콘텐츠 보호 개념, 자습서 및 방법 가이드를 참조하세요.

참고

이 문서의 나머지 부분에서는 .NET을 사용하여 v2 콘텐츠 보호를 v3으로 마이그레이션하는 방법에 대해 설명합니다. 다른 언어나 방법에 대한 지침 또는 샘플 코드가 필요한 경우 이 페이지에 대한 GitHub 문제를 만드세요.

독립 실행형 라이선스 제공 서버로 AMS 사용 중단(하이브리드 온-프레미스 모드)

v3 API는 더 이상 키 제공 서비스를 다른 타사 원본 서버를 통해 스트리밍 또는 제공되는 콘텐츠에 대한 라이선스를 제공하는 데 키 제공 서비스를 사용할 수 있는 콘텐츠 보호를 위한 독립 실행형 기능으로 사용할 수 없습니다. 즉, AMS는 더 이상 V3 API에서 키 제공 전용 시나리오를 지원하지 않으며 v3로 제공할 때 동적 패키징 및 암호화를 사용하여 AMS 원본 서비스에서 스트리밍해야 합니다.

v2 API를 사용하여 암호화되고 "하이브리드" 모델로 제공된 기존 콘텐츠는 계속 작동하지만(키는 데이터 평면에서 계속 검색 가능), v2 관리 평면 또는 v3 관리 평면을 통한 키 관리(업데이트 및 편집)는 2024년 2월 29일 이후에 더 이상 작동하지 않습니다.

참고

v3를 사용하여 제공되는 모든 새 콘텐츠는 AMS에서 콘텐츠 보호 및 스트리밍만 지원하며 더 이상 "하이브리드" 모드를 지원하지 않습니다. 데이터 평면은 v2에서 만든 기존 키와 라이선스를 계속 제공하지만 더 이상 v2 또는 v3 API를 통한 관리 또는 업데이트를 지원하지 않습니다.

v2 자산, 스트리밍 로케이터 및 속성의 v3 표시 여부

v2 API에서 Assets, StreamingLocators 및 ContentKeys는 스트리밍 콘텐츠를 보호하는 데 사용되었습니다. v3 API로 마이그레이션할 때 v2 API Assets, StreamingLocators 및 ContentKeys는 모두 v3 API에 자동으로 노출되며 모든 데이터에 액세스할 수 있습니다.

그러나 v2에서 생성된 v2 항목의 속성은 v3 API를 통해 업데이트할 수 없습니다.

v2 엔터티에 저장된 콘텐츠를 업데이트하거나 변경해야 하는 경우 v2 API를 사용하여 업데이트하거나 새 v3 API 엔터티를 만들어 마이그레이션해야 합니다.

자산 식별자 차이점

마이그레이션하려면 v2 자산에서 속성 또는 콘텐츠 키에 액세스해야 합니다. v2 API는 AssetId를 기본 식별 키로 사용하지만 새로운 v3 API는 엔터티의 Azure Resource Management 이름을 기본 식별자로 사용한다는 점을 이해하는 것이 중요합니다. (v2 Asset.Name 속성은 고유 식별자로 사용되지 않습니다.) v3 API를 사용하면 v2 자산 이름이 이제 Asset.Description으로 표시됩니다.

예를 들어 이전에 ID가 nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8인 v2 자산이 있었다면 이제 식별자가 GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8 끝에 있습니다. V3 API를 통해 v2 자산을 나열할 때 이를 확인할 수 있습니다.

v2 API를 사용하여 생성 및 게시된 모든 자산에는 StreamingPolicy의 기본 콘텐츠 키 정책 대신 v3 API의 ContentKeyPolicy 및 ContentKey가 있습니다.

자세한 내용은 콘텐츠 키 정책 문서 및 스트리밍 정책 문서를 참조하세요.

AMSE(Azure Media Services 탐색기) v2 및 AMSE v3 도구를 나란히 사용

v3 Azure Media Services 탐색기 도구와 함께 v2 Azure Media Services 탐색기 도구를 사용하여 v2 API를 통해 생성 및 게시된 자산의 데이터를 나란히 비교할 수 있습니다. 속성은 모두 다른 위치에 표시되어야 합니다.

.NET 콘텐츠 보호 마이그레이션 샘플 사용

Media Services 코드 샘플의 ContentProtection에서 v2tov3MigrationSample을 사용하여 자산 식별자의 차이점을 비교하는 코드 샘플을 찾을 수 있습니다.

스트리밍 로케이터 나열

자산 항목에서 새로운 v3 메서드 ListStreamingLocators를 사용하여 v2 API에서 생성된 자산과 연결된 StreamingLocators를 쿼리할 수 있습니다. ListStreamingLocatorsAsync의 .NET 클라이언트 SDK 버전도 참조하세요.

ListStreamingLocators 메서드의 결과는 StreamingPolicyName과 함께 로케이터의 Name 및 StreamingLocatorId를 제공합니다.

콘텐츠 키 찾기

StreamingLocators와 함께 사용된 ContentKeys를 찾으려면 StreamingLocator.ListContentKeysAsync 메서드를 호출하면 됩니다.

v3 API의 콘텐츠 보호에 대한 자세한 내용은 Media Services 동적 암호화를 사용하여 콘텐츠 보호 문서를 참조하세요.

동일한 ContentKey를 유지하는 v2 ContentKeyPolicy 변경

먼저 v2 SDK를 통해 자산의 게시를 취소(모든 스트리밍 로케이터 제거)해야 합니다. 방법은 다음과 같습니다.

  1. 로케이터를 삭제합니다.
  2. ContentKeyAuthorizationPolicy의 연결을 해제합니다.
  3. AssetDeliveryPolicy의 연결을 해제합니다.
  4. ContentKey의 연결을 해제합니다.
  5. ContentKey를 삭제합니다.
  6. v3 StreamingPolicy 및 ContentKeyPolicy를 사용하여 v3에서 새 StreamingLocator를 생성하고 필요한 특정 콘텐츠 키 식별자와 키 값을 지정합니다.

참고

v3 API를 사용하여 v2 로케이터를 삭제할 수 있지만, v2 API에서 만들어진 콘텐츠 키 또는 콘텐츠 키 정책은 제거되지 않습니다.

콘텐츠 보호 개념, 자습서 및 방법 가이드

개념

자습서

빠른 시작: 포털을 사용한 콘텐츠 암호화

방법 가이드

도구

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 질문하거나 업데이트를 따를 수 있습니다.