Azioni Tipi di risorse Chiavi di condizione

Azioni, risorse e chiavi di condizione per AWS Security Agent

AWS Security Agent (prefisso del servizio:securityagent) fornisce le seguenti risorse, azioni e chiavi di contesto delle condizioni specifiche del servizio da utilizzare nelle politiche di autorizzazione IAM.

Riferimenti:

Scopri come configurare questo servizio.
Visualizza un elenco delle operazioni API disponibili per questo servizio.
Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni IAM.

Argomenti

Azioni definite da Security Agent AWS
Tipi di risorse definiti da AWS Security Agent
Chiavi di condizione per AWS Security Agent

Azioni definite da Security Agent AWS

Puoi specificare le seguenti operazioni nell'elemento Action di un'istruzione di policy IAM. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando utilizzi un'operazione in una policy, in genere consenti o rifiuti l'accesso all'operazione API o al comando CLI con lo stesso nome. Tuttavia, in alcuni casi, una singola operazione controlla l'accesso a più di una operazione. In alternativa, alcune operazioni richiedono operazioni differenti.

La colonna Livello di accesso della tabella Azioni descrive come viene classificata l'azione (Elenco, Lettura, Gestione delle autorizzazioni o Tagging). Questa classificazione può aiutare a comprendere il livello di accesso che un'operazione mette a disposizione quando viene utilizzata in una policy. Per ulteriori informazioni sui livelli di accesso, vedere Livelli di accesso nei riepiloghi delle politiche.

La colonna Tipi di risorsa della tabella Operazioni indica se ogni operazione supporta le autorizzazioni a livello di risorsa. Se non vi è nessun valore in corrispondenza di questa colonna, è necessario specificare tutte le risorse ("*") alle quali si applica la policy nell'elemento Resource dell'istruzione di policy. Se la colonna include un tipo di risorsa, puoi specificare un ARN di quel tipo in una istruzione con tale operazione. Se l'operazione ha una o più risorse richieste, il chiamante deve disporre dell'autorizzazione per utilizzare l'operazione con tali risorse. Le risorse richieste sono indicate nella tabella con un asterisco (*). Se si limita l'accesso alle risorse con l'elemento Resource in una policy IAM, è necessario includere un ARN o un modello per ogni tipo di risorsa richiesta. Alcune operazioni supportano più tipi di risorse. Se il tipo di risorsa è facoltativo (non indicato come obbligatorio), puoi scegliere di utilizzare uno tra i tipi di risorsa facoltativi.

La colonna Chiavi di condizione della tabella Operazioni contiene le chiavi che è possibile specificare nell'elemento Condition di un'istruzione di policy. Per ulteriori informazioni sulle chiavi di condizione associate alle risorse per il servizio guarda la colonna Chiavi di condizione della tabella Tipi di risorsa.

La colonna Azioni dipendenti della tabella Azioni mostra le autorizzazioni aggiuntive che possono essere necessarie per eseguire correttamente un'azione. Queste autorizzazioni possono essere necessarie in aggiunta all'autorizzazione per l'azione stessa. Quando un'azione specifica azioni dipendenti, tali dipendenze possono applicarsi a risorse aggiuntive definite per quell'azione, non solo alla prima risorsa elencata nella tabella.

Nota

Le chiavi relative alle condizioni delle risorse sono elencate nella tabella Tipi di risorse. Nella colonna Tipi di risorse (*obbligatorio) della tabella Operazioni è presente un collegamento al tipo di risorsa che si applica a un'operazione. Il tipo di risorsa nella tabella Tipi di risorse include la colonna Chiavi di condizione, che contiene le chiavi delle condizioni delle risorse che si applicano a un'operazione nella tabella Operazioni.

Per dettagli sulle colonne nella tabella seguente, consultare Tabella delle operazioni.

