암호화 미디어 확장

requestMediaKeySystemAccess()는 문자열 encrypted-media로 식별되는 정책 제어 기능이다. 그 기본 허용 목록은 'self'이다 [PERMISSIONS-POLICY].

WebIDL[Exposed=Window]
partial interface Navigator {
  [SecureContext] Promise<MediaKeySystemAccess> requestMediaKeySystemAccess (
      DOMString keySystem,
      sequence<MediaKeySystemConfiguration> supportedConfigurations);
};

WebIDLenum MediaKeysRequirement {
  "required",
  "optional",
  "not-allowed"
};

MediaKeysRequirement 열거형은 다음과 같이 정의된다:

WebIDLdictionary MediaKeySystemConfiguration {
  DOMString                               label = "";
  sequence<DOMString>                     initDataTypes = [];
  sequence<MediaKeySystemMediaCapability> audioCapabilities = [];
  sequence<MediaKeySystemMediaCapability> videoCapabilities = [];
  MediaKeysRequirement                    distinctiveIdentifier = "optional";
  MediaKeysRequirement                    persistentState = "optional";
  sequence<DOMString>                     sessionTypes;
};

MediaKeySystemConfiguration 딕셔너리는 다음 멤버를 포함한다:

label 타입은 DOMString이며, 기본값은 ""

MediaKeySystemConfiguration에 보존될 선택적 레이블이며, getConfiguration() 메서드가 MediaKeySystemAccess에서 반환한다.

initDataTypes 타입은 sequence<DOMString>이며, 기본값은 []

지원되는 초기화 데이터 타입 이름의 목록. 이 객체의 초기화 데이터 타입 기능은 목록이 비어 있거나 다른 모든 멤버와 함께 지원되는 값을 하나 이상 포함하는 경우(알고리즘에 의해 결정된 대로) 지원되는 것으로 간주된다. 시퀀스의 값은 빈 문자열이어서는 안 된다 MUST.

audioCapabilities 타입은 sequence<MediaKeySystemMediaCapability>이며, 기본값은 []

지원되는 오디오 타입 및 기능 쌍의 목록. 이 객체의 오디오 기능은 목록이 비어 있거나, 다른 모든 멤버와 함께 지원되는 값을 하나 이상 포함하는 경우(알고리즘에 의해 결정된 대로) 지원되는 것으로 간주된다. 값 사이에 충돌이 있으면, 앞의 값이 선택된다. 빈 목록은 지원되는 오디오 기능이 없음을 나타낸다. 이 경우, videoCapabilities 요소는 비어 있어서는 안 된다.

videoCapabilities 타입은 sequence<MediaKeySystemMediaCapability>이며, 기본값은 []

지원되는 비디오 타입 및 기능 쌍의 목록. 이 객체의 비디오 기능은 목록이 비어 있거나, 다른 모든 멤버와 함께 지원되는 값을 하나 이상 포함하는 경우(알고리즘에 의해 결정된 대로) 지원되는 것으로 간주된다. 값 사이에 충돌이 있으면, 앞의 값이 선택된다. 빈 목록은 지원되는 비디오 기능이 없음을 나타낸다. 이 경우, audioCapabilities 요소는 비어 있어서는 안 된다.

distinctiveIdentifier 타입은 MediaKeysRequirement이며, 기본값은 "optional"

구별 식별자의 사용이 요구되는지 여부.

이 멤버가 "not-allowed"이면, 구현은 이 구성에서 생성된 어떤 객체와 연결된 어떤 작업에 대해서도 구별 식별자 또는 구별 영구 식별자를 사용해서는 안 된다 MUST NOT.

persistentState 타입은 MediaKeysRequirement이며, 기본값은 "optional"

상태를 영속화하는 능력이 요구되는지 여부. 여기에는 세션 데이터 및 기타 모든 유형의 상태가 포함된다.

이 멤버가 "not-allowed"이면, CDM은 이 객체의 Document의 애플리케이션 또는 출처와 관련된 어떤 상태도 영속화해서는 안 된다 MUST NOT.

참고

이 멤버의 목적상, 영속 상태에는 키 시스템 구현이 제어하는 영속 고유 식별자(구별 식별자)가 포함되지 않는다. distinctiveIdentifier는 이 요구사항을 독립적으로 반영한다.

영속 상태가 지원되지 않는 경우에는 "temporary" 세션만 생성할 수 있다.

참고

"temporary" 세션의 경우, 상태를 저장할 필요와 능력은 키 시스템 구현별이며 사용되는 기능에 따라 달라질 수 있다.

참고

"temporary"가 아닌 세션을 생성하려는 애플리케이션은 requestMediaKeySystemAccess()를 호출할 때 이 멤버를 "required"로 설정해야 한다.

sessionTypes 타입은 sequence<DOMString>

지원되어야 하는 MediaKeySessionType의 목록. 모든 값은 지원되어야 한다.

딕셔너리가 requestMediaKeySystemAccess()에 전달될 때 이 멤버가 존재하지 않으면 [Infra], 딕셔너리는 이 멤버가 [ "temporary" ]로 설정된 것처럼 취급된다.

구현은 이 딕셔너리에 멤버를 추가해서는 안 된다 SHOULD NOT. 멤버가 추가되는 경우, 그것들은 MediaKeysRequirement 타입이어야 MUST 하며, 가장 넓은 범위의 애플리케이션 및 클라이언트 조합을 지원하기 위해 기본값을 "optional"로 가지는 것이 권장된다 RECOMMENDED.

이 딕셔너리는 상태 또는 데이터를 CDM에 전달하는 데 사용되어서는 안 된다 MUST NOT.

WebIDLdictionary MediaKeySystemMediaCapability {
  DOMString contentType = "";
  DOMString? encryptionScheme = null;
  DOMString robustness = "";
};

이 객체가 나타내는 기능이 지원되는 것으로 간주되려면, contentType은 빈 문자열이어서는 안 되며 MUST NOT, 모든 코덱을 포함한 전체 값이 robustness와 함께 지원되어야 MUST 한다.

keySystem 타입은 DOMString이며, 읽기 전용

사용 중인 키 시스템을 식별한다.

getConfiguration()

requestMediaKeySystemAccess() 알고리즘이 선택한 지원되는 구성 옵션 조합을 반환한다.

반환되는 객체는 이 객체로 이행된 프로미스를 반환한 requestMediaKeySystemAccess() 호출에 전달된 첫 번째 충족 가능한 MediaKeySystemConfiguration 구성의 비엄격 부분집합(그리고 암시된 기본값)이다. 그 단일 구성에 지정되지 않은 기능에 대한 값은 포함하지 않으므로(암시된 기본값 제외), 키 시스템 구현의 모든 기능을 반영하지 않을 수 있다. 구성 안의 모든 값은 어떤 조합으로도 사용할 수 있다. MediaKeysRequirement 타입의 멤버는 어떤 조합에 대해 기능이 요구되는지를 반영한다. 그 값은 "optional"이 되지 않는다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 configuration 값을 반환한다.

   주

   이로 인해 이 메서드가 호출될 때마다 configuration에서 새 객체가 생성되고 초기화된다.

   주

   encryptionScheme이 애플리케이션에 의해 제공되지 않았더라도, 누적된 configuration은 여전히 값이 null인 encryptionScheme 필드를 포함해야 MUST 하므로, polyfill은 특정 값을 지정하지 않고도 해당 필드에 대한 사용자 에이전트의 지원 여부를 감지할 수 있다.

createMediaKeys()

keySystem을 위한 새 MediaKeys 객체를 생성한다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. promise를 새 프로미스로 둔다.

