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.

Fonctionnement d’Amazon Detective avec IAM

Par défaut, les utilisateurs et les rôles ne sont pas autorisés à créer ou à modifier des ressources Amazon Detective. Ils ne peuvent pas non plus effectuer de tâches à l'aide de l' AWS API AWS Management Console AWS CLI, ou. Un administrateur Detective doit disposer de politiques Gestion des identités et des accès AWS (IAM) qui accordent aux utilisateurs et aux rôles IAM l'autorisation d'effectuer des opérations d'API spécifiques sur les ressources spécifiques dont ils ont besoin. L’administrateur doit ensuite associer ces politiques au principal ayant besoin de ces autorisations.

Detective utilise des politiques basées sur l’identité IAM pour accorder des autorisations aux types d’utilisateurs et d’actions suivants :

Pour obtenir une vue d'ensemble de la façon dont Detective et d' Services AWS autres utilisent IAM, consultez la section Création de politiques dans l'onglet JSON du guide de l'utilisateur d'IAM.

politiques basées sur l’identité Detective

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. Detective prend en charge des actions, ressources et clés de condition spécifiques.

Pour en savoir plus sur 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.

Actions

Les administrateurs peuvent utiliser les politiques AWS JSON 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. Intégration d’actions dans une politique afin d’accorder l’autorisation d’exécuter les opérations associées.

Les déclarations de politique doivent inclure un élément Action ou NotAction. L’élément Action répertorie les actions autorisées par la politique. L’élément NotAction répertorie les actions qui ne sont pas autorisées.

Les actions définies pour Detective reflètent les tâches que vous pouvez effectuer à l’aide de Detective. Les actions stratégiques dans Detective ont le préfixe suivant :detective:.

Par exemple, pour accorder l’autorisation d’utiliser l’opération d’API CreateMembers afin d’inviter des comptes membres à consulter un graphe de comportement, vous incluez l’action detective:CreateMembers dans la politique.

Pour indiquer plusieurs actions dans une seule déclaration, séparez-les par des virgules. Par exemple, pour un compte membre, la politique inclut l’ensemble des actions liées à la gestion d’une invitation :

"Action": [
      "detective:ListInvitations",
      "detective:AcceptInvitation",
      "detective:RejectInvitation",
      "detective:DisassociateMembership
]

Vous pouvez utiliser des caractères génériques (*) pour spécifier plusieurs actions. Par exemple, pour gérer les données utilisées dans leur graphe de comportement, les comptes administrateurs de Detective doivent être en mesure d’effectuer les tâches suivantes :

Au lieu de répertorier ces actions séparément, vous pouvez autoriser l’accès à toutes les actions qui se terminent par le mot Members. La politique à cet effet peut inclure les mesures suivantes :

"Action": "detective:*Members"

Pour afficher la liste des actions Detective, consultez Actions définies par Amazon Detective dans la Référence de l’autorisation de service.

Ressources

Les administrateurs peuvent utiliser les politiques AWS JSON 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 auxquels l’action s’applique. Il est recommandé de définir une ressource à l’aide de son Amazon Resource Name (ARN). Pour les actions qui ne sont pas compatibles avec les autorisations de niveau ressource, utilisez un caractère générique (*) afin d’indiquer que l’instruction s’applique à toutes les ressources.

"Resource": "*"

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

Pour Detective, le seul type de ressource est le graphe de comportement. La ressource du graphe de comportement dans Detective possède l’ARN suivant :

arn:aws:detective:${Region}:${AccountId}:graph:${GraphId}

Par exemple, un graphe de comportement présente les valeurs suivantes :

Pour identifier ce graphe de comportement dans une instruction Resource, vous devez utiliser l’ARN suivant :

"Resource": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"

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

"Resource": [
      "resource1",
      "resource2"
]

Par exemple, le même AWS compte peut être invité à devenir membre dans plusieurs graphes de comportement. Dans la politique de ce compte membre, la déclaration Resource liste les graphes de comportement auxquels ils étaient invités.

