Crate pssh_box

Parsing and serialization support for pssh boxes, as used in DRM systems.

This crate defines Rust data structures allowing you to store, parse and serialize Protection System Specific Header (PSSH) boxes, which provide data for the initialization of a Digital Rights Management (DRM) system. PSSH boxes are used:

• in an MP4 box of type pssh in an MP4 fragment (CMAF/MP4/ISOBMFF containers)

• in a <cenc:pssh> element in a DASH MPD manifest

• in DRM initialization data passed to the Encrypted Media Extension of a web browser

• in an EXT-X-SESSION-KEY field of an m3u8 playlist.

A PSSH box includes information for a single DRM system. This library supports the PSSH data formats for the following DRM systems:

• Widevine, owned by Google, widely used for DASH streaming
• PlayReady, owned by Microsoft, widely used for DASH streaming
• WisePlay, owned by Huawei
• Irdeto
• Marlin
• Nagra
• FairPlay (the unofficial version used by Netflix)
• Common Encryption

PSSH boxes contain (depending on the DRM system) information on the key_ID for which to obtain a content key, the encryption scheme used (e.g. cenc, cbc1, cens or cbcs), the URL of the licence server, and checksum data.

Modules

irdeto

Definitions for PSSH data in the Irdeto DRM system.

nagra

Definitions for PSSH data in the Nagra DRM system.

playready

Definitions for PSSH data in the PlayReady DRM system.

widevine

Definitions for PSSH data in the Widevine DRM system.

wiseplay

Definitions for PSSH data in the WisePlay DRM system.

Structs

DRMKeyId

The Content Key or default_KID.

DRMSystemId

The identifier for a DRM system.

PsshBox

A PSSH box, also called a ProtectionSystemSpecificHeaderBox in ISO 23001-7:2012.

PsshBoxVec

Enums

PsshData

Data in a PSSH box whose format is dependent on the DRM system used.

Constants

CENC_SYSTEM_ID

COMMON_SYSTEM_ID

FAIRPLAYNFLX_SYSTEM_ID

IRDETO_SYSTEM_ID

MARLIN_SYSTEM_ID

NAGRA_SYSTEM_ID

PLAYREADY_SYSTEM_ID

WIDEVINE_SYSTEM_ID

WISEPLAY_SYSTEM_ID

Traits

ToBytes

Functions

find_iter

Locate the positions of a PsshBox in a buffer, if present. Returns an iterator over start positions for PSSH boxes in the buffer.

from_base64

Parse one or more PSSH boxes from some initialization data encoded in base64 format.

from_buffer

Read one or more PSSH boxes from a slice of octets, stopping (but not returning an error) when non-PSSH data is found in the slice. An error is returned if the parsing fails.

from_bytes

Read one or more PSSH boxes from some initialization data provided as a slice of octets, returning an error if any non-PSSH data is found in the slice or if the parsing fails.

from_hex

Parse one or more PSSH boxes from some initialization data encoded in hex format.

pprint

Multiline pretty printing of a PsshBox (verbose alternative to to_string() method).

version

The version of this crate.