2. 다음 단계를 병렬로 실행한다:

   1. configuration을 이 객체의 configuration 값의 값으로 둔다.

   2. configuration의 distinctiveIdentifier 멤버의 값이 "required"이면 use distinctive identifier를 true로 두고, 그렇지 않으면 false로 둔다.

   3. configuration의 persistentState 멤버 값이 "required"이면 persistent state allowed를 true로 두고, 그렇지 않으면 false로 둔다.

   4. 필요한 경우 이 객체의 cdm implementation 값이 나타내는 키 시스템 구현을 로드하고 초기화한다.

   5. instance를 이 객체의 cdm implementation 값이 나타내는 키 시스템 구현의 새 인스턴스로 둔다.

   6. configuration을 사용하여 키 시스템 기능을 활성화, 비활성화 및/또는 선택하도록 instance를 초기화한다.

   7. use distinctive identifier가 false이면, instance가 구별 식별자 및 구별 영구 식별자를 사용하지 못하게 한다.

   8. persistent state allowed가 false이면, instance가 이 객체의 Document의 애플리케이션 또는 출처와 관련된 어떤 상태도 영속화하지 못하게 한다.

   9. 앞의 단계 중 하나라도 실패하면, 적절한 오류 이름을 이름으로 가지는 새 DOMException으로 promise를 거부한다.

   10. media keys를 새 MediaKeys 객체로 두고, 다음과 같이 초기화한다:

       1. use distinctive identifier 값을 use distinctive identifier로 둔다.

       2. persistent state allowed 값을 persistent state allowed로 둔다.

       3. supported session types 값을 configuration의 sessionTypes 멤버 값으로 둔다.

       4. cdm implementation 값을 이 객체의 cdm implementation 값으로 둔다.

       5. cdm instance 값을 instance로 둔다.

   11. promise를 media keys로 이행한다.

3. promise를 반환한다.

createSession()

새 MediaKeySession 객체를 반환한다.

참고

sessionType 매개변수는 반환된 객체의 동작에 영향을 준다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 supported session types 값이 sessionType을 포함하지 않으면, 던진다 [WEBIDL] NotSupportedError.

   참고

   영속 세션 타입인가? 알고리즘이 true를 반환하는 sessionType 값은 이 객체의 persistent state allowed 값이 false이면 실패한다.

2. 구현이 현재 상태에서 MediaKeySession 작업을 지원하지 않으면, 던진다 [WEBIDL] InvalidStateError.

   참고

   일부 구현은 이 MediaKeys 객체가 setMediaKeys()를 사용하여 미디어 요소와 연결될 때까지 MediaKeySession 알고리즘을 실행할 수 없다. 이 단계는 애플리케이션이 그러한 작업을 수행하려고 시도하기 전에 이 드문 동작을 감지할 수 있게 한다.

3. session을 새 MediaKeySession 객체로 두고, 다음과 같이 초기화한다:

   1. sessionId 속성을 빈 문자열로 둔다.

   2. expiration 속성을 NaN으로 둔다.

   3. closed 속성을 새 프로미스로 둔다.

   4. key status를 새 빈 MediaKeyStatusMap 객체로 두고, 다음과 같이 초기화한다:

      1. size 속성을 0으로 둔다.

   5. session type 값을 sessionType으로 둔다.

   6. uninitialized 값을 true로 둔다.

   7. callable 값을 false로 둔다.

   8. closing or closed 값을 false로 둔다.

   9. use distinctive identifier 값을 이 객체의 use distinctive identifier 값으로 둔다.

   10. cdm implementation 값을 이 객체의 cdm implementation으로 둔다.

   11. cdm instance 값을 이 객체의 cdm instance로 둔다.

4. session을 반환한다.

getStatusForPolicy()

주어진 MediaKeysPolicy에 대한 MediaKeyStatus를 반환한다.

WebIDLdictionary MediaKeysPolicy {
    DOMString minHdcpVersion;
};

MediaKeysPolicy 딕셔너리는 선택적 속성만으로 구성된 객체이다. 각 속성은 정책 요구사항을 나타낸다. CDM이 모든 요구사항에 기반하여 복호화된 미디어 데이터의 제시를 허용할 경우, 정책이 충족되었다고 한다.

HDCP 정책은 minHdcpVersion으로 나타낸다. 시스템이 지정된 HDCP 버전 이상을 활성화할 수 있으면, 그 정책은 "usable"의 MediaKeyStatus를 결과로 낳는다. [EME-HDCP-VERSION-REGISTRY]는 minHdcpVersion 값에서 HDCP 명세로의 매핑을 제공한다.

참고

HDCP 상태의 결정은 CDM이 재생 중 그러한 제한을 강제하는 방식과 같은 방식으로 수행되어야 한다. 이렇게 하면 애플리케이션 개발자가 재생을 시작하기 위해 어떤 콘텐츠를 가져올지 최적화할 수 있도록 합리적인 힌트를 얻을 수 있다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. policy에 존재하는 딕셔너리 멤버가 없으면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

2. promise를 새 프로미스로 둔다.

3. 다음 단계를 실행하도록 태스크를 큐에 넣는다:

   1. policy의 각 딕셔너리 멤버에 대해, 다음 단계를 실행한다:

      1. 키가 유효한 MediaKeysPolicy 멤버가 아니거나 값의 타입이 올바르지 않으면, TypeError로 promise를 거부하고 이 단계를 중단한다.

   2. policy의 각 딕셔너리 멤버에 대해, 다음 단계를 실행한다:

      1. CDM이 딕셔너리 멤버에 대한 MediaKeyStatus를 결정할 수 없으면, NotSupportedError로 promise를 거부하고 이 단계를 중단한다.

   3. policy의 각 딕셔너리 멤버에 대해, 다음 단계를 실행한다:

      1. CDM이 딕셔너리 멤버에 대해 복호화된 미디어 데이터의 제시를 차단할 것이라면, promise를 "output-restricted"로 이행하고 이 단계를 중단한다.

   4. promise를 "usable"로 이행한다.

4. promise를 반환한다.

setServerCertificate()

라이선스 서버로 보내는 메시지를 암호화하는 데 사용할 서버 인증서를 제공한다.

그러한 인증서를 사용하는 키 시스템의 경우, 애플리케이션은 서버 인증서를 명시적으로 설정하기 위해 SHOULD setServerCertificate()를 호출해야 한다. 그렇지 않으면 라이선스 교환이 실패할 수 있다.

참고

일부 키 시스템은 "message" 이벤트 큐에 넣기 알고리즘을 통해 서버에서 인증서를 요청하는 것도 지원한다. 하지만 그러한 인증서를 사용하는 모든 키 시스템이 이를 지원하는 것은 아니다.

서버 인증서 내용은 키 시스템별이다. 이는 실행 가능한 코드를 포함해서는 안 된다 MUST NOT.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 cdm implementation 값이 나타내는 키 시스템 구현이 서버 인증서를 지원하지 않으면, false로 이행된 프로미스를 반환한다.

2. serverCertificate가 빈 배열이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

3. certificate를 serverCertificate 매개변수 내용의 사본으로 둔다.

4. promise를 새 프로미스로 둔다.

5. 다음 단계를 병렬로 실행한다:

   1. sanitized certificate를 certificate의 검증 및/또는 정제된 버전으로 둔다.

      참고

      사용자 에이전트는 인증서를 CDM에 전달하기 전에 철저히 검증해야 한다. 여기에는 값이 합리적인 한계 안에 있는지 확인하고, 관련 없는 데이터나 필드를 제거하고, 미리 파싱하고, 정제하고, 및/또는 완전히 정제된 버전을 생성하는 것이 포함될 수 있다. 사용자 에이전트는 필드의 길이와 값이 합리적인지 확인해야 한다. 알 수 없는 필드는 거부하거나 제거해야 한다.

   2. 이 객체의 cdm instance를 사용하여 sanitized certificate를 처리한다.

   3. 앞의 단계가 실패하면, 적절한 오류 이름을 이름으로 가지는 새 DOMException으로 promise를 거부한다.

   4. promise를 true로 이행한다.