Azioni	Descrizione	Livello di accesso	Tipi di risorsa (*obbligatorio)	Chiavi di condizione	Operazioni dipendenti
AddArtifact	Concede il permesso di aggiungere un Artifact per lo spazio dell'agente specificato	Scrittura	AgentSpace*
BatchDeletePentests	Concede l'autorizzazione a eliminare più test di penetrazione in un'unica richiesta	Scrittura	AgentSpace*		kms:Decrypt
BatchGetAgentSpaces	Concede l'autorizzazione a recuperare più spazi per agenti in un'unica richiesta	Lettura	AgentSpace*		kms:Decrypt
BatchGetArtifactMetadata	Concede il permesso di recuperare uno o più record di Artifact Metadata per un determinato Agent Space	Lettura	AgentSpace*
BatchGetFindings	Concede l'autorizzazione a recuperare più risultati dei test di sicurezza in un'unica richiesta	Lettura	AgentSpace*		kms:Decrypt
BatchGetPentestJobContentMetadata	Concede l'autorizzazione a recuperare più metadati dei contenuti di pentest job in un'unica richiesta	Lettura	AgentSpace*		kms:Decrypt
BatchGetPentestJobTasks	Concede l'autorizzazione a recuperare più attività di Pentest Job in un'unica richiesta	Lettura	AgentSpace*		kms:Decrypt
BatchGetPentestJobs	Concede l'autorizzazione a recuperare più lavori di test di sicurezza in un'unica richiesta	Lettura	AgentSpace*		kms:Decrypt
BatchGetPentests	Concede l'autorizzazione a recuperare più test di penetrazione in un'unica richiesta	Lettura	AgentSpace*		kms:Decrypt
BatchGetTargetDomains	Concede l'autorizzazione a recuperare più domini di destinazione in un'unica richiesta	Lettura	TargetDomain*
CreateAgentSpace	Concede l'autorizzazione a creare un record di spazio per gli agenti	Scrittura		aws:RequestTag/${TagKey} aws:TagKeys	kms:Decrypt kms:DescribeKey kms:GenerateDataKeyWithoutPlaintext
CreateApplication	Autorizza l'utente a creare una nuova applicazione	Scrittura		aws:RequestTag/${TagKey} aws:TagKeys	iam:PassRole kms:DescribeKey sso:CreateApplication
CreateDesignReview	Concede l'autorizzazione a creare una revisione del progetto	Scrittura	AgentSpace*
CreateIntegration	Concede l'autorizzazione a creare un'integrazione per i test di sicurezza	Scrittura		aws:RequestTag/${TagKey} aws:TagKeys
CreateMembership	Concede l'autorizzazione ad aggiungere un singolo membro a uno spazio agente con un ruolo specificato	Scrittura	AgentSpace*
CreateOneTimeLoginSession	Concede l'autorizzazione a creare una sessione di accesso unica	Scrittura	AgentSpace*
CreatePentest	Concede l'autorizzazione a creare una nuova configurazione per il test di penetrazione	Scrittura	AgentSpace*		kms:Decrypt
CreateSecurityRequirement	Concede l'autorizzazione ad aggiungere un requisito di sicurezza gestito dal cliente	Scrittura	SecurityRequirementPack*
CreateTargetDomain	Concede l'autorizzazione a creare un record di dominio di destinazione	Scrittura
DeleteAgentSpace	Concede l'autorizzazione a eliminare un record di spazio dell'agente	Scrittura	AgentSpace*		kms:Decrypt
DeleteApplication	Concede l'autorizzazione a eliminare l'applicazione	Scrittura	Application*
DeleteArtifact	Concede il permesso di eliminare un Artifact	Scrittura	AgentSpace*
DeleteDesignReview	Concede il permesso di eliminare una revisione del progetto	Scrittura	AgentSpace*
DeleteIntegration	Concede l'autorizzazione a eliminare l'integrazione di un'applicazione	Scrittura	Integration*
DeleteMembership	Concede l'autorizzazione a rimuovere un singolo membro associato a uno spazio agente	Scrittura	AgentSpace*
DeleteSecurityRequirement	Concede l'autorizzazione a eliminare un requisito di sicurezza gestito dal cliente	Scrittura	SecurityRequirementPack*
DeleteTargetDomain	Concede l'autorizzazione a eliminare un record del dominio di destinazione	Scrittura	TargetDomain*
GetApplication	Concede l'autorizzazione a ottenere i dettagli dell'applicazione in base all'ID dell'applicazione	Lettura	Application*
GetArtifact	Concede il permesso di recuperare un Artifact per lo spazio dell'agente specificato	Lettura	AgentSpace*
GetDesignReview	Concede il permesso di ottenere lo stato della revisione della progettazione dello spazio agente associato	Lettura	AgentSpace*
GetDesignReviewArtifact	Concede l'autorizzazione a ottenere gli elementi di revisione del progetto per un documento specifico	Lettura	AgentSpace*
GetDesignReviewFeedback	Concede l'autorizzazione a ricevere feedback per un commento relativo alla revisione del progetto	Lettura	AgentSpace*
GetIntegration	Concede l'autorizzazione a ottenere i metadati di integrazione per ID	Lettura	Integration*
GetSecurityRequirement	Concede l'autorizzazione a recuperare un requisito di sicurezza	Lettura	SecurityRequirementPack*
InitiateProviderRegistration	Concede l'autorizzazione ad avviare la registrazione dell'app Security Agent per il fornitore specificato (ad esempio:) GitHub	Scrittura
ListAgentSpaces	Concede l'autorizzazione a elencare gli spazi degli agenti	List
ListApplications	Concede l'autorizzazione a elencare tutte le applicazioni nell'account	List
ListArtifacts	Concede l'autorizzazione a elencare tutti gli artefatti per lo spazio dell'agente specificato	List	AgentSpace*
ListDesignReviewComments	Concede il permesso di elencare i commenti relativi alla revisione del progetto	List	AgentSpace*
ListDesignReviews	Concede l'autorizzazione a elencare tutte le revisioni dei progetti per lo spazio riservato agli agenti	List	AgentSpace*
ListDiscoveredEndpoints	Concede l'autorizzazione a elencare gli endpoint scoperti associati a un lavoro pentest con il filtraggio opzionale del prefisso URI	List	AgentSpace*		kms:Decrypt
ListFindings	Concede l'autorizzazione a elencare i risultati con supporto per il filtraggio e l'impaginazione	List	AgentSpace*		kms:Decrypt
ListIntegratedResources	Concede l'autorizzazione a elencare le risorse integrate per uno spazio agente	List	AgentSpace*
ListIntegrations	Concede l'autorizzazione a ottenere le integrazioni di proprietà del chiamante Account AWS	List
ListMemberships	Concede l'autorizzazione a elencare tutti i membri associati a uno spazio agente con supporto per l'impaginazione	List	AgentSpace*
ListPentestJobTasks	Concede l'autorizzazione a elencare le attività di lavoro Pentest associate a un lavoro Pentest	List	AgentSpace*		kms:Decrypt
ListPentestJobsForPentest	Concede l'autorizzazione a elencare i lavori nei test di penetrazione associati a un test di penetrazione	List	AgentSpace*		kms:Decrypt
ListPentests	Concede l'autorizzazione a elencare i test di penetrazione con il filtraggio opzionale in base allo stato	List	AgentSpace*		kms:Decrypt
ListResourcesFromIntegration	Concede l'autorizzazione a elencare le risorse di Integration	List	Integration*
ListSecurityRequirements	Concede l'autorizzazione a elencare tutti i requisiti di sicurezza	List	SecurityRequirementPack*
ListTagsForResource	Concede l'autorizzazione per elencare i tag per una risorsa	Lettura	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
ListTargetDomains	Concede l'autorizzazione a elencare i domini di destinazione	List
PutDesignReviewFeedback	Concede l'autorizzazione a inviare feedback per un commento relativo alla revisione del progetto	Scrittura	AgentSpace*
StartCodeRemediation	Concede l'autorizzazione ad avviare la correzione del codice per i risultati	Scrittura	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StartPentestJob	Concede il permesso di avviare l'esecuzione di un penetration test	Scrittura	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StopPentestJob	Concede l'autorizzazione a interrompere l'esecuzione di un penetration test in corso	Scrittura	AgentSpace*		kms:Decrypt
TagResource	Concede l'autorizzazione per aggiungere tag a una risorsa	Assegnazione di tag	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:RequestTag/${TagKey} aws:TagKeys
ToggleManagedSecurityRequirement	Concede l'autorizzazione a cambiare lo stato di un requisito di sicurezza gestito	Scrittura	SecurityRequirementPack*
UntagResource	Concede l'autorizzazione per rimuovere tag da una risorsa	Assegnazione di tag	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:TagKeys
UpdateAgentSpace	Concede l'autorizzazione ad aggiornare un record di spazio dell'agente	Scrittura	AgentSpace*		kms:Decrypt
UpdateApplication	Concede l'autorizzazione ad aggiornare la configurazione dell'applicazione	Scrittura	Application*		iam:PassRole kms:DescribeKey
UpdateFinding	Concede l'autorizzazione ad aggiornare un risultato di sicurezza esistente con nuovi dettagli o status	Scrittura	AgentSpace*		kms:Decrypt
UpdateIntegratedResources	Concede l'autorizzazione ad aggiornare le risorse integrate per uno spazio agente	Scrittura	AgentSpace*
UpdatePentest	Concede l'autorizzazione ad aggiornare un penetration test esistente con nuove configurazioni o impostazioni	Scrittura	AgentSpace*		kms:Decrypt
UpdateSecurityRequirement	Concede l'autorizzazione ad aggiornare un requisito di sicurezza gestito dal cliente	Scrittura	SecurityRequirementPack*
UpdateTargetDomain	Concede l'autorizzazione ad aggiornare un record del dominio di destinazione	Scrittura	TargetDomain*
VerifyTargetDomain	Concede l'autorizzazione a verificare la proprietà di un dominio di destinazione registrato	Scrittura	TargetDomain*

