Comment Amazon QLDB travaille avec IAM

Avant IAM de gérer l'accès àQLDB, découvrez quelles IAM fonctionnalités sont disponiblesQLDB.

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

IAMfonctionnalités que vous pouvez utiliser avec Amazon QLDB
Fonctionnalité IAM	QLDBsoutien
Politiques basées sur l’identité	Oui
Politiques basées sur les ressources	Non
Actions de politique	Oui
Ressources de politique	Oui
Clés de condition d’une politique	Oui
ACLs	Non
ABAC(balises dans les politiques)	Oui
Informations d’identification temporaires	Oui
Autorisations de principals	Non
Fonctions de service	Oui
Rôles liés à un service	Non

Pour obtenir une vue d'ensemble du fonctionnement de la plupart des fonctionnalités QLDB et des autres AWS services IAM fonctionnalités, consultez la section AWS services relative à leur fonctionnement IAM dans le guide de IAM l'utilisateur.

Stratégies basées sur l’identité pour QLDB

Prend en charge les politiques basées sur l'identité : Oui

Les politiques basées sur l'identité sont JSON des documents de politique d'autorisation que vous pouvez joindre à une identité, telle qu'un IAM utilisateur, un groupe d'utilisateurs ou un rôle. Ces politiques contrôlent quel type d’actions des utilisateurs et des rôles peuvent exécuter, sur quelles ressources et dans quelles conditions. Pour savoir comment créer une politique basée sur l'identité, voir Création de IAM politiques dans le Guide de l'IAMutilisateur.

Avec les politiques IAM basées sur l'identité, vous pouvez spécifier les actions et les ressources autorisées ou refusées ainsi que les conditions dans lesquelles les actions sont autorisées ou refusées. Vous ne pouvez pas spécifier le principal dans une politique basée sur une identité car celle-ci s’applique à l’utilisateur ou au rôle auquel elle est attachée. Pour en savoir plus sur tous les éléments que vous pouvez utiliser dans une JSON politique, consultez la référence aux éléments de IAM JSON politique dans le Guide de IAM l'utilisateur.

Exemples de stratégies basées sur l’identité pour QLDB

Pour consulter des exemples de politiques QLDB basées sur l'identité, consultez. Exemples de politiques basées sur l'identité pour Amazon QLDB

Politiques basées sur les ressources dans QLDB

Prend en charge les politiques basées sur les ressources : Non

Les politiques basées sur les ressources sont des documents JSON de stratégie que vous attachez à une ressource. Les politiques de confiance dans les IAM rôles et les politiques relatives aux compartiments Amazon S3 sont des exemples de politiques basées sur les ressources. Dans les services qui sont compatibles avec les politiques basées sur les ressources, les administrateurs de service peuvent les utiliser pour contrôler l’accès à une ressource spécifique. Pour la ressource dans laquelle se trouve la politique, cette dernière définit quel type d’actions un principal spécifié peut effectuer sur cette ressource et dans quelles conditions. Vous devez spécifier un principal dans une politique basée sur les ressources. Les principaux peuvent inclure des comptes, des utilisateurs, des rôles, des utilisateurs fédérés ou. AWS services

Pour activer l'accès entre comptes, vous pouvez spécifier un compte entier ou IAM des entités d'un autre compte comme principal dans une politique basée sur les ressources. L’ajout d’un principal entre comptes à une politique basée sur les ressources ne représente qu’une partie de l’instauration de la relation d’approbation. Lorsque le principal et la ressource sont différents Comptes AWS, un IAM administrateur du compte de confiance doit également accorder à l'entité principale (utilisateur ou rôle) l'autorisation d'accéder à la ressource. Pour ce faire, il attache une politique basée sur une identité à l’entité. Toutefois, si une politique basée sur des ressources accorde l’accès à un principal dans le même compte, aucune autre politique basée sur l’identité n’est requise. Pour plus d'informations, voir Accès aux ressources entre comptes IAM dans le Guide de IAM l'utilisateur.

Actions de politique pour QLDB

Soutient les actions politiques : Oui

Les administrateurs peuvent utiliser AWS JSON des politiques pour spécifier qui a accès à quoi. C’est-à-dire, quel principal peut effectuer des actions sur quelles ressources et dans quelles conditions.

L'Actionélément d'une JSON politique décrit les actions que vous pouvez utiliser pour autoriser ou refuser l'accès dans une politique. Les actions de stratégie portent généralement le même nom que l' AWS APIopération associée. Il existe certaines exceptions, telles que les actions avec autorisation uniquement qui n'ont pas d'opération correspondante. API Certaines opérations nécessitent également plusieurs actions dans une politique. Ces actions supplémentaires sont nommées actions dépendantes.