6. promise를 반환한다.

이 절은 저장소 및 영속성과 관련된 일반 요구사항을 설명한다.

MediaKeys 객체의 persistent state allowed 값이 false이면, 그 객체의 cdm instance는 이 객체 또는 이 객체가 생성한 어떤 세션에 대한 작업의 결과로 상태를 영속화하거나 이전에 영속화된 상태에 접근해서는 안 된다 SHALL NOT.

MediaKeys 객체의 persistent state allowed 값이 true이면, 그 객체의 cdm instance는 이 객체 또는 이 객체가 생성한 어떤 세션에 대한 작업의 결과로 상태를 영속화하거나 이전에 영속화된 상태에 접근할 수 있다 MAY.

영속화된 데이터는 항상 이 객체의 Document의 출처만 접근할 수 있도록 저장되어야 MUST 한다. 또한 데이터는 현재 브라우징 프로필에서만 접근 가능해야 MUST 한다. 다른 브라우징 프로필, 사용자 에이전트 및 애플리케이션은 저장된 데이터에 접근할 수 있어서는 안 된다 MUST NOT. 사용자 기기에 저장되는 정보를 참고한다.

영속 저장소를 지원할 때의 추가 고려사항은 10. 보안 및 11. 개인정보 보호를 참고한다.

sessionId 타입은 DOMString이며, 읽기 전용

이 객체와 연결된 키 또는 라이선스에 대한 세션 ID.

expiration 타입은 unrestricted double이며, 읽기 전용

세션의 모든 키에 대한 만료 시간, 또는 그러한 시간이 존재하지 않거나 라이선스가 명시적으로 절대 만료되지 않는 경우 NaN으로, 이는 CDM에 의해 결정된다. 이 값은 세션 수명 동안 변경될 수 있으며, 예를 들어 어떤 동작이 윈도우의 시작을 트리거하는 경우가 이에 해당한다.

closed 타입은 Promise<MediaKeySessionClosedReason>이며, 읽기 전용

세션 닫힘 알고리즘이 실행된 결과로 객체가 닫힘 상태가 될 때 신호를 보낸다. 이 프로미스는 이행될 수만 있으며 절대 거부되지 않는다.

keyStatuses 타입은 MediaKeyStatusMap이며, 읽기 전용

세션에 알려진 키 ID에서 연결된 키의 현재 상태로 가는 읽기 전용 맵에 대한 참조. 각 항목은 고유한 키 ID를 가져야 MUST 한다.

참고

맵 항목과 그 값은 이벤트 루프가 도는 언제든 갱신될 수 있다. 맵은 결코 불일치하거나 부분적으로 갱신되어서는 안 되지만 MUST NOT, 접근 사이에 이벤트 루프가 돌면 접근 사이에 변경될 수 있다. 키 ID는 load() 또는 update() 호출의 결과로 추가될 수 있다. 키 ID는 기존 키에 대한 지식을 제거하는(또는 기존 키 집합을 새 집합으로 대체하는) update() 호출의 결과로 제거될 수 있다. 키 ID는 만료와 같이 사용할 수 없게 되었다는 이유로 제거되어서는 안 된다 MUST NOT. 대신, 그러한 키에는 "expired"와 같은 적절한 상태가 주어져야 MUST 한다.

주

일부 오래된 플랫폼에는 키 ID를 노출하지 않는 키 시스템 구현이 포함될 수 있으며, 이로 인해 준수하는 사용자 에이전트 구현을 제공하는 것이 불가능해진다. 그러한 경우 상호 운용성을 극대화하기 위해, 비어 있지 않은 목록이 적절할 때마다 이 객체의 집계된 상태에 가장 적절한 MediaKeyStatus와 1바이트 키 ID 0을 포함하는 단일 쌍으로 맵이 채워진다 (예: 이 객체가 나타내는 키 세션이 키를 포함할 수 있는 경우).

onkeystatuseschange 타입은 EventHandler

keystatuseschange 이벤트에 대한 이벤트 핸들러.

onmessage 타입은 EventHandler

message 이벤트에 대한 이벤트 핸들러.

generateRequest()

initData에 기반하여 라이선스 요청을 생성한다. 알고리즘이 성공하고 프로미스가 이행되면, 타입이 "license-request" 또는 "individualization-request"인 message가 항상 큐에 들어간다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 프로미스를 반환한다.

2. 이 객체의 uninitialized 값이 false이면, InvalidStateError로 거부된 프로미스를 반환한다.

3. 이 객체의 uninitialized 값을 false로 둔다.

4. initDataType이 빈 문자열이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

5. initData가 빈 배열이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

6. 이 객체의 cdm implementation 값이 나타내는 키 시스템 구현이 initDataType을 초기화 데이터 타입으로 지원하지 않으면, NotSupportedError로 거부된 프로미스를 반환한다. 문자열 비교는 대소문자를 구분한다.

7. init data를 initData 매개변수 내용의 사본으로 둔다.

8. session type을 이 객체의 session type으로 둔다.

9. promise를 새 프로미스로 둔다.

10. 다음 단계를 병렬로 실행한다:

    1. init data가 initDataType에 대해 유효하지 않으면, 새로 생성된 TypeError로 promise를 거부한다.

    2. sanitized init data를 init data의 검증되고 정제된 버전으로 둔다.

       사용자 에이전트는 초기화 데이터를 CDM에 전달하기 전에 철저히 검증해야 MUST 한다. 여기에는 필드의 길이와 값이 합리적인지 확인하고, 값이 합리적인 한계 안에 있는지 확인하며, 관련 없거나 지원되지 않거나 알 수 없는 데이터 또는 필드를 제거하는 것이 포함된다. 사용자 에이전트가 초기화 데이터를 미리 파싱하고, 정제하고, 및/또는 완전히 정제된 버전을 생성하는 것이 RECOMMENDED된다. initDataType이 지정한 초기화 데이터 형식이 여러 항목을 지원하는 경우, 사용자 에이전트는 CDM이 필요로 하지 않는 항목을 제거해야 SHOULD 한다. 사용자 에이전트는 초기화 데이터 안의 항목 순서를 다시 정렬해서는 안 된다 MUST NOT.

    3. 앞의 단계가 실패하면, 새로 생성된 TypeError로 promise를 거부한다.

    4. sanitized init data가 비어 있으면, NotSupportedError로 promise를 거부한다.

    5. session id를 빈 문자열로 둔다.

    6. message를 null로 둔다.

    7. message type을 null로 둔다.

    8. cdm을 이 객체의 cdm instance 값이 나타내는 CDM 인스턴스로 둔다.

    9. cdm을 사용하여 다음 단계를 실행한다:

       1. sanitized init data가 cdm에서 지원되지 않으면, NotSupportedError로 promise를 거부한다.

       2. 다음 목록에서 session type의 값에 해당하는 단계를 따른다:

          "temporary"

          requested license type을 영속화할 수 없는 임시 라이선스로 둔다.

          참고

          반환되는 라이선스는 영속화할 수 없어야 하며, 이와 관련된 정보를 영속화할 것을 요구해서도 안 된다.

          "persistent-license"

          requested license type을 영속화 가능한 라이선스로 둔다.

       3. session id를 고유한 세션 ID 문자열로 둔다.

          session type에 대해 영속 세션 타입인가? 알고리즘을 실행한 결과가 true이면, 그 ID는 이 객체의 Document의 출처 안에서, Document와 브라우징 세션 전체를 포함하여 시간에 걸쳐 고유해야 MUST 한다.

       4. requested license type에 대한 라이선스 요청을 sanitized init data에 기반하여 생성할 수 있는 경우:

          1. message를 initDataType에 따라 해석된 sanitized init data에 기반하여 생성된, requested license type에 대한 라이선스 요청으로 둔다.

             cdm은 sanitized init data를 통해 제공되지 않은 미디어 데이터를 포함하여 어떤 스트림별 데이터도 사용해서는 안 된다 MUST NOT.

             cdm은 이 시점에서 세션 ID를 포함한 세션 데이터를 저장해서는 안 된다 SHOULD NOT. 세션 저장소 및 영속성을 참고한다.

          2. message type을 "license-request"로 둔다.

          그 외의 경우:

          1. message를 requested license type에 대한 라이선스 요청을 sanitized init data에 기반하여 생성하기 전에 처리되어야 하는 요청으로 둔다.

             이후 update() 호출에서 CDM은 initDataType에 따라 해석되는 sanitized init data에 기반하여 requested license type에 대한 라이선스 요청을 생성해야 MUST 한다.

          2. message type이 message의 타입, 즉 "license-request" 또는 "individualization-request"를 반영하게 한다.

    10. 다음 단계를 실행하도록 태스크를 큐에 넣는다:

        1. 앞의 단계 중 하나라도 리소스 부족 때문에 실패했으면, QuotaExceededError로 promise를 거부한다.

        2. 앞의 단계 중 하나라도 다른 이유로 실패했으면, 적절한 오류 이름을 이름으로 가지는 새 DOMException으로 promise를 거부한다.

        3. sessionId 속성을 session id로 설정한다.

        4. 이 객체의 callable 값을 true로 설정한다.

        5. promise를 undefined로 이행한다.

        6. session에 대해 "message" 이벤트 큐에 넣기 알고리즘을 실행하고, message type과 message를 제공한다.

