secure_token_encrypt_uri

Директива `secure_token_encrypt_uri` обеспечивает защищённое шифрование URIs с помощью настроенных криптографических ключей в NGINX.

Синтаксисsecure_token_encrypt_uri on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументыflag

Описание

Директива secure_token_encrypt_uri является частью модуля Secure Token для NGINX и используется для повышения безопасности путём шифрования URIs ресурсов, обслуживаемых веб‑сервером. Когда эта директива включена, URIs, запрашиваемые клиентами, шифруются с использованием заданного ключа, что предотвращает несанкционированный доступ и гарантирует, что ссылки на ресурсы не могут быть легко расшифрованы третьими сторонами. Это особенно полезно в средах, где доставляются чувствительные ресурсы, и помогает поддерживать целостность и конфиденциальность этих ресурсов.

С точки зрения конфигурации директива принимает один флаговый параметр, который может быть установлен в 'on' или 'off'. При установке в 'on' функциональность шифрования активируется, позволяя динамически генерировать защищённые URIs на основе входящих запросов. Метод шифрования использует HMAC с SHA-256, обеспечивая высокий уровень безопасности для генерируемых tokens. Модуль также позволяет задавать различные параметры конфигурации, такие как установка времени истечения tokens и определение списков контроля доступа (ACLs) для более эффективного управления ресурсами в соответствии с требованиями безопасности.

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

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

http {
    secure_token_encrypt_uri on;
    secure_token_key your-encryption-key;  
    ...
}

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

Если настроено некорректно, клиенты могут получать недоступные ресурсы из-за шифрования URI.

Контролируйте производительность, поскольку шифрование может вносить задержки при высокой нагрузке.

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