Exemplos de políticas baseadas em identidade para o Amazon S3 Glacier

Por padrão, usuários e funções não têm permissão para criar ou modificar recursos do S3 Glacier. Eles também não podem executar tarefas usando o AWS Management Console, a AWS Command Line Interface (AWS CLI) ou a API AWS. Para conceder aos usuários permissão para executar ações nos recursos de que precisam, um administrador do IAM pode criar políticas do IAM. O administrador pode então adicionar as políticas do IAM aos perfis, e os usuários podem assumir os perfis.

Para saber como criar uma política baseada em identidade do IAM usando esses exemplos de documento de política JSON, consulte Criação de políticas do IAM no Guia do Usuário do IAM.

Para obter detalhes sobre ações e tipos de recurso definidos pelo S3 Glacier, incluindo o formato dos ARNs para cada tipo de recurso, consulte Ações, recursos e chaves de condição do S3 Glacier na Referência de autorização do serviço.

Esta é uma política de exemplo que concede permissões para três ações relacionadas ao cofre do (glacier:CreateVault (glacier:DescribeVault, e glacier:ListVaults) em um recurso, usando o Nome do Recurso da Amazon (ARN) que identifica todos os cofres na Região da us-west-2 AWS. Os ARNs identificam exclusivamente os recursos AWS. Para obter mais informações sobre ARNs usados com o S3 Glacier, consulte Recursos de política para o S3 Glacier.

      {
         "Version": "2012-10-17",
         "Statement": [
            {
               "Effect": "Allow",
               "Action": [
               "glacier:CreateVault",
               "glacier:DescribeVault",
               "glacier:ListVaults"
               ],
               "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/*"
            }
         ]
      }

A política concede permissões para criar, listar e obter descrições de cofres na região us-west-2. O caractere curinga (*) ao final do ARN do significa que essa instrução pode corresponder a qualquer nome de cofre.

Importante

Ao conceder permissões para criar um cofre usando a operação glacier:CreateVault, você deve especificar um caractere curinga (*) porque você não saberá o nome do cofre até criar o cofre.

Melhores práticas de políticas

As políticas baseadas em identidade determinam se alguém pode criar, acessar ou excluir recursos do S3 Glacier em sua conta. Essas ações podem incorrer em custos para a Conta da AWS. Ao criar ou editar políticas baseadas em identidade, siga estas diretrizes e recomendações:

• Comece com AWS as políticas gerenciadas pela e avance para as permissões de privilégio mínimo: para começar a conceder permissões a seus usuários e workloads, use as AWS políticas gerenciadas pela que concedem permissões para muitos casos de uso comuns. Elas estão disponíveis na sua Conta da AWS. Recomendamos que você reduza ainda mais as permissões definindo políticas gerenciadas pelo cliente da AWS específicas para seus casos de uso. Para obter mais informações, consulte Políticas gerenciadas pela AWS ou Políticas gerenciadas pela AWS para perfis de trabalho no Guia do usuário do IAM.

• Aplique permissões de privilégio mínimo: ao definir permissões com as políticas do IAM, conceda apenas as permissões necessárias para executar uma tarefa. Você faz isso definindo as ações que podem ser executadas em atributos específicos sob condições específicas, também conhecidas como permissões de privilégio mínimo. Para obter mais informações sobre como usar o IAM para aplicar permissões, consulte Políticas e permissões no IAM no Guia do usuário do IAM.

• Use condições nas políticas do IAM para restringir ainda mais o acesso: você pode adicionar uma condição às políticas para limitar o acesso a ações e atributos. Por exemplo, você pode escrever uma condição de política para especificar que todas as solicitações devem ser enviadas usando SSL. Você também pode usar condições para conceder acesso a ações de serviço, se elas forem usadas por meio de um AWS service (Serviço da AWS) específico, como o AWS CloudFormation. Para obter mais informações, consulte Elementos de política JSON do IAM: Condition no Guia do usuário do IAM.

• Use o IAM Access Analyzer para validar suas políticas do IAM a fim de garantir permissões seguras e funcionais: o IAM Access Analyzer valida as políticas novas e existentes para que elas sigam a linguagem de política do IAM (JSON) e as práticas recomendadas do IAM. O IAM Access Analyzer oferece mais de 100 verificações de política e recomendações acionáveis para ajudá-lo a criar políticas seguras e funcionais. Para obter mais informações, consulte Validação de políticas do IAM Access Analyzer no Guia do usuário do IAM.

• Exigir autenticação multifator (MFA): se houver um cenário que exija usuários do IAM ou um usuário raiz em sua Conta da AWS, ative a MFA para obter segurança adicional. Para exigir MFA quando as operações de API forem chamadas, adicione condições de MFA às suas políticas. Para obter mais informações, consulte Configuração de acesso à API protegido por MFA no Guia do usuário do IAM.

Para obter mais informações sobre as práticas recomendadas do IAM, consulte Práticas recomendadas de segurança no IAM no Guia do usuário do IAM.

Usando o console S3 Glacier

Para acessar o console da Amazon S3 Glacier, você deve ter um conjunto mínimo de permissões. Essas permissões devem autorizar você a listar e visualizar detalhes sobre os recursos do S3 Glacier na sua Conta da AWS. Se você criar uma política baseada em identidade que seja mais restritiva do que as permissões mínimas necessárias, o console não funcionará como pretendido para entidades (usuários ou perfis) com essa política.

Não é necessário conceder permissões mínimas do console para usuários que fazem chamadas somente à AWS CLI ou à AWS API. Em vez disso, permita o acesso somente a ações que correspondam a operação de API que estiverem tentando executar.

O console do S3 Glacier fornece um ambiente integrado para você criar e gerenciar cofres do S3 Glacier. No mínimo, as identidades do IAM criadas devem receber permissões para a ação glacier:ListVaults de visualizar o console do S3 Glacier, conforme mostrado no exemplo a seguir.

         {
               "Version": "2012-10-17",
               "Statement": [
                  {
                     "Action": [
                     "glacier:ListVaults"     
                     ],
                     "Effect": "Allow",
                     "Resource": "*"
                  }
               ]
            }

A AWS aborda muitos casos de uso comuns fornecendo políticas autônomas do IAM que são criadas e administradas pela AWS. As políticas gerenciadas concedem permissões necessárias para casos de uso comuns, de maneira que você possa evitar a necessidade de investigar quais permissões são necessárias. Para obter mais informações, consulte Políticas gerenciadas da AWS no Guia do usuário do IAM.

As seguintes AWS políticas gerenciadas, que você pode anexar aos usuários da sua conta, são específicas do S3 Glacier:

• AmazonGlacierReadOnlyAccess – Concede acesso somente de leitura ao S3 Glacier por meio de AWS Management Console.

• AmazonGlacierFullAccess – Concede acesso completo ao S3 Glacier por meio de AWS Management Console.

Você também pode criar suas próprias políticas do IAM personalizadas e conceder permissões para ações e recursos de API do S3 Glacier. Você pode anexar essas políticas personalizadas a perfis personalizados do IAM que você cria para seus cofres do S3 Glacier.

Ambas as AWS políticas gerenciadas do S3 Glacier abordadas na próxima seção concedem permissões para glacier:ListVaults.

Para obter mais informações, consulte Adicionando Permissões a um Usuário no Guia do Usuário do IAM.

Permitir que usuários visualizem suas próprias permissões

Este exemplo mostra como é possível criar uma política que permite que os usuários do IAM visualizem as políticas gerenciadas e em linha anexadas a sua identidade de usuário. Essa política inclui permissões para concluir essa ação no console ou de forma programática usando a AWS CLI ou a AWS API.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}

