secure_token_encrypt_uri_key

Директива `secure_token_encrypt_uri_key` указывает ключ, используемый для шифрования URI в модуле Secure Token для NGINX.

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

Описание

Директива secure_token_encrypt_uri_key используется в модуле Secure Token для NGINX и задаёт ключ, применяемый для шифрования URI, повышая безопасность при доставке контента через CDN-сервисы, такие как Akamai или Amazon CloudFront. Эта директива принимает один аргумент: ключ шифрования — строку, которая должна быть надёжно сформирована. При задании модуль будет использовать этот ключ для генерации защищённых токенов, которые передаются в параметрах URI.

При применении этой директивы крайне важно обеспечить, чтобы ключ был сильным и случайно сгенерированным, так как это напрямую влияет на безопасность создаваемых токенов. Зашифрованные токены включают параметры, ограничивающие доступ по времени, IP-адресу и ACL (списки контроля доступа), что может быть критично для защиты временно чувствительного контента, например видеопотоков. Использование надёжных методов шифрования (таких как HMAC с SHA-256) гарантирует, что только авторизованные пользователи смогут генерировать действительные токены, эффективно предотвращая несанкционированный доступ к защищённому контенту.

Ещё один важный аспект — контекст, в котором можно задавать эту директиву. Она может использоваться в блоках http, server или location, что даёт гибкие варианты настройки безопасности в зависимости от требований развертывания. Правильное использование этой директивы не только защищает URI, но и дополняет другие директивы модуля, которые управляют токенами и контролем доступа для различных типов медиа, обслуживаемых через NGINX.

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

http {
    secure_token_encrypt_uri_key "mysecretkey";
}

Убедитесь, что ключ хранится надежно и его сложно угадать.

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

Директиву следует поместить в соответствующий контекст (http, server или location), чтобы она вступила в силу.

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