Use encryptionContractConfiguration to configure one or more content encryption keys for your endpoints that use SPEKE 2.0. The encryption contract defines which content keys are used to encrypt the audio and video tracks in your stream. To configure the encryption contract, specify which audio and video encryption presets to use.
Note the following considerations when using encryptionContractConfiguration:
• encryptionContractConfiguration can be used for DASH endpoints that use SPEKE 2.0. SPEKE 2.0 relies on the CPIX 2.3 specification.
• You must disable key rotation for this endpoint by setting keyRotationIntervalSeconds to 0.
presetSpeke20Audio
A collection of audio encryption presets.
Value description:
• PRESET-AUDIO-1 - Use one content key to encrypt all of the audio tracks in your stream.
Type: string Required: True
Values: PRESET-AUDIO-1
presetSpeke20Video
A collection of video encryption presets.
Value description:
• PRESET-VIDEO-1 - Use one content key to encrypt all of the video tracks in your stream.
Type: string Required: True
Values: PRESET-VIDEO-1
HlsManifest
A HTTP Live Streaming (HLS) manifest configuration on a CMAF endpoint.
adMarkers
Controls how ad markers are included in the packaged endpoint. Valid values are none, passthrough, scte35_enhanced, or daterange.
Properties
• NONE - omits all SCTE-35 ad markers from the output.
• PASSTHROUGH - creates a copy in the output of the SCTE-35 ad markers (comments) taken directly from the input manifest.
• SCTE35_ENHANCED - generates ad markers and blackout tags in the output based on the SCTE-35 messages from the input manifest.
• DATERANGE - inserts SCTE-35 EXT-X-DATERANGE tags to signal ad and program transition events in HLS and CMAF manifests. If you use DATERANGE, you must set a
programDateTimeIntervalSeconds value greater than 0. To learn more about DATERANGE, see SCTE-35 Ad Marker EXT-X-DATERANGE.
Type: string Required: False
Values: NONE | SCTE35_ENHANCED | PASSTHROUGH | DATERANGE
playlistWindowSeconds
Time window (in seconds) contained in each parent manifest.
Type: integer Required: False
manifestName
A short string that's appended to the end of the endpoint URL to create a unique path to this endpoint.
The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
Type: string Required: False
programDateTimeIntervalSeconds
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify.
Additionally, ID3Timed metadata messages are generated every 5 seconds starting when the content was ingested.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
Omit this attribute or enter 0 to indicate that the EXT-X-PROGRAM-DATE-TIME tags are not included in the manifest.
Type: integer Required: False
playlistType
When specified as either event or vod, a corresponding EXT-X-PLAYLIST-TYPE entry is included in the media playlist. Indicates if the playlist is live to VOD content.
Type: string Required: False
Values: NONE | EVENT | VOD
Properties
id
The manifest ID is required and must be unique within the OriginEndpoint. The ID can't be changed after the endpoint is created.
Type: string Required: True
includeIframeOnlyStream
Applies to stream sets with a single video track only. When true, the stream set includes an additional I-frame only stream, along with the other tracks. If false, this extra stream is not included.
Type: boolean Required: False
url
The URL that's used to request this manifest from this endpoint.
Type: string Required: False
HlsManifestCreateOrUpdateParameters
Parameters for creating an HTTP Live Streaming (HLS) manifest configuration on a CMAF endpoint.
adMarkers
Controls how ad markers are included in the packaged endpoint. Valid values are none, passthrough, scte35_enhanced, or daterange.
• NONE - omits all SCTE-35 ad markers from the output.
• PASSTHROUGH - creates a copy in the output of the SCTE-35 ad markers (comments) taken directly from the input manifest.
• SCTE35_ENHANCED - generates ad markers and blackout tags in the output based on the SCTE-35 messages from the input manifest.
• DATERANGE - inserts SCTE-35 EXT-X-DATERANGE tags to signal ad and program transition events in HLS and CMAF manifests. If you use DATERANGE, you must set a
programDateTimeIntervalSeconds value greater than 0. To learn more about DATERANGE, see SCTE-35 Ad Marker EXT-X-DATERANGE.
Type: string Required: False
Values: NONE | SCTE35_ENHANCED | PASSTHROUGH | DATERANGE
playlistWindowSeconds
Time window (in seconds) contained in each parent manifest.
Type: integer Required: False
Properties
manifestName
A short string that's appended to the end of the endpoint URL to create a unique path to this endpoint.
The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
Type: string Required: False
programDateTimeIntervalSeconds
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify.
Additionally, ID3Timed metadata messages are generated every 5 seconds starting when the content was ingested.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
Omit this attribute or enter 0 to indicate that the EXT-X-PROGRAM-DATE-TIME tags are not included in the manifest.
Type: integer Required: False
playlistType
When specified as either event or vod, a corresponding EXT-X-PLAYLIST-TYPE entry is included in the media playlist. Indicates if the playlist is live to VOD content.
Type: string Required: False
Values: NONE | EVENT | VOD
includeIframeOnlyStream
Applies to stream sets with a single video track only. When true, the stream set includes an additional I-frame only stream, along with the other tracks. If false, this extra stream is not included.
Type: boolean Required: False
id
The manifest ID is required and must be unique within the OriginEndpoint. The ID can't be changed after the endpoint is created.
Type: string Required: True
adsOnDeliveryRestrictions
The flags on SCTE-35 segmentation descriptors that have to be present for MediaPackage to insert ad markers in the output manifest. For information about SCTE-35 in MediaPackage, see SCTE-35 Message Options in AWS Elemental MediaPackage.
Type: AdsOnDeliveryRestrictions (p. 57) Required: False
Properties
adTriggers
The SCTE-35 message types that MediaPackage treats as ad markers in the output manifest. For information about SCTE-35 in MediaPackage, see SCTE-35 Message Options in AWS Elemental MediaPackage.
Type: Array of type string Required: False
HlsPackage
Parameters for Apple HLS packaging.
useAudioRenditionGroup
When true, AWS Elemental MediaPackage bundles all audio tracks in a rendition group. All other tracks in the stream can be used with any audio rendition from the group.
Type: boolean Required: False
segmentDurationSeconds
Duration (in seconds) of each fragment. Actual fragments are rounded to the nearest multiple of the source fragment duration.
Type: integer Required: False
adMarkers
Controls how ad markers are included in the packaged endpoint. Valid values are none, passthrough, scte35_enhanced, or daterange.
• NONE - omits all SCTE-35 ad markers from the output.
• PASSTHROUGH - creates a copy in the output of the SCTE-35 ad markers (comments) taken directly from the input manifest.
• SCTE35_ENHANCED - generates ad markers and blackout tags in the output based on the SCTE-35 messages from the input manifest.
• DATERANGE - inserts SCTE-35 EXT-X-DATERANGE tags to signal ad and program transition events in HLS and CMAF manifests. If you use DATERANGE, you must set a
programDateTimeIntervalSeconds value greater than 0. To learn more about DATERANGE, see SCTE-35 Ad Marker EXT-X-DATERANGE.
Type: string Required: False
Values: NONE | SCTE35_ENHANCED | PASSTHROUGH | DATERANGE
includeDvbSubtitles
When enabled, MediaPackage passes through digital video broadcasting (DVB) subtitles into the output.
Type: boolean Required: False
Properties
programDateTimeIntervalSeconds
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify.
Additionally, ID3Timed metadata messages are generated every 5 seconds starting when the content was ingested.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
Omit this attribute or enter 0 to indicate that the EXT-X-PROGRAM-DATE-TIME tags are not included in the manifest.
Type: integer Required: False
playlistType
When specified as either event or vod, a corresponding EXT-X-PLAYLIST-TYPE entry is included in the media playlist. Indicates if the playlist is live to VOD content.
Type: string Required: False
Values: NONE | EVENT | VOD
streamSelection
Limitations for outputs from the endpoint, based on the video bitrate.
Type: StreamSelection (p. 75) Required: False
includeIframeOnlyStream
Only applies to stream sets with a single video track. When true, the stream set includes an additional I-frame only stream, along with the other tracks. If false, this extra stream is not included.
Type: boolean Required: False
adsOnDeliveryRestrictions
The flags on SCTE-35 segmentation descriptors that have to be present for MediaPackage to insert ad markers in the output manifest. For information about SCTE-35 in MediaPackage, see SCTE-35 Message Options in AWS Elemental MediaPackage.
Type: AdsOnDeliveryRestrictions (p. 57) Required: False
adTriggers
The SCTE-35 message types that MediaPackage treats as ad markers in the output manifest. For information about SCTE-35 in MediaPackage, see SCTE-35 Message Options in AWS Elemental MediaPackage.
Type: Array of type string Required: False
Properties
MssEncryption
Holds encryption information so that access to the content can be controlled by a DRM solution.
spekeKeyProvider
Parameters for the SPEKE key provider.
Type: SpekeKeyProvider (p. 74) Required: True
MssPackage
Parameters for Microsoft Smooth Streaming packaging.
manifestWindowSeconds
Time window (in seconds) contained in each manifest.
Type: integer Required: False
segmentDurationSeconds
Duration (in seconds) of each fragment. Actual fragments are rounded to the nearest multiple of the source fragment duration.
Type: integer Required: False
encryption
Parameters for encrypting content.
Type: MssEncryption (p. 69) Required: False
streamSelection
Limitations for outputs from the endpoint, based on the video bitrate.
Type: StreamSelection (p. 75) Required: False
OriginEndpoint
OriginEndpoint configuration.
startoverWindowSeconds
Maximum duration (seconds) of content to retain for startover playback. A 0 indicates that startover playback is disabled for this endpoint.
Type: integer Required: False
Properties
manifestName
A short string that's appended to the end of the endpoint URL to create a unique path to this endpoint.
Type: string Required: False
description
Any descriptive information that you want to add to the endpoint for future identification purposes.
Type: string Required: False
dashPackage
Parameters for DASH packaging.
Type: DashPackage (p. 60) Required: False
whitelist
The IP addresses that can access this endpoint.
Type: Array of type string Required: False
cmafPackage
Parameters for CMAF packaging.
Type: CmafPackage (p. 58) Required: False
hlsPackage
Parameters for Apple HLS packaging.
Type: HlsPackage (p. 67) Required: False
url
The URL that's used to request content from this endpoint.
Type: string Required: False
tags
The tags assigned to the endpoint.
Type: Tags (p. 75) Required: False
Properties
authorization
Parameters for CDN authorization.
Type: Authorization (p. 57) Required: False
origination
Controls video origination from this endpoint.
• ALLOW - enables this endpoint to serve content to requesting devices.
• DENY - prevents this endpoint from serving content. Denying origination is helpful for harvesting live-to-VOD assets. For more information about harvesting and origination, see Live-live-to-VOD Requirements.
Type: string Required: False
Values: ALLOW | DENY
timeDelaySeconds
Minimum duration (seconds) of delay to enforce on the playback of live content. A 0 indicates that there is no time delay in effect for this endpoint
Type: integer Required: False
id
The endpoint identifier.
Type: string Required: False
arn
The endpoint's unique system-generated resource name, based on the AWS record.
Type: string Required: False
channelId
The ID of the channel associated with this endpoint.
Type: string Required: False
mssPackage
Parameters for Microsoft Smooth Streaming packaging.
Type: MssPackage (p. 69)
Properties
Required: False
OriginEndpointCreateParameters
OriginEndpoint configuration.
startoverWindowSeconds
Maximum duration (seconds) of content to retain for startover playback. Omit this attribute or enter 0 to indicate that startover playback is disabled for this endpoint.
Type: integer Required: False
manifestName
A short string that's appended to the end of the endpoint URL to create a unique path to this endpoint.
Type: string Required: False
description
Any descriptive information that you want to add to the endpoint for future identification purposes.
Type: string Required: False
dashPackage
Parameters for DASH packaging.
Type: DashPackage (p. 60) Required: False
whitelist
The IP addresses that can access this endpoint.
Type: Array of type string Required: False
cmafPackage
Parameters for Common Media Application Format (CMAF) packaging.
Type: CmafPackageCreateOrUpdateParameters (p. 59) Required: False
hlsPackage
Parameters for Apple HLS packaging.
Type: HlsPackage (p. 67) Required: False
Properties
tags
The tags to assign to the endpoint.
Type: Tags (p. 75) Required: False
authorization
Parameters for CDN authorization.
Type: Authorization (p. 57) Required: False
origination
Controls video origination from this endpoint.
• ALLOW - enables this endpoint to serve content to requesting devices.
• DENY - prevents this endpoint from serving content. Denying origination is helpful for harvesting live-to-VOD assets. For more information about harvesting and origination, see Live-live-to-VOD Requirements.
Type: string Required: False
Values: ALLOW | DENY
timeDelaySeconds
Minimum duration (seconds) of delay to enforce on the playback of live content. Omit this attribute or enter 0 to indicate that there is no time delay in effect for this endpoint
Type: integer Required: False
id
The endpoint ID is required and must be unique for your account in this region. The ID can't be changed after the endpoint is created.
Type: string Required: True
channelId
The ID of the channel associated with this endpoint.
Type: string Required: True
mssPackage
Parameters for Microsoft Smooth Streaming packaging.
Type: MssPackage (p. 69) Required: False
Properties
OriginEndpointList
A collection of OriginEndpoint records.
originEndpoints
List of endpoints that are configured on this account and the channel that you specified in the request parameters.
Type: Array of type OriginEndpoint (p. 69) Required: False
nextToken
Pagination token. Use this token to request the next page of channel results.
Type: string Required: False
SpekeKeyProvider
Keyprovider settings for DRM.