Exemplos de política gerenciada pelo cliente

Nesta seção, você encontrará exemplos de políticas de usuário que concedem permissões para diversas ações do S3 Glacier. Essas políticas funcionam quando você está usando a API REST do S3 Glacier, os SDKs da Amazon, a AWS CLI, se aplicável, o console de gerenciamento do S3 Glacier.

nota

Todos os exemplos usam a Região do Oeste dos EUA (Oregon) (us-west-2) e contêm IDs de conta fictícios.

Exemplos

• Exemplo 1: permitir que um usuário faça download de arquivos de um cofre
• Exemplo 2: permitir que um usuário crie um cofre e configure notificações
• Exemplo 3: permitir que um usuário faça upload para um cofre específico
• Exemplo 4: conceder a um usuário permissões completas em um cofre específico

Exemplo 1: permitir que um usuário faça download de arquivos de um cofre

Para fazer download de um arquivo, você primeiro inicia um trabalho a fim de recuperar o arquivo. Depois que o trabalho de recuperação for concluído, você poderá fazer download dos dados. A política de exemplo a seguir concede permissões para a ação glacier:InitiateJob a fim de iniciar um trabalho (que permite ao usuário recuperar um arquivo ou um inventário de cofre do cofre) e permissões para a ação glacier:GetJobOutput a fim de fazer download dos dados recuperados. A política também concede permissões para realizar a ação glacier:DescribeJob, de maneira que o usuário possa obter o status do trabalho. Para obter mais informações, consulte Initiate Job (trabalhos POST).