"Resource": [
      "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899",
      "arn:aws:detective:us-east-1:444455556666:graph:056d2a9521xi2bbluw1d164680eby416"
]

Certaines actions Detective, telles que la création d’un graphe de comportement, la liste des graphes de comportement et la liste des invitations à des graphes de comportement, ne sont pas effectuées sur un graphe de comportement spécifique. Pour ces actions, l’instruction Resource doit utiliser le caractère générique (*).

"Resource": "*"

Pour les actions du compte administrateur, Detective vérifie toujours que l’utilisateur à l’origine de la demande appartient au compte administrateur pour le graphe de comportement concerné. Pour les actions relatives au compte membre, Detective vérifie toujours que l’utilisateur qui fait la demande appartient au compte membre. Même si une politique IAM autorise l’accès à un graphe de comportement, si l’utilisateur n’appartient pas au bon compte, il ne peut pas effectuer l’action.

Pour toutes les actions effectuées sur un graphe de comportement spécifique, la politique IAM doit inclure l’ARN du graphe. L’ARN du graphe peut être ajouté ultérieurement. Par exemple, lorsqu’un compte active Detective pour la première fois, la politique IAM initiale donne accès à toutes les actions de Detective, en utilisant le caractère générique pour l’ARN du graphe. Cela permet à l’utilisateur de commencer immédiatement à gérer les comptes membres et à mener des enquêtes dans leur graphe de comportement. Une fois le graphe de comportement créé, vous pouvez mettre à jour la politique pour ajouter l’ARN du graphe.

Clés de condition

Les administrateurs peuvent utiliser les politiques AWS JSON 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 indique à quel moment les instructions s’exécutent en fonction de critères définis. 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. Pour voir toutes les clés de condition AWS globales, voir les clés de contexte de condition AWS globales dans le guide de l'utilisateur IAM.

Detective ne définit pas son propre ensemble de clés de condition. Detective prend en charge l’utilisation de certaines clés de condition globales. Pour voir toutes les clés de condition AWS globales, consultez la section Clés contextuelles de condition AWS globale dans le guide de l'utilisateur IAM.

Pour savoir avec quelles actions et ressources vous pouvez utiliser une clé de condition, consultez Actions définies par Amazon Detective.

Exemples

Pour voir des exemples de politiques Detective basées sur l’identité, consultez Exemples de politiques basées sur l’identité d’Amazon Detective.

Politiques basées sur les ressources Detective (non prises en charge)

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

Autorisation basée sur les balises du graphe de comportement Detective

Des valeurs de balise peuvent être attribuées à chaque graphe de comportement. Vous pouvez utiliser ces valeurs de balise dans les instructions de condition pour gérer l’accès au graphe de comportement.

L’instruction de condition pour une valeur de balise utilise le format suivant.

{"StringEquals"{"aws:ResourceTag/<tagName>": "<tagValue>"}}

Par exemple, utilisez le code suivant pour autoriser ou refuser une action lorsque la valeur de la balise Department est Finance.

{"StringEquals"{"aws:ResourceTag/Department": "Finance"}}

Pour des exemples de politiques qui utilisent des valeurs de balise de ressource, consultez Compte administrateur : restriction de l’accès en fonction des valeurs de balise.

Rôles IAM Detective

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

Utilisation des informations d’identification temporaires avec Detective

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 STS API telles que AssumeRoleou GetFederationToken.

Detective prend en charge l’utilisation des informations d’identification temporaires.

Rôles liés à un service

Les rôles liés aux AWS services permettent aux services d'accéder aux ressources d'autres services pour effectuer une action en votre nom. Les rôles liés à un service s’affichent dans votre compte IAM et sont la propriété du 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 à un service, consultez Utilisation des rôles liés aux services pour Detective.

Rôles de service (non pris en charge)

Cette fonctionnalité permet à un service d’endosser un rôle de 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 s’affichent dans votre compte IAM et sont la propriété du compte. Cela signifie qu’un administrateur IAM peut modifier les autorisations associées à ce rôle. Toutefois, une telle action peut perturber le bon fonctionnement du service.

Detective ne prend pas en charge les rôles de service.