vod_drm_request_uri

The `vod_drm_request_uri` directive specifies the URI to be used for requesting DRM (Digital Rights Management) licenses for video content in NGINX-based Video on Demand (VOD) packaging.

Syntaxvod_drm_request_uri URI;
Defaultnone
Contexthttp, server, location
Arguments1

Description

The vod_drm_request_uri directive is utilized within the NGINX-based VOD Packager module to define the endpoint from which DRM licenses are obtained when serving protected video content. This directive is essential for integrating licensing servers that facilitate content decryption, allowing only authorized users to access premium media files. By specifying this URI, NGINX can effectively request the necessary licenses on behalf of the client, enabling seamless playback of DRM-protected content.

When configured, vod_drm_request_uri must be defined in the contexts of HTTP, server, or location blocks. The directive expects exactly one argument: the URI of the DRM licensing server. This URI can be either an absolute path or a fully qualified URL, depending on the system architecture and the setup of the DRM services. The license request will occur upon client requests for video content, enhancing playback security and control over how the media is accessed and used.

It's important to ensure that the correct URI is specified in the configuration, as an incorrect or unreachable URI could lead to playback failures or unauthorized access to content. The module handles the interactions with the licensing server internally, making it relatively easy for administrators to implement content protection in their video delivery systems without requiring intricate changes to the application code.

Config Example

location /video {
    vod_drm_request_uri /drm/license;
    ... other configuration ...
}

Ensure the URI is reachable; otherwise, content requests will fail.

Incorrectly specifying the URI format can lead to license retrieval errors.

Missing required HTTP headers may lead to ineffective license acquisition.

← Back to all directives