Управление политикой доступа (bucket policy)

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

1. Посмотрите описание команды CLI для редактирования ACL бакета:

   yc storage bucket update --help
   

2. Опишите конфигурацию политики доступа в виде схемы данных в формате JSON:

   {
     "Version": "2012-10-17",
     "Statement": {
       "Effect": "Allow",
       "Principal": "*",
       "Action": "s3:GetObject",
       "Resource": "arn:aws:s3:::<имя_бакета>/*",
       "Condition": {
         "Bool": {
           "aws:SecureTransport": "true"
         }
       }
     }
   }
   

   Где:

   • Version — версия описания политик доступа. Необязательный параметр.
   • Statement — правила политики доступа:

     • Effect — запрет или разрешение запрошенного действия. Возможные значения: Allow и Deny.

     • Principal — идентификатор субъекта запрошенного разрешения. Получателем может быть пользователь, сервисный аккаунт или группа пользователей. Возможные значения: *, <идентификатор_субъекта>. Необязательный параметр.

       Идентификаторы можно получить следующими способами:

       • Пользователь.
       • Сервисный аккаунт.
       • Группа пользователей — перейдите на вкладку Группы в интерфейсе Cloud Organization.

     • Action — действие, которое будет разрешено при срабатывании политики. Возможные значения: s3:GetObject, s3:PutObject и * если необходимо применять политику ко всем действиям.

     • Resource — ресурс, к которому будет применяться правило.

     • Condition — условие, которое будет проверяться. Необязательный параметр.

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

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

3. Выполните команду:

   yc storage bucket update \
     --name <имя_бакета> \
     --policy-from-file <путь_к_файлу_с_политиками>
   

   Результат:

   name: my-bucket
   folder_id: csgeoelk7fl1********
   default_storage_class: STANDARD
   versioning: VERSIONING_SUSPENDED
   max_size: "10737418240"
   policy:
       Statement:
         Action: s3:GetObject
         Condition:
           Bool:
             aws:SecureTransport: "true"
           Effect: Allow
           Principal: '*'
           Resource: arn:aws:s3:::my-bucket
         Version: "2012-10-17"
   acl: {}
   created_at: "2022-12-14T08:42:16.273717Z"
   

Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

1. Опишите конфигурацию политики доступа в виде схемы данных формата JSON:

   {
     "Version": "2012-10-17",
     "Statement": {
       "Effect": "Allow",
       "Principal": "*",
       "Action": "s3:GetObject",
       "Resource": "arn:aws:s3:::<имя_бакета>/*",
       "Condition": {
         "Bool": {
           "aws:SecureTransport": "true"
         }
       }
     }
   }
   

   Где:

   • Version — версия описания политик доступа. Необязательный параметр.
   • Statement — правила политики доступа:

     • Effect — запрет или разрешение запрошенного действия. Возможные значения: Allow и Deny.

     • Principal — идентификатор субъекта запрошенного разрешения. Получателем может быть пользователь, сервисный аккаунт или группа пользователей. Возможные значения: *, <идентификатор_субъекта>. Необязательный параметр.

       Идентификаторы можно получить следующими способами:

       • Пользователь.
       • Сервисный аккаунт.
       • Группа пользователей — перейдите на вкладку Группы в интерфейсе Cloud Organization.

     • Action — действие, которое будет разрешено при срабатывании политики. Возможные значения: s3:GetObject, s3:PutObject и * если необходимо применять политику ко всем действиям.

     • Resource — ресурс, к которому будет применяться правило.

     • Condition — условие, которое будет проверяться. Необязательный параметр.

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

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

   Сохраните готовую конфигурацию в файле policy.json.

2. Выполните команду:

   aws s3api put-bucket-policy \
     --endpoint https://storage.yandexcloud.net \
     --bucket <имя_бакета> \
     --policy file://policy.json
   

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Получите статические ключи доступа — секретный ключ и идентификатор ключа, используемые для аутентификации в Object Storage.

