Cómo QLDB trabaja Amazon con IAM - Base de datos Amazon Quantum Ledger (AmazonQLDB)

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 QLDB trabaja Amazon con IAM

Antes de gestionar el IAM acceso aQLDB, infórmate sobre IAM las funciones disponibles para su usoQLDB.

importante

Aviso de fin de soporte: los clientes actuales podrán usar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre.

Para obtener una visión de alto nivel de cómo QLDB y otros Servicios de AWS funcionan con la mayoría de IAM las funciones, consulte Servicios de AWS que funcionan IAM en la Guía IAM del usuario.

Políticas de QLDB basadas en identidades

Compatibilidad con las políticas basadas en identidad:

Las políticas basadas en la identidad son documentos de política de JSON permisos que se pueden adjuntar a una identidad, como un IAM usuario, 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 información sobre cómo crear una política basada en la identidad, consulte Creación de IAM políticas en la Guía del usuario. IAM

Con las políticas IAM basadas en la identidad, 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á adjunto. Para obtener más información sobre todos los elementos que puede utilizar en una JSON política, consulte la referencia sobre los elementos de la IAM JSON política en la Guía del IAMusuario.

Ejemplos de políticas basadas en identidades de QLDB

Para ver ejemplos de políticas QLDB basadas en la identidad, consulte. Ejemplos de políticas basadas en identidad para Amazon QLDB

Políticas basadas en recursos de QLDB

Admite políticas basadas en recursos: no

Las políticas basadas en recursos son JSON documentos de políticas que se adjuntan a un recurso. Algunos ejemplos de políticas basadas en recursos son las políticas de confianza de IAM roles 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 en una política en función de recursos. Los principales pueden incluir cuentas, usuarios, roles, usuarios federados o Servicios de AWS.

Para habilitar el acceso entre cuentas, puede especificar una cuenta completa o IAM entidades de otra cuenta como principales en una política basada en 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 están en direcciones diferentes Cuentas de AWS, el IAM administrador de la cuenta de confianza también debe conceder permiso a la entidad principal (usuario o rol) para acceder al recurso. Para conceder el permiso, adjunte la entidad a una política basada en identidad. Sin embargo, si la política en función de recursos concede el 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 Acceso a recursos entre cuentas IAM en la Guía del IAM usuario.

Acciones de política para QLDB

Compatibilidad con las acciones de política:

Los administradores pueden usar AWS JSONpolíticas para especificar quién tiene acceso a qué. Es decir, qué entidad principal puede realizar acciones en qué recursos y en qué condiciones.

El Action elemento de una JSON política describe las acciones que puede utilizar para permitir o denegar el acceso en una política. Las acciones políticas suelen tener el mismo nombre que las asociadas AWS APIoperación. Hay algunas excepciones, como las acciones que solo permiten permisos y que no tienen una operación coincidente. API 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 QLDB acciones, consulta Acciones definidas por Amazon QLDB en la Referencia de autorización de servicio.

Las acciones políticas 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 (*) 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 los datos QLDB transaccionales API (QLDBsesión) mediante la ejecución de declaraciones PartiQL en un libro mayor, debe conceder permiso a SendCommand la acción de la siguiente manera.

"Action": "qldb:SendCommand"

Para ver los libros mayores en el modo de permisos STANDARD, vaya a Referencia de permisos PartiQL y consulte los permisos adicionales necesarios para cada comando PartiQL.

Para ver ejemplos de políticas basadas en la QLDB identidad, consulte. Ejemplos de políticas basadas en identidad para Amazon QLDB

Recursos de políticas para QLDB

Compatibilidad con los recursos de políticas:

Los administradores pueden usar AWS JSONpolíticas 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 JSON de política especifica el objeto o los 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 mediante su nombre de recurso de Amazon (ARN). Puede 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, utilice un carácter comodín (*) para indicar que la instrucción se aplica a todos los recursos.

