param_name
Директива `param_name` задаёт имя параметра запроса, используемого для генерации secure token в конфигурациях NGINX, использующих Secure Token Module.
Описание
Директива param_name является частью Secure Token Module для NGINX и используется для генерации secure tokens для сетей доставки контента (CDN), таких как Akamai и Amazon CloudFront. Установив эту директиву, администраторы могут задать конкретное имя параметра строки запроса, которое будет включено в генерируемые secure tokens. Это обеспечивает большую гибкость в проектировании API и взаимодействии с пользователями, так как указанное имя параметра легко распознаётся и разбирается клиентами или приложениями, использующими токен.
При реализации этой директивы пользователь должен передать один аргумент, задающий имя параметра. Это имя затем можно использовать для динамического встраивания полученного secure token в URLs или manifest files. Secure token содержит важные компоненты, такие как expiration times и необязательные списки контроля доступа (ACL), гарантируя, что контент доступен только при выполнении определённых условий. Директива param_name играет критическую роль в интеграции логики secure token с общей конфигурацией NGINX, обеспечивая корректную идентификацию и использование со стороны клиентских приложений.
Эта директива особенно полезна в сценариях, где генерируются разные токены и имена параметров должны быть различными, чтобы избежать конфликтов или путаницы. Правильное использование param_name помогает поддерживать чистую и организованную структуру URL, упрощая взаимодействие с CDN и одновременно сохраняя целостность мер по управлению доступом.
Пример конфига
secure_token_akamai {
param_name my_token;
key abc123;
acl all;
start 0;
end 3600;
}Убедитесь, что имя параметра не конфликтует с другими существующими параметрами запроса.
Убедитесь, что клиенты информированы об имени параметра, чтобы они могли корректно разбирать токены.
Имейте в виду, что изменение param_name требует обновления всех клиентских приложений, которые от него зависят.