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.
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é
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'instance d'agent donnée | Écrire | |||
| AddControl | Accorde l'autorisation d'ajouter un contrôle géré par le client | Écrire | |||
| BatchDeletePentests | Autorise la suppression de plusieurs tests de pénétration en une seule demande | Écrire | |||
| BatchGetAgentInstances | Accorde l'autorisation de récupérer plusieurs instances d'agent en une seule demande | Lecture | |||
| BatchGetArtifactMetadata | Accorde l'autorisation de récupérer un ou plusieurs enregistrements de métadonnées d'Artifact pour l'instance d'agent donnée | Lecture | |||
| BatchGetFindings | Autorise la récupération de plusieurs résultats de tests de sécurité en une seule demande | Lecture | |||
| BatchGetPentestJobs | Autorise la récupération de plusieurs tâches de test de sécurité en une seule demande | Lecture | |||
| BatchGetPentests | Autorise la récupération de plusieurs tests de pénétration en une seule demande | Lecture | |||
| BatchGetSecurityTestContentMetadata | Accorde l'autorisation de récupérer plusieurs métadonnées du contenu des tests de sécurité en une seule demande | Lecture | |||
| BatchGetTasks | Accorde l'autorisation de récupérer plusieurs tâches de test de sécurité en une seule demande | Lecture | |||
| CreateAgentInstance | Accorde l'autorisation de créer un enregistrement d'instance d'agent | Écrire | |||
| CreateApplication | Accorde l'autorisation de créer une application | Écrire |
iam:PassRole sso:CreateApplication |
||
| CreateDocumentReview | Accorde l'autorisation de créer une révision de document | Écrire | |||
| CreateIntegration | Autorise la création d'une intégration de tests de sécurité | Écrire | |||
| CreateMembership | Accorde l'autorisation d'ajouter un seul membre à une instance d'agent avec un rôle spécifié | Écrire | |||
| CreateOneTimeLoginSession | Accorde l'autorisation de créer une session de connexion unique | Écrire | |||
| CreatePentest | Autorise la création d'une nouvelle configuration de test d'intrusion | Écrire | |||
| DeleteAgentInstance | Accorde l'autorisation de supprimer un enregistrement d'instance d'agent | Écrire | |||
| DeleteApplication | Autorise la suppression de l'application | Écrire | |||
| DeleteArtifact | Accorde l'autorisation de supprimer un Artifact | Écrire | |||
| DeleteControl | Accorde l'autorisation de supprimer un contrôle géré par le client | Écrire | |||
| DeleteIntegration | Accorde l'autorisation de supprimer l'intégration d'une application | Écrire | |||
| DeleteMembership | Accorde l'autorisation de supprimer un seul membre associé à une instance d'agent | Écrire | |||
| DescribeFindings | Autorise la récupération des résultats de sécurité pour un test d'intrusion ou des tâches de test de sécurité dans le cadre d'un test d'intrusion | Lecture | |||
| GetApplication | Accorde l'autorisation d'obtenir les détails de l'application par identifiant d'application | Lecture | |||
| GetArtifact | Accorde l'autorisation de récupérer un Artifact pour l'instance d'agent donnée | Lecture | |||
| GetCodeReviewTask | Accorde l'autorisation de récupérer une tâche de révision de code | Lecture | |||
| GetControl | Accorde l'autorisation de récupérer un contrôle | Lecture | |||
| GetDocReviewTask | Accorde l'autorisation de récupérer une tâche de révision de document | Lecture | |||
| GetDocumentReview | Accorde l'autorisation d'obtenir le statut de la révision du document de l'instance d'agent associée | Lecture | |||
| GetDocumentReviewArtifact | Accorde l'autorisation d'obtenir un artefact de révision de document pour un document spécifique | Lecture | |||
| GetIntegration | Accorde l'autorisation d'obtenir les métadonnées d'intégration par identifiant | Lecture | |||
| GetLoginSessionCredentials | Accorde l'autorisation de récupérer les informations d'identification pour une session de connexion unique | Lecture | |||
| HandleOneTimeLoginSession | Accorde l'autorisation de traiter et d'invalider une session de connexion unique | Écrire | |||
| InitiateProviderRegistration | Accorde l'autorisation d'initier l'enregistrement de l'application Security Agent pour le fournisseur donné (par exemple : GitHub) | Écrire | |||
| ListAgentInstanceTasks | Accorde l'autorisation de répertorier les tâches pour une instance d'agent spécifique | List | |||
| ListAgentInstances | Accorde l'autorisation de répertorier les instances d'agent | 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 le projet donné | List | |||
| ListControls | Accorde l'autorisation de répertorier tous les contrôles | List | |||
| 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 | |||
| ListDocumentReviewComments | Accorde l'autorisation de répertorier les commentaires relatifs à la révision de documents | List | |||
| ListDocumentReviews | Accorde l'autorisation de répertorier toutes les revues de documents pour le projet donné | List | |||
| ListFindings | Permet de répertorier les résultats avec un support de filtrage et de pagination | List | |||
| ListIntegratedResources | Accorde l'autorisation de répertorier les ressources intégrées pour une instance d'agent | List | |||
| ListIntegrations | Accorde l'autorisation d'obtenir les intégrations détenues par l'appelant Compte AWS | List | |||
| ListMemberships | Accorde l'autorisation de répertorier tous les membres associés à une instance d'agent avec support de pagination | List | |||
| ListPentestJobsForPentest | Permet de répertorier les offres d'emploi associées à un test d'intrusion | List | |||
| ListPentests | Permet de répertorier les tests d'intrusion avec un filtrage optionnel par statut | List | |||
| ListResourcesFromIntegration | Accorde l'autorisation de répertorier les ressources issues de Integration | List | |||
| ListTasks | Permet de répertorier les tâches de test de sécurité associées à une tâche de pentest | List | |||
| StartCodeRemediation | Autorise le lancement de la correction du code pour les résultats | Écrire | |||
| StartPentestExecution | Autorise le lancement d'un test d'intrusion | Écrire | |||
| StopPentestExecution | Autorise l'arrêt de l'exécution d'un test d'intrusion en cours | Écrire | |||
| ToggleManagedControl | Accorde l'autorisation de changer de statut | Écrire | |||
| UpdateAgentInstance | Autorise la mise à jour d'un enregistrement d'instance d'agent | Écrire | |||
| UpdateApplication | Accorde l'autorisation de mettre à jour la configuration de l'application | Écrire |
iam:PassRole |
||
| UpdateControl | Autorise la mise à jour d'un contrôle géré par le client | Écrire | |||
| UpdateFinding | Autorise la mise à jour d'une constatation de sécurité existante avec de nouveaux détails ou un nouveau statut | Écrire | |||
| UpdateIntegratedResources | Autorise la mise à jour des ressources intégrées pour une instance d'agent | Écrire | |||
| UpdatePentest | Autorise la mise à jour d'un test d'intrusion existant avec une nouvelle configuration ou de nouveaux paramètres | Écrire | |||
| VerifyTargetDomain | Accorde l'autorisation de vérifier la propriété d'un domaine cible enregistré dans une instance d'agent | Écrire |
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}
|
|
| Control |
arn:${Partition}:securityagent:${Region}:${Account}:control/${ControlId}
|
|
| Integration |
arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}
|
|
| AgentInstance |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}
|
|
| Artifact |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/artifact/${ArtifactId}
|
|
| Pentest |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest/${PentestId}
|
|
| PentestJob |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest-job/${JobId}
|
|
| PentestTask |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest-task/${TaskId}
|
|
| Finding |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/finding/${FindingId}
|
Clés de condition pour AWS Security Agent
securityagent ne possède aucune clé de contexte spécifique au service pouvant être utilisée dans l'Conditionélément des déclarations de politique. Pour obtenir la liste des clés de contexte globales disponibles pour tous les services, consultez la section Clés de contexte de condition AWS globales.
