Políticas baseadas em identidade Políticas baseadas em recursos Ações de políticas recursos de políticas Chaves de condição de políticas ACLs ABAC Credenciais temporárias Sessões de acesso direto Perfis de serviço Perfis vinculados ao serviço

Como o Amazon S3 funciona com o IAM

Antes de usar o IAM para gerenciar o acesso ao Amazon S3, saiba quais recursos do IAM estão disponíveis para uso com o Amazon S3.

Recursos do IAM que você pode usar com o Amazon S3
Atributo do IAM	Suporte ao Amazon S3
Políticas baseadas em identidade	Sim
Políticas baseadas em atributos	Sim
Ações de políticas	Sim
atributos de políticas	Sim
Chaves de condição de política (específicas do serviço)	Sim
ACLs	Sim
ABAC (tags em políticas)	Parcial
Credenciais temporárias	Sim
Sessões de acesso direto (FAS)	Sim
Perfis de serviço	Sim
Perfis vinculados ao serviço	Parcial

Consulte uma visão geral de como o Amazon S3 e outros serviços da AWS funcionam com a maioria dos recursos do IAM em Serviços da AWS que funcionam com o IAM no Guia do usuário do IAM.

Políticas baseadas em identidade do Amazon S3

É compatível com políticas baseadas em identidade

Sim

As políticas baseadas em identidade são documentos de políticas de permissões JSON que você pode anexar a uma identidade, como usuário, grupo de usuários ou perfil do IAM. Essas políticas controlam quais ações os usuários e funções podem realizar, em quais recursos e em que condições. Para saber como criar uma política baseada em identidade, consulte Criar políticas do IAM no Guia do usuário do IAM.

Com as políticas baseadas em identidade do IAM, é possível especificar ações ou atributos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. Não é possível especificar a entidade principal em uma política baseada em identidade porque ela se aplica ao usuário ou função à qual ela está anexado. Para saber mais sobre todos os elementos que podem ser usados em uma política JSON, consulte Referência de elementos da política JSON do IAM no Guia do Usuário do IAM.

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

Consulte exemplos de políticas baseadas em identidade do Amazon S3 em Políticas baseadas em identidade do Amazon S3.

Políticas baseadas em recurso no Amazon S3

É compatível com políticas baseadas em atributos

Sim

Políticas baseadas em recursos são documentos de políticas JSON que você anexa a um recurso. São exemplos de políticas baseadas em recursos as políticas de confiança de perfil do IAM e as políticas de bucket do Amazon S3. Em serviços compatíveis com políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Para o atributo ao qual a política está anexada, a política define quais ações uma entidade principal especificada pode executar nesse atributo e em que condições. Você deve especificar uma entidade principal em uma política baseada em recursos. As entidades principais podem incluir contas, usuários, funções, usuários federados ou Serviços da AWS.

Para permitir o acesso entre contas, você pode especificar uma conta inteira ou as entidades do IAM em outra conta como a entidade principal em uma política baseada em atributo. Adicionar uma entidade principal entre contas à política baseada em atributo é apenas metade da tarefa de estabelecimento da relação de confiança. Quando a entidade principal e o atributo estão em diferentes Contas da AWS, um administrador do IAM da conta confiável também deve conceder à entidade principal (usuário ou perfil) permissão para acessar o atributo. Eles concedem permissão ao anexar uma política baseada em identidade para a entidade. No entanto, se uma política baseada em atributo conceder acesso a uma entidade principal na mesma conta, nenhuma política baseada em identidade adicional será necessária. Para obter mais informações, consulte Como os perfis do IAM diferem de políticas baseadas em recursos no Guia do usuário do IAM.

O serviço do Amazon S3 é compatível com políticas de bucket, políticas de pontos de acesso e concessões de acesso:

Políticas de bucket são políticas baseadas em recursos que são anexadas a um bucket do Amazon S3. Uma política de bucket define quais entidades principais podem realizar ações no bucket.
As políticas de ponto de acesso são políticas baseadas em recursos que são avaliadas em conjunto com a política de bucket correspondente.
As concessões de acesso são um modelo simplificado para definir permissões de acesso aos dados no Amazon S3 por prefixo, bucket ou objeto. Consulte informações sobre a funcionalidade Concessões de Acesso do S3 em Gerenciar o acesso com a funcionalidade Concessões de Acesso do S3.

Entidades principais para políticas de bucket

O elemento Principal especifica o usuário, a conta, o serviço ou outra entidade que tem o acesso permitido ou negado a um recurso. Veja a seguir exemplos de especificação de Principal. Para obter mais informações, consulte Principal no Guia do usuário do IAM.

Conceder permissões a uma Conta da AWS

Para conceder permissões a uma Conta da AWS, identifique a conta usando o formato a seguir.


"AWS":"account-ARN"

Veja os exemplos a seguir.


"Principal":{"AWS":"arn:aws:iam::AccountIDWithoutHyphens:root"}


"Principal":{"AWS":["arn:aws:iam::AccountID1WithoutHyphens:root","arn:aws:iam::AccountID2WithoutHyphens:root"]}

Conceder permissões a um usuário do IAM

Para conceder permissão para um usuário do IAM na sua conta, você deve fornecer um par de nome-valor "AWS":"user-ARN".


"Principal":{"AWS":"arn:aws:iam::account-number-without-hyphens:user/username"}

Para obter exemplos detalhados que fornecem instruções passo a passo, consulte Exemplo 1: Proprietário do bucket que concede permissões do bucket aos usuários e Exemplo 3: O proprietário do bucket concede permissões para objetos que não possui.

nota

Se uma identidade do IAM for excluída depois que você atualizar a política de bucket, a política de bucket mostrará um identificador exclusivo no elemento da entidade principal em vez de um ARN. Esses IDs exclusivos nunca são reutilizados; portanto você pode remover com segurança entidades principais com identificadores exclusivos de todas as suas instruções de política. Para obter mais informações sobre identificadores exclusivos, consulte Identificadores do IAM no Guia do usuário do IAM.

Conceder permissões anônimas

Atenção

Tenha cuidado ao conceder acesso anônimo ao bucket do Amazon S3. Quando você concede acesso anônimo, qualquer pessoa no mundo pode acessar seu bucket. É altamente recomendável que você nunca conceda nenhum tipo de acesso anônimo de gravação ao seu bucket do S3.

Para conceder permissão a todos, também denominada acesso anônimo, defina o curinga ("*") como o valor Principal. Por exemplo, se você configura seu bucket como um site, quer que todos os objetos no bucket sejam publicamente acessíveis.


"Principal":"*"


"Principal":{"AWS":"*"}

Usar "Principal": "*" com um efeito Allow em uma política baseada em recursos permite que qualquer pessoa, mesmo que não esteja conectada à AWS, acesse seu recurso.

Usar "Principal" : { "AWS" : "*" } com um efeito Allow em uma política baseada em recursos permite que qualquer usuário raiz, usuário do IAM, sessão de função assumida ou usuário federado em qualquer conta na mesma partição acesse seu recurso.

Para usuários anônimos, esses dois métodos são equivalentes. Para obter mais informações, consulte Todas as entidades principais no Guia do usuário do IAM.

Não é possível usar um curinga para fazer a correspondência de parte de um nome de entidade principal ou ARN.

Importante

Como qualquer pessoa pode criar uma Conta da AWS, o nível de segurança desses dois métodos é equivalente, mesmo que funcionem de maneira diferente.

Restringir permissões de recursos

Também é possível usar a política de recursos para restringir o acesso a recursos que, de outra forma, estariam disponíveis para entidades principais do IAM. Use uma instrução Deny para impedir o acesso.

O exemplo a seguir bloqueará o acesso se um protocolo de transporte seguro não for usado:


{"Effect": "Deny", 
 "Principal": "*",
 "Action": "s3:*",
 "Resource": <bucket ARN>,
 "Condition": {
   "Boolean": { "aws:SecureTransport" : "false"}
 }
}

Usar "Principal": "*" para que essa restrição se aplique a todos é uma prática recomendada para essa política, em vez de tentar negar acesso somente a contas ou entidades principais específicas usando esse método.

Exigir acesso por URLs do CloudFront

Você pode exigir que os usuários acessem seu conteúdo do Amazon S3 somente usando URLs do CloudFront em vez de URLs do Amazon S3. Para fazer isso, crie um controle de acesso de origem (OAC) do CloudFront. Depois, altere as permissões em seus dados do S3. Na política de bucket, é possível definir o CloudFront como entidade principal da seguinte forma:


"Principal":{"Service":"cloudfront.amazonaws.com"}

Use um elemento Condition na política para permitir que o CloudFront acesse o bucket somente quando a solicitação for em nome da distribuição do CloudFront que contém a origem do S3.



        "Condition": {
           "StringEquals": {
              "AWS:SourceArn": "arn:aws:cloudfront::111122223333:distribution/CloudFront-distribution-ID"
           }
        }

Consulte mais informações sobre como solicitar acesso ao S3 por meio de URLs do CloudFront em Restringir o acesso ao conteúdo de uma origem do Amazon Simple Storage Service no Guia do desenvolvedor do Amazon CloudFront. Consulte mais informações sobre os benefícios de segurança e privacidade com o uso do Amazon CloudFront em Configurar o acesso seguro e restringir o acesso ao conteúdo.

Exemplos de política baseada em recursos para o Amazon S3

Consulte exemplos de política para buckets do Amazon S3 em Políticas de bucket para o Amazon S3.
Consulte exemplos de política para pontos de acesso em Configurar políticas do IAM para uso de pontos de acesso.

Ações de políticas para o Amazon S3

Oferece suporte a ações de políticas

Sim

Os administradores podem usar as políticas da JSON AWS para especificar quem tem acesso a quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O elemento Action de uma política JSON descreve as ações que você pode usar para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome que a operação de API da AWS associada. Existem algumas exceções, como ações somente de permissão, que não têm uma operação de API correspondente. Há também algumas operações que exigem várias ações em uma política. Essas ações adicionais são chamadas de ações dependentes.

Incluem ações em uma política para conceder permissões para executar a operação associada.

Veja a seguir diferentes tipos de relacionamento de mapeamento entre as operações de API do S3 e as ações de políticas necessárias.

Mapeamento de um para um com o mesmo nome. Por exemplo, para usar a operação de API PutBucketPolicy, a ação de política s3:PutBucketPolicy é necessária.
Mapeamento de um para um com nomes diferentes. Por exemplo, para usar a operação de API ListObjectsV2, a ação de política s3:ListBucket é necessária.
Mapeamento de um para muitos. Por exemplo, para usar a operação de API HeadObject, a s3:GetObject é necessária. Além disso, quando você usa o Bloqueio de Objetos do S3 e deseja obter o status de retenção legal ou as configurações de retenção de um objeto, as ações de política s3:GetObjectLegalHold ou s3:GetObjectRetention correspondentes também são necessárias para que você possa usar a operação de API HeadObject.
Mapeamento de muitos para um. Por exemplo, para usar as operações de API ListObjectsV2 ou HeadBucket, a ação de política s3:ListBucket é necessária.

Consulte uma lista de ações do Amazon S3 para uso em políticas em Actions defined by Amazon S3 na Referência de autorização do serviço. Consulte uma lista completa de operações de API do Amazon S3 em Amazon S3 API Actions na Referência de API do Amazon Simple Storage Service.

As ações da política no Amazon S3 usam o seguinte prefixo antes da ação:

s3

Para especificar várias ações em uma única instrução, separe-as com vírgulas.


"Action": [
      "s3:action1",
      "s3:action2"
         ]

As operações de bucket são operações de API do S3 que operam no tipo de recurso de bucket. Por exemplo, CreateBucket, ListObjectsV2 e PutBucketPolicy. As ações de política do S3 para operações de bucket exigem que o elemento Resource nas políticas de bucket ou nas políticas baseadas em identidade do IAM seja o identificador do nome do recurso da Amazon (ARN) do tipo de bucket do S3 no formato de exemplo a seguir.


"Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET"

A política de bucket a seguir concede a permissão s3:ListBucket ao usuário Akua (com a conta 12345678901) para realizar a operação de API ListObjectsV2 e listar objetos em um bucket do S3.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow Akua to list objects in the bucket",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::12345678901:user/Akua"
            },
            "Action": [
            "s3:ListBucket"
            ],
            "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET"
        }
    ]
}

Operações de bucket em políticas de ponto de acesso

As permissões concedidas em uma política de ponto de acesso entrarão em vigor somente se o bucket subjacente conceder as mesmas permissões. Ao usar os pontos de acesso do S3, você deve delegar o controle de acesso do bucket ao ponto de acesso ou adicionar as mesmas permissões nas políticas de ponto de acesso à política do bucket subjacente. Para ter mais informações, consulte Configurar políticas do IAM para uso de pontos de acesso. Nas políticas de ponto de acesso, as ações de políticas do S3 para operações de bucket exigem que você use o ARN accesspoint para o elemento Resource no formato a seguir.


"Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/DOC-EXAMPLE-ACCESS-POINT"

A política de ponto de acesso a seguir concede a permissão s3:ListBucket ao usuário Akua (com a conta 12345678901) para realizar a operação de API ListObjectsV2 por meio do ponto de acesso DOC-EXAMPLE-ACCESS-POINT do S3 para listar objetos no bucket associado ao ponto de acesso.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow Akua to list objects in the bucket through access point",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::12345678901:user/Akua"
            },
            "Action": [
            "s3:ListBucket"
            ],
            "Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/DOC-EXAMPLE-ACCESS-POINT"
        }
    ]
}

nota

Nem todas as operações de bucket são compatíveis com o ponto de acesso do S3. Para ter mais informações, consulte Compatibilidade de ponto de acesso com operações do S3.

As operações de objeto são operações de API do S3 que atuam sobre o tipo de recurso do objeto. Por exemplo, GetObject, PutObject e DeleteObject. As ações de política do S3 para operações de objeto exigem que o elemento Resource nas políticas seja o ARN do objeto do S3 nos formatos de exemplo a seguir.


"Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*"


"Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/prefix/*"

nota

O ARN do objeto deve conter uma barra após o nome do bucket, conforme mostrado nos exemplos anteriores.

A política de bucket a seguir concede a permissão s3:PutObject ao usuário Akua (com a conta 12345678901) para realizar a operação de API PutObject e fazer upload de objetos em um bucket do S3.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow Akua to upload objects",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::12345678901:user/Akua"
            },
            "Action": [
            "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*"
        }
    ]
}

Operações de objetos em políticas de ponto de acesso

Ao usar os pontos de acesso do S3 para controlar o acesso às operações de objetos, você pode usar políticas de ponto de acesso. Quando você usa políticas de ponto de acesso, as ações de políticas do S3 para operações de objeto exigem que você use o ARN accesspoint para o elemento Resource no seguinte formato: arn:aws:s3:region:account-id:accesspoint/access-point-name/object/resource. Para operações de objeto que usam o ponto de acesso, você deve incluir o valor /object/ após o ARN completo do ponto de acesso no elemento Resource. Aqui estão alguns exemplos.


"Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/DOC-EXAMPLE-ACCESS-POINT/object/*"


"Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/DOC-EXAMPLE-ACCESS-POINT/object/prefix/*"

A política de ponto de acesso a seguir concede a permissão s3:GetObject ao usuário Akua (com a conta 12345678901) para realizar a operação de API GetObject por meio do ponto de acesso DOC-EXAMPLE-ACCESS-POINT em todos os objetos no bucket associado ao ponto de acesso.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow Akua to get objects through access point",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::12345678901:user/Akua"
            },
            "Action": [
            "s3:GetObject"
            ],
            "Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/DOC-EXAMPLE-ACCESS-POINT/object/*"
        }
    ]
}

nota

Nem todas as operações de objetos são compatíveis com o ponto de acesso do S3. Para ter mais informações, consulte Compatibilidade de ponto de acesso com operações do S3.

As operações de ponto de acesso são operações de API do S3 que operam no tipo de recurso de accesspoint. Por exemplo, CreateAccessPoint, DeleteAccessPoint e GetAccessPointPolicy. As ações de política do S3 para operações de ponto de acesso só podem ser usadas em políticas baseadas em identidade do IAM, não em políticas de bucket ou políticas de ponto de acesso. As operações de pontos de acesso exigem que o elemento Resource seja o ARN accesspoint no formato de exemplo a seguir.


"Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/DOC-EXAMPLE-ACCESS-POINT"

A política baseada em identidade do IAM a seguir concede a permissão s3:GetAccessPointPolicy para realizar a operação de API GetAccessPointPolicy no ponto de acesso DOC-EXAMPLE-ACCESS-POINT do S3.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Grant permission to retrieve the access point policy of access point DOC-EXAMPLE-ACCESS-POINT",
            "Effect": "Allow",
            "Action": [
            "s3:GetAccessPointPolicy"
            ],
            "Resource": "arn:aws:s3:*:123456789012:access point/DOC-EXAMPLE-ACCESS-POINT"
        }
    ]
}

Se você usa pontos de acesso, consulte Operações de bucket em políticas de ponto de acesso para controlar o acesso às operações de bucket e Operações de objetos em políticas de ponto de acesso para controlar o acesso às operações de objetos. Consulte mais informações sobre como configurar políticas de ponto de acesso em Configurar políticas do IAM para uso de pontos de acesso.

Com o Amazon S3 Object Lambda, você pode adicionar seu próprio código às solicitações GET, LIST e HEAD do Amazon S3 para modificar e processar dados, conforme eles são retornados para uma aplicação. É possível fazer solicitações por um ponto de acesso do Object Lambda, que funciona da mesma maneira que fazer solicitações por outros pontos de acesso. Para ter mais informações, consulte Transformar objetos com o S3 Object Lambda.

Consulte mais informações sobre como configurar políticas de operações de ponto de acesso do Object Lambda em Configurar políticas do IAM para pontos de acesso do Object Lambda.

Um ponto de acesso multirregional fornece um endpoint global que as aplicações podem usar para atender a solicitações de buckets do S3 localizados em várias Região da AWS. É possível usar um ponto de acesso multirregional para criar aplicações de várias regiões com a mesma arquitetura usada em uma única região, depois executar essas aplicações em qualquer lugar do mundo. Para ter mais informações, consulte Pontos de acesso multirregionais no Amazon S3.

Consulte mais informações sobre como configurar políticas de operações de ponto de acesso multirregionais em Exemplos de políticas de pontos de acesso multirregionais.

(Operações em Lote) As operações de trabalho são operações de API do S3 que operam no tipo de recurso de trabalho. Por exemplo, DescribeJob e CreateJob. As ações de política do S3 para operações de trabalho só podem ser usadas em políticas baseadas em identidade do IAM, não em políticas de buckets. Além disso, as operações de trabalho exigem que o elemento Resource nas políticas baseadas em identidade do IAM seja o ARN job no formato de exemplo a seguir.


"Resource": "arn:aws:s3:*:123456789012:job/*"

A política baseada em identidade do IAM a seguir concede a permissão s3:DescribeJob para realizar a operação de API DescribeJob no trabalho do Operações em Lote do S3 DOC-EXAMPLE-JOB.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow describing the Batch operation job DOC-EXAMPLE-JOB",
            "Effect": "Allow",
            "Action": [
            "s3:DescribeJob"
            ],
            "Resource": "arn:aws:s3:*:123456789012:job/DOC-EXAMPLE-JOB"
        }
    ]
}

Consulte mais informações sobre como definir as operações de configuração do Lente de Armazenamento do S3 em Permissões do Amazon S3 Storage Lens.

As operações da conta são operações de API do S3 que operam no nível da conta. Por exemplo, GetPublicAccessBlock (para conta). A conta não é um tipo de recurso definido pelo Amazon S3. As ações de política do S3 para operações de conta só podem ser usadas em políticas baseadas em identidade do IAM, não em políticas de buckets. Além disso, as operações da conta exigem que o elemento Resource nas políticas baseadas em identidade do IAM seja "*".

A política baseada em identidade do IAM a seguir concede a permissão s3:GetAccountPublicAccessBlock para realizar a operação de API GetPublicAccessBlock no nível da conta e recuperar as configurações do Bloqueio de Acesso Público no nível da conta.


{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Sid":"Allow retrieving the account-level Public Access Block settings",
         "Effect":"Allow",
         "Action":[
            "s3:GetAccountPublicAccessBlock" 
         ],
         "Resource":[
            "*"
         ]
       }
    ]
}

Exemplos de políticas para o Amazon S3

Consulte exemplos de políticas baseadas em identidade do Amazon S3 em Políticas baseadas em identidade do Amazon S3.
Consulte exemplos de políticas baseadas em recursos do Amazon S3 em Políticas de bucket para o Amazon S3 e Configurar políticas do IAM para uso de pontos de acesso.

Recursos de políticas para o Amazon S3

Oferece suporte a atributos de políticas

Sim

O elemento Resource de política JSON especifica o objeto ou os objetos aos quais a ação se aplica. As instruções devem incluir um elemento Resource ou um elemento NotResource. Como prática recomendada, especifique um recurso usando Nome do recurso da Amazon (ARN). Isso pode ser feito para ações que oferecem suporte a um tipo de atributo específico, conhecido como permissões em nível de atributo.

Para ações não compatíveis com permissões no nível de recurso, como operações de listagem, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.


"Resource": "*"

Algumas ações de API do Amazon S3 são compatíveis com vários recursos. Por exemplo, s3:GetObject acessa EXAMPLE-RESOURCE-1 e EXAMPLE-RESOURCE-2; portanto, uma entidade principal deve ter permissões para acessar os dois recursos. Para especificar vários recursos em uma única instrução, separe os ARNs com vírgulas.


"Resource": [
      "EXAMPLE-RESOURCE-1",
      "EXAMPLE-RESOURCE-2"

Os recursos no Amazon S3 são buckets, objetos, pontos de acesso ou trabalhos. Em uma política, use o nome do recurso da Amazon (ARN) do bucket, do objeto, do ponto de acesso ou do trabalho para identificar o recurso.

Consulte uma lista completa dos tipos de recurso do Amazon S3 e os respectivos ARNs em Resources defined by Amazon S3 na Referência de autorização do serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Actions defined by Amazon S3.

Curingas para ARNs de recursos

Você pode usar curingas como parte do ARN do recurso. É possível usar caracteres curinga (* e ?) em qualquer segmento de ARN (partes separadas por dois pontos). Um asterisco (*) representa qualquer combinação de zero ou mais caracteres, e um ponto de interrogação (?) representa qualquer caractere único. É possível usar vários caracteres * ou ? em cada segmento, mas um curinga não pode abranger segmentos.

O ARN a seguir usa o curinga * na parte do ARN relativa ao ID para identificar todos os objetos no bucket examplebucket.
```
arn:aws:s3:::examplebucket/*
```
O ARN a seguir usa * para indicar todos os buckets e objetos do S3.
```
arn:aws:s3:::*
```
O ARN a seguir usa curingas, * e ?, na parte de relative-ID. Ele identifica todos os objetos em buckets, como example1bucket, example2bucket, example3bucket e assim por diante.
```
arn:aws:s3:::example?bucket/*
```

Variáveis de política para ARNs de recursos

Você pode usar variáveis de política em ARNs do Amazon S3. No momento da avaliação da política, essas variáveis predefinidas são substituídas pelos valores correspondentes. Vamos supor que você organize seu bucket como um conjunto de pastas, sendo uma pasta para cada um dos seus usuários. O nome da pasta é igual ao nome do usuário. Para conceder aos usuários permissão às pastas, você pode especificar uma variável de política no ARN do recurso:


arn:aws:s3:::bucket_name/developers/${aws:username}/

No tempo de execução, quando a política é avaliada, a variável ${aws:username} no ARN do recurso é substituída pelo nome de usuário da pessoa que faz a solicitação.

Exemplos de políticas para o Amazon S3

Consulte exemplos de políticas baseadas em identidade do Amazon S3 em Políticas baseadas em identidade do Amazon S3.
Consulte exemplos de políticas baseadas em recursos do Amazon S3 em Políticas de bucket para o Amazon S3 e Configurar políticas do IAM para uso de pontos de acesso.

Chaves de condição de política para o Amazon S3

Compatível com chaves de condição de política específicas do serviço

Sim

O elemento Condition (ou Condition bloco de) permite que você especifique condições nas quais uma instrução está em vigor. O elemento Condition é opcional. É possível criar expressões condicionais que usam agentes de condição, como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação.

Se você especificar vários elementos Condition em uma instrução ou várias chaves em um único Condition elemento, a AWS os avaliará usando uma operação lógica AND. Se você especificar vários valores para uma única chave de condição, a AWS avaliará a condição usando uma operação lógica OR. Todas as condições devem ser atendidas para que as permissões da instrução sejam concedidas.

Você também pode usar variáveis de espaço reservado ao especificar as condições. Por exemplo, é possível conceder a um usuário do IAM permissão para acessar um atributo somente se ele estiver marcado com seu nome de usuário do IAM. Para obter mais informações, consulte Elementos de política do IAM: variáveis e tags no Guia do usuário do IAM.

A AWS é compatível com chaves de condição globais e chaves de condição específicas do serviço. Para ver todas as AWS chaves de condição globais da , consulte AWSChaves de contexto de condição globais da no Guia do usuário do IAM.

Cada chave de condição do Amazon S3 é associada ao mesmo cabeçalho de solicitação de nome permitido pela API na qual a condição pode ser definida. As chaves de condição específicas do Amazon S3 ditam o comportamento dos cabeçalhos de solicitação de mesmo nome. Por exemplo, a chave de condição s3:VersionId usada para conceder permissão condicional à permissão s3:GetObjectVersion define o comportamento do parâmetro de consulta versionId que você define em uma solicitação GET Object.

Consulte uma lista de chaves de condição do Amazon S3 em Condition keys for Amazon S3 na Referência de autorização do serviço. Para saber com quais ações e recursos é possível usar uma chave de condição, consulte Actions defined by Amazon S3.

Exemplo: restringir uploads aos objetos com uma classe de armazenamento específica

Suponha que a Conta A, representada pelo ID da conta 123456789012, possui um bucket. O administrador da Conta A deseja restringir Dave, um usuário na Conta A, para que ele só possa carregar objetos no bucket armazenado com a classe de armazenamento STANDARD_IA. Para restringir uploads de objetos a uma classe de armazenamento específica, o administrador da Conta A pode usar a chave de condição s3:x-amz-storage-class, conforme mostrado no exemplo de política de bucket a seguir.


{
                 "Version": "2012-10-17",
                 "Statement": [
                   {
                     "Sid": "statement1",
                     "Effect": "Allow",
                     "Principal": {
                       "AWS": "arn:aws:iam::123456789012:user/Dave"
                     },
                     "Action": "s3:PutObject",
                     "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET1/*",
                     "Condition": {
                       "StringEquals": {
                         "s3:x-amz-storage-class": [
                           "STANDARD_IA"
                         ]
                       }
                     }
                   }
                 ]
            }

No exemplo, o bloco Condition especifica a condição StringEquals que é aplicada ao par de chave-valor especificado, "s3:x-amz-acl":["public-read"]. Existe um conjunto de chaves predefinidas que pode ser usado para expressar uma condição. O exemplo usa a chave de condição s3:x-amz-acl. Essa condição exige que o usuário inclua o cabeçalho x-amz-acl com o valor public-read em cada solicitação de objeto PUT.

Exemplos de políticas para o Amazon S3

Consulte exemplos de políticas baseadas em identidade do Amazon S3 em Políticas baseadas em identidade do Amazon S3.
Consulte exemplos de políticas baseadas em recursos do Amazon S3 em Políticas de bucket para o Amazon S3 e Configurar políticas do IAM para uso de pontos de acesso.

ACLs no Amazon S3

Oferece suporte a ACLs

Sim

No Amazon S3, as listas de controle de acesso (ACLs) controlam quais Contas da AWS têm permissões para acessar um recurso. As ACLs são semelhantes às políticas baseadas em recursos, embora não usem o formato de documento de política JSON.

Importante

A maioria dos casos de uso modernos no Amazon S3 não exige mais o uso de ACLs.

Consulte informações sobre como usar ACLs para controlar o acesso no Amazon S3 em Gerenciar o acesso com ACLs.

ABAC com o Amazon S3

Oferece suporte a ABAC (tags em políticas)

Parcial

O controle de acesso baseado em recurso (ABAC) é uma estratégia de autorização que define permissões com base em recursos. Na AWS, esses atributos são chamados de tags. É possível anexar tags a entidades do IAM (usuários ou perfis) e a muitos atributos da AWS. A marcação de entidades e atributos é a primeira etapa do ABAC. Em seguida, você cria políticas de ABAC para permitir operações quando a tag da entidade principal corresponder à tag do atributo que ela está tentando acessar.

O ABAC é útil em ambientes que estão crescendo rapidamente e ajuda em situações em que o gerenciamento de políticas se torna um problema.

Para controlar o acesso baseado em tags, forneça informações sobre as tags no elemento de condição de uma política usando as chaves de condição aws:ResourceTag/key-name, aws:RequestTag/key-name ou aws:TagKeys.

Se um serviço oferecer suporte às três chaves de condição para cada tipo de recurso, o valor será Sim para o serviço. Se um serviço oferecer suporte às três chaves de condição somente para alguns tipos de recursos, o valor será Parcial.

Para obter mais informações sobre o ABAC, consulte O que é ABAC? no Guia do usuário do IAM. Para visualizar um tutorial com etapas para configurar o ABAC, consulte Usar controle de acesso baseado em atributos (ABAC) no Guia do usuário do IAM.

Consulte exemplos de políticas baseadas em identidade para limitar o acesso aos trabalhos de Operações em Lote do S3 com base em tags em Controlar permissões para o recurso Operações em lote do S3 usando tags de trabalho.

ABAC e tags de objetos

Nas políticas de ABAC, os objetos usam tags s3: em vez de tags aws:. Para controlar o acesso a objetos com base em tags, forneça informações sobre a tag no elemento de condição de uma política usando as seguintes tags:

s3:ExistingObjectTag/tag-key
s3:s3:RequestObjectTagKeys
s3:RequestObjectTag/tag-key

Consulte informações sobre como usar tags de objeto para controlar o acesso, incluindo exemplos de políticas de permissão, em Marcação e políticas de controle de acesso.

Usar credenciais temporárias com o Amazon S3

Oferece suporte a credenciais temporárias

Sim

Alguns Serviços da AWS não funcionam quando você faz login usando credenciais temporárias. Para obter informações adicionais, incluindo quais Serviços da AWS funcionam com credenciais temporárias, consulte Serviços da AWS que funcionam com o IAM no Guia do usuário do IAM.

Você está usando credenciais temporárias se faz login no AWS Management Console usando qualquer método, exceto um nome de usuário e uma senha. Por exemplo, quando você acessa a AWS usando o link de autenticação única (SSO) da empresa, esse processo cria automaticamente credenciais temporárias. Você também cria automaticamente credenciais temporárias quando faz login no console como usuário e, em seguida, alterna perfis. Para obter mais informações sobre como alternar perfis, consulte Alternar para um perfil (console) no Guia do usuário do IAM.

Você pode criar credenciais temporárias manualmente usando a AWS CLI ou a API da AWS. Em seguida, você pode usar essas credenciais temporárias para acessar aAWS .AWS A recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para mais informações, consulte Credenciais de segurança temporárias no IAM.

Sessões de acesso direto para o Amazon S3

Suporte para o recurso Encaminhamento de sessões de acesso (FAS)

Sim

Quando você usa um usuário do IAM ou um perfil para executar ações na AWS, você é considerado uma entidade principal. Ao usar alguns serviços, você pode executar uma ação que inicia outra ação em um serviço diferente. O recurso FAS utiliza as permissões da entidade principal que chama um AWS service (Serviço da AWS), combinadas às permissões do AWS service (Serviço da AWS) solicitante, para realizar solicitações para serviços downstream. As solicitações de FAS só são feitas quando um serviço recebe uma solicitação que exige interações com outros Serviços da AWS ou com recursos para serem concluídas. Nesse caso, você precisa ter permissões para executar ambas as ações. Para obter detalhes da política ao fazer solicitações de FAS, consulte Encaminhar sessões de acesso.

O FAS é usado pelo Amazon S3 para fazer chamadas ao AWS KMS para descriptografar um objeto quando se usa a SSE-KMS para criptografá-lo. Para ter mais informações, consulte Usar criptografia do lado do servidor com o AWS KMS (SSE-KMS).
A funcionalidade Concessões de Acesso do S3 também usa FAS. Depois de criar uma concessão de acesso aos seus dados do S3 para uma identidade específica, o beneficiário solicita uma credencial temporária da funcionalidade Concessões de Acesso do S3. A funcionalidade Concessões de Acesso do S3 obtém uma credencial temporária para o solicitante pelo AWS STS e vende a credencial a ele. Para ter mais informações, consulte Solicitar acesso aos dados do Amazon S3 por meio da funcionalidade Concessões de Acesso do S3.

Perfis de serviço para o Amazon S3

Oferece suporte a perfis de serviço

Sim

Um perfil de serviço é um perfil do IAM que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. Para obter mais informações, consulte Criar um perfil para delegar permissões a um AWS service (Serviço da AWS) no Guia do usuário do IAM.

Atenção

A alteração das permissões de um perfil de serviço pode interromper a funcionalidade do Amazon S3. Edite perfis de serviço somente quando o Amazon S3 instruir a fazer isso.

Perfis vinculados ao serviço para o Amazon S3

Oferece suporte a perfis vinculados ao serviço

Parcial

Um perfil vinculado ao serviço é um tipo de perfil de serviço vinculado a um AWS service (Serviço da AWS). O serviço pode assumir o perfil de executar uma ação em seu nome. Os perfis vinculados ao serviço aparecem em sua Conta da AWS e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não pode editar as permissões para perfis vinculados ao serviço.

O Amazon S3 é compatível com perfis vinculados a serviço da Lente de Armazenamento do Amazon S3. Consulte detalhes de como criar ou gerenciar perfis vinculados ao serviço do Amazon S3 em Usar funções vinculadas a serviços para o Amazon S3 Storage Lens.

Serviço do Amazon S3 como entidade principal

Nome do serviço na política	Recurso do S3	Mais informações
`s3.amazonaws.com`	Replicação do S3	Configuração da replicação
`s3.amazonaws.com`	Notificações de eventos do S3	Notificações de eventos do Amazon S3
`s3.amazonaws.com`	Inventário S3	Inventário do Amazon S3
`access-grants.s3.amazonaws.com`	Concessões de Acesso do S3	Registrar um local
`batchoperations.s3.amazonaws.com`	Operações em lote do S3	Conceder permissões para operações em lote do Amazon S3
`logging.s3.amazonaws.com`	Registro em log de acesso ao servidor do S3	Habilitar o log de acesso ao servidor do Amazon S3
`storage-lens.s3.amazonaws.com`	Lente de Armazenamento do S3	Exibição de métricas de lente de armazenamento do Amazon S3 usando uma exportação de dados

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Identity and Access Management

Políticas e permissões

Como o Amazon S3 funciona com o IAM

Políticas baseadas em identidade do Amazon S3

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

Políticas baseadas em recurso no Amazon S3

Entidades principais para políticas de bucket

Conceder permissões a uma Conta da AWS

Conceder permissões a um usuário do IAM

nota

Conceder permissões anônimas

Atenção

Importante

Restringir permissões de recursos

Exigir acesso por URLs do CloudFront

Exemplos de política baseada em recursos para o Amazon S3

Ações de políticas para o Amazon S3

Operações de buckets

Operações de bucket em políticas de ponto de acesso

nota

Operações com objetos

nota

Operações de objetos em políticas de ponto de acesso

nota

Operações de ponto de acesso

Operações de ponto de acesso do Object Lambda

Operações de ponto de acesso multirregionais

Operações de trabalho em lote

Operações de configuração da Lente de Armazenamento do S3

Operações de conta

Exemplos de políticas para o Amazon S3

Recursos de políticas para o Amazon S3

Curingas para ARNs de recursos

Variáveis de política para ARNs de recursos

Exemplos de políticas para o Amazon S3

Chaves de condição de política para o Amazon S3

Exemplo: restringir uploads aos objetos com uma classe de armazenamento específica

Exemplos de políticas para o Amazon S3

ACLs no Amazon S3

Importante

ABAC com o Amazon S3

ABAC e tags de objetos

Usar credenciais temporárias com o Amazon S3

Sessões de acesso direto para o Amazon S3

Perfis de serviço para o Amazon S3

Atenção

Perfis vinculados ao serviço para o Amazon S3