A política concede essas permissões em um cofre chamado examplevault. Você pode obter o ARN do cofre por meio do console do S3 Glacier ou, de maneira programática, chamando as ações Describe Vault (GET vault) ou List Vaults (GET vaults).

{
               "Version":"2012-10-17",
               "Statement": [
                  {
                     "Effect": "Allow",
                     "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault",
                     "Action":["glacier:InitiateJob",
                              "glacier:GetJobOutput",
                              "glacier:DescribeJob"] 
                  }
               ]
               }

Exemplo 2: permitir que um usuário crie um cofre e configure notificações

A política de exemplo a seguir concede permissões para criar um cofre na região EUA-oeste-2, conforme especificado no elemento Resource, e configurar notificações. Para obter mais informações sobre como trabalhar com notificações, consulte Configurar notificações de cofre no Amazon S3 Glacier. A política também concede permissões para listar cofres na região AWS e obter a descrição de um cofre específico.

Importante

Ao conceder permissões para criar um cofre usando a operação glacier:CreateVault, você deve especificar um caractere curinga (*) no valor Resource porque você não saberá o nome do cofre até criar o cofre.

{
               "Version":"2012-10-17",
               "Statement": [
                  {
                     "Effect": "Allow",
                     "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/*",
                     "Action":["glacier:CreateVault",
                              "glacier:SetVaultNotifications",
                              "glacier:GetVaultNotifications",
                              "glacier:DeleteVaultNotifications",
                              "glacier:DescribeVault",
                              "glacier:ListVaults"] 
                  }
               ]
               }

Exemplo 3: permitir que um usuário faça upload para um cofre específico

A política de exemplo a seguir concede permissões a fim de fazer upload de arquivos para um determinado cofre na região EUA-oeste-2. Essas permissões permitem que um usuário faça upload de um arquivo ao mesmo tempo usando a operação da API Upload Archive (POST archive) ou em partes usando a operação da API Initiate Multipart Upload (POST multipart-uploads).

{
               "Version":"2012-10-17",
               "Statement": [
                  {
                     "Effect": "Allow",
                     "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault",
                     "Action":["glacier:UploadArchive",
                              "glacier:InitiateMultipartUpload",
                              "glacier:UploadMultipartPart",
                              "glacier:ListParts",
                              "glacier:ListMultipartUploads",
                              "glacier:CompleteMultipartUpload"] 
                  }
               ]
               }

Exemplo 4: conceder a um usuário permissões completas em um cofre específico

A política de exemplo a seguir concede permissões a todas as ações do S3 Glacier em um cofre chamado examplevault.

{
            "Version":"2012-10-17",
            "Statement": [
               {
                  "Effect": "Allow",
                  "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault",
                  "Action":["glacier:*"] 
               }
            ]
            }