Signed Video

Description

The Signed Video API contains the settings that makes it possible for applications and users to retrieve signed video content from a channel. Utilizing the parameter group Image.I#.MPEG.SignedVideo, where I# is the name of the video channel, makes it possible to validate whether the video has been manipulated or tampered with after it was exported from the camera. Supported parameters are:

ParameterTypeDescription
Enabled=<yes/no>BooleanAvailable values are yes or no.

Model

Signing a video can be done in two different ways:

Default

This method enables/disables video signing for a video channel with the regular Signed Video API parameter group Image.I#.MPEG.SignedVideo and the parameter Enabled.

Per stream

Signing can also be enabled/disabled directly in a stream with the Signed Video URL option, i.e. using the boolean videosigned that can have the values 1 or 0 and may look like this:

gst-launch-1.0 -v rtspsrc location="rtsp://<user:password>@<ip addr>/axis-media/media.amp?videosigned=1" ! fakesink silent=false

Identification

API Discovery

id=signed-video

Use cases

Setup signed video

Use these examples to sign a video and ensure its origin and authenticity. The video can then be validated to prove that it has not been manipulated with after being transferred from the camera.

Setup signed video on a channel

To enable video signing by default on a channel you should use the Enabled parameter like this:

//<servername>/axis-cgi/param.cgi?action=update&Image.I0.MPEG.SignedVideo.Enabled=yes

Setup signed video for a stream

To enable video signing for a stream you should use the videosigned URL-option like this:

gst-launch-1.0 -v rtspsrc location="rtsp://<user:password>@<ip addr>/axis-media/media.amp?videosigned=1" ! fakesink silent=false

API specification

SignedVideo.Enabled

The Enabled parameter is used when you wish to enable/disable video signing with the parameter handling API.

List security level

Operator, Viewer

Update security level

Admin

Image.I#.MPEG.SignedVideo.Enabled

Valid values for # ranges from 0 and up to the maximum number of channels specified by the product -1. This means that the valid values for a product with 100 channels has a range between 0–99.

ParameterDescription
Enabled=yes|noEnables and disables signed video for a channel. The default value is no.

RTSP URL Options

gst-launch-1.0 -v rtspsrc location="rtsp://<user:password>@<ip addr>/axis-media/media.amp?videosigned=1" ! fakesink silent=false
ParameterDescription
videosigned=1|0Enables and disables signed video for a stream.

General error codes

The following RTSP errors can be returned for all methods.

Error codeDescription
400 Bad RequestAn error in the request, e.g. an invalid URL option.
503 Service UnavailableAn error in the service while handling the request.