Políticas de Amazon QuickSight (basadas en identidades)

Con las políticas basadas en identidades de IAM, puede especificar las acciones y los recursos permitidos o denegados, así como las condiciones en las que se permiten o deniegan las acciones. Amazon QuickSight admite acciones, claves de condición y recursos específicos. Para obtener información sobre todos los elementos que utiliza en una política JSON, consulte Referencia de los elementos de las políticas JSON de IAM en la Guía del usuario de IAM.

Puede utilizar las credenciales raíz de AWS o las credenciales de usuario de IAM para crear una cuenta de Amazon QuickSight. Las credenciales raíz y de administrador de AWS ya cuentan con todos los permisos necesarios para administrar el acceso de Amazon QuickSight a los recursos de AWS.

No obstante, es aconsejable que proteja sus credenciales raíz y en su lugar utilice credenciales de usuario de IAM. Para ello, puede crear una política y asociarla al usuario de IAM y a los roles que tenga planificado utilizar para Amazon QuickSight. La política debe incluir las declaraciones adecuadas para las tareas administrativas de Amazon QuickSight que necesite llevar a cabo, tal y como se describe en las siguientes secciones.

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 en qué condiciones.

El elemento Action de una política JSON describe las acciones que puede utilizar para conceder 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 QuickSight utilizan el siguiente prefijo antes de la acción: quicksight:. Por ejemplo, para conceder a alguien permiso para ejecutar una instancia de Amazon EC2 con la operación RunInstances de la API de Amazon EC2, debe incluir la acción ec2:RunInstances en la política. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Amazon QuickSight 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": [
	      "quicksight:action1",
	      "quicksight:action2"]

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

"Action": "quicksight:Create*"

Amazon QuickSight proporciona una serie de acciones de AWS Identity and Access Management (IAM). Todas las acciones de Amazon QuickSight incluyen el prefijo quicksight:, como, por ejemplo, quicksight:Subscribe. Para obtener más información sobre el uso de acciones de Amazon QuickSight en una política de IAM, consulte Ejemplos de políticas de IAM para Amazon QuickSight.

Para ver la lista más actualizada de acciones de Amazon QuickSight, consulte Acciones definidas por Amazon QuickSight en la Guía del usuario de IAM.

Recursos

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 en qué condiciones.

El elemento Resource de la política JSON especifica el objeto u objetos a los que se aplica la acción. Las instrucciones deben contener un elemento Resource o NotResource. Como práctica recomendada, especifique un recurso utilizando el Nombre de recurso de Amazon (ARN). Puedes hacerlo para acciones que admitan un tipo de recurso específico, conocido como permisos de nivel de recurso.

Para las acciones que no admiten permisos de nivel de recurso, como las operaciones de descripción, utiliza un carácter comodín (*) para indicar que la instrucción se aplica a todos los recursos.

"Resource": "*"

El siguiente es un ejemplo de política. Significa que el intermediario que tiene esta política asociada puede invocar la operación CreateGroupMembership para cualquier grupo, siempre que el nombre de usuario que se añade al grupo no sea user1.

{
    "Effect": "Allow",
    "Action": "quicksight:CreateGroupMembership",
    "Resource": "arn:aws:quicksight:us-east-1:aws-account-id:group/default/*",
    "Condition": {
        "StringNotEquals": {
            "quicksight:UserName": "user1"
        }
    }
}

Algunas acciones de Amazon QuickSight, como las que se utilizan para crear recursos, no se pueden llevar a cabo en un recurso específico. En dichos casos, debe utilizar el carácter comodín (*).

"Resource": "*"

Algunas acciones de la API de se utilizan varios recursos. Para especificar varios recursos en una única instrucción, separe los ARN con comas.

"Resource": [
	      "resource1",
	      "resource2"

Para ver una lista de los tipos de recursos de Amazon QuickSight y sus nombres de recurso de Amazon (ARN), consulte Recursos definidos por Amazon QuickSight en la Guía del usuario de IAM. Para obtener información sobre las acciones con las que puede especificar el ARN de cada recurso, consulte Acciones definidas por Amazon QuickSight.

Claves de condición

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 en qué condiciones.

El elemento Condition (o bloque de Condition) permite especificar condiciones en las que entra en vigor una instrucción. El elemento Condition es opcional. Puedes crear expresiones condicionales que utilizan operadores de condición, tales como igual o menor que, para que la condición de la política coincida con los valores de la solicitud.

Si especifica varios elementos de Condition en una instrucción o varias claves en un único elemento de Condition, AWS las evalúa mediante una operación AND lógica. Si especifica varios valores para una única clave de condición, AWS evalúa la condición con una operación lógica OR. Se deben cumplir todas las condiciones antes de que se concedan los permisos de la instrucción.

También puedes utilizar variables de marcador de posición al especificar condiciones. Por ejemplo, puedes conceder un permiso de usuario de IAM para acceder a un recurso solo si está etiquetado con su nombre de usuario de IAM. Para más información, consulta Elementos de la política de IAM: variables y etiquetas en la Guía del usuario de IAM.

AWS admite claves de condición globales y claves de condición específicas del servicio. 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.

Amazon QuickSight 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 AWSen la Guía del usuario de IAM.

Ejemplos

Para ver ejemplos de políticas basadas en identidades de Amazon QuickSight, consulte Políticas de Amazon QuickSight basadas en identidades de IAM.