Actions Types de ressources Clés de condition

Actions, ressources et clés de condition pour AWS Security Agent

AWS L'agent de sécurité (préfixe de service :securityagent) fournit les ressources, actions et clés de contexte de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.

Références :

Découvrez comment configurer ce service.
Affichez la liste des opérations d'API disponibles pour ce service.
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.

Rubriques

Actions définies par l'agent AWS de sécurité
Types de ressources définis par l'agent AWS de sécurité
Clés de condition pour AWS Security Agent

Actions définies par l'agent AWS de sécurité

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.

La colonne Niveau d'accès du tableau Actions décrit la manière dont l'action est classée (liste, lecture, gestion des autorisations ou balisage). Cette classification peut vous aider à comprendre le niveau d'accès accordé par une action utilisée dans une politique. Pour plus d'informations sur les niveaux d'accès, consultez la section Niveaux d'accès dans les résumés des politiques.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

La colonne Actions dépendantes du tableau Actions indique les autorisations supplémentaires qui peuvent être nécessaires pour lancer une action avec succès. Ces autorisations peuvent être nécessaires en plus de l'autorisation pour l'action elle-même. Lorsqu'une action spécifie des actions dépendantes, ces dépendances peuvent s'appliquer à des ressources supplémentaires définies pour cette action, et pas uniquement à la première ressource répertoriée dans le tableau.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions	Description	Niveau d'accès	Types de ressources (*obligatoire)	Clés de condition	Actions dépendantes
AddArtifact	Accorde l'autorisation d'ajouter un Artifact pour l'espace d'agent donné	Écrire	AgentSpace*
BatchDeletePentests	Autorise la suppression de plusieurs tests de pénétration en une seule demande	Écrire	AgentSpace*		kms:Decrypt
BatchGetAgentSpaces	Accorde l'autorisation de récupérer plusieurs espaces d'agent en une seule demande	Lecture	AgentSpace*		kms:Decrypt
BatchGetArtifactMetadata	Accorde l'autorisation de récupérer un ou plusieurs enregistrements de métadonnées d'Artifact pour l'espace d'agent donné	Lecture	AgentSpace*
BatchGetFindings	Autorise la récupération de plusieurs résultats de tests de sécurité en une seule demande	Lecture	AgentSpace*		kms:Decrypt
BatchGetPentestJobContentMetadata	Accorde l'autorisation de récupérer les métadonnées du contenu de plusieurs tâches de pentest en une seule demande	Lecture	AgentSpace*		kms:Decrypt
BatchGetPentestJobTasks	Accorde l'autorisation de récupérer plusieurs tâches de pentest en une seule demande	Lecture	AgentSpace*		kms:Decrypt
BatchGetPentestJobs	Permet de récupérer plusieurs tâches de test de sécurité en une seule demande	Lecture	AgentSpace*		kms:Decrypt
BatchGetPentests	Autorise la récupération de plusieurs tests de pénétration en une seule demande	Lecture	AgentSpace*		kms:Decrypt
BatchGetTargetDomains	Accorde l'autorisation de récupérer plusieurs domaines cibles en une seule demande	Lecture	TargetDomain*
CreateAgentSpace	Accorde l'autorisation de créer un enregistrement d'espace agent	Écrire		aws:RequestTag/${TagKey} aws:TagKeys	kms:Decrypt kms:DescribeKey kms:GenerateDataKeyWithoutPlaintext
CreateApplication	Accorde l'autorisation de créer une application	Écrire		aws:RequestTag/${TagKey} aws:TagKeys	iam:PassRole kms:DescribeKey sso:CreateApplication
CreateDesignReview	Accorde l'autorisation de créer une révision de conception	Écrire	AgentSpace*
CreateIntegration	Autorise la création d'une intégration de tests de sécurité	Écrire		aws:RequestTag/${TagKey} aws:TagKeys
CreateMembership	Accorde l'autorisation d'ajouter un seul membre à un espace d'agent avec un rôle spécifié	Écrire	AgentSpace*
CreateOneTimeLoginSession	Accorde l'autorisation de créer une session de connexion unique	Écrire	AgentSpace*
CreatePentest	Autorise la création d'une nouvelle configuration de test d'intrusion	Écrire	AgentSpace*		kms:Decrypt
CreateSecurityRequirement	Accorde l'autorisation d'ajouter une exigence de sécurité gérée par le client	Écrire	SecurityRequirementPack*
CreateTargetDomain	Accorde l'autorisation de créer un enregistrement de domaine cible	Écrire
DeleteAgentSpace	Accorde l'autorisation de supprimer un enregistrement de l'espace agent	Écrire	AgentSpace*		kms:Decrypt
DeleteApplication	Autorise la suppression de l'application	Écrire	Application*
DeleteArtifact	Accorde l'autorisation de supprimer un Artifact	Écrire	AgentSpace*
DeleteDesignReview	Autorise la suppression d'une révision de conception	Écrire	AgentSpace*
DeleteIntegration	Accorde l'autorisation de supprimer l'intégration d'une application	Écrire	Integration*
DeleteMembership	Accorde l'autorisation de supprimer un seul membre associé à un espace d'agent	Écrire	AgentSpace*
DeleteSecurityRequirement	Accorde l'autorisation de supprimer une exigence de sécurité gérée par le client	Écrire	SecurityRequirementPack*
DeleteTargetDomain	Accorde l'autorisation de supprimer un enregistrement de domaine cible	Écrire	TargetDomain*
GetApplication	Accorde l'autorisation d'obtenir les détails de l'application par identifiant d'application	Lecture	Application*
GetArtifact	Accorde l'autorisation de récupérer un Artifact pour l'espace d'agent donné	Lecture	AgentSpace*
GetDesignReview	Accorde l'autorisation d'obtenir le statut de la révision de la conception de l'espace d'agent associée	Lecture	AgentSpace*
GetDesignReviewArtifact	Accorde l'autorisation d'obtenir un artefact de révision de conception pour un document spécifique	Lecture	AgentSpace*
GetDesignReviewFeedback	Accorde l'autorisation de recueillir des commentaires pour un commentaire de révision de conception	Lecture	AgentSpace*
GetIntegration	Accorde l'autorisation d'obtenir les métadonnées d'intégration par identifiant	Lecture	Integration*
GetSecurityRequirement	Accorde l'autorisation de récupérer une exigence de sécurité	Lecture	SecurityRequirementPack*
InitiateProviderRegistration	Accorde l'autorisation d'initier l'enregistrement de l'application Security Agent pour le fournisseur donné (par exemple : GitHub)	Écrire
ListAgentSpaces	Accorde l'autorisation de répertorier les espaces réservés aux agents	List
ListApplications	Accorde l'autorisation de répertorier toutes les applications du compte	List
ListArtifacts	Accorde l'autorisation de répertorier tous les artefacts pour l'espace d'agent donné	List	AgentSpace*
ListDesignReviewComments	Accorde l'autorisation de répertorier les commentaires relatifs aux révisions de conception	List	AgentSpace*
ListDesignReviews	Permet de répertorier toutes les révisions de conception pour l'espace d'agent donné	List	AgentSpace*
ListDiscoveredEndpoints	Accorde l'autorisation de répertorier les points de terminaison découverts associés à une tâche de pentest avec un filtrage optionnel par préfixe d'URI	List	AgentSpace*		kms:Decrypt
ListFindings	Permet de répertorier les résultats avec un support de filtrage et de pagination	List	AgentSpace*		kms:Decrypt
ListIntegratedResources	Accorde l'autorisation de répertorier les ressources intégrées pour un espace d'agent	List	AgentSpace*
ListIntegrations	Accorde l'autorisation d'obtenir les intégrations détenues par l'appelant Compte AWS	List
ListMemberships	Permet de répertorier tous les membres associés à un espace d'agent avec support de pagination	List	AgentSpace*
ListPentestJobTasks	Permet de répertorier les tâches de pentest associées à une tâche de pentest	List	AgentSpace*		kms:Decrypt
ListPentestJobsForPentest	Permet de répertorier les offres d'emploi associées à un test d'intrusion	List	AgentSpace*		kms:Decrypt
ListPentests	Permet de répertorier les tests d'intrusion avec un filtrage optionnel par statut	List	AgentSpace*		kms:Decrypt
ListResourcesFromIntegration	Accorde l'autorisation de répertorier les ressources issues de l'intégration	List	Integration*
ListSecurityRequirements	Accorde l'autorisation de répertorier toutes les exigences de sécurité	List	SecurityRequirementPack*
ListTagsForResource	Accorde l'autorisation de répertorier les balises d'une ressource	Lecture	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
ListTargetDomains	Accorde l'autorisation de répertorier les domaines cibles	List
PutDesignReviewFeedback	Accorde l'autorisation de soumettre des commentaires pour un commentaire de révision de conception	Écrire	AgentSpace*
StartCodeRemediation	Autorise le lancement de la correction du code pour les résultats	Écrire	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StartPentestJob	Autorise le lancement d'un test d'intrusion	Écrire	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StopPentestJob	Autorise l'arrêt de l'exécution d'un test d'intrusion en cours	Écrire	AgentSpace*		kms:Decrypt
TagResource	Accorde l'autorisation d'ajouter des balises à une ressource	Identification	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:RequestTag/${TagKey} aws:TagKeys
ToggleManagedSecurityRequirement	Accorde l'autorisation de changer le statut d'une exigence de sécurité gérée	Écrire	SecurityRequirementPack*
UntagResource	Accorde l'autorisation de supprimer des identifications d'une ressource.	Identification	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:TagKeys
UpdateAgentSpace	Autorise la mise à jour d'un enregistrement d'espace agent	Écrire	AgentSpace*		kms:Decrypt
UpdateApplication	Accorde l'autorisation de mettre à jour la configuration de l'application	Écrire	Application*		iam:PassRole kms:DescribeKey
UpdateFinding	Autorise la mise à jour d'une constatation de sécurité existante avec de nouveaux détails ou un nouveau statut	Écrire	AgentSpace*		kms:Decrypt
UpdateIntegratedResources	Autorise la mise à jour des ressources intégrées pour un espace d'agent	Écrire	AgentSpace*
UpdatePentest	Autorise la mise à jour d'un test d'intrusion existant avec une nouvelle configuration ou de nouveaux paramètres	Écrire	AgentSpace*		kms:Decrypt
UpdateSecurityRequirement	Accorde l'autorisation de mettre à jour une exigence de sécurité gérée par le client	Écrire	SecurityRequirementPack*
UpdateTargetDomain	Autorise la mise à jour d'un enregistrement de domaine cible	Écrire	TargetDomain*
VerifyTargetDomain	Accorde l'autorisation de vérifier la propriété d'un domaine cible enregistré	Écrire	TargetDomain*