"Resource": "*"

Para ver una lista de los tipos de QLDB recursos y sus respectivos tiposARNs, consulta Recursos definidos por Amazon QLDB en la Referencia de autorización de servicio. Para saber con qué acciones puede especificar cada recurso, consulte Acciones definidas por Amazon QLDB. ARN

EnQLDB, los recursos principales son los libros de contabilidad. QLDBtambién admite tipos de recursos adicionales: tablas y flujos. Sin embargo, puede crear tablas y secuencias solamente en el contexto de libro mayor existente.

Una QLDB tabla es una vista materializada de una colección desordenada de revisiones de documentos del diario del libro mayor. En el modo de STANDARD permisos de un libro mayor, debes crear IAM políticas que concedan permisos para ejecutar sentencias 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 Cómo empezar con el modo de permisos estándar en Amazon QLDB.

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 las 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 sobre el modelo de objetos QLDB de datos, consulte. Conceptos básicos y terminología de Amazon QLDB

Estos recursos tienen ARNs asociados únicos, como se muestra en la siguiente tabla.

Tipo de recurso ARN
ledger arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}
table arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/table/${TableId}
catalog arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/information_schema/user_tables
stream arn:${Partition}:qldb:${Region}:${Account}:stream/${LedgerName}/${StreamId}

Por ejemplo, para especificar el myExampleLedger recurso en la declaración, utilice lo siguienteARN.

"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 QLDB basadas en la identidad, consulte. Ejemplos de políticas basadas en identidad para Amazon QLDB

Claves de condición de políticas para QLDB

Compatibilidad con claves de condición de políticas específicas del servicio:

Los administradores pueden utilizar AWS JSONpolíticas 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. Puede crear expresiones condicionales que utilicen 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 Condition elementos en una declaración o varias claves en un solo Condition elemento, AWS los evalúa mediante una AND operación lógica. Si especifica varios valores para una sola 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 puede utilizar variables de marcador de posición al especificar condiciones. Por ejemplo, puede conceder a un IAM usuario permiso para acceder a un recurso solo si está etiquetado con su nombre de IAM usuario. Para obtener más información, consulte los elementos de IAM política: variables y etiquetas en la Guía del IAM usuario.

AWS admite claves de condición globales y claves de condición específicas del servicio. Para ver todas AWS claves de condición globales, consulte AWS claves de contexto de condiciones globales en la Guía IAM del usuario.

Para ver una lista de claves de QLDB estado, consulta Claves de estado de Amazon QLDB en la Referencia de autorización de servicio. Para saber con qué acciones y recursos puede utilizar una clave de condición, consulte Acciones definidas por Amazon QLDB.

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 purge = true admite DROP INDEX declaraciones y purge = false DROP TABLE declaraciones. Otras QLDB acciones admiten algunas claves de condición globales.

Para ver ejemplos de políticas QLDB basadas en la identidad, consulte. Ejemplos de políticas basadas en identidad para Amazon QLDB

Listas de control de acceso () ACLs en QLDB

SoportaACLs: 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. ACLsson similares a las políticas basadas en recursos, aunque no utilizan el formato de documento de JSON políticas.

Control de acceso basado en atributos () con ABAC QLDB

Soportes ABAC (etiquetas en las políticas): Sí

El control de acceso basado en atributos (ABAC) es una estrategia de autorización que define los permisos en función de los atributos. En AWS, estos atributos se denominan etiquetas. Puede adjuntar etiquetas a IAM entidades (usuarios o roles) y a muchas AWS recursos. Etiquetar entidades y recursos es el primer paso deABAC. Luego, diseñe ABAC políticas para permitir las operaciones cuando la etiqueta del principal coincida con la etiqueta del recurso al que está intentando acceder.

