aws_s3_bucket
Директива aws_s3_bucket задаёт имя корзины Amazon S3, которая будет использоваться для прокси-запросов.
Описание
Директива aws_s3_bucket является частью модуля NGINX, который позволяет проксировать запросы к аутентифицированным сервисам AWS, в частности для взаимодействия с Amazon S3. Эта директива позволяет указать корзину S3, которую сервер NGINX должен использовать при обработке запросов. Указывая имя корзины, NGINX может формировать корректные endpoint URLs для запросов к S3, обеспечивая бесшовный доступ к хранимым объектам в указанной корзине.
Данная директива требует одного аргумента — имени корзины S3. Она может использоваться в различных контекстах, таких как http, server и location. Пользователи должны убедиться, что они настроили необходимые учетные данные для аутентификации и ключи подписи через другие директивы модуля, такие как aws_access_key, aws_signing_key и aws_key_scope, чтобы предоставить NGINX разрешение безопасно взаимодействовать с S3.
При выполнении запроса, если в соответствующем location также указана директива aws_sign, NGINX автоматически подпишет запрос с помощью AWS V4 signing process, используя данные, указанные в других соответствующих директивах, что позволит ему аутентифицироваться по отношению к корзине S3 для управления доступом и операций с данными.
Пример конфига
location / {
aws_access_key your_aws_access_key;
aws_key_scope scope_of_generated_signing_key;
aws_signing_key signing_key_generated_using_script;
aws_s3_bucket your_s3_bucket;
aws_sign;
proxy_pass http://your_s3_bucket.s3.amazonaws.com;
}Убедитесь, что указанное имя S3 bucket написано правильно и с учётом регистра, так как имена S3 bucket чувствительны к регистру.
Ключи подписи должны поддерживаться в актуальном состоянии; просроченные ключи приведут к ошибкам аутентификации при доступе к S3 bucket.
Будьте осторожны с завершающими слешами в директиве proxy_pass; неверная конфигурация может привести к непредвиденным ошибкам 404.