11. promise를 반환한다.

load()

지정된 세션에 대해 저장된 데이터를 이 객체로 로드한다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 프로미스를 반환한다.

2. 이 객체의 uninitialized 값이 false이면, InvalidStateError로 거부된 프로미스를 반환한다.

3. 이 객체의 uninitialized 값을 false로 둔다.

4. sessionId가 빈 문자열이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

5. 이 객체의 session type에 대해 영속 세션 타입인가? 알고리즘을 실행한 결과가 false이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

6. origin을 이 객체의 Document의 출처로 둔다.

7. promise를 새 프로미스로 둔다.

8. 다음 단계를 병렬로 실행한다:

   1. sanitized session ID를 sessionId의 검증 및/또는 정제된 버전으로 둔다.

      참고

      사용자 에이전트는 sessionId 값을 CDM에 전달하기 전에 철저히 검증해야 한다. 최소한 여기에는 길이와 값이 합리적인지 확인하는 것(예: 수십 문자보다 길지 않고 영숫자인지)이 포함되어야 한다.

   2. 앞의 단계가 실패했거나 sanitized session ID가 비어 있으면, 새로 생성된 TypeError로 promise를 거부한다.

   3. 이 객체의 Document 안에 닫힘 상태가 아니며, sessionId 속성이 sanitized session ID인 MediaKeySession 객체가 있으면, QuotaExceededError로 promise를 거부한다.

      참고

      다시 말해, 이 브라우징 컨텍스트 안에서 이 sanitized session ID에 대해 닫히지 않은 세션이 타입과 관계없이 이미 존재하면 세션을 만들지 않는다.

   4. expiration time을 NaN으로 둔다.

   5. message를 null로 둔다.

   6. message type을 null로 둔다.

   7. cdm을 이 객체의 cdm instance 값이 나타내는 CDM 인스턴스로 둔다.

   8. cdm을 사용하여 다음 단계를 실행한다:

      1. origin 안에 sanitized session ID에 대해 저장된 데이터가 없으면, promise를 false로 이행하고 이 알고리즘의 병렬 단계를 중단한다.

      2. 저장된 세션의 session type이 현재 MediaKeySession session type과 같지 않으면, 새로 생성된 TypeError로 promise를 거부한다.

      3. session data를 origin 안의 sanitized session ID에 대해 저장된 데이터로 둔다. 이는 다른 출처의 데이터나 출처와 연결되지 않은 데이터를 포함해서는 안 된다 MUST NOT.

      4. 어떤 Document 안에든 닫힘 상태가 아니며 session data를 나타내는 MediaKeySession 객체가 있으면, QuotaExceededError로 promise를 거부한다.

         참고

         다시 말해, 어떤 브라우징 컨텍스트 안에서든 이 sanitized session ID에 대해 닫히지 않은 영속 세션이 이미 존재하면 세션을 만들지 않는다.

      5. session data를 로드한다.

      6. session data가 세션의 만료 시간을 나타내면, expiration time을 그 만료 시간으로 둔다.

      7. 메시지를 보내야 하는 경우, 다음 단계를 실행한다:

         1. message를 session data에 기반하여 생성된 메시지로 둔다.

         2. message type을 그 메시지에 대한 적절한 MediaKeyMessageType으로 둔다.

   9. 다음 단계를 실행하도록 태스크를 큐에 넣는다:

      1. 앞의 단계 중 하나라도 실패했으면, 적절한 오류 이름으로 promise를 거부한다.

      2. sessionId 속성을 sanitized session ID로 설정한다.

      3. 이 객체의 callable 값을 true로 설정한다.

      4. 로드된 세션이 어떤 키에 대한 정보를 포함하면(알려진 키가 있으면), session에 대해 키 상태 갱신 알고리즘을 실행하고, 각 키의 키 ID와 적절한 MediaKeyStatus를 제공한다.

         키의 상태를 확실히 결정하기 위해 추가 처리가 필요하다면 "status-pending"을 사용한다. 하나 이상의 키에 대한 추가 처리가 완료되면, 실제 상태로 키 상태 갱신 알고리즘을 다시 실행한다.

      5. session에 대해 만료 갱신 알고리즘을 실행하고, expiration time을 제공한다.

      6. promise를 true로 이행한다.

      7. message가 null이 아니면, session에 대해 "message" 이벤트 큐에 넣기 알고리즘을 실행하고, message type과 message를 제공한다.

9. promise를 반환한다.

update()

라이선스를 포함한 메시지를 CDM에 제공한다.

response 매개변수는 CDM에 제공할 메시지를 포함한다. 내용은 키 시스템별이다. 이는 실행 가능한 코드를 포함해서는 안 된다 MUST NOT.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 프로미스를 반환한다.

2. 이 객체의 callable 값이 false이면, InvalidStateError로 거부된 프로미스를 반환한다.

3. response가 빈 배열이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

4. response copy를 response 매개변수 내용의 사본으로 둔다.

5. promise를 새 프로미스로 둔다.

