Acciones, recursos y claves de condición para AWS Transfer Family

AWS Transfer Family (prefijo de servicio:transfer) proporciona los siguientes recursos, acciones y claves de contexto de condiciones específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Acciones definidas por AWS Transfer Family

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
CreateAccess	Otorga permiso para agregar un acceso asociado a un servidor	Escritura	server*		iam:PassRole
CreateAgreement	Otorga permiso para agregar un acuerdo asociado a un servidor	Escritura	server*		iam:PassRole
				aws:TagKeys aws:RequestTag/${TagKey}
CreateConnector	Concede permiso para crear un conector	Escritura		aws:TagKeys aws:RequestTag/${TagKey}	iam:PassRole
CreateProfile	Otorga permiso para crear un perfil	Escritura		aws:TagKeys aws:RequestTag/${TagKey}
CreateServer	Otorga permiso para crear un servidor.	Write		aws:TagKeys aws:RequestTag/${TagKey}	iam:PassRole
CreateUser	Otorga permiso para agregar un usuario asociado a un servidor.	Escritura	server*		iam:PassRole
				aws:TagKeys aws:RequestTag/${TagKey}
CreateWorkflow	Concede permiso para crear un flujo de trabajo	Escritura		aws:TagKeys aws:RequestTag/${TagKey}
DeleteAccess	Otorga permiso para eliminar el acceso	Escritura	server*
DeleteAgreement	Otorga permiso para eliminar un acuerdo	Escritura	agreement*
DeleteCertificate	Otorga permiso para eliminar un certificado	Escritura	certificate*
DeleteConnector	Concede permiso para eliminar un conector	Escritura	connector*
DeleteHostKey	Otorga permiso para eliminar una clave de host asociada a un servidor	Escritura	host-key*
DeleteProfile	Otorga permiso para eliminar un perfil	Escritura	profile*
DeleteServer	Otorga permiso para eliminar un servidor.	Write	server*
DeleteSshPublicKey	Otorga permiso para eliminar una clave pública SSH de un usuario.	Write	user*
DeleteUser	Otorga permiso para eliminar un usuario asociado a un servidor.	Escritura	user*
DeleteWorkflow	Concede permiso para eliminar un flujo de trabajo	Escritura	workflow*
DescribeAccess	Otorga permiso para describir un acceso asociado a un servidor	Leer	server*
DescribeAgreement	Otorga permiso para describir un acuerdo asignado a un servidor	Leer	agreement*
DescribeCertificate	Otorga permiso para describir un certificado	Leer	certificate*
DescribeConnector	Otorga permiso para describir un conector	Leer	connector*
DescribeExecution	Otorga permiso para describir una ejecución asociada a un flujo de trabajo	Leer	workflow*
DescribeHostKey	Otorga permiso para describir una clave de host asociada a un servidor	Leer	host-key*
DescribeProfile	Otorga permiso para describir un perfil	Leer	profile*
DescribeSecurityPolicy	Otorga permiso para describir una política de seguridad.	Read
DescribeServer	Otorga permiso para describir un servidor.	Read	server*
DescribeUser	Otorga permiso para describir un usuario asociado a un servidor.	Leer	user*
DescribeWorkflow	Otorga permiso para describir un flujo de trabajo	Leer	workflow*
ImportCertificate	Otorga permiso para agregar un certificado	Escritura		aws:TagKeys aws:RequestTag/${TagKey}
ImportHostKey	Otorga permiso para agregar una clave de host a un servidor	Escritura	server*
				aws:TagKeys aws:RequestTag/${TagKey}
ImportSshPublicKey	Otorga permiso para agregar una clave pública SSH a un usuario.	Escritura	user*
ListAccesses	Otorga permiso para enumerar accesos	Leer	server*
ListAgreements	Otorga permiso para enumerar acuerdos	Leer	server*
ListCertificates	Otorga permiso para enumerar certificados	Leer
ListConnectors	Otorga permiso para enumerar conectores	Leer
ListExecutions	Otorga permiso para enumerar ejecuciones asociadas a un flujo de trabajo	Leer	workflow*
ListHostKeys	Otorga permiso para enumerar las claves de host asociadas a un servidor	Leer	server*
ListProfiles	Otorga permiso para enumerar perfiles.	Leer
ListSecurityPolicies	Otorga permiso para mostrar una lista de políticas de seguridad.	List
ListServers	Otorga permiso para mostrar una lista de servidores.	Enumeración
ListTagsForResource	Otorga permiso para incluir etiquetas para un recurso AWS de Transfer Family	Leer	agreement
			certificate
			connector
			host-key
			profile
			server
			user
			workflow
ListUsers	Otorga permiso para mostrar una lista de los usuarios asociados a un servidor.	Enumeración	server*
ListWorkflows	Otorga permiso para enumerar flujos de trabajo	Enumeración
SendWorkflowStepState	Otorga permiso para enviar una devolución de llamada para pasos personalizados asíncronos	Escritura	workflow*
StartDirectoryListing	Otorga permiso para iniciar una operación de lista en un servidor remoto mediante un conector	Escritura	connector*
StartFileTransfer	Otorga permiso para iniciar una transferencia de archivos de conector	Escritura	connector*
StartServer	Otorga permiso para iniciar un servidor.	Write	server*
StopServer	Otorga permiso para detener un servidor.	Escritura	server*
TagResource	Otorga permiso para etiquetar un recurso AWS de Transfer Family	Etiquetado	agreement
			certificate
			connector
			host-key
			profile
			server
			user
			workflow
				aws:TagKeys aws:RequestTag/${TagKey}
TestConnection	Otorga permiso para probar la conexión de un conector al servidor remoto	Escritura	connector*
TestIdentityProvider	Otorga permiso para probar un proveedor de identidad personalizada de servidor.	Leer	user*
UntagResource	Otorga permiso para desetiquetar un recurso de AWS Transfer Family	Etiquetado	agreement
			certificate
			connector
			host-key
			profile
			server
			user
			workflow
				aws:TagKeys
UpdateAccess	Otorga permiso para actualizar el acceso	Escritura			iam:PassRole
UpdateAgreement	Otorga permiso para actualizar un acuerdo	Escritura	agreement*		iam:PassRole
UpdateCertificate	Otorga permiso para actualizar un certificado	Escritura	certificate*
UpdateConnector	Otorga permiso para actualizar un conector	Escritura	connector*		iam:PassRole
UpdateHostKey	Otorga permiso para actualizar una clave de host	Escritura	host-key*
UpdateProfile	Otorga permiso para actualizar un perfil.	Escritura	profile*
UpdateServer	Otorga permiso para actualizar la configuración de un servidor.	Write	server*		iam:PassRole
UpdateUser	Otorga permiso para actualizar la configuración de un usuario.	Escritura	user*		iam:PassRole

Tipos de recursos definidos por AWS Transfer Family

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
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/${AgreementId}	aws:ResourceTag/${TagKey}
host-key	arn:${Partition}:transfer:${Region}:${Account}:host-key/${ServerId}/${HostKeyId}	aws:ResourceTag/${TagKey}

Claves de condición para AWS Transfer Family

AWS Transfer Family define las siguientes claves de condición que se pueden utilizar en el Condition elemento de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso por las etiquetas que se pasan en la solicitud	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por las etiquetas asociadas al recurso	Cadena
aws:TagKeys	Filtra el acceso por las claves de etiquetas que se pasan en la solicitud	ArrayOfString