Types de ressources définis par l'agent AWS de sécurité

Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources	ARN	Clés de condition
Application	`arn:${Partition}:securityagent:${Region}:${Account}:application/${ApplicationId}`	aws:ResourceTag/${TagKey}
SecurityRequirementPack	`arn:${Partition}:securityagent:${Region}:${Account}:security-requirement-pack/${SecurityRequirementPackId}`	aws:ResourceTag/${TagKey}
Integration	`arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}`	aws:ResourceTag/${TagKey}
AgentSpace	`arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}`	aws:ResourceTag/${TagKey}
TargetDomain	`arn:${Partition}:securityagent:${Region}:${Account}:target-domain/${TargetDomainId}`	aws:ResourceTag/${TagKey}

Clés de condition pour AWS Security Agent

AWS L'agent de sécurité définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une politique IAM. Vous pouvez utiliser ces clés pour affiner les conditions d’application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez la section Clés contextuelles de condition AWS globales.

Clés de condition	Description	Type
aws:RequestTag/${TagKey}	Filtre l'accès en fonction des identifications transmises dans la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des identifications associées à la ressource	Chaîne
aws:TagKeys	Filtre l'accès en fonction des clés d'identification qui sont transmises dans la demande	ArrayOfString

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AWS Secrets Manager

AWS Security Hub