key_id

Директива 'key' задаёт криптографический ключ, используемый для подписи защищённых токенов, создаваемых NGINX Secure Token Module для интеграции с CDN.

Синтаксисkey hex_string;
По умолчаниюnone
Контекст
Аргументы1

Описание

Директива 'key' в NGINX Secure Token Module имеет решающее значение для генерации защищённых токенов, используемых для доставки контента в средах CDN, таких как Akamai и Amazon CloudFront. Эта директива принимает один аргумент — шестнадцатеричную строку, представляющую криптографический ключ. Безопасность и корректность создаваемых токенов во многом зависят от этого ключа, поскольку он комбинируется с параметрами токена для получения HMAC-подписи на основе SHA-256. Включение этого ключа в конфигурацию позволяет NGINX генерировать уникальные токены, которые шифруют URL или данные, предназначенные для доставки, тем самым ограничивая несанкционированный доступ к контенту, защищённому этими токенами.

При работе эта директива часто используется вместе с другими связанными директивами, такими как 'acl', которая задаёт списки контроля доступа для проверки токенов, и 'param_name', которая определяет имя параметра строки запроса, в котором будет содержаться сгенерированный токен. При правильной настройке NGINX будет динамически управлять генерацией токенов, обеспечивая защиту коммерческого контента, доставляемого через CDN, и соблюдение политик доступа, заданных в конфигурациях. Это обеспечивает не только управление доступом, но и повышает уровень безопасности против подделки токенов или несанкционированного использования контента.

Пример конфига

secure_token_akamai {
    key 1234567890abcdef1234567890abcdef; // Example key as a hex string
    acl "allow all";
    param_name "token";
    start 0;
    end 3600;
}

Убедитесь, что ключ является допустимой шестнадцатеричной строкой; в противном случае генерация токена завершится неудачей.

Будьте осторожны с раскрытием ключа; обращайтесь с ним как с паролем и избегайте его записи в логах.

Регулярно перегенерируйте и управляйте ключами, чтобы повысить уровень безопасности.

← Ко всем директивам