Acciones Tipos de recurso Claves de condición

Claves de condición, recursos y acciones del AWS Security Agent

AWS Security Agent (prefijo de servicio:securityagent) proporciona los siguientes recursos, acciones y claves de contexto de condiciones específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

Obtenga información para configurar este servicio.
Vea una lista de las operaciones de API disponibles para este servicio.
Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Temas

Acciones definidas por Security Agent AWS
Tipos de recursos definidos por AWS Security Agent
Claves de condición para AWS Security Agent

Acciones definidas por Security Agent AWS

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Nivel de acceso de la tabla Acciones describe cómo se clasifica la acción (lista, lectura, administración de permisos o etiquetado). Esta clasificación puede ayudarle a entender el nivel de acceso que una acción concede cuando se utiliza en una política. Para obtener más información sobre los niveles de acceso, consulte Niveles de acceso en los resúmenes de políticas.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

La columna Acciones dependientes de la tabla Acciones muestra los permisos adicionales que pueden ser necesarios para llamar a una acción correctamente. Es posible que estos permisos sean necesarios además del permiso para la acción en sí. Cuando una acción especifica acciones dependientes, esas dependencias pueden aplicarse a los recursos adicionales definidos para esa acción, no solo al primer recurso de la tabla.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
AddArtifact	Otorga permiso para añadir un Artefacto al espacio de agente dado	Escritura	AgentSpace*
BatchDeletePentests	Otorga permiso para eliminar varias pruebas de penetración en una sola solicitud	Escritura	AgentSpace*		kms:Decrypt
BatchGetAgentSpaces	Otorga permiso para recuperar varios espacios de agentes en una sola solicitud	Lectura	AgentSpace*		kms:Decrypt
BatchGetArtifactMetadata	Otorga permiso para recuperar uno o más registros de metadatos de artefactos para el espacio de agente determinado	Lectura	AgentSpace*
BatchGetFindings	Otorga permiso para recuperar varios resultados de pruebas de seguridad en una sola solicitud	Lectura	AgentSpace*		kms:Decrypt
BatchGetPentestJobContentMetadata	Otorga permiso para recuperar varios metadatos del contenido de las tareas de Pentest en una sola solicitud	Lectura	AgentSpace*		kms:Decrypt
BatchGetPentestJobTasks	Otorga permiso para recuperar varios trabajos de prueba pendientes en una sola solicitud	Lectura	AgentSpace*		kms:Decrypt
BatchGetPentestJobs	Otorga permiso para recuperar varios trabajos de pruebas de seguridad en una sola solicitud	Lectura	AgentSpace*		kms:Decrypt
BatchGetPentests	Otorga permiso para recuperar varias pruebas de penetración en una sola solicitud	Lectura	AgentSpace*		kms:Decrypt
BatchGetTargetDomains	Otorga permiso para recuperar varios dominios de destino en una sola solicitud	Lectura	TargetDomain*
CreateAgentSpace	Otorga permiso para crear un registro de espacio de agentes	Escritura		aws:RequestTag/${TagKey} aws:TagKeys	kms:Decrypt kms:DescribeKey kms:GenerateDataKeyWithoutPlaintext
CreateApplication	Otorga permiso para crear una aplicación nueva	Escritura		aws:RequestTag/${TagKey} aws:TagKeys	iam:PassRole kms:DescribeKey sso:CreateApplication
CreateDesignReview	Otorga permiso para crear una revisión de diseño	Escritura	AgentSpace*
CreateIntegration	Otorga permiso para crear una integración de pruebas de seguridad	Escritura		aws:RequestTag/${TagKey} aws:TagKeys
CreateMembership	Otorga permiso para añadir un solo miembro a un espacio de agentes con una función específica	Escritura	AgentSpace*
CreateOneTimeLoginSession	Otorga permiso para crear una sesión de inicio de sesión única	Escritura	AgentSpace*
CreatePentest	Otorga permiso para crear una nueva configuración de prueba de penetración	Escritura	AgentSpace*		kms:Decrypt
CreateSecurityRequirement	Otorga permiso para añadir un requisito de seguridad gestionado por el cliente	Escritura	SecurityRequirementPack*
CreateTargetDomain	Otorga permiso para crear un registro de dominio de destino	Escritura
DeleteAgentSpace	Otorga permiso para eliminar un registro de espacio de agentes	Escritura	AgentSpace*		kms:Decrypt
DeleteApplication	Otorga permiso para eliminar una aplicación	Escritura	Application*
DeleteArtifact	Otorga permiso para eliminar un Artefacto	Escritura	AgentSpace*
DeleteDesignReview	Otorga permiso para eliminar una reseña de diseño	Escritura	AgentSpace*
DeleteIntegration	Otorga permiso para eliminar la integración de una aplicación	Escritura	Integration*
DeleteMembership	Otorga permiso para eliminar un solo miembro asociado a un espacio de agentes	Escritura	AgentSpace*
DeleteSecurityRequirement	Otorga permiso para eliminar un requisito de seguridad gestionado por el cliente	Escritura	SecurityRequirementPack*
DeleteTargetDomain	Otorga permiso para eliminar un registro de dominio de destino	Escritura	TargetDomain*
GetApplication	Otorga permiso para obtener los detalles de la solicitud por identificador de la aplicación	Lectura	Application*
GetArtifact	Otorga permiso para recuperar un Artefacto en el espacio de agente indicado	Lectura	AgentSpace*
GetDesignReview	Otorga permiso para obtener el estado de la revisión del diseño del espacio de agentes asociado	Lectura	AgentSpace*
GetDesignReviewArtifact	Otorga permiso para obtener un artefacto de revisión de diseño para un documento específico	Lectura	AgentSpace*
GetDesignReviewFeedback	Otorga permiso para recibir comentarios sobre un comentario de revisión de diseño	Lectura	AgentSpace*
GetIntegration	Otorga permiso para obtener los metadatos de la integración por ID	Lectura	Integration*
GetSecurityRequirement	Otorga permiso para recuperar un requisito de seguridad	Lectura	SecurityRequirementPack*
InitiateProviderRegistration	Otorga permiso para iniciar el registro de la aplicación Security Agent para el proveedor en cuestión (por ejemplo: GitHub)	Escritura
ListAgentSpaces	Otorga permiso para enumerar los espacios de los agentes	Enumeración
ListApplications	Otorga permiso para enumerar todas las aplicaciones de la cuenta	Enumeración
ListArtifacts	Otorga permiso para enumerar todos los artefactos del espacio de agente en cuestión	Enumeración	AgentSpace*
ListDesignReviewComments	Otorga permiso para incluir los comentarios de las revisiones de diseño	Enumeración	AgentSpace*
ListDesignReviews	Otorga permiso para publicar todas las revisiones de diseño del espacio de agente en cuestión	Enumeración	AgentSpace*
ListDiscoveredEndpoints	Otorga permiso para enumerar los puntos finales descubiertos asociados a un trabajo de prueba previo con el filtrado opcional de prefijos de URI	Enumeración	AgentSpace*		kms:Decrypt
ListFindings	Otorga permiso para enumerar los hallazgos con soporte de filtrado y paginación	Enumeración	AgentSpace*		kms:Decrypt
ListIntegratedResources	Otorga permiso para enumerar los recursos integrados para un espacio de agentes	Enumeración	AgentSpace*
ListIntegrations	Otorga permiso para que las integraciones sean propiedad de la persona que llama Cuenta de AWS	Enumeración
ListMemberships	Otorga permiso para enumerar todos los miembros asociados a un espacio de agente con soporte de paginación	Enumeración	AgentSpace*
ListPentestJobTasks	Otorga permiso para enumerar las tareas de trabajo de prueba pendientes asociadas a un trabajo de prueba pendiente	Enumeración	AgentSpace*		kms:Decrypt
ListPentestJobsForPentest	Otorga permiso para enumerar los trabajos de prueba de penetración asociados a una prueba de penetración	Enumeración	AgentSpace*		kms:Decrypt
ListPentests	Otorga permiso para enumerar las pruebas de penetración con el filtrado opcional por estado	Enumeración	AgentSpace*		kms:Decrypt
ListResourcesFromIntegration	Otorga permiso para enumerar los recursos de Integration	Enumeración	Integration*
ListSecurityRequirements	Otorga permiso para enumerar todos los requisitos de seguridad	Enumeración	SecurityRequirementPack*
ListTagsForResource	Concede permiso para enumerar las etiquetas de un recurso	Lectura	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
ListTargetDomains	Otorga permiso para publicar los dominios de destino	Enumeración
PutDesignReviewFeedback	Otorga permiso para enviar comentarios para un comentario de revisión de diseño	Escritura	AgentSpace*
StartCodeRemediation	Otorga permiso para iniciar la corrección del código a partir de los hallazgos	Escritura	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StartPentestJob	Otorga permiso para iniciar la ejecución de una prueba de penetración	Escritura	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StopPentestJob	Otorga permiso para detener la ejecución de una prueba de penetración en ejecución	Escritura	AgentSpace*		kms:Decrypt
TagResource	Otorga permiso para agregar etiquetas a un recurso	Etiquetado	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:RequestTag/${TagKey} aws:TagKeys
ToggleManagedSecurityRequirement	Otorga permiso para cambiar el estado de un requisito de seguridad gestionado	Escritura	SecurityRequirementPack*
UntagResource	Concede permiso para eliminar etiquetas de un recurso	Etiquetado	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:TagKeys
UpdateAgentSpace	Otorga permiso para actualizar un registro de espacio de agente	Escritura	AgentSpace*		kms:Decrypt
UpdateApplication	Otorga permiso para actualizar la configuración de la aplicación	Escritura	Application*		iam:PassRole kms:DescribeKey
UpdateFinding	Otorga permiso para actualizar un hallazgo de seguridad existente con nuevos detalles o estados	Escritura	AgentSpace*		kms:Decrypt
UpdateIntegratedResources	Otorga permiso para actualizar los recursos integrados de un espacio de agentes	Escritura	AgentSpace*
UpdatePentest	Otorga permiso para actualizar una prueba de penetración existente con una configuración o ajustes nuevos	Escritura	AgentSpace*		kms:Decrypt
UpdateSecurityRequirement	Otorga permiso para actualizar un requisito de seguridad gestionado por el cliente	Escritura	SecurityRequirementPack*
UpdateTargetDomain	Otorga permiso para actualizar un registro de dominio de destino	Escritura	TargetDomain*
VerifyTargetDomain	Otorga permiso para verificar la propiedad de un dominio de destino registrado	Escritura	TargetDomain*

Tipos de recursos definidos por AWS Security Agent

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
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}

Claves de condición para AWS Security Agent

AWS Security Agent define las siguientes claves de condición que se pueden utilizar en el Condition elemento de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.

A fin de ver las claves de condición globales que están disponibles para todos los servicios, consulte AWS Claves de contexto de condición globales.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso por las etiquetas que se pasan en la solicitud	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por las etiquetas asociadas al recurso	Cadena
aws:TagKeys	Filtra el acceso por las claves de etiquetas que se pasan en la solicitud	ArrayOfString

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

AWS Secrets Manager

AWS Security Hub