1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:

   
   resource "yandex_iam_service_account" "sa" {
     name = "<имя_сервисного_аккаунта>"
   }
   
   // Назначение роли сервисному аккаунту
   resource "yandex_resourcemanager_folder_iam_member" "sa-admin" {
     folder_id = "<идентификатор_каталога>"
     role      = "storage.admin"
     member    = "serviceAccount:${yandex_iam_service_account.sa.id}"
   }
   
   // Создание статического ключа доступа
   resource "yandex_iam_service_account_static_access_key" "sa-static-key" {
     service_account_id = yandex_iam_service_account.sa.id
     description        = "static access key for object storage"
   }
   
   resource "yandex_storage_bucket" "b" {
     access_key = "yandex_iam_service_account_static_access_key.sa-static-key.access_key"
     secret_key = "yandex_iam_service_account_static_access_key.sa-static-key.secret_key"
     bucket     = "my-policy-bucket"
     policy     = <<POLICY
    {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": "*",
         "Action": "s3:*",
         "Resource": [
           "arn:aws:s3:::my-policy-bucket/*",
           "arn:aws:s3:::my-policy-bucket"
         ]
       },
       {
         "Effect": "Deny",
         "Principal": "*",
         "Action": "s3:PutObject",
         "Resource": [
           "arn:aws:s3:::my-policy-bucket/*",
           "arn:aws:s3:::my-policy-bucket"
         ]
       }
     ]
   }
   POLICY
   }
   

   Где:

   • access_key — идентификатор статического ключа доступа.
   • secret_key — значение секретного ключа доступа.
   • bucket — имя бакета. Обязательный параметр.
   • policy — имя политики. Обязательный параметр.

   Настройки политики:

   • Version — версия описания политик доступа. Необязательный параметр.
   • Statement — правила политики доступа:

     • Effect — запрет или разрешение запрошенного действия. Возможные значения: Allow и Deny.

     • Principal — идентификатор субъекта запрошенного разрешения. Получателем может быть пользователь, сервисный аккаунт или группа пользователей. Возможные значения: *, <идентификатор_субъекта>. Необязательный параметр.

       Идентификаторы можно получить следующими способами:

       • Пользователь.
       • Сервисный аккаунт.
       • Группа пользователей — перейдите на вкладку Группы в интерфейсе Cloud Organization.

     • Action — действие, которое будет разрешено при срабатывании политики. Возможные значения: s3:GetObject, s3:PutObject и * если необходимо применять политику ко всем действиям.

     • Resource — ресурс, к которому будет применяться правило.

     • Condition — условие, которое будет проверяться. Необязательный параметр.

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

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

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов.

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

Чтобы управлять политикой доступа, воспользуйтесь методом REST API update для ресурса Bucket, вызовом gRPC API BucketService/Update или методом S3 API PutBucketPolicy. Если ранее для бакета уже была установлена политика доступа, то после применения новой политики она будет полностью перезаписана.

Выполните следующую команду:

aws --endpoint https://storage.yandexcloud.net s3api get-bucket-policy \
  --bucket <имя_бакета> \
  --output text

Результат:

{
  "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:::<имя_бакета>/*\",\"Condition\":{\"Bool\":{\"aws:SecureTransport\":\"true\"}}}}"
}

Подробнее о параметрах читайте в описании схемы данных.

Воспользуйтесь методом S3 API GetBucketPolicy.

Выполните следующую команду:

aws --endpoint https://storage.yandexcloud.net s3api delete-bucket-policy \
  --bucket <имя_бакета>

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Если вы применили политику доступа к бакету при помощи Terraform, вы можете удалить её:

1. Найдите в конфигурационном файле параметры созданной ранее политики доступа, которую необходимо удалить:

   resource "yandex_storage_bucket" "b" {
     bucket = "my-policy-bucket"
     policy = <<POLICY
    {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": "*",
         "Action": "s3:*",
         "Resource": [
           "arn:aws:s3:::my-policy-bucket/*",
           "arn:aws:s3:::my-policy-bucket"
         ]
       },
       {
         "Effect": "Deny",
         "Principal": "*",
         "Action": "s3:PutObject",
         "Resource": [
           "arn:aws:s3:::my-policy-bucket/*",
           "arn:aws:s3:::my-policy-bucket"
         ]
       }
     ]
   }
   POLICY
   }
   

2. Удалите поле policy с описанием параметров политики доступа из конфигурационного файла.

3. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы редактировали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров без удаляемого описания политики доступа. Если в конфигурации есть ошибки, Terraform на них укажет.

4. Удалите политику доступа.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Введите слово yes и нажмите Enter.

   После этого в указанном каталоге будет удалена политика доступа к бакету. Проверить отсутствие политики доступа можно в консоли управления.

Воспользуйтесь методом S3 API DeleteBucketPolicy.