Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Cómo funciona Amazon QLDB con IAM Antes de utilizar IAM para administrar el acceso a QLDB, conozca qué características de IAM se pueden utilizar con QLDB. **importante** Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL. **Características de IAM que puede utilizar con Amazon QLDB** | Característica de IAM | Compatibilidad de QLDB | | --- | --- | | [Políticas basadas en identidades](#security_iam_service-with-iam-id-based-policies) | Sí | | [Políticas basadas en recursos](#security_iam_service-with-iam-resource-based-policies) | No | | [Acciones de políticas](#security_iam_service-with-iam-id-based-policies-actions) | Sí | | [Recursos de políticas](#security_iam_service-with-iam-id-based-policies-resources) | Sí | | [Claves de condición de política](#security_iam_service-with-iam-id-based-policies-conditionkeys) | Sí | | [ACLs](#security_iam_service-with-iam-acls) | No | | [ABAC (etiquetas en políticas)](#security_iam_service-with-iam-tags) | Sí | | [Credenciales temporales](#security_iam_service-with-iam-roles-tempcreds) | Sí | | [Permisos de entidades principales](#security_iam_service-with-iam-principal-permissions) | No | | [Roles de servicio](#security_iam_service-with-iam-roles-service) | Sí | | [Roles vinculados al servicio](#security_iam_service-with-iam-roles-service-linked) | No | *Para obtener una visión general de cómo funcionan la QLDB y Servicios de AWS otras funciones con la mayoría de las funciones de IAM, [Servicios de AWS consulte Cómo funcionan con IAM en la Guía del usuario](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) de IAM.* ## Políticas basadas en identidades de QLDB **Compatibilidad con las políticas basadas en identidad:** sí Las políticas basadas en identidad son documentos de políticas de permisos JSON que puede asociar a una identidad, como un usuario de IAM, un grupo de usuarios o un rol. Estas políticas controlan qué acciones pueden realizar los usuarios y los roles, en qué recursos y en qué condiciones. Para obtener más información sobre cómo crear una política basada en identidad, consulte [Creación de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) en la *Guía del usuario de IAM*. 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. No es posible especificar la entidad principal en una política basada en identidad porque se aplica al usuario o rol al que está asociada. Para obtener más información sobre los elementos que puede utilizar en una política de JSON, consulte [Referencia de los elementos de las políticas de JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) en la *Guía del usuario de IAM*. ### Ejemplos de políticas basadas en identidades de QLDB Para ver ejemplos de políticas basadas en identidad de QLDB, consulte [Ejemplos de políticas basadas en identidades para Amazon QLDB](security_iam_id-based-policy-examples.md). ## Políticas basadas en recursos de QLDB **Admite políticas basadas en recursos:** no Las políticas basadas en recursos son documentos de política JSON que se asocian a un recurso. Los ejemplos de políticas basadas en recursos son las *políticas de confianza de roles* de IAM y las *políticas de bucket* de Amazon S3. En los servicios que admiten políticas basadas en recursos, los administradores de servicios pueden utilizarlos para controlar el acceso a un recurso específico. Para el recurso al que se asocia la política, la política define qué acciones puede realizar una entidad principal especificada en ese recurso y en qué condiciones. Debe [especificar una entidad principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) en una política en función de recursos. Los directores pueden incluir cuentas, usuarios, roles, usuarios federados o. Servicios de AWS Para habilitar el acceso entre cuentas, puede especificar toda una cuenta o entidades de IAM de otra cuenta como la entidad principal de una política en función de recursos. Añadir a una política en función de recursos una entidad principal entre cuentas es solo una parte del establecimiento de una relación de confianza. Cuando el principal y el recurso son diferentes Cuentas de AWS, el administrador de IAM de la cuenta de confianza también debe conceder a la entidad principal (usuario o rol) permiso para acceder al recurso. Para conceder el permiso, adjunte la entidad a una política basada en identidad. Sin embargo, si la política basada en recursos concede acceso a una entidad principal de la misma cuenta, no es necesaria una política basada en identidad adicional. Para obtener más información, consulte [Cross account resource access in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) en la *Guía del usuario de IAM*. ## Acciones de política para QLDB **Compatibilidad con las acciones de políticas:** sí Los administradores pueden usar las políticas de AWS JSON 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 políticas suelen tener el mismo nombre que la operación de AWS API 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. Para ver una lista de las acciones de QLDB, consulte [Acciones definidas por Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions) en la *Referencia de autorizaciones de servicio*. Las acciones de políticas de QLDB utilizan el siguiente prefijo antes de la acción: ``` qldb ``` Para especificar varias acciones en una única instrucción, sepárelas con comas. ``` "Action": [ "qldb:action1", "qldb:action2" ] ``` Puede utilizar caracteres comodín (\$1) para especificar varias acciones . Por ejemplo, para especificar todas las acciones que comiencen con la palabra `Describe`, incluya la siguiente acción: ``` "Action": "qldb:Describe*" ``` Para interactuar con la API de datos transaccionales de QLDB (*sesión de QLDB*) mediante la ejecución de instrucciones [PartiQL](ql-reference.md) en un libro mayor, debe conceder permiso a la acción `SendCommand` de la siguiente manera. ``` "Action": "qldb:SendCommand" ``` Para ver los libros mayores en el modo de permisos `STANDARD`, vaya a [Referencia de permisos PartiQL](getting-started-standard-mode.md#security_iam_partiql-reference) y consulte los permisos adicionales necesarios para cada comando PartiQL. Para ver ejemplos de políticas basadas en identidad de QLDB, consulte [Ejemplos de políticas basadas en identidades para Amazon QLDB](security_iam_id-based-policy-examples.md). ## Recursos de políticas de QLDB **Compatibilidad con los recursos de políticas:** sí Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puedes 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)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). 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 (\$1) para indicar que la instrucción se aplica a todos los recursos. ``` "Resource": "*" ``` *Para ver una lista de los tipos de recursos de QLDB y ARNs sus respectivos tipos, [consulte Recursos definidos por Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-resources-for-iam-policies) en la Referencia de autorización de servicio.* Para obtener información sobre las acciones con las que puede especificar el ARN de cada recurso, consulte [Acciones definidas por Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions). En QLDB, el recurso principal son los *libros mayores*. QLDB también admite otros tipos de recursos: *tablas* y *secuencias*. Sin embargo, puede crear tablas y secuencias solamente en el contexto de libro mayor existente. Una tabQLDB es una vista materializada de una colección sin ordenar de revisiones de documentos del diario del libro mayor. En el modo de permisos `STANDARD` del libro mayor, deberá crear políticas de IAM que concedan permisos para ejecutar instrucciones PartiQL en este recurso de tabla. Con los permisos del recurso de tabla podrá ejecutar instrucciones para acceder al estado actual de la tabla. También puede consultar el historial de revisiones de la tabla usando la función integrada `history()`. Para obtener más información, consulte [Introducción al modo de permisos estándar en Amazon QLDB](getting-started-standard-mode.md). **nota** La `CREATE TABLE` instrucción crea una tabla con un identificador único y el nombre de tabla proporcionado. El nombre de tabla proporcionado debe ser único entre todas las tablas activas. Sin embargo, QLDB le permite desactivar tablas, por lo que puede haber varias tablas inactivas que compartan el mismo nombre de tabla. Por lo tanto, los recursos de tabla ARNs hacen referencia al identificador único asignado por el sistema y no al nombre de la tabla definido por el usuario. Cada libro mayor también proporciona un recurso de catálogo definido por el sistema que puede consultar para obtener una lista de todas las tablas e índices de un libro mayor. Para obtener más información acerca del modelo de objeto de datos de QLDB, consulte [Conceptos básicos y terminología de Amazon QLDB](ledger-structure.md). Estos recursos tienen ARNs asociados únicos, como se muestra en la siguiente tabla. **** | Tipo de recurso | ARN | | --- | --- | | ledger | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1 | | table | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1/table/\$1\$1TableId\$1 | | catalog | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1/information\$1schema/user\$1tables | | stream | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:stream/\$1\$1LedgerName\$1/\$1\$1StreamId\$1 | Por ejemplo, para especificar el recurso `myExampleLedger` en su instrucción, utilice el siguiente ARN: ``` "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" ``` Para especificar varios recursos en una sola sentencia, sepárelos ARNs con comas. ``` "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2" ] ``` Para ver ejemplos de políticas basadas en identidad de QLDB, consulte [Ejemplos de políticas basadas en identidades para Amazon QLDB](security_iam_id-based-policy-examples.md). ## Claves de condición de política para QLDB **Compatibilidad con claves de condición de políticas específicas del servicio:** sí Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puedes 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), 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 mediante una `OR` operación lógica. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html) 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 AWS globales, consulte las claves de [contexto de condición AWS globales en la Guía](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) del usuario de *IAM*. Para ver una lista de las claves de condición de QLDB, consulte [Claves de condición para Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-policy-keys) en la *Referencia de autorizaciones de servicio*. Para obtener más información acerca de las acciones y los recursos con los que puede utilizar una clave de condición, consulte [Acciones definidas por Amazon QLDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions). Las acciones `PartiQLDropIndex` y `PartiQLDropTable` admiten la clave de condición `qldb:Purge`. Esta clave de condición filtra el acceso por el valor de `purge` especificado en una instrucción `DROP` PartiQL. Sin embargo, QLDB actualmente solo admite `purge = true` para instrucciones `DROP INDEX` y `purge = false` para instrucciones `DROP TABLE`. Otras acciones de QLDB admiten algunas claves de condición globales. Para ver ejemplos de políticas basadas en identidad de QLDB, consulte [Ejemplos de políticas basadas en identidades para Amazon QLDB](security_iam_id-based-policy-examples.md). ## Listas de control de acceso (ACLs) en QLDB **Soportes ACLs**: No Las listas de control de acceso (ACLs) controlan qué directores (miembros de la cuenta, usuarios o roles) tienen permisos para acceder a un recurso. ACLs son similares a las políticas basadas en recursos, aunque no utilizan el formato de documento de políticas JSON. ## Control de acceso basado en atributos (ABAC) con QLDB **Admite ABAC (etiquetas en las políticas):** sí El control de acceso basado en atributos (ABAC) es una estrategia de autorización que define permisos en función de atributos. *En AWS, estos atributos se denominan etiquetas.* Puede adjuntar etiquetas a las entidades de IAM (usuarios o roles) y a muchos AWS recursos. El etiquetado de entidades y recursos es el primer paso de ABAC. A continuación, designa las políticas de ABAC para permitir operaciones cuando la etiqueta de la entidad principal coincida con la etiqueta del recurso al que se intenta acceder. ABAC es útil en entornos que crecen con rapidez y ayuda en situaciones en las que la administración de las políticas resulta engorrosa. Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el [elemento de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de una política utilizando las claves de condición `aws:ResourceTag/key-name`, `aws:RequestTag/key-name` o `aws:TagKeys`. Si un servicio admite las tres claves de condición para cada tipo de recurso, el valor es **Sí** para el servicio. Si un servicio admite las tres claves de condición solo para algunos tipos de recursos, el valor es **Parcial**. *Para obtener más información sobre ABAC, consulte [Definición de permisos con la autorización de ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) en la Guía del usuario de IAM*. Para ver un tutorial con los pasos para configurar ABAC, consulte [Uso del control de acceso basado en atributos (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) en la *Guía del usuario de IAM*. Para obtener más información acerca del etiquetado de recursos de QLDB, consulte [Etiquetado de recursos de Amazon QLDB](tagging.md). Para consultar un ejemplo de política basada en la identidad para limitar el acceso a un recurso en función de las etiquetas de ese recurso, consulte [Actualización de libros mayores de QLDB basada en etiquetas](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-update-ledger-tags). ## Uso de credenciales temporales con QLDB **Compatibilidad con credenciales temporales:** sí Algunas Servicios de AWS no funcionan cuando inicias sesión con credenciales temporales. Para obtener información adicional, incluidas las que Servicios de AWS funcionan con credenciales temporales, consulta Cómo [Servicios de AWS funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la Guía del *usuario de IAM*. Utiliza credenciales temporales si inicia sesión en ellas Consola de administración de AWS mediante cualquier método excepto un nombre de usuario y una contraseña. Por ejemplo, cuando accedes AWS mediante el enlace de inicio de sesión único (SSO) de tu empresa, ese proceso crea automáticamente credenciales temporales. También crea credenciales temporales de forma automática cuando inicia sesión en la consola como usuario y luego cambia de rol. Para obtener más información sobre el cambio de roles, consulte [Cambio de un usuario a un rol de IAM (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) en la *Guía del usuario de IAM*. Puedes crear credenciales temporales manualmente mediante la AWS CLI API o. AWS A continuación, puede utilizar esas credenciales temporales para acceder AWS. AWS recomienda generar credenciales temporales de forma dinámica en lugar de utilizar claves de acceso a largo plazo. Para obtener más información, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html). ## Permisos de entidades principales entre servicios de QLDB **Compatibilidad con sesiones de acceso directo (FAS):** no Cuando utilizas un usuario o un rol de IAM para realizar acciones en AWSél, se te considera director. Cuando utiliza algunos servicios, es posible que realice una acción que desencadene otra acción en un servicio diferente. FAS utiliza los permisos del principal que llama y los que solicita Servicio de AWS para realizar solicitudes a los servicios descendentes. Servicio de AWS Las solicitudes de FAS solo se realizan cuando un servicio recibe una solicitud que requiere interacciones con otros Servicios de AWS recursos para completarse. En este caso, debe tener permisos para realizar ambas acciones. Para obtener información sobre las políticas a la hora de realizar solicitudes de FAS, consulte [Reenviar sesiones de acceso](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html). ## Roles de servicio de QLDB **Compatibilidad con roles de servicio:** sí Un rol de servicio es un [rol de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que asume un servicio para realizar acciones en su nombre. Un administrador de IAM puede crear, modificar y eliminar un rol de servicio desde IAM. Para obtener más información, consulte [Creación de un rol para delegar permisos a un Servicio de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) en la *Guía del usuario de IAM*. **aviso** Cambiar los permisos de un rol de servicio podría interrumpir la funcionalidad de QLDB. Edite los roles de servicio solo cuando QLDB proporcione orientación para hacerlo. QLDB admite roles de servicio para las operaciones de API `ExportJournalToS3` y `StreamJournalToKinesis`, tal como se describe en la siguiente sección. ### Elección de un rol de IAM en QLDB Cuando exporta bloques de diario de secuencia de QLDB, debe elegir un rol que permita a QLDB escribir objetos en el destino indicado en su nombre. Si ya ha creado un rol de servicio, QLDB le proporciona una lista de roles para elegir. Es importante elegir un rol que permita el acceso para escribir en el bucket de Amazon S3 especificado para una exportación o en el recurso de Amazon Kinesis Data Streams especificado para una secuencia. Para obtener más información, consulte [Permisos de exportación de diarios en QLDB](export-journal.perms.md) o [Permisos de secuencia en QLDB](streams.perms.md). **nota** Para transferir un rol a QLDB al solicitar una secuencia o exportación de diario, debe tener permisos para realizar la acción `iam:PassRole` en el recurso de rol de IAM. Esto se suma a los permisos para realizar `qldb:ExportJournalToS3` en el recurso del libro mayor de QLDB o `qldb:StreamJournalToKinesis` en el subrecurso de secuencia de QLDB. ## Roles vinculados a servicios de QLDB **Compatibilidad con roles vinculados al servicio:** no Un rol vinculado a un servicio es un tipo de rol de servicio que está vinculado a un. Servicio de AWS El servicio puede asumir el rol para realizar una acción en su nombre. Los roles vinculados al servicio aparecen en usted Cuenta de AWS y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios. Para obtener más información acerca de cómo crear o administrar roles vinculados a servicios, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html). Busque un servicio en la tabla que incluya `Yes` en la columna **Rol vinculado a un servicio**. Seleccione el vínculo **Sí** para ver la documentación acerca del rol vinculado a servicios para ese servicio.