Comment Amazon Lex fonctionne avec IAM - Amazon Lex V1

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment Amazon Lex fonctionne avec IAM

Avant d'utiliser IAM pour gérer l'accès à Amazon Lex, découvrez quelles fonctionnalités IAM peuvent être utilisées avec Amazon Lex.

Pour obtenir une vue d'ensemble de la façon dont Amazon Lex et les autres AWS services fonctionnent avec la plupart des fonctionnalités IAM, consultez les AWSservices compatibles avec IAM dans le guide de l'utilisateur IAM.

Politiques basées sur l'identité pour Amazon Lex

Prend en charge les politiques basées sur une identité

Oui

Les politiques basées sur l’identité sont des documents de politique d’autorisations JSON que vous pouvez attacher à une identité telle qu’un utilisateur, un Groupes d’utilisateurs IAM ou un rôle IAM. 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 découvrir comment créer une politique basée sur l'identité, consultez Création de politiques IAM dans le Guide de l’utilisateur IAM.

Avec les politiques IAM basées sur l’identité, vous pouvez spécifier des actions et 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 découvrir tous les éléments que vous utilisez dans une politique JSON, consultez Références des éléments de politique JSON IAM dans le Guide de l’utilisateur IAM.

Exemples de politiques basées sur l'identité pour Amazon Lex

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

Politiques basées sur les ressources au sein d'Amazon Lex

Prend en charge les politiques basées sur une ressource

Non

Les politiques basées sur les ressources sont des documents de politique JSON que vous attachez à une ressource. Des politiques basées sur les ressources sont, par exemple, les politiques de confiance de rôle IAM et des politiques de compartiment Amazon S3. 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 des Services AWS.

