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 travaille Amazon Kendra avec IAM

Avant de gérer l'IAMaccès à Amazon Kendra, vous devez connaître les IAM fonctionnalités disponibles pour Amazon Kendra. Pour obtenir une vue d'ensemble du fonctionnement d'Amazon Kendra et des autres AWS servicesIAM, consultez la section AWS Services That Work with du guide de IAM l'IAMutilisateur.

Politiques basées sur l'identité d'Amazon Kendra

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. Amazon Kendra prend en charge des actions, des ressources et des clés de condition spécifiques. Pour en savoir plus sur tous les éléments que vous utilisez dans une JSON politique, consultez la section Référence des éléments de IAM JSON stratégie dans le guide de IAM l'utilisateur.

Actions

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.

Les actions politiques dans Amazon Kendra utilisent le préfixe suivant avant l'action :. kendra: Par exemple, pour autoriser quelqu'un à répertorier les index Amazon Kendra avec l'ListIndicesAPIopération, vous devez inclure l'kendra:ListIndicesaction dans sa politique. Les déclarations de politique doivent inclure un élément Action ou NotAction. Amazon Kendra définit son propre ensemble d'actions décrivant les tâches que vous pouvez effectuer avec ce service.

Pour spécifier plusieurs actions dans une seule déclaration, séparez-les par des virgules comme suit :

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

Pour consulter la liste des actions Amazon Kendra, consultez la section Actions définies par Amazon Kendra dans IAM le guide de l'utilisateur.

Ressources

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": "*"

La ressource d'index Amazon Kendra contient les éléments suivants : ARN

arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}

Pour plus d'informations sur le format deARNs, consultez Amazon Resource Names (ARNs) et AWS Service Namespaces.

Par exemple, pour spécifier un index dans votre relevé, utilisez GUID l'index ci-dessous ARN :

"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"

Pour spécifier tous les index appartenant à un compte spécifique, utilisez le caractère générique (*) :

"Resource": "arn:aws:${Region}:${Account}:index/*"

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

"Resource": "*"

Pour consulter la liste des types de ressources Amazon Kendra et leurs caractéristiquesARNs, consultez la section Ressources définies par Amazon Kendra dans IAM le guide de l'utilisateur. Pour savoir quelles actions vous pouvez définir pour chaque ressource, consultez ARN la section Actions définies par Amazon Kendra.

Clés de condition

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.

Amazon Kendra ne fournit aucune clé de condition spécifique à un service, mais prend en charge l'utilisation de certaines clés de condition globales. Pour voir toutes les clés de condition AWS globales, voir Clés contextuelles de condition AWS globale dans le guide de IAM l'utilisateur.

Exemples

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

Politiques basées sur les ressources Amazon Kendra

Amazon Kendra ne prend pas en charge les politiques basées sur les ressources.

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

Amazon Kendra ne prend pas en charge les listes de contrôle d'accès (ACLs) pour l'accès aux AWS services et aux ressources.

Autorisation basée sur les tags Amazon Kendra

Vous pouvez associer des balises à certains types de ressources Amazon Kendra pour autoriser l'accès à ces ressources. Pour contrôler l'accès en fonction des balises, fournissez les informations relatives aux balises dans l'élément de condition d'une politique à l'aide des clésaws:RequestTag/key-name, ou de aws:TagKeys condition.

Le tableau suivant répertorie les actions, les types de ressources correspondants et les clés de condition 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.

Pour plus d'informations sur le balisage des ressources Amazon Kendra, consultez. Balises Pour un exemple de politique basée sur l'identité qui limite l'accès à une ressource en fonction des balises de ressource, voir. Exemples de politique basée sur des balises Pour plus d'informations sur l'utilisation de balises pour limiter l'accès aux ressources, consultez la section Contrôle de l'accès à l'aide de balises dans le Guide de IAM l'utilisateur.

Rôles d'Amazon Kendra IAM

Un IAMrôle est une entité de votre AWS compte qui possède des autorisations spécifiques.

Utilisation d'informations d'identification temporaires avec Amazon Kendra

Vous pouvez utiliser des informations d'identification temporaires pour vous connecter à la fédération, assumer un IAM rôle ou assumer un rôle entre comptes. Vous obtenez des informations d'identification de sécurité temporaires en appelant AWS STS API des opérations telles que AssumeRoleou GetFederationToken.

Amazon Kendra prend en charge l'utilisation d'informations d'identification temporaires.

Rôles de service

Cette fonction permet à un service d’endosser une fonction du service en votre nom. Ce rôle autorise le service à accéder à des ressources d’autres services pour effectuer une action en votre nom. Les rôles de service apparaissent dans votre IAM compte et sont détenus par le compte. Cela signifie qu'un IAM administrateur peut modifier les autorisations associées à ce rôle. Toutefois, une telle action peut perturber le bon fonctionnement du service.

Amazon Kendra prend en charge les rôles de service.

Choisir un IAM rôle dans Amazon Kendra

Lorsque vous créez un index, appelez l'BatchPutDocumentopération, créez une source de données ou créez unFAQ, vous devez fournir un rôle d'accès Amazon Resource Name (ARN) qu'Amazon Kendra utilise pour accéder aux ressources requises en votre nom. Si vous avez déjà créé un rôle, la console Amazon Kendra vous propose une liste de rôles parmi lesquels choisir. Il est important de choisir un rôle qui permet d'accéder aux ressources dont vous avez besoin. Pour de plus amples informations, veuillez consulter IAM rôles d'accès pour Amazon Kendra.