Intégration d’actions dans une stratégie afin d’accorder l’autorisation d’exécuter les opérations associées.

Pour consulter la liste des QLDB actions, consultez la section Actions définies par Amazon QLDB dans le Service Authorization Reference.

Les actions de politique en QLDB cours utilisent le préfixe suivant avant l'action :

qldb

Pour indiquer plusieurs actions dans une seule déclaration, séparez-les par des virgules.

"Action": [
      "qldb:action1",
      "qldb:action2"
]

Vous pouvez aussi spécifier plusieurs actions à l’aide de caractères génériques (*). Par exemple, pour spécifier toutes les actions qui commencent par le mot Describe, incluez l’action suivante :

"Action": "qldb:Describe*"

Pour interagir avec les données QLDB transactionnelles API (QLDBSession) en exécutant des instructions partiQL sur un registre, vous devez autoriser SendCommand l'action comme suit.

"Action": "qldb:SendCommand"

Pour les registres en mode STANDARD autorisations, consultez le Référence des autorisations partiQL pour connaître les autorisations supplémentaires requises pour chaque commande partiQL.

Pour consulter des exemples de politiques QLDB basées sur l'identité, consultez. Exemples de politiques basées sur l'identité pour Amazon QLDB

Ressources de politique pour QLDB

Prend en charge les ressources politiques : Oui

Les administrateurs peuvent utiliser AWS JSON des politiques pour spécifier qui a accès à quoi. C’est-à-dire, quel principal peut effectuer des actions sur quelles ressources et dans quelles conditions.

L'élément Resource JSON de stratégie indique le ou les objets auxquels s'applique l'action. Les instructions doivent inclure un élément Resource ou NotResource. Il est recommandé de spécifier une ressource en utilisant son Amazon Resource Name (ARN). Vous pouvez le faire pour des actions qui prennent en charge un type de ressource spécifique, connu sous la dénomination autorisations de niveau ressource.

Pour les actions qui ne sont pas compatibles avec les autorisations de niveau ressource, telles que les opérations de liste, utilisez un caractère générique (*) afin d’indiquer que l’instruction s’applique à toutes les ressources.

"Resource": "*"

Pour consulter la liste des types de QLDB ressources et leurs caractéristiquesARNs, consultez la section Ressources définies par Amazon QLDB dans le Service Authorization Reference. Pour savoir quelles actions vous pouvez définir pour chaque ressource, consultez la ARN section Actions définies par Amazon QLDB.

DansQLDB, les ressources principales sont les registres. QLDBprend également en charge d'autres types de ressources : tables et flux. Toutefois, vous ne pouvez créer des tables et des flux que dans le contexte d'un registre existant.

Un QLDB tableau est une vue matérialisée d'un ensemble non ordonné de révisions de documents provenant du journal du grand livre. Dans le mode STANDARD autorisations d'un registre, vous devez créer des IAM politiques qui accordent des autorisations pour exécuter des instructions partiQL sur cette ressource de table. Avec des autorisations sur une ressource de table, vous pouvez exécuter des instructions qui accèdent à l'état actuel de la table. Vous pouvez également consulter l'historique des révisions de la table à l'aide de la history() fonction intégrée. Pour en savoir plus, veuillez consulter la section Commencer à utiliser le mode d'autorisation standard sur Amazon QLDB.

Note

L'CREATE TABLEinstruction crée une table avec un identifiant unique et le nom de table fourni. Le nom de table fourni doit être unique parmi toutes les tables actives. Toutefois, il vous QLDB permet de désactiver les tables, de sorte que plusieurs tables inactives peuvent porter le même nom de table. Par conséquent, les ressources de table ARNs font référence à l'ID unique attribué par le système plutôt qu'au nom de table défini par l'utilisateur.

Chaque registre fournit également une ressource de catalogue définie par le système que vous pouvez interroger pour répertorier toutes les tables et tous les index d'un registre. Pour plus d'informations sur le modèle d'objet de QLDB données, consultezConcepts fondamentaux et terminologie d'Amazon QLDB.

Ces ressources sont ARNs associées à des ressources uniques, comme indiqué dans le tableau suivant.

Type de ressource	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}

Par exemple, pour spécifier la myExampleLedger ressource dans votre relevé, utilisez ce qui suitARN.

"Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger"

Pour spécifier plusieurs ressources dans une seule instruction, séparez-les ARNs par des virgules.

"Resource": [
      "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1",
      "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2"
]

Pour consulter des exemples de politiques QLDB basées sur l'identité, consultez. Exemples de politiques basées sur l'identité pour Amazon QLDB

Clés de condition de politique pour QLDB

Prend en charge les clés de condition de politique spécifiques au service : Oui