Tipi di risorse definiti da AWS Security Agent

I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM. Ogni operazione nella Tabella delle operazioni identifica i tipi di risorse che possono essere specificati con tale operazione. Un tipo di risorsa può anche definire quali chiavi di condizione puoi includere in una policy. Queste chiavi vengono visualizzate nell'ultima colonna della tabella Tipi di risorsa. Per dettagli sulle colonne nella tabella seguente, consulta Tabella dei tipi di risorsa.

Tipi di risorse	ARN	Chiavi di condizione
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}

Chiavi di condizione per AWS Security Agent

AWS Security Agent definisce le seguenti chiavi di condizione che possono essere utilizzate nell'Conditionelemento di una policy IAM. Puoi utilizzare queste chiavi per perfezionare ulteriormente le condizioni in base alle quali si applica l'istruzione di policy. Per dettagli sulle colonne nella tabella seguente, consulta Tabella delle chiavi di condizione.

Per visualizzare le chiavi di condizione globali disponibili per tutti i servizi, consulta le chiavi di contesto delle condizioni AWS globali.

Chiavi di condizione	Descrizione	Tipo
aws:RequestTag/${TagKey}	Filtra l'accesso per i tag passati nella richiesta	Stringa
aws:ResourceTag/${TagKey}	Filtra l'accesso per i tag associati alla risorsa	Stringa
aws:TagKeys	Filtra l'accesso tramite le chiavi di tag passate nella richiesta	ArrayOfString

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

AWS Secrets Manager

AWS Security Hub