6. 다음 단계를 병렬로 실행한다:

   1. sanitized response를 response copy의 검증 및/또는 정제된 버전으로 둔다.

      참고

      사용자 에이전트는 응답을 CDM에 전달하기 전에 철저히 검증해야 한다. 여기에는 값이 합리적인 한계 안에 있는지 확인하고, 관련 없는 데이터나 필드를 제거하고, 미리 파싱하고, 정제하고, 및/또는 완전히 정제된 버전을 생성하는 것이 포함될 수 있다. 사용자 에이전트는 필드의 길이와 값이 합리적인지 확인해야 한다. 알 수 없는 필드는 거부하거나 제거해야 한다.

   2. 앞의 단계가 실패했거나 sanitized response가 비어 있으면, 새로 생성된 TypeError로 promise를 거부한다.

   3. message를 null로 둔다.

   4. message type을 null로 둔다.

   5. session closed를 false로 둔다.

   6. cdm을 이 객체의 cdm instance 값이 나타내는 CDM 인스턴스로 둔다.

   7. cdm을 사용하여 다음 단계를 실행한다:

      1. sanitized response의 형식이 어떤 방식으로든 유효하지 않으면, 새로 생성된 TypeError로 promise를 거부한다.

      2. 다음 목록에서 첫 번째로 일치하는 조건에 대한 규정에 따라 sanitized response를 처리한다:

         sanitized response가 라이선스 또는 키를 포함하는 경우

         참고

         여기에는 초기 라이선스, 갱신된 라이선스, 라이선스 갱신 메시지가 포함된다.

         다음 목록에서 첫 번째로 일치하는 조건에 대한 규정에 따라 sanitized response를 처리한다:

         sessionType이 "temporary"이고 sanitized response가 그 안에 포함된 모든 라이선스, 키 또는 유사한 세션 데이터를 포함한 세션 데이터를 저장해야 한다고 지정하지 않는 경우

         어떤 세션 데이터도 저장하지 않고 sanitized response를 처리한다.

         sessionType이 "persistent-license"이고 sanitized response가 영속화 가능한 라이선스를 포함하는 경우

         sanitized response를 처리하고, sanitized response에 포함된 라이선스/키와 관련 세션 데이터를 저장한다. 그러한 데이터는 이 객체의 Document의 출처만 접근할 수 있도록 저장되어야 MUST 한다.

         그 외의 경우

         새로 생성된 TypeError로 promise를 거부한다.

         세션 저장소 및 영속성도 참고한다.

         각 세션에 대한 키를 포함한 상태 정보는, 중복되는 키 ID를 포함하더라도 하나의 세션을 닫는 것이 다른 세션의 관찰 가능한 상태에 영향을 주지 않는 방식으로 저장되어야 MUST 한다.

         참고

         sanitized response가 키 및/또는 관련 데이터를 포함하는 경우, cdm은 키 ID로 인덱싱된 키와 관련 데이터를 (메모리에) 저장할 가능성이 높다.

         참고

         세션 안에서의 대체 알고리즘은 키 시스템에 따라 다르다.

         참고

         CDM 구현이 표준적이고 합리적으로 높은 MediaKeySession 객체당 최소 키 수와 표준 대체 알고리즘, 그리고 표준적이고 합리적으로 높은 MediaKeySession 객체 수를 지원하는 것이 RECOMMENDED된다. 이는 합리적인 수의 키 로테이션 알고리즘이 사용자 에이전트 전반에서 구현될 수 있게 하며, 같은 요소의 다양한 스트림 (예: 적응형 스트림, 다양한 오디오 및 비디오 트랙)이 서로 다른 키를 사용하는 사용 사례에서 재생 중단 가능성을 줄일 수 있다.

         sanitized response가 라이선스 파기 기록 확인을 포함하고 sessionType이 "persistent-license"인 경우

         다음 단계를 실행한다:

         1. 키 세션을 닫고, 이 객체와 연결된 저장된 모든 세션 데이터를 지운다. 여기에는 sessionId와 라이선스 파기 기록이 포함된다.

            참고

            이후 이 객체의 sessionId 값으로 load()를 호출하면, 해당 세션 ID에 대해 저장된 데이터가 없기 때문에 실패한다.

         2. session closed를 true로 설정한다.

         그 외의 경우

         어떤 세션 데이터도 저장하지 않고 sanitized response를 처리한다.

         참고

         예를 들어, sanitized response는 다른 message 이벤트를 생성하는 데 사용될 정보를 포함할 수 있다. 이 경우, 내용을 sessionType에 대해 검증할 필요가 없다.

      3. 메시지를 보내야 하는 경우, 다음 단계를 실행한다:

         1. message를 그 메시지로 둔다.

         2. message type을 그 메시지에 대한 적절한 MediaKeyMessageType으로 둔다.

   8. 다음 단계를 실행하도록 태스크를 큐에 넣는다:

      1. session closed가 true인 경우:

         이 객체에 대해 이유 "release-acknowledged"와 함께 세션 닫힘 알고리즘을 실행한다.

         그 외의 경우:

         다음 단계를 실행한다:

         1. 이 객체에 대해 CDM에 알려진 키 집합이 변경되었거나 어떤 키의 상태가 변경되었으면, session에 대해 키 상태 갱신 알고리즘을 실행하고, 각 알려진 키의 키 ID와 적절한 MediaKeyStatus를 제공한다.

            키의 상태를 확실히 결정하기 위해 추가 처리가 필요하다면 "status-pending"을 사용한다. 하나 이상의 키에 대한 추가 처리가 완료되면, 실제 상태로 키 상태 갱신 알고리즘을 다시 실행한다.

         2. 세션의 만료 시간이 변경되었으면, session에 대해 만료 갱신 알고리즘을 실행하고, 새 만료 시간을 제공한다.

         3. 앞의 단계 중 하나라도 실패했으면, 적절한 오류 이름을 이름으로 가지는 새 DOMException으로 promise를 거부한다.

         4. message가 null이 아니면, session에 대해 "message" 이벤트 큐에 넣기 알고리즘을 실행하고, message type과 message를 제공한다.

      2. promise를 undefined로 이행한다.

7. promise를 반환한다.

close()

애플리케이션이 더 이상 세션을 필요로 하지 않으며 CDM이 세션과 연결된 모든 리소스를 해제하고 이를 닫아야 함을 나타낸다. 영속화된 데이터는 해제되거나 지워져서는 안 된다.

참고

반환된 프로미스는 요청이 처리되면 이행되며, closed 속성 프로미스는 세션이 닫힐 때 "closed-by-application"로 이행된다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 closing or closed 값이 true이면, undefined로 이행된 프로미스를 반환한다.

2. 이 객체의 callable 값이 false이면, InvalidStateError로 거부된 프로미스를 반환한다.

3. promise를 새 프로미스로 둔다.

4. 이 객체의 closing or closed 값을 true로 설정한다.

5. 다음 단계를 병렬로 실행한다:

   1. cdm을 이 객체의 cdm instance 값이 나타내는 CDM 인스턴스로 둔다.

   2. cdm을 사용하여 이 객체와 연결된 키 세션을 닫는다.

      참고

      키 세션을 닫으면 명시적으로 저장되지 않은 모든 라이선스와 키가 파괴된다.

   3. 다음 단계를 실행하도록 태스크를 큐에 넣는다:

      1. promise를 undefined로 이행한다.

      2. 이 객체에 대해 이유 "closed-by-application"와 함께 세션 닫힘 알고리즘을 실행한다.

6. promise를 반환한다.

remove()

세션과 연결된 모든 라이선스와 키를 제거한다. 영속 세션 타입의 경우, 릴리스 메시지 확인이 update()에 의해 처리되면 각 세션 타입에 대해 정의된 대로 다른 세션 데이터가 지워진다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 프로미스를 반환한다.

2. 이 객체의 callable 값이 false이면, InvalidStateError로 거부된 프로미스를 반환한다.

3. promise를 새 프로미스로 둔다.