Les administrateurs peuvent utiliser AWS JSON des politiques pour spécifier qui a accès à quoi. C’est-à-dire, quel principal peut effectuer des actions sur quelles ressources et dans quelles conditions.

L’élément Condition (ou le bloc Condition) vous permet de spécifier des conditions lorsqu’une instruction est appliquée. L’élément Condition est facultatif. Vous pouvez créer des expressions conditionnelles qui utilisent des opérateurs de condition, tels que les signes égal ou inférieur à, pour faire correspondre la condition de la politique aux valeurs de la demande.

Si vous spécifiez plusieurs éléments Condition dans une instruction, ou plusieurs clés dans un seul élément Condition, AWS les évalue à l’aide d’une opération AND logique. Si vous spécifiez plusieurs valeurs pour une seule clé de condition, AWS évalue la condition à l'aide d'une OR opération logique. Toutes les conditions doivent être remplies avant que les autorisations associées à l’instruction ne soient accordées.

Vous pouvez aussi utiliser des variables d’espace réservé quand vous spécifiez des conditions. Par exemple, vous pouvez autoriser un IAM utilisateur à accéder à une ressource uniquement si celle-ci est étiquetée avec son nom IAM d'utilisateur. Pour plus d'informations, consultez IAMla section Éléments de politique : variables et balises dans le Guide de IAM l'utilisateur.

AWS prend en charge les clés de condition globales et les clés de condition spécifiques au service. Pour voir toutes les clés de condition AWS globales, voir les clés contextuelles de condition AWS globales dans le guide de IAM l'utilisateur.

Pour consulter la liste des clés de QLDB condition, consultez la section Clés de condition pour Amazon QLDB dans la référence d'autorisation de service. Pour savoir avec quelles actions et ressources vous pouvez utiliser une clé de condition, consultez Actions définies par Amazon QLDB.

Les PartiQLDropTable actions PartiQLDropIndex et prennent en charge la clé de qldb:Purge condition. Cette clé de condition filtre l'accès en fonction de la purge valeur spécifiée dans une instruction partiQLDROP. Cependant, il n'QLDBest actuellement pris en charge que purge = true pour DROP INDEX les instructions, et purge = false pour les DROP TABLE instructions. D'autres QLDB actions prennent en charge certaines clés de condition globales.

Pour consulter des exemples de politiques QLDB basées sur l'identité, consultez. Exemples de politiques basées sur l'identité pour Amazon QLDB

Listes de contrôle d'accès (ACLs) dans QLDB

Supports ACLs : Non

Les listes de contrôle d'accès (ACLs) contrôlent les principaux (membres du compte, utilisateurs ou rôles) autorisés à accéder à une ressource. ACLssont similaires aux politiques basées sur les ressources, bien qu'elles n'utilisent pas le format du document JSON de stratégie.

Contrôle d'accès basé sur les attributs () ABAC avec QLDB

Supports ABAC (balises dans les politiques) : Oui

Le contrôle d'accès basé sur les attributs (ABAC) est une stratégie d'autorisation qui définit les autorisations en fonction des attributs. Dans AWS, ces attributs sont appelés balises. Vous pouvez associer des balises à IAM des entités (utilisateurs ou rôles) et à de nombreuses AWS ressources. Le balisage des entités et des ressources est la première étape deABAC. Vous concevez ensuite des ABAC politiques pour autoriser les opérations lorsque le tag du principal correspond à celui de la ressource à laquelle il essaie d'accéder.

ABACest utile dans les environnements qui se développent rapidement et aide dans les situations où la gestion des politiques devient fastidieuse.

Pour contrôler l’accès basé sur des étiquettes, vous devez fournir les informations d’étiquette dans l’élément de condition d’une politique utilisant les clés de condition aws:ResourceTag/key-name, aws:RequestTag/key-name ou aws:TagKeys.

Si un service prend en charge les trois clés de condition pour tous les types de ressources, alors la valeur pour ce service est Oui. Si un service prend en charge les trois clés de condition pour certains types de ressources uniquement, la valeur est Partielle.

Pour plus d'informationsABAC, voir Qu'est-ce que c'est ABAC ? dans le guide de IAM l'utilisateur. Pour consulter un didacticiel présentant les étapes de configurationABAC, voir Utiliser le contrôle d'accès basé sur les attributs (ABAC) dans le guide de l'IAMutilisateur.

Pour plus d'informations sur le balisage QLDB des ressources, consultezMarquer les ressources Amazon QLDB.

Pour visualiser un exemple de politique basée sur l'identité permettant de limiter l'accès à une ressource en fonction des balises de cette ressource, consultez Mise à jour QLDB des registres en fonction des balises.

Utilisation d'informations d'identification temporaires avec QLDB

Supporte les informations d'identification temporaires : Oui

