Cómo funciona Amazon WorkDocs con IAM

Antes de utilizar IAM para administrar el acceso a Amazon WorkDocs, debe conocer qué características de IAM se encuentran disponibles con Amazon WorkDocs. Para obtener una perspectiva general sobre cómo funcionan Amazon WorkDocs y otros servicios de AWS con IAM, consulte Servicios de AWS que funcionan con IAM en la Guía del usuario de IAM.

Políticas de Amazon WorkDocs basadas en identidades

Con las políticas basadas en identidad de IAM, puede especificar acciones permitidas o denegadas. Amazon WorkDocs admite acciones específicas. Para obtener más información acerca de los elementos que utiliza en una política de JSON, consulte Referencia de los elementos de las políticas de JSON de IAM en la Guía del usuario de IAM.

Acciones

Los administradores pueden utilizar las políticas JSON de AWS para especificar quién tiene acceso a qué. Es decir, qué entidad principal puede realizar acciones en qué recursos y bajo qué condiciones.

El elemento Action de una política JSON describe las acciones que puede utilizar para permitir o denegar el acceso en una política. Las acciones de la política generalmente tienen el mismo nombre que la operación de API de AWS asociada. Hay algunas excepciones, como acciones de solo permiso que no tienen una operación de API coincidente. También hay algunas operaciones que requieren varias acciones en una política. Estas acciones adicionales se denominan acciones dependientes.

Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.

Las acciones de políticas de Amazon WorkDocs utilizan el siguiente prefijo antes de la acción: workdocs:. Por ejemplo, para conceder a alguien permiso para ejecutar la operación de API DescribeUsers de Amazon WorkDocs, incluya la acción workdocs:DescribeUsers en su política. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Amazon WorkDocs define su propio conjunto de acciones que describen las tareas que se pueden realizar con este servicio.

Para especificar varias acciones en una única instrucción, sepárelas con comas del siguiente modo:

"Action": [
      "workdocs:DescribeUsers",
      "workdocs:CreateUser"

Puede utilizar caracteres comodín para especificar varias acciones (*). Por ejemplo, para especificar todas las acciones que comiencen con la palabra Describe, incluya la siguiente acción:

"Action": "workdocs:Describe*"

nota

Para garantizar la compatibilidad con versiones anteriores, incluya la acción zocalo. Por ejemplo:

"Action": [
"zocalo:*",
"workdocs:*"
],

Para ver una lista de las acciones de Amazon WorkDocs, consulte Acciones definidas por Amazon WorkDocs en la Guía del usuario de IAM.

Recursos

Amazon WorkDocs no permite especificar los ARN de los recursos en una política.

Claves de condición

Amazon WorkDocs no proporciona ninguna clave de condición específica del servicio, pero sí admite el uso de algunas claves de condición globales. Para ver todas las claves de condición globales de AWS, consulte Claves de contexto de condición globales de AWS en la Guía del usuario de IAM.

Ejemplos

Para ver ejemplos de políticas basadas en identidades de Amazon WorkDocs, consulte Ejemplos de políticas basadas en identidades de Amazon WorkDocs.

Políticas basadas en recursos de Amazon WorkDocs

Amazon WorkDocs no admite las políticas basadas en recursos.

Autorización basada en etiquetas de Amazon WorkDocs

Amazon WorkDocs no admite el etiquetado de recursos ni el control de acceso basado en etiquetas.

Roles de IAM de Amazon WorkDocs

Un rol de IAM es una entidad de la cuenta de AWS que dispone de permisos específicos.

Uso de credenciales temporales con Amazon WorkDocs

Le recomendamos que utilice credenciales temporales para iniciar sesión con federación, asumir un rol de IAM o asumir un rol de acceso entre cuentas. Las credenciales de seguridad temporales se obtienen mediante una llamada a operaciones de la API de AWS STS, como AssumeRole o GetFederationToken.

Amazon WorkDocs admite el uso de credenciales temporales.

Roles vinculados a servicios

Los roles vinculados a servicios permiten a los servicios de AWS obtener acceso a los recursos de otros servicios para completar una acción en su nombre. Los roles vinculados a servicios aparecen en la cuenta de IAM y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios.

Amazon WorkDocs no admite roles vinculados a servicios.

Roles de servicio

Esta característica permite que un servicio asuma un rol de servicio en su nombre. Este rol permite que el servicio obtenga acceso a los recursos de otros servicios para completar una acción en su nombre. Los roles de servicio aparecen en su cuenta de IAM y son propiedad de la cuenta. Esto significa que un administrador de IAM puede cambiar los permisos de este rol. Sin embargo, hacerlo podría deteriorar la funcionalidad del servicio.

Amazon WorkDocs no admite roles de servicio.