Ações, recursos e chaves de condição do AWS Transfer Family - Referência de autorização do serviço
AçõesTipos de recursosChaves de condição

Ações, recursos e chaves de condição do AWS Transfer Family

O AWS Transfer Family (prefixo de serviço: transfer) fornece os seguintes recursos, ações e chaves de contexto de condição específicos do serviço para uso em políticas de permissão do IAM.

Referências:

Ações definidas pelo AWS Transfer Family

Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.

A coluna Nível de acesso da tabela Ações descreve como a ação é classificada (lista, leitura, gravação, gerenciamento de permissões ou marcação). Esta classificação pode ajudar você a compreender o nível de acesso que uma ação concede quando a usa em uma política. Para obter mais informações sobre níveis de acesso, consulte Níveis de acesso em resumos de políticas.

A coluna Tipos de recursos na tabela Ações indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") aos quais a política se aplica no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma instrução com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o elemento Resource em uma política do IAM, deverá incluir um ARN ou padrão para cada tipo de recurso necessário. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um dos tipos de recurso opcionais.

A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.

A coluna Ações dependentes da tabela Ações mostra permissões adicionais que podem ser necessárias para chamar uma ação com êxito. Essas permissões podem ser necessárias além da permissão para a ação em si. Quando uma ação especifica ações dependentes, essas dependências podem se aplicar a recursos adicionais definidos para essa ação, não somente ao primeiro recurso listado na tabela.

nota

As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.

Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.

Ações Descrição Nível de acesso Tipos de recursos (*necessários) Chaves de condição Ações dependentes
CreateAccess Concede permissão para adicionar um acesso associado a um servidor Gravar

server*

iam:PassRole

CreateAgreement Concede permissão para adicionar um contrato associado a um servidor Gravar

server*

iam:PassRole

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

CreateConnector Concede permissão para criar um conector Gravar

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

transfer:RequestConnectorProtocol

iam:PassRole

CreateProfile Concede permissão para criar um perfil Gravar

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

CreateServer Concede permissão para criar um servidor Gravação

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

transfer:RequestServerEndpointType

transfer:RequestServerDomain

transfer:RequestServerProtocols

iam:PassRole

CreateUser Concede permissão para adicionar um usuário associado a um servidor Gravar

server*

iam:PassRole

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

CreateWebApp Concede permissão para criar um webapp Gravar

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

iam:PassRole

CreateWorkflow Concede permissão para criar um fluxo de trabalho Gravar

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

DeleteAccess Concede permissão para excluir acesso Gravar

server*

DeleteAgreement Concede permissão para excluir um contrato Gravar

agreement*

DeleteCertificate Concede permissão para excluir um certificado Gravar

certificate*

DeleteConnector Concede permissão para excluir um conector Gravar

connector*

DeleteHostKey Concede permissão para excluir uma chave de host associada a um servidor Gravar

host-key*

DeleteProfile Concede permissão para excluir perfil Gravar

profile*

DeleteServer Concede permissão para excluir um servidor Gravação

server*

DeleteSshPublicKey Concede permissão para excluir uma chave pública SSH de um usuário Gravação

user*

DeleteUser Concede permissão para excluir um usuário associado a um servidor Gravar

user*

DeleteWebApp Concede permissão para excluir um webapp Gravar

webapp*

DeleteWebAppCustomization Concede permissão para excluir uma personalização de webapp Gravar

webapp*

DeleteWorkflow Concede permissão para excluir um fluxo de trabalho Gravar

workflow*

DescribeAccess Concede permissão para descrever um acesso atribuído a um servidor Leitura

server*

DescribeAgreement Concede permissão para descrever um contrato atribuído a um servidor Leitura

agreement*

DescribeCertificate Concede permissão para descrever um certificado Leitura

certificate*

DescribeConnector Concede permissão para descrever um conector Leitura

connector*

DescribeExecution Concede permissão para descrever uma execução associada a um fluxo de trabalho Leitura

workflow*

DescribeHostKey Concede permissão para descrever uma chave de host associada a um servidor Leitura

host-key*

DescribeProfile Concede permissão para descrever um perfil Leitura

profile*

DescribeSecurityPolicy Concede permissão para descrever uma política de segurança Read
DescribeServer Concede permissão para descrever um servidor Read

server*

DescribeUser Concede permissão para descrever um usuário associado a um servidor Leitura

user*

DescribeWebApp Concede permissão para descrever um webapp Leitura

webapp*

DescribeWebAppCustomization Concede permissão para descrever uma personalização de webapp Leitura

webapp*

DescribeWorkflow Concede permissão para descrever um fluxo de trabalho Leitura

workflow*

ImportCertificate Concede permissão para adicionar um certificado Gravar

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

ImportHostKey Concede permissão para adicionar uma chave de host a um servidor Gravar

server*

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

ImportSshPublicKey Concede permissão para adicionar uma chave pública SSH a um usuário Gravar

user*

ListAccesses Concede permissão para listar acessos Leitura

server*

ListAgreements Concede permissão para listar contratos Leitura

server*

ListCertificates Concede permissão para listar certificados Leitura
ListConnectors Concede permissão para listar conectores Leitura
ListExecutions Concede permissão para listar execuções associadas a um fluxo de trabalho Leitura

workflow*

ListFileTransferResults Concede permissão para listar status de transferência de arquivos para conectores Leitura

connector*

ListHostKeys Concede permissão para listar chaves de host associadas a um servidor Leitura