4. 다음 단계를 병렬로 실행한다:

   1. cdm을 이 객체의 cdm instance 값이 나타내는 CDM 인스턴스로 둔다.

   2. message를 null로 둔다.

   3. message type을 null로 둔다.

   4. cdm을 사용하여 다음 단계를 실행한다:

      1. 세션과 연결된 라이선스 및/또는 키가 있으면:

         1. 세션과 연결된 라이선스 및/또는 키를 파괴한다.

            참고

            이는 라이선스 및/또는 키가 메모리, 영속 저장소 또는 둘 다에 있는지와 관계없이 이를 파괴함을 의미한다.

         2. 다음 목록에서 이 객체의 session type 값에 해당하는 단계를 따른다:

            "temporary"

            다음 단계를 계속한다.

            "persistent-license"

            1. record of license destruction를 이 객체가 나타내는 라이선스에 대한 라이선스 파기 기록으로 둔다.

            2. record of license destruction를 저장한다.

            3. message를 record of license destruction을 포함하거나 반영하는 메시지로 둔다.

   5. 다음 단계를 실행하도록 태스크를 큐에 넣는다:

      1. session에 대해 키 상태 갱신 알고리즘을 실행하고, 세션 안의 모든 키 ID와 각 키에 대한 "released" MediaKeyStatus 값을 제공한다.

      2. session에 대해 만료 갱신 알고리즘을 실행하고, NaN을 제공한다.

      3. 앞의 단계 중 하나라도 실패했으면, 적절한 오류 이름을 이름으로 가지는 새 DOMException으로 promise를 거부한다.

      4. message type을 "license-release"로 둔다.

      5. promise를 undefined로 이행한다.

      6. message가 null이 아니면, session에 대해 "message" 이벤트 큐에 넣기 알고리즘을 실행하고, message type과 message를 제공한다.

5. promise를 반환한다.

MediaKeyStatusMap 객체는 키 ID에서 연결된 키의 현재 상태로 가는 읽기 전용 맵이다.

키의 상태는 그 키가 현재 사용 중인지 여부 및 미디어 데이터와 독립적이다.

WebIDL[Exposed=Window, SecureContext] interface MediaKeyStatusMap {
  iterable<BufferSource,MediaKeyStatus>;
  readonly attribute unsigned long size;
  boolean has (BufferSource keyId);
  (MediaKeyStatus or undefined) get (BufferSource keyId);
};

WebIDLenum MediaKeyStatus {
  "usable",
  "expired",
  "released",
  "output-restricted",
  "output-downscaled",
  "usable-in-future",
  "status-pending",
  "internal-error"
};

MediaKeyStatus 열거형은 다음과 같이 정의된다:

MediaKeyMessageEvent 객체는 message 이벤트에 사용된다.

WebIDLenum MediaKeyMessageType {
  "license-request",
  "license-renewal",
  "license-release",
  "individualization-request"
};

MediaKeyMessageType은 다음과 같이 정의된다:

WebIDL[Exposed=Window, SecureContext]
interface MediaKeyMessageEvent : Event {
  constructor(DOMString type, MediaKeyMessageEventInit eventInitDict);
  readonly attribute MediaKeyMessageType messageType;
  readonly attribute ArrayBuffer         message;
};

WebIDLdictionary MediaKeyMessageEventInit : EventInit {
  required MediaKeyMessageType messageType;
  required ArrayBuffer         message;
};

메서드는 반환된 프로미스를 simple exception [WEBIDL] 또는 DOMException으로 거부하여 오류를 보고한다. 다음의 simple exceptions 및 [WEBIDL]의 DOMException 이름이 알고리즘에서 사용된다. 알고리즘에서 지정된 원인은 각 이름 옆에 나열되어 있지만, 이 이름들은 다른 이유로도 사용될 수 있다 MAY.

이 절은 알고리즘을 보완하는 세션 저장소와 지속성에 대한 개요를 제공한다.

다음 요구사항은 저장소와 지속성의 요구사항에 추가로 적용된다.

이 객체의 session type에 대해 지속 세션 유형인가? 알고리즘을 실행한 결과가 false이면, 사용자 에이전트와 CDM은 어느 시점에도 세션의 기록이나 세션과 관련된 데이터를 지속시켜서는 MUST NOT 된다. 여기에는 라이선스, 키, 라이선스 폐기 기록, 그리고 세션 ID가 포함된다.

이 절의 나머지는 지속 세션 유형인가? 알고리즘이 true를 반환하는 세션 유형에 적용된다.

CDM은 update()가 처음 호출되기 전까지 세션 ID를 포함한 세션 데이터를 저장하지 않는 것이 SHOULD NOT 된다. 구체적으로, CDM은 generateRequest() 알고리즘 동안 세션 데이터를 저장하지 않는 것이 SHOULD NOT 된다. 이는 애플리케이션이 세션을 인식하고 결국 이를 제거해야 함을 알도록 보장한다.

세션이 삭제될 때 세션과 관련된 모든 데이터는 삭제되어야 MUST 하며, 예를 들어 update()에서 라이선스 폐기 기록 확인 응답을 처리할 때가 이에 해당한다. 지속 데이터를 보라.

CDM은 주어진 세션의 데이터가 어떤 Document에서도 닫히지 않은 하나의 MediaKeySession 객체에만 존재하도록 보장해야 MUST 한다. 다시 말해, sessionId 매개변수로 지정된 세션을 나타내는 MediaKeySession이 이미 있는 경우, load()는 실패해야 MUST 한다. 이는 generateRequest()를 통해 이를 생성한 객체가 여전히 활성 상태이거나, load()를 통해 다른 객체에 로드되었기 때문일 수 있다. 세션은 이를 나타낸 적이 있는 모든 객체가 닫힌 경우에만 다시 로드될 MAY 수 있다.

지속 세션 유형인가? 알고리즘이 true를 반환하는 유형을 사용해 세션을 생성하는 애플리케이션은, 나중에 먼저 remove()를 사용하여 제거 프로세스를 시작한 다음, 메시지 교환을 포함할 수 있는 제거 프로세스가 성공적으로 완료되도록 보장함으로써 저장된 데이터를 제거하는 것이 SHOULD 된다. CDM도 적절한 경우 세션을 제거할 MAY 수 있지만, 애플리케이션은 이에 의존하지 않는 것이 SHOULD NOT 된다.

지속 저장소를 지원할 때의 추가 고려사항은 10. 보안 및 11. 개인정보 보호를 보라.

mediaKeys 타입은 MediaKeys이며, 읽기 전용, nullable

이 미디어 요소에 대한 암호화된 미디어 데이터를 재생 중 복호화할 때 사용되는 MediaKeys.

onencrypted 타입은 EventHandler

encrypted 이벤트에 대한 이벤트 핸들러. 이는 모든 HTMLMediaElement가 콘텐츠 속성과 IDL 속성 모두로 지원해야 MUST 한다.

onwaitingforkey 타입은 EventHandler

waitingforkey 이벤트에 대한 이벤트 핸들러. 이는 모든 HTMLMediaElement가 콘텐츠 속성과 IDL 속성 모두로 지원해야 MUST 한다.

setMediaKeys()

재생 중 미디어 데이터를 복호화할 때 사용할 MediaKeys를 제공한다.

참고

재생 중 연결된 MediaKeys 객체를 지우거나 교체하는 것의 지원은 구현 품질 문제이다. 많은 경우 이는 좋지 않은 사용자 경험이나 거부된 프로미스를 초래한다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행해야 MUST 한다:

1. 이 객체의 attaching media keys 값이 true이면, InvalidStateError로 거부된 프로미스를 반환한다.

2. mediaKeys와 mediaKeys 속성이 같은 객체이면, undefined로 이행된 프로미스를 반환한다.

3. 이 객체의 attaching media keys 값을 true로 둔다.

4. promise를 새 프로미스로 둔다.