ABACes útil en entornos de rápido crecimiento y ayuda en situaciones en las que la administración de políticas se vuelve engorrosa.

Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el elemento de condición 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 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 al respectoABAC, consulte ¿Qué es? ABAC en la Guía IAM del usuario. Para ver un tutorial con los pasos de configuraciónABAC, consulte Usar el control de acceso basado en atributos (ABAC) en la Guía del IAMusuario.

Para obtener más información sobre el etiquetado de QLDB recursos, consulte. Etiquetado de los recursos de Amazon QLDB

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 Actualizar los QLDB libros de contabilidad en función de las etiquetas.

Uso de credenciales temporales con QLDB

Compatibilidad con credenciales temporales:

Alguno Servicios de AWS no funcionan cuando inicias sesión con credenciales temporales. Para obtener información adicional, incluyendo qué Servicios de AWS trabaje con credenciales temporales, consulte Servicios de AWS que funcionan IAM en la Guía IAM del usuario.

Está utilizando credenciales temporales si inicia sesión en AWS Management Console utilizando 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 su 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 rol, consulte Cambiar a un rol (consola) en la Guía del IAMusuario.

Puede crear credenciales temporales manualmente mediante el AWS CLI o AWS API. 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.

Permisos de entidades principales entre servicios de QLDB

Admite sesiones de acceso directo (FAS): No

Cuando utiliza un IAM usuario o un rol para realizar acciones en AWS, se le considera director. Cuando utiliza algunos servicios, es posible que realice una acción que desencadene otra acción en un servicio diferente. FASutiliza los permisos del director que llama a un Servicio de AWS, combinado con la solicitud Servicio de AWS para realizar solicitudes a los servicios intermedios. FASlas solicitudes solo se realizan cuando un servicio recibe una solicitud que requiere interacciones con otros Servicios de AWS o recursos para completar. En este caso, debe tener permisos para realizar ambas acciones. Para obtener detalles sobre la política a la hora de realizar FAS solicitudes, consulte Reenviar las sesiones de acceso.

Roles de servicio para QLDB

Compatibilidad con roles de servicio:

Una función de servicio es una IAMfunción que un servicio asume para realizar acciones en su nombre. Un IAM administrador puede crear, modificar y eliminar un rol de servicio desde dentroIAM. Para obtener más información, consulte Crear un rol para delegar permisos a un Servicio de AWS en la Guía del usuario de IAM.

aviso

Cambiar los permisos de un rol de servicio podría interrumpir QLDB la funcionalidad. Edite las funciones de servicio solo cuando se QLDB proporcionen instrucciones para hacerlo.

QLDBadmite funciones de servicio para las StreamJournalToKinesis API operaciones ExportJournalToS3 y operaciones, tal y como se describe en la siguiente sección.

Elegir un IAM rol en QLDB

Al exportar o transmitir bloques de diarioQLDB, debe elegir un rol que permita QLDB escribir objetos en el destino indicado en su nombre. Si ya ha creado un rol de servicio, le QLDB proporciona una lista de roles entre los que puede 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 del diario en QLDB o Transmita los permisos en QLDB.

nota

Para transferir un rol QLDB al solicitar la exportación o transmisión de un diario, debe tener permisos para realizar la iam:PassRole acción en el recurso del IAM rol. Esto se suma a los permisos para realizar tareas qldb:ExportJournalToS3 en el recurso QLDB contable o qldb:StreamJournalToKinesis en el subrecurso de QLDB transmisión.

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 la función de realizar una acción en su nombre. Los roles vinculados al servicio aparecen en su Cuenta de AWS y son propiedad del servicio. Un IAM administrador puede ver, pero no editar, los permisos de las funciones vinculadas al servicio.

Para obtener más información sobre la creación o la administración de funciones vinculadas a un servicio, consulte Servicios de AWS que funcionan con. IAM Busque un servicio en la tabla que incluya Yes en la columna Rol vinculado a un servicio. Seleccione el vínculo para ver la documentación acerca del rol vinculado a servicios para ese servicio.