server*

ListProfiles Concede permissão para listar perfis Leitura
ListSecurityPolicies Concede permissão para listar políticas de segurança List
ListServers Concede permissão para listar servidores Lista
ListTagsForResource Concede permissão para listar etiquetas de um recurso do AWS Transfer Family Leitura

agreement

certificate

connector

host-key

profile

server

user

workflow

ListUsers Concede permissão para listar usuários associados a um servidor Lista

server*

ListWebApps Concede permissão para listar webapps Lista
ListWorkflows Concede permissão para listar fluxos de trabalho Lista
SendWorkflowStepState Concede permissão para emitir um retorno de chamada para etapas personalizadas assíncronas Gravar

workflow*

StartDirectoryListing Concede permissão para iniciar uma operação de lista em um servidor remoto usando um conector Gravar

connector*

StartFileTransfer Concede permissão para iniciar uma transferência de arquivo de conexão Gravar

connector*

StartRemoteDelete Concede permissão para iniciar uma operação de exclusão de conector em um servidor remoto Gravar

connector*

StartRemoteMove Concede permissão para iniciar uma operação de movimentação de um conector em um servidor remoto Gravar

connector*

StartServer Concede permissão para iniciar um servidor Write

server*

StopServer Concede permissão para interromper um servidor Gravar

server*

TagResource Concede permissão para marcar um recurso do AWS Transfer Family Tags

agreement

certificate

connector

host-key

profile

server

user

webapp

workflow

aws:TagKeys

aws:RequestTag/${TagKey}

TestConnection Concede permissão para testar a conexão de um conector com o servidor remoto Gravar

connector*

TestIdentityProvider Concede permissão para testar o provedor de identidade personalizado de um servidor Leitura

user*

UntagResource Concede permissão para desmarcar um recurso do AWS Transfer Family Tags

agreement

certificate

connector

host-key

profile

server

user

webapp

workflow

aws:TagKeys

UpdateAccess Concede permissão para atualizar acesso Gravar

iam:PassRole

UpdateAgreement Concede permissão para atualizar um contrato Gravar

agreement*

iam:PassRole

UpdateCertificate Concede permissão para atualizar um certificado Gravar

certificate*

UpdateConnector Concede permissão para atualizar um conector Gravar

connector*

iam:PassRole

UpdateHostKey Concede permissão para atualizar uma chave de host Gravar

host-key*

UpdateProfile Concede permissão para atualizar um perfil Gravar

profile*

UpdateServer Concede permissão para atualizar a configuração de um servidor Gravação

server*

iam:PassRole

transfer:RequestServerEndpointType

transfer:RequestServerProtocols

UpdateUser Concede permissão para atualizar a configuração de um usuário Gravar

user*

iam:PassRole

UpdateWebApp Concede permissão para atualizar a configuração de um webapp Gravar

webapp*

iam:PassRole

UpdateWebAppCustomization Concede permissão para atualizar a configuração de uma personalização de webapp Gravar

webapp*

iam:PassRole

Tipos de recursos definidos pelo AWS Transfer Family

Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela Tipos de recursos. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos ARN Chaves de condição
user arn:${Partition}:transfer:${Region}:${Account}:user/${ServerId}/${UserName}

aws:ResourceTag/${TagKey}

server arn:${Partition}:transfer:${Region}:${Account}:server/${ServerId}

aws:ResourceTag/${TagKey}

workflow arn:${Partition}:transfer:${Region}:${Account}:workflow/${WorkflowId}

aws:ResourceTag/${TagKey}

certificate arn:${Partition}:transfer:${Region}:${Account}:certificate/${CertificateId}

aws:ResourceTag/${TagKey}

connector arn:${Partition}:transfer:${Region}:${Account}:connector/${ConnectorId}

aws:ResourceTag/${TagKey}

profile arn:${Partition}:transfer:${Region}:${Account}:profile/${ProfileId}

aws:ResourceTag/${TagKey}

agreement arn:${Partition}:transfer:${Region}:${Account}:agreement/${ServerId}/${AgreementId}

aws:ResourceTag/${TagKey}

host-key arn:${Partition}:transfer:${Region}:${Account}:host-key/${ServerId}/${HostKeyId}

aws:ResourceTag/${TagKey}

webapp arn:${Partition}:transfer:${Region}:${Account}:webapp/${WebAppId}

aws:ResourceTag/${TagKey}

Chaves de condição do AWS Transfer Family

O AWS Transfer Family define as seguintes chaves de condição que podem ser usadas no elemento Condition de uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.

Para exibir as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de contexto de condição globais da AWS.

Chaves de condição Descrição Tipo
aws:RequestTag/${TagKey} Filtra o acesso pelas etiquetas que são transmitidas na solicitação Segmento
aws:ResourceTag/${TagKey} Filtra o acesso pelas etiquetas associadas ao recurso Segmento
aws:TagKeys Filtra o acesso pelas chaves da etiqueta que são transmitidas na solicitação ArrayOfString
transfer:RequestConnectorProtocol Filtra o acesso pelo protocolo do conector transmitido na solicitação String
transfer:RequestServerDomain Filtra o acesso pelo domínio de armazenamento transmitido na solicitação String
transfer:RequestServerEndpointType Filtra o acesso pelo tipo de endpoint transmitido na solicitação String
transfer:RequestServerProtocols Filtra o acesso pelos protocolos de servidor transmitidos na solicitação ArrayOfString