Whitelist and Blacklist Output Filters - AWS Elemental Delta

This is version 2.3 of the AWS Elemental Delta documentation. This is the latest version. For prior versions, see the Previous Versions section of AWS Elemental Delta Documentation.

Whitelist and Blacklist Output Filters

The Whitelist and Blacklist output filters restrict what IP addresses can receive content from the endpoint.

  • IP Whitelist makes it so that only playback devices within the specified range have access to content.

  • IP Blacklist makes it so that only playback devices outside the specified range have access to content.

Both filters work with all types of content and apply to content requested from the Whitelist or Blacklist output filter as well as any downstream endpoints.

These are the settings for a Whitelist or Blacklist output filter.

Enable Endpoint

A setting that indicates if content is playable from this filter.

When you select Enable Endpoint, downstream players can access content through this filter. Otherwise, players must access content from a filter further out on the output filter branch.

When enabled, Delta provides you a playback URL in the format described in Endpoints on Output Filters.

Custom URL

Text to add to the endpoint URL to create a unique path to this endpoint.

The custom endpoint URL is in this format:

http://<Delta IP address>/out/u/custom_url_text.<extension>

When applicable, child manifest names include the custom URL text with a sequential number appended:

custom_url_text_1
custom_url_text_2
Warning

CMAF and HLS output filter endpoints use the same manifest file extension (.m3u8). If you have both types of endpoints on the same content and use custom URLs, make sure that the URLs that you define are unique. Otherwise, you may encounter playback issues.

Description

Any descriptive text that helps you to identify the endpoint later. This information is also useful creating a cross-reference to data in your content management system (CMS). Additionally, it helps to distinguish between multiple endpoints of the same type, each with unique output characteristics.

IP Address Range

The range of IP addresses that are restricting traffic.

For Whitelist, enter one of these:

  • The IP address of the single client player that can access the content.

  • A range of IP addresses in CIDR notation that can access the content. All the IP addresses in the range (including the first and last) are able to access the content.

For Blacklist, enter one of these:

  • The IP address of the single client player that cannot access the content.

  • A range of IP addresses in CIDR notation that cannot access the content. None of the IP addresses in the range (including the first and last) are able to access the content.