5. 다음 단계를 병렬로 실행한다:

   1. 다음 조건이 모두 성립하면:

      • mediaKeys가 null이 아니고,

      • mediaKeys가 나타내는 CDM 인스턴스가 이미 다른 미디어 요소에서 사용 중이며

      • 사용자 에이전트가 이를 이 요소와 함께 사용할 수 없으면

      이 객체의 attaching media keys 값을 false로 두고, QuotaExceededError로 promise를 거부한다.

   2. mediaKeys 속성이 null이 아니면, 다음 단계를 실행한다:

      1. 사용자 에이전트 또는 CDM이 연결 제거를 지원하지 않으면, 이 객체의 attaching media keys 값을 false로 두고 NotSupportedError로 promise를 거부한다.

      2. 연결을 현재 제거할 수 없으면, 이 객체의 attaching media keys 값을 false로 두고 InvalidStateError로 promise를 거부한다.

         참고

         예를 들어, 일부 구현은 재생 중 제거를 허용하지 않을 수 있다.

      3. mediaKeys 속성이 나타내는 CDM 인스턴스를 미디어 데이터 복호화에 사용하는 것을 중지하고, 미디어 요소와의 연결을 제거한다.

      4. 앞의 단계가 실패했으면, 이 객체의 attaching media keys 값을 false로 두고 적절한 오류 이름으로 promise를 거부한다.

   3. mediaKeys가 null이 아니면, 다음 단계를 실행한다:

      1. mediaKeys가 나타내는 CDM 인스턴스를 미디어 데이터 복호화를 위해 미디어 요소와 연결한다.

      2. 앞의 단계가 실패했으면, 다음 단계를 실행한다:

         1. mediaKeys 속성을 null로 설정한다.

         2. 이 객체의 attaching media keys 값을 false로 둔다.

         3. 이름이 적절한 오류 이름인 새 DOMException으로 promise를 거부한다.

      3. 미디어 요소에 대해 필요하면 재생 재개 시도 알고리즘을 실행하도록 태스크를 큐에 넣는다.

   4. mediaKeys 속성을 mediaKeys로 설정한다.

   5. 이 객체의 attaching media keys 값을 false로 둔다.

   6. promise를 undefined로 이행한다.

6. promise를 반환한다.

MediaEncryptedEvent 객체는 encrypted 이벤트에 사용된다.

WebIDL[Exposed=Window]
interface MediaEncryptedEvent : Event {
    constructor(DOMString type, optional MediaEncryptedEventInit eventInitDict = {});
    readonly        attribute DOMString    initDataType;
    readonly        attribute ArrayBuffer? initData;
};

WebIDLdictionary MediaEncryptedEventInit : EventInit {
  DOMString    initDataType = "";
  ArrayBuffer? initData = null;
};

사용자 에이전트 구현자는 CDM이 이 명세의 기능을 사용하여 보호된 미디어를 재생하는 데 합리적으로 필요하지 않은 정보, 저장소 또는 시스템 기능에 접근하지 않도록 보장해야 MUST 한다. 구체적으로, CDM은 다음을 해서는 SHALL NOT 안 된다.

• 이 명세에서 명시적으로 허용한 대로 사용자 에이전트를 통하는 경우를 제외하고, 로컬 또는 원격 네트워크 리소스에 접근하는 것.

• 이 명세의 기능을 사용하여 보호된 미디어를 재생하는 데 합리적으로 필요한 경우를 제외하고, 저장소(예: 디스크 또는 메모리)에 접근하는 것.

• CDM 상태와 지속 데이터 외의 사용자 데이터에 접근하는 것.

• 이 명세의 기능을 사용하여 보호된 미디어를 재생하는 데 합리적으로 필요한 경우를 제외하고, 하드웨어 구성요소 또는 장치에 접근하는 것.

사용자 에이전트 구현자는 위 요구사항을 충족하기 위해 다양한 기법을 사용할 수 있다. 예를 들어, 자체 CDM도 구현하는 사용자 에이전트 구현자는 위 내용을 해당 구성요소의 설계 요구사항으로 포함할 수 있다. 제3자 CDM을 사용하는 사용자 에이전트 구현자는 금지된 정보와 구성요소에 접근할 수 없는 제한된 환경(예: "sandbox")에서 실행되도록 보장할 수 있다.

CDM과 주고받는 모든 메시지와 통신, 예를 들어 CDM과 라이선스 서버 사이의 통신은 사용자 에이전트를 통해 전달되어야 MUST 한다. CDM은 직접적인 대역 외 네트워크 요청을 해서는 MUST NOT 된다. 직접 개별화에 설명된 것 이외의 모든 메시지와 통신은 이 명세에 정의된 API를 통해 애플리케이션을 거쳐 전달되어야 MUST 한다. 구체적으로, 애플리케이션별, 출처별, 또는 콘텐츠별 정보를 포함하거나 애플리케이션이 지정한 URL 또는 그 출처에 기반한 URL로 전송되는 모든 통신은 API를 거쳐야 MUST 한다. 여기에는 모든 라이선스 교환 메시지가 포함된다.

지속 데이터에는 CDM이 저장하거나, CDM을 대신하여 사용자 에이전트가 저장한 모든 데이터 중 MediaKeys 객체의 폐기 후에도 존재하는 데이터가 포함된다. 구체적으로, 여기에는 CDM이 저장하거나 CDM을 대신하여 사용자 에이전트가 저장한 모든 식별자(고유 식별자 포함), 라이선스, 키, 키 ID, 또는 라이선스 폐기 기록이 포함된다.

애플리케이션에 노출되거나, 예를 들어 CDM의 사용을 통해 추론 가능한 값은 식별자로 설계되었는지 여부와 관계없이 클라이언트 또는 사용자를 식별하는 데 사용될 수 있다. 이 절은 그러한 우려를 피하거나 적어도 완화하기 위한 요구사항을 정의한다. 식별자에 대해서는 추가 요구사항이 있다.

구현에서 식별자, 특히 구별 식별자 또는 구별 영구 식별자를 사용하는 것은 개인정보 보호 문제를 제기한다. 이 절은 그러한 우려를 피하거나 적어도 완화하기 위한 요구사항을 정의한다. 애플리케이션에 노출되는 값에 대한 요구사항도 애플리케이션에 노출되는 식별자에 적용된다.

식별자, 특히 고유 식별자는 때때로 개별화 또는 프로비저닝이라고 하는 프로세스를 통해 생성되거나 얻어진다. 그 결과로 생성된 식별자는 애플리케이션에 의해 연관 불가능해야 MUST 하며, 그 사용은 단일 프로필의 단일 출처에만 노출되어야 MUST 한다. 이 프로세스는 식별자가 삭제된 뒤와 같이 여러 번 수행될 MAY 수 있다.

이 프로세스는 사용자 에이전트가 직접 또는 애플리케이션을 통해 수행되어야 MUST 한다. 두 유형의 개별화에 대한 메커니즘, 흐름 및 제한은 다음 절에 설명된 것처럼 서로 다르다. 어떤 방법이 사용되는지는 CDM 구현 및 이 명세의 요구사항, 특히 아래 요구사항의 적용에 따라 달라진다.

구현은 각 MediaKeySession 객체 안에서 여러 키를 지원해야 MUST 한다.

구현은 재생 중 키 간의 끊김 없는 전환을 지원해야 MUST 한다. 여기에는 같은 MediaKeySession 안의 키와 별도의 MediaKeySession 객체 안의 키 모두가 포함된다.

이 절은 이 명세의 구현에서 지원되는 콘텐츠(미디어 리소스)의 속성을 정의한다.