Certains AWS services ne fonctionnent pas lorsque vous vous connectez à l'aide d'informations d'identification temporaires. Pour plus d'informations, y compris celles qui AWS services fonctionnent avec des informations d'identification temporaires, consultez AWS services la section relative à l'utilisation IAM dans le Guide de IAM l'utilisateur.

Vous utilisez des informations d'identification temporaires si vous vous connectez à l' AWS Management Console aide d'une méthode autre qu'un nom d'utilisateur et un mot de passe. Par exemple, lorsque vous accédez à AWS l'aide du lien d'authentification unique (SSO) de votre entreprise, ce processus crée automatiquement des informations d'identification temporaires. Vous créez également automatiquement des informations d’identification temporaires lorsque vous vous connectez à la console en tant qu’utilisateur, puis changez de rôle. Pour plus d'informations sur le changement de rôle, consultez la section Passage à un rôle (console) dans le guide de IAM l'utilisateur.

Vous pouvez créer manuellement des informations d'identification temporaires à l'aide du AWS CLI ou AWS API. Vous pouvez ensuite utiliser ces informations d'identification temporaires pour y accéder AWS. AWS recommande de générer dynamiquement des informations d'identification temporaires au lieu d'utiliser des clés d'accès à long terme. Pour plus d'informations, consultez la section Informations d'identification de sécurité temporaires dans IAM.

Autorisations de principal interservices pour QLDB

Prend en charge les sessions d'accès transféré (FAS) : Non

Lorsque vous utilisez un IAM utilisateur ou un rôle pour effectuer des actions AWS, vous êtes considéré comme un mandant. Lorsque vous utilisez certains services, vous pouvez effectuer une action qui initie une autre action dans un autre service. FASutilise les autorisations du principal appelant an AWS service, combinées à la demande AWS service pour adresser des demandes aux services en aval. FASles demandes ne sont effectuées que lorsqu'un service reçoit une demande qui nécessite des interactions avec d'autres personnes AWS services ou des ressources pour être traitée. Dans ce cas, vous devez disposer d’autorisations nécessaires pour effectuer les deux actions. Pour plus de détails sur les politiques relatives FAS aux demandes, consultez la section Transférer les sessions d'accès.

Fonctions du service pour QLDB

Supporte les rôles de service : Oui

Un rôle de service est un IAMrôle qu'un service assume pour effectuer des actions en votre nom. Un IAM administrateur peut créer, modifier et supprimer un rôle de service de l'intérieurIAM. Pour plus d'informations, consultez la section Création d'un rôle auquel déléguer des autorisations AWS service dans le Guide de IAM l'utilisateur.

Avertissement

La modification des autorisations associées à un rôle de service peut perturber QLDB les fonctionnalités. Modifiez les rôles de service uniquement lorsque QLDB vous recevez des instructions à cet effet.

QLDBprend en charge les rôles de service pour StreamJournalToKinesis API les opérations ExportJournalToS3 et, comme décrit dans la section suivante.

Choix d'un rôle IAM dans QLDB

Lorsque vous exportez ou diffusez des blocs de journalQLDB, vous devez choisir un rôle QLDB pour autoriser l'écriture d'objets vers la destination donnée en votre nom. Si vous avez déjà créé un rôle de service, il vous QLDB fournit une liste de rôles parmi lesquels choisir. Il est important de choisir un rôle qui autorise l'accès à l'écriture dans le compartiment Amazon S3 que vous avez spécifié pour une exportation, ou à la ressource Amazon Kinesis Data Streams spécifiée pour un flux. Pour plus d’informations, consultez Autorisations d'exportation de journaux dans QLDB ou Autorisations de diffusion dans QLDB.

Note

Pour transmettre un rôle QLDB lorsque vous demandez une exportation de journal ou un flux, vous devez être autorisé à effectuer l'iam:PassRoleaction sur la ressource du IAM rôle. Cela s'ajoute aux autorisations d'exécution qldb:ExportJournalToS3 sur la ressource QLDB Ledger ou qldb:StreamJournalToKinesis sur la sous-ressource QLDB Stream.

Rôles liés à un service pour QLDB

Prend en charge les rôles liés aux services : Non

Un rôle lié à un service est un type de rôle de service lié à un. AWS service Le service peut endosser le rôle afin d’effectuer une action en votre nom. Les rôles liés au service apparaissent dans votre Compte AWS fichier et appartiennent au service. Un IAM administrateur peut consulter, mais pas modifier les autorisations pour les rôles liés à un service.

Pour plus de détails sur la création ou la gestion de rôles liés à un service, consultez la section relative à l'AWS services utilisation de. IAM Recherchez un service dans le tableau qui inclut un Yes dans la colonne Rôle lié à un service. Choisissez le lien Oui pour consulter la documentation du rôle lié à ce service.