Pour permettre un accès intercompte, vous pouvez spécifier un compte entier ou des entités IAM dans un autre compte en tant que 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. Quand le principal et la ressource se trouvent dans des Comptes AWS différents, un administrateur IAM dans le compte approuvé doit également accorder à l’entité principal (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, consultez Différence entre les rôles IAM et les politiques basées sur une ressource dans le Guide de l’utilisateur IAM.

Actions politiques pour Amazon Lex

Prend en charge les actions de politique

Oui

Les administrateurs peuvent utiliser les politiques JSON AWS 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 Action d’une politique JSON décrit les actions que vous pouvez utiliser pour autoriser ou refuser l’accès à une politique. Les actions de politique possèdent généralement le même nom que l’opération d’API AWS associée. Il existe quelques exceptions, telles que les actions avec autorisations uniquement qui n’ont pas d’opération API correspondante. 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 actions Amazon Lex, consultez la section Actions définies par Amazon Lex dans le Service Authorization Reference.

Les actions politiques dans Amazon Lex utilisent le préfixe suivant avant l'action :

lex

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

"Action": [ "lex:action1", "lex: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": "lex:Describe*"

Ressources relatives aux politiques pour Amazon Lex

Prend en charge les ressources de politique

Oui

Les administrateurs peuvent utiliser les politiques JSON AWS 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 de politique JSON Resource indique le ou les objets pour lesquels l’action s’applique. Les instructions doivent inclure un élément Resource ou NotResource. Il est recommandé de définir une ressource à l’aide de 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": "*"

L'ARN d'une ressource de bot Amazon Lex a le format suivant.

arn:aws:lex:${Region}:${Account}:bot:${Bot-Name}

Pour plus d’informations sur le format des ARN, consultez Noms ARN (Amazon Resource Name) et Espaces de noms du service AWS.

Par exemple, pour spécifier le bot OrderFlowers dans votre instruction, utilisez l'ARN suivant.

"Resource": "arn:aws:lex:us-east-2:123456789012:bot:OrderFlowers"

Pour spécifier tous les bots qui appartiennent à un compte spécifique, utilisez le caractère générique (*).

"Resource": "arn:aws:lex:us-east-2:123456789012:bot:*"

Certaines actions Amazon Lex, telles que celles relatives à la création de ressources, ne peuvent pas être effectuées sur une ressource spécifique. Dans ce cas, vous devez utiliser le caractère générique (*).

"Resource": "*"

Pour consulter la liste des types de ressources Amazon Lex et de leurs ARN, consultez la section Ressources définies par Amazon Lex dans le Service Authorization Reference. Pour savoir avec quelles actions vous pouvez spécifier l'ARN de chaque ressource, consultez Actions définies par Amazon Lex.

Clés de conditions de politique pour Amazon Lex

Prise en charge des clés de condition de stratégie spécifiques au service

Oui

Les administrateurs peuvent utiliser les politiques JSON AWS 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 opération OR 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 accorder à un utilisateur IAM l’autorisation d’accéder à une ressource uniquement si elle est balisée avec son nom d’utilisateur IAM. Pour plus d'informations, consultez Éléments des politiques IAM : variables et balises dans le Guide de l'utilisateur IAM.

AWS prend en charge les clés de condition globales et les clés de condition spécifiques à un service. Pour afficher toutes les clés de condition globales AWS, consultez Clés de contexte de condition globale AWS dans le Guide de l’utilisateur IAM.

Pour consulter la liste des clés de condition Amazon Lex, consultez la section Clés de condition pour Amazon Lex 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 Lex.

Le tableau suivant répertorie les clés de condition Amazon Lex qui s'appliquent aux ressources Amazon Lex. Vous pouvez inclure ces clés dans les Condition éléments d'une politique d'autorisation IAM.

Clé de condition Amazon Lex Description Type de valeur Autorisation
lex:associatedIntents

Détermine l'ensemble d'intentions pouvant être utilisées lors de la création ou de la modification de la définition d'un bot.

Tableau de chaînes

lex:PutBot

lex:associatedSlotTypes

Détermine l'ensemble de types d'options pouvant être utilisés lors de la création ou de la modification de la définition d'un type d'option.

Tableau de chaînes

lex:PutIntent

lex:ChannelType

Détermine le type d'association de canaux de bot qu'un utilisateur peut créer, générer ou supprimer.

Chaîne

lex:CreateBotChannelAssociation

lex:DeleteBotChannelAssociation

lex:GetBotChannelAssociation

ACL dans Amazon Lex

Prend en charge les listes ACL

Non

Les listes de contrôle d’accès (ACL) vérifient quels principaux (membres de compte, utilisateurs ou rôles) ont l’autorisation d’accéder à une ressource. Les listes de contrôle d’accès sont similaires aux politiques basées sur les ressources, bien qu’elles n’utilisent pas le format de document de politique JSON.

ABAC avec Amazon Lex

Prend en charge ABAC (identifications dans les politiques)

Partielle

Le contrôle d’accès basé sur les attributs (ABAC) est une politique d’autorisation qui définit des autorisations en fonction des attributs. Dans AWS, ces attributs sont appelés étiquettes. Vous pouvez attacher des étiquettes à des entités IAM (utilisateurs ou rôles), ainsi qu’à de nombreuses ressources AWS. L’étiquetage des entités et des ressources est la première étape d’ABAC. Vous concevez ensuite des politiques ABAC pour autoriser des opérations quand l’identification du principal correspond à celle de la ressource à laquelle il tente d’accéder.

L’ABAC est utile dans les environnements qui connaissent une croissance rapide et pour les cas où la gestion des politiques devient fastidieuse.

Pour contrôler l'accès basé sur des balises, vous devez fournir les informations de balise 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’informations sur l’ABAC, consultez Qu’est-ce que le contrôle d’accès basé sur les attributs (ABAC) ? dans le Guide de l’utilisateur IAM. Pour accéder à un didacticiel décrivant les étapes de configuration de l’ABAC, consultez Utilisation du contrôle d’accès par attributs (ABAC) dans le Guide de l’utilisateur IAM.

Vous pouvez associer des balises à certains types de ressources Amazon Lex à des fins d'autorisation. Pour contrôler l'accès basé sur des balises, vous devez fournir les informations des balises dans l'élément de condition d'une stratégie en utilisant les clés de condition lex:ResourceTag/${TagKey}, aws:RequestTag/${TagKey} ou aws:TagKeys.

Pour plus d'informations sur le balisage des ressources Amazon Lex, consultezMarquer vos ressources Amazon Lex.

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 Utiliser un tag pour accéder à une ressource.

Le tableau suivant répertorie les actions et les types de ressources correspondants pour le contrôle d'accès basé sur des balises. Chaque action est autorisée en fonction des balises associées au type de ressource correspondant.

Action Type de ressource Clés de condition Remarques
CreateBotVersion bot lex:ResourceTag  
DeleteBot bot lex:ResourceTag  
DeleteBotAlias alias lex:ResourceTag  
DeleteBotChannelAssociation channel lex:ResourceTag  
DeleteBotVersion bot lex:ResourceTag  
DeleteSession bot ou alias lex:ResourceTag Utilise les balises associées au bot lorsque l'alias est défini sur $LATEST. Utilise les balises associées à l'alias spécifié lorsqu'elles sont utilisées avec d'autres alias.
DeleteUtterances bot lex:ResourceTag  
GetBot bot ou alias lex:ResourceTag Utilise les balises associées au bot lorsque l'versionOrAlias est défini sur $LATEST ou la version numérique. Utilise les balises associées à l'alias spécifié lorsqu'elles sont utilisées avec des alias
GetBotAlias alias lex:ResourceTag  
GetBotChannelAssociation canal lex:ResourceTag  
GetBotChannelAssociations canal lex:ResourceTag Utilise les balises associées au bot lorsque l'alias est défini sur « - ». Utilise les balises associées à l'alias spécifié lorsqu'un alias de bot est spécifié
GetBotVersions bot lex:ResourceTag  
GetExport bot lex:ResourceTag  
GetSession bot ou alias lex:ResourceTag Utilise les balises associées au bot lorsque l'alias est défini sur $LATEST. Utilise les balises associées à l'alias spécifié lorsqu'elles sont utilisées avec d'autres alias.
GetUtterancesView bot lex:ResourceTag  
ListTagsForResource bot, alias ou canal lex:ResourceTag  
PostContent bot ou alias lex:ResourceTag Utilise les balises associées au bot lorsque l'alias est défini sur $LATEST. Utilise les balises associées à l'alias spécifié lorsqu'elles sont utilisées avec d'autres alias.
PostText bot ou alias lex:ResourceTag Utilise les balises associées au bot lorsque l'alias est défini sur $LATEST. Utilise les balises associées à l'alias spécifié lorsqu'elles sont utilisées avec d'autres alias.
PutBot bot lex:ResourceTag, aws:RequestTag, aws:TagKeys  
PutBotAlias alias lex:ResourceTag, aws:RequestTag, aws:TagKeys  
PutSession bot ou alias lex:ResourceTag Utilise les balises associées au bot lorsque l'alias est défini sur $LATEST. Utilise les balises associées à l'alias spécifié lorsqu'elles sont utilisées avec d'autres alias.
StartImport bot lex:ResourceTag S'appuie sur la stratégie d'accès pour l'opération PutBot. Les balises et les autorisations spécifiques à l'opération StartImport sont ignorées.
TagResource bot, alias ou canal lex:ResourceTag, aws:RequestTag, aws:TagKeys  
UntagResource bot, alias ou canal lex:ResourceTag, aws:RequestTag, aws:TagKeys  

Utilisation d'informations d'identification temporaires avec Amazon Lex

Prend en charge les informations d’identification temporaires

Oui

Certains Services AWS ne fonctionnent pas quand vous vous connectez à l’aide d’informations d’identification temporaires. Pour plus d’informations, notamment sur les Services AWS qui fonctionnent avec des informations d’identification temporaires, consultez Services AWS qui fonctionnent avec IAM dans le Guide de l’utilisateur IAM.

Vous utilisez des informations d’identification temporaires quand vous vous connectez à la AWS Management Console en utilisant toute méthode autre qu’un nom d’utilisateur et un mot de passe. Par exemple, lorsque vous accédez à AWS en utilisant le lien d’authentification unique (SSO) de votre société, 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 Changement de rôle (console) dans le Guide de l’utilisateur IAM.

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

Vous pouvez utiliser des informations d’identification temporaires pour vous connecter à l’aide de la fédération, endosser un rôle IAM ou encore pour endosser un rôle intercompte. Vous obtenez des informations d'identification de sécurité temporaires en appelant des opérations d'AWS STSAPI telles que AssumeRoleou GetFederationToken.

Autorisations principales interservices pour Amazon Lex

Prend en charge les sessions d'accès direct (FAS)

Oui

Lorsque vous vous servez d’un utilisateur IAM ou d’un rôle IAM pour accomplir des actions dans AWS, vous êtes considéré comme un principal. Lorsque vous utilisez certains services, l’action que vous effectuez est susceptible de lancer une autre action dans un autre service. FAS utilise les autorisations du principal appelant Service AWS, combinées à la demande Service AWS pour effectuer des demandes aux services en aval. Les demandes FAS ne sont formulées que lorsqu’un service reçoit une demande qui, pour aboutir, a besoin d’interagir avec d’autres ressources ou Services AWS. Dans ce cas, vous devez disposer d’autorisations nécessaires pour effectuer les deux actions. Pour plus de détails sur une politique lors de la formulation de demandes FAS, consultez Transmission des sessions d’accès.

Rôles de service pour Amazon Lex

Prend en charge les fonctions du service

Oui

Un rôle de service est un rôle IAM qu'un service endosse pour accomplir des actions en votre nom. Un administrateur IAM peut créer, modifier et supprimer une fonction du service à partir d’IAM. Pour plus d’informations, consultez Création d’un rôle pour la délégation d’autorisations à un Service AWS dans le Guide de l’utilisateur IAM.

Avertissement

La modification des autorisations associées à un rôle de service peut perturber les fonctionnalités d'Amazon Lex. Modifiez les rôles de service uniquement lorsque Amazon Lex fournit des instructions à cet effet.

Choix d'un rôle IAM dans Amazon Lex

Amazon Lex utilise des rôles liés à un service pour appeler Amazon Comprehend et Amazon Polly. Il utilise des autorisations au niveau des ressources sur les fonctions AWS Lambda pour les appeler.

Vous devez fournir un rôle IAM pour activer le balisage des conversations. Pour de plus amples informations, veuillez consulter Création d'un rôle IAM et de stratégies pour les journaux de conversation.

Rôles liés à un service pour Amazon Lex

Prend en charge les rôles liés à un service.

Oui

Un rôle lié à un service est un type de fonction du service lié à un Service AWS. Le service peut endosser le rôle afin d’effectuer une action en votre nom. Les rôles liés à un service s’affichent dans votre Compte AWS et sont détenus par le service. Un administrateur IAM peut consulter, mais ne peut pas modifier, les autorisations concernant les rôles liés à un service.

Pour plus d'informations sur la création ou la gestion des rôles liés aux services Amazon Lex, consultez. Utilisation de rôles liés à un service pour Amazon Lex