"org.w3.clearkey" 키 시스템은 소스를 복호화하기 위해 평문 clear(암호화되지 않은) 키를 사용한다. 추가적인 클라이언트 측 콘텐츠 보호는 요구되지 않는다. 이 키 시스템은 아래에 설명되어 있다.

{
  "kids": [
    "LwVHf8JLtPrv2GUXFW2v_A",
    "0DdtU9od-Bh5L3xbv0Xf_A"
  ],
  "type": "temporary"
}

{
  "keys": [{
    "kty": "oct",
    "k": "tQ0bJVWb6b0KPL6KtZIy_A",
    "kid": "LwVHf8JLtPrv2GUXFW2v_A"
  }],
  "type": "temporary"
}

{
  "kids": [ "LwVHf8JLtPrv2GUXFW2v_A", "0DdtU9od-Bh5L3xbv0Xf_A" ]
}

{
  "kids": [
    "LwVHf8JLtPrv2GUXFW2v_A",
    "0DdtU9od-Bh5L3xbv0Xf_A"
  ]
}

사용자 에이전트 및 키 시스템 구현은 MUST 미디어 데이터, 초기화 데이터, update()에 전달되는 데이터, 라이선스, 키 데이터, 그리고 애플리케이션이 제공하는 기타 모든 데이터를 신뢰할 수 없는 콘텐츠 및 잠재적 공격 벡터로 간주해야 한다. 이들은 관련 위협을 완화하기 위해 적절한 보호 조치를 사용해야 MUST 하며, 그러한 데이터를 안전하게 파싱하고 복호화하는 등의 주의를 기울여야 한다. 사용자 에이전트는 데이터를 CDM에 전달하기 전에 검증하는 것이 좋다 SHOULD.

구현은 프로그램 제어 흐름에 영향을 주는 능동 콘텐츠 또는 수동 콘텐츠를 애플리케이션에 반환해서는 안 된다 MUST NOT.

사용자 에이전트는 사용자에게 웹을 안전하게 탐색할 수 있는 방법을 제공할 책임이 있다. 이 책임은 제3자의 기능을 포함하여 사용자 에이전트가 사용하는 모든 기능에 적용된다. 사용자 에이전트 구현자는 키 시스템 구현자로부터 충분한 정보를 얻어 키 시스템과의 통합이 갖는 보안 영향을 적절히 평가할 수 있도록 해야 MUST 한다. 사용자 에이전트 구현자는 CDM 구현이 사용자 에이전트가 사용자에게 보안을 제공하는 데 충분한 제어를 제공하거나 및/또는 지원하도록 보장해야 MUST 한다. 사용자 에이전트 구현자는 CDM 구현이 보안 취약점이 발생한 경우 신속하고 사전 예방적으로 업데이트될 수 있고 그렇게 되도록 보장해야 MUST 한다.

완전히 샌드박스화되지 않았거나 및/또는 플랫폼 기능을 사용하는 CDM 구현을 악용하면, 공격자가 OS 또는 플랫폼 기능에 접근하거나 권한을 상승시키거나(예: system 또는 root로 실행), 드라이버, 커널, 펌웨어, 하드웨어 등에 접근할 수 있다. 그러한 기능, 소프트웨어, 하드웨어는 적대적 소프트웨어나 웹 기반 공격에 견고하도록 작성되지 않았을 수 있으며, 특히 사용자 에이전트와 비교할 때 보안 수정으로 업데이트되지 않을 수 있다. CDM 구현의 보안 취약점 수정 업데이트가 없거나, 드물거나, 느리면 위험이 증가한다. 그러한 CDM 구현과 이를 노출하는 UA는 모든 데이터의 구문 분석을 포함하여 보안의 모든 영역에서 특히 주의해야 MUST 한다.

사용자 에이전트가 충분히 샌드박스화하거나 다른 방식으로 보안할 수 없는 키 시스템 구현을 지원하기로 선택한 경우, 사용자 에이전트는 이를 로드하거나 호출하기 전에 사용자가 충분히 정보를 제공받고 및/또는 명시적으로 동의하도록 보장하는 것이 SHOULD 된다.

EME 및 키 시스템에 의해 공개되는 정보에 관한 우려는 두 범주로 나뉜다: (a) 특정적이지는 않지만 사용자 에이전트 또는 기기의 핑거프린팅 가능성에 기여할 수 있는 정보에 대한 우려, 그리고 (b) 사용자 추적에 직접 사용될 수 있는 사용자별 정보.

악성 애플리케이션은 지원되는 키 시스템 목록과 관련 정보를 감지하거나 열거함으로써 사용자나 사용자 에이전트를 핑거프린팅할 수 있을 수 있다. 적절한 출처 보호가 제공되지 않으면, 여기에는 방문한 사이트와 해당 사이트에 저장된 정보의 감지가 포함될 수 있다. 특히 키 시스템은 출처 간에 키 또는 기타 데이터를 공유해서는 안 된다 MUST.

이 명세의 여러 기능은 핑거프린팅에 약간 기여할 수 있는 기능 정보를 노출한다:

• MediaKeySystemMediaCapability의 encryptionScheme 멤버는 키 시스템이 어떤 암호화 스킴을 지원하는지 드러낸다. 이 정보는 대체로 키 시스템 자체에 의해 결정되므로, 애플리케이션의 키 시스템 선택이 이미 암시하는 것을 넘어서는 정보는 거의 추가하지 않는다.

• getStatusForPolicy()는 지정된 HDCP 정책을 강제할 수 있는지 여부를 드러낸다. 이는 현재 연결된 디스플레이 체인의 기능을 반영하며, 사용자가 디스플레이를 재구성하면 세션 중에 변경될 수 있다.

사용자 에이전트는 사용자 익명성을 보존하고/하거나 브라우징 활동 기록이 클라이언트에 영속화되지 않도록 하기 위한 동작 모드(예: 비공개 브라우징)를 지원할 수 있다. 이전 절에서 논의한 개인정보 보호 우려는 그러한 모드를 사용하는 사용자에게 특히 우려될 수 있다.

그러한 모드를 지원하는 사용자 에이전트 구현자는 이러한 모드에서 키 시스템에 대한 접근을 비활성화해야 하는지 신중히 고려하는 것이 좋다 SHOULD. 예를 들어, 그러한 모드는 MediaKeySystemAccess 객체 중 persistentState 또는 distinctiveIdentifier를 지원하거나 사용하는 객체의 생성을 금지할 수 있다 MAY (이는 CDM 구현의 일부로서일 수도 있고, 애플리케이션이 그것들을 "required"라고 표시했기 때문일 수도 있다). 구현이 그러한 생성을 금지하지 않는다면, 이를 허용하기 전에 그러한 모드의 예상되는 개인정보 보호 속성에 대한 의미와 잠재적 결과를 사용자에게 알리는 것이 좋다 SHOULD.

이 명세에 정의된 API는 보안 출처에서만 지원되며, 이전 절에서 논의한 정보를 보호한다. 식별자는 식별자 암호화에 명시된 대로 추가로 암호화된다.

애플리케이션은, 사용하는 서버를 포함하여, CDM으로부터의 데이터나 메시지를 포함하거나 관련된 모든 트래픽에 보안 전송을 사용하는 것이 좋다 SHOULD. 여기에는 message 이벤트에서 전달되는 모든 데이터와 update()에 전달되는 모든 데이터가 포함되지만 이에 국한되지 않는다.

모든 사용자 에이전트는 사용자 에이전트 또는 애플리케이션이 보안 출처와 전송을 강제하려는 경우 안전하지 않은 콘텐츠나 전송에 노출되지 않도록 혼합 콘텐츠 [MIXED-CONTENT]를 적절히 처리해야 MUST 한다.