Exemplos de políticas baseadas em identidade para o Amazon Glacier - Amazon Glacier
Práticas recomendadas de políticaUtilizar o consolePermitir que os usuários visualizem suas próprias permissõesExemplos de política gerenciada pelo cliente

Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.

Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte Classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. O Amazon Glacier é um serviço independente com suas próprias APIs que armazena dados em cofres e é diferente das classes de armazenamento do Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, a AWS recomenda as classes de armazenamento do Amazon S3 Glacier, que oferecem uma experiência superior ao cliente com APIs baseadas em bucket do S3, disponibilidade total da Região da AWS, custos mais baixos e integração de serviços da AWS. Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando nossas Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

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

Por padrão, usuários e funções não têm permissão para criar ou modificar recursos do Amazon Glacier. Para conceder permissão aos usuários para executar ações nos recursos que eles precisam, um administrador do IAM pode criar políticas do IAM.

Para aprender a criar uma política baseada em identidade do IAM ao usar esses documentos de política em JSON de exemplo, consulte Criar políticas do IAM (console) no Guia do usuário do IAM.

Para obter detalhes sobre ações e tipos de recurso definidos pelo Amazon Glacier, incluindo o formato dos ARNs para cada tipo de recurso, consulte Ações, recursos e chaves de condição do Amazon 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 Amazon Glacier (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 Amazon Glacier, consulte Recursos de políticas para o Amazon Glacier.

JSON

      {
         "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.

Práticas recomendadas de política

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

  • Comece com as políticas gerenciadas pela AWS 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 políticas gerenciadas pela AWS, que concedem permissões para muitos casos de uso comuns. Elas estão disponíveis em seus Conta da AWS. Recomendamos que você reduza ainda mais as permissões definindo políticas gerenciadas pelo cliente da AWS que são 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 funções 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 recursos 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 recursos. Por exemplo, você pode escrever uma condição de política para especificar que todas as solicitações devem ser enviadas usando SSL. 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 CloudFormation. Para obter mais informações, consulte Elementos da política JSON do IAM: condição 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 cem verificações de política e recomendações práticas para ajudar 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 do Amazon Glacier

Para acessar o console do Amazon Glacier, você deve ter um conjunto mínimo de permissões. Com essas permissões, é possível listar e visualizar detalhes sobre os recursos do Amazon Glacier em sua Conta da AWS. Caso crie uma política baseada em identidade mais restritiva 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 à API do AWS. Em vez disso, permita o acesso somente a ações que correspondam à operação de API que estiverem tentando executar.

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

JSON

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

AWS A 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 pela AWS no Guia do usuário do IAM.

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

  • AmazonGlacierReadOnlyAccess – Concede acesso somente de leitura ao Amazon Glacier por meio do Console de gerenciamento da AWS.

  • AmazonGlacierFullAccess – Concede acesso completo ao Amazon Glacier por meio do Console de gerenciamento da AWS.

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 Amazon Glacier. Você pode anexar essas políticas personalizadas a perfis personalizados do IAM que você cria para seus cofres do Amazon Glacier.

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

Para obter informações, consulte Adicionar permissões a um usuário no Guia do usuário do IAM.

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

Este exemplo mostra como criar uma política que permita 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 API da AWS.

{
    "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 Amazon Glacier. Essas políticas funcionam quando você está usando a API REST do Amazon Glacier, os SDKs da Amazon, a AWS CLI ou, se aplicável, o console de gerenciamento do Amazon 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.

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 Amazon Glacier ou, de maneira programática, chamando as ações de API Describe Vault (GET vault) ou List Vaults (GET vaults).

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 do cofre no Amazon 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.

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).

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 Amazon Glacier em um cofre chamado examplevault.