Solicitar acesso aos dados do Amazon S3 por meio da funcionalidade Concessões de Acesso do S3

Depois de usar a funcionalidade Concessões de Acesso do Amazon S3 para criar uma concessão de acesso que dá acesso aos dados do S3 para as entidades principais do AWS Identity and Access Management (IAM), suas identidades de diretório corporativo ou as aplicações autorizadas, os beneficiários poderão solicitar credenciais para acessar esses dados.

Quando uma aplicação ou AWS service (Serviço da AWS) usa a operação de API GetDataAccess para pedir à funcionalidade Concessões de Acesso do S3 acesso aos dados do S3 em nome de um beneficiário, primeiro a funcionalidade Concessões de Acesso do S3 verifica se você concedeu acesso aos dados para essa entidade. Em seguida, a funcionalidade Concessões de Acesso do S3 usa a operação de API AssumeRole para obter um token de credencial temporário e o envia ao solicitante. Esse token temporário de credencial é um token do AWS Security Token Service (AWS STS).

A solicitação GetDataAccess deve incluir o parâmetro target, que especifica o escopo dos dados do S3 aos quais as credenciais temporárias se aplicam. Esse escopo target pode ser igual ao escopo da concessão ou um subconjunto desse escopo, mas o escopo target deve estar dentro do escopo da concessão concedida ao solicitante. A solicitação também deve especificar o parâmetro permission para indicar o nível de permissão das credenciais temporárias, seja READ, WRITE ou READWRITE.

O solicitante pode especificar o nível de privilégio do token temporário na solicitação de credencial. Usando o parâmetro privilege, o solicitante pode reduzir ou aumentar o escopo de acesso das credenciais temporárias, dentro dos limites do escopo da concessão. O valor padrão do parâmetro privilege é Default, o que significa que o escopo target da credencial retornada é o escopo original da concessão. O outro valor possível para privilege é Minimal. Se o escopo target for reduzido do escopo original da concessão, a credencial temporária será reduzida para corresponder ao escopo target, desde que o escopo target esteja dentro do escopo da concessão.

A tabela a seguir detalha o efeito do parâmetro privilege em duas concessões. Uma concessão tem o escopo S3://DOC-EXAMPLE-BUCKET1/bob/*, que inclui todo o prefixo bob/ no bucket DOC-EXAMPLE-BUCKET1. A outra concessão tem o escopo S3://DOC-EXAMPLE-BUCKET1/bob/reports/*, que inclui apenas o prefixo bob/reports/ no bucket DOC-EXAMPLE-BUCKET1.

O parâmetro durationSeconds define a duração da credencial temporária, em segundos. O valor padrão é 3600 segundos (1 hora), mas o solicitante (o beneficiário) pode especificar um intervalo que varia de 900 segundos (15 minutos) até 43200 segundos (12 horas). Se o beneficiário solicitar um valor maior do que esse máximo, a solicitação falhará.

Para obter mais informações, consulte GetDataAccess na Referência da API do Amazon Simple Storage Service.

Você pode solicitar credenciais temporárias usando a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e os AWS SDKs.

aws s3control get-data-access \
--account-id 111122223333 \
--target s3://DOC-EXAMPLE-BUCKET/prefixA* \
--permission READ \
--privilege Default \
--region us-east-2

{
"Credentials": {
	"AccessKeyId": "Example-key-id",
	"SecretAccessKey": "Example-access-key",
	"SessionToken": "Example-session-token",
"Expiration": "2023-06-14T18:56:45+00:00"},
    "MatchedGrantTarget": "s3://DOC-EXAMPLE-BUCKET/prefixA**"
}