Спецификация URL параметров - Video CDN [RU]

Параметры URL переопределяют ваши настройки по умолчанию для каждого URL. Использование не обязательно, но важно для безопасности и позволяет более точно настраивать взаимодействие с пользователем.

Рекомендуется определять глобальные (или доменные) настройки там, где это возможно. Используйте настройку конкретного URL только при реальной необходимости.

Использование

По умолчанию все параметры поддерживаются. Их можно заблокировать с помощью соответствующих глобальных (или подоменных) настроек. Однако, блокировка не имеет практического смысла, если включена Подпись URL: при изменении параметров URL подпись становится недействительной и пользователь теряет доступ

Формат

Параметры URL записываются парами в формате /name=value/. Например: http://example.org/parameter1=value1/parameter2=value2/path/to/file.mp4

В некоторых случаях браузеры (или плееры в браузере) некорректно обрабатывают комбинацию =. В таких случаях вместо неё может использоваться символ _ как разделитель.

Но одновременно разрешён только один вариант. Не смешивайте их!

Параметры

key

Этот параметр относится к Подпись URL.

Использование /key=KEY_VALUE[,option1[,option2,..]/, например:

http://cdn.domain.com/key=9CVHszhqqsA,end=1374068216/1/2/3.mp4

Этот параметр содержит значение подписи URL. Он проверяет, что запрошенный URL не был изменён после публикации на сайте,содержит первичный путь и настройки отдачи.

Подпись генерируется хешированием части URL с использованием алгоритма MD5на основе base64. Подробнее см. в этом руководстве

Вся часть URL после KEY_VALUE подписывается (включая все дополнительные опции /key=../). Для URL /key=KEY_VALUE,end=1701234567/speed=1.3/path/to/file.mp4 строка для подписи будет ,end=17123123/speed=1.3/path/to/file.mp4

All parameters to the left of /key=../ are ignored. In /speed=0/key=KEY_VALUE/path/to/file.mp4, the /speed=0/ value will be ignored.

Опции (с их значениями) после KEY_VALUE могут быть указаны в произвольном порядке.

Contact the support team to make a whitelist of addresses allowed to bypass this verification.

Опция «begin»

Эта опция относится к Время жизни URL

Usage of /key=KEY_VALUE,begin=123456789/, e.g.:

http://video.com/key=LePgDoTB7PDqCBQsRxa92w,begin=1987654321/output.mp4

The option specifies the time when a signature becomes valid. Value must be a UNIX Timestamp.

Опция «end»

Эта опция относится к Время жизни URL

Usage of /key=KEY_VALUE,end=1701234567/, e.g.:

http://video.com/key=LePgDoTB7PDqCBQsRxa92w,end=1987654321/output.mp4

The option specifies the time before which a signature remains valid. Value must be a UNIX Timestamp.

Опция «ip»

This option relates to Привязка URL к IP адресу.

Usage of /key=KEY_VALUE,ip=ip_prefix1[;ip_prefix2,..]/, e.g.:

http://video.ahcdn.com/key=yP5e7rTfBrgPLhuDzCBg,ip=1.2.3.4/output.mp4
http://video.ahcdn.com/key=yP5e7rTfBrgPLhuDzCBg,ip=5.6.7;2a02:b48/output.mp4
http://video.ahcdn.com/key=yP5e7rTfBrgPLhuDzCBg,ip=2a02:b48/output.mp4

The option binds urls to specific ip addresses or prefixes.

The value can define either a complete address, or just a prefix part. A prefix part is:

a set of octets (for IPv4), separated by the . (dot) symbol
a set of hextets (for IPv6), separated by the : (colon) symbol

The ip parameter is ignored by the CDN if the user’s request contains a valid referer header.

In hotlinking scenarios, spoofing the referer is considered difficult. Therefore, when the referer is correct, it is generally beneficial to allow requests from incorrect IP addresses to preserve traffic.

Опция «limit»

This option relates to the Ограничение IP на URL

Usage of /key=KEY_VALUE,limit=3/, e.g.:

http://video.com/key=UsijXw8tJK60yTBLu6wsyA,end=1987654321,limit=3/output.mp4

The option defines a count of unique IP addresses allowed to access the url.

Значение должно быть целым числом в диапазоне [1..5].

Опция «len»

Этот параметр относится к Частичной подписи URL.

Usage of /key=KEY_VALUE,len=80/, e.g.:

http://cdn.domain.com/key=9CVHszhqqsA,end=1374068216,len=6/1/2/3_720p.mp4

The option defines a length of url or its part, used for signature verification.

By default, the whole url is being signed (the part after /key=VALUE), but it can be limited by a certain byte number. Limitation applies to the left side of the url.

sec

Этот параметр относится к Проверка cookie.

Usage of /sec=COOKIE_NAME/, e.g.:

http://video.com/key=GnElxcWZ+dx27qMJBDQ,end=1987654321,ip=1.2.3.4/sec=cookie_name/output.mp4

Этот параметр может быть проигнорирован.

hash

Этот параметр относится к Шифрование URL.