Claves de condición, recursos y acciones del AWS Security Agent - Referencia de autorizaciones de servicio
AccionesTipos de recursoClaves de condición

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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:

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 a la instancia de agente dada Escritura

AgentSpace*

AddControl Otorga permiso para añadir un control gestionado por el cliente Escritura

Application*

BatchDeletePentests Otorga permiso para eliminar varias pruebas de penetración en una sola solicitud Escritura

AgentSpace*

BatchGetAgentInstances Otorga permiso para recuperar varias instancias de agente en una sola solicitud Lectura

AgentInstance*

BatchGetAgentSpaces Otorga permiso para recuperar varios espacios de agentes en una sola solicitud Lectura

AgentSpace*

BatchGetArtifactMetadata Otorga permiso para recuperar uno o más registros de metadatos de artefactos para la instancia de agente determinada Lectura

AgentSpace*

BatchGetFindings Otorga permiso para recuperar varios resultados de pruebas de seguridad en una sola solicitud Lectura

AgentSpace*

BatchGetPentestJobContentMetadata Otorga permiso para recuperar varios metadatos del contenido de las tareas de Pentest en una sola solicitud Lectura

AgentSpace*

BatchGetPentestJobTasks Otorga permiso para recuperar varios trabajos de prueba pendientes en una sola solicitud Lectura

AgentSpace*

BatchGetPentestJobs Otorga permiso para recuperar varios trabajos de pruebas de seguridad en una sola solicitud Lectura

AgentSpace*

BatchGetPentests Otorga permiso para recuperar varias pruebas de penetración en una sola solicitud Lectura

AgentSpace*

BatchGetSecurityTestContentMetadata Otorga permiso para recuperar varios metadatos del contenido de las pruebas de seguridad en una sola solicitud Lectura

AgentSpace*

BatchGetTasks Otorga permiso para recuperar varias tareas de pruebas de seguridad en una sola solicitud Lectura

AgentSpace*

CreateAgentInstance Otorga permiso para crear un registro de instancias de agente Escritura

Application*

CreateAgentSpace Otorga permiso para crear un registro de espacio de agentes Escritura
CreateApplication Otorga permiso para crear una aplicación nueva Escritura

iam:PassRole

sso:CreateApplication

CreateDesignReview Otorga permiso para crear una revisión de diseño Escritura

AgentSpace*

CreateDocumentReview Otorga permiso para crear una revisión de documentos Escritura

AgentSpace*

CreateIntegration Otorga permiso para crear una integración de pruebas de seguridad Escritura

Application*

CreateMembership Otorga permiso para añadir un solo miembro a una instancia de agente con un rol específico 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*

CreateSecurityRequirement Otorga permiso para añadir un requisito de seguridad gestionado por el cliente Escritura

Application*

DeleteAgentInstance Otorga permiso para eliminar un registro de instancia de agente Escritura

AgentInstance*

DeleteAgentSpace Otorga permiso para eliminar un registro de espacio de agentes Escritura

AgentSpace*

DeleteApplication Otorga permiso para eliminar una aplicación Escritura

Application*

DeleteArtifact Otorga permiso para eliminar un Artefacto Escritura

AgentSpace*

DeleteControl Otorga permiso para eliminar un control gestionado por el cliente Escritura

Control*

DeleteDesignReview Otorga permiso para eliminar una revisión de diseño Escritura

AgentSpace*

DeleteDocumentReview Otorga permiso para eliminar una reseña de un documento 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 una instancia de agente Escritura

AgentSpace*

DeleteSecurityRequirement Otorga permiso para eliminar un requisito de seguridad gestionado por el cliente Escritura

SecurityRequirement*

DescribeFindings Otorga permiso para recuperar los hallazgos de seguridad para una prueba de penetración o para realizar tareas de prueba de seguridad en una prueba de penetración Lectura

AgentSpace*

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 para la Instancia de Agente dada Lectura

AgentSpace*

GetCodeReviewTask Otorga permiso para recuperar una tarea de revisión de código Lectura

AgentSpace*

GetControl Otorga permiso para recuperar un control Lectura

Control*

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*

GetDocReviewTask Otorga permiso para recuperar una tarea de revisión de documentos Lectura

AgentSpace*

GetDocumentReview Otorga permiso para obtener el estado de la revisión de documentos de la instancia de agente asociada Lectura

AgentSpace*

GetDocumentReviewArtifact Otorga permiso para obtener un artefacto de revisión de documentos para un documento específico Lectura

AgentSpace*

GetIntegration Otorga permiso para obtener los metadatos de la integración por ID Lectura

Integration*

GetLoginSessionCredentials Otorga permiso para recuperar las credenciales de una sesión de inicio de sesión única Lectura
GetSecurityRequirement Otorga permiso para recuperar un requisito de seguridad Lectura

SecurityRequirement*

HandleOneTimeLoginSession Otorga permiso para procesar e invalidar una sesión de inicio de sesión única Escritura
InitiateProviderRegistration Otorga permiso para iniciar el registro de la aplicación Security Agent para el proveedor en cuestión (por ejemplo: GitHub) Escritura

Application*

ListAgentInstanceTasks Otorga permiso para enumerar las tareas de una instancia de agente específica Enumeración

AgentInstance*

ListAgentInstances Otorga permiso para enumerar las instancias de los agentes Enumeración
ListAgentSpaces Otorga permiso para publicar 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 de un proyecto determinado Enumeración

AgentSpace*

ListControls Otorga permiso para enumerar todos los controles Enumeración
ListDesignReviewComments Otorga permiso para incluir los comentarios de las revisiones de diseño Enumeración

AgentSpace*

ListDesignReviews Otorga permiso para incluir todas las revisiones de diseño del proyecto 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*

ListDocumentReviewComments Otorga permiso para enumerar los comentarios de revisión de documentos Enumeración

AgentSpace*

ListDocumentReviews Otorga permiso para enumerar todas las revisiones de documentos del proyecto en cuestión Enumeración

AgentSpace*

ListFindings Otorga permiso para enumerar los hallazgos con soporte de filtrado y paginación Enumeración

AgentSpace*

ListIntegratedResources Otorga permiso para enumerar los recursos integrados para una instancia de agente 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 una instancia 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*

ListPentestJobsForPentest Otorga permiso para enumerar los trabajos de prueba de penetración asociados a una prueba de penetración Enumeración

AgentSpace*

ListPentests Otorga permiso para enumerar las pruebas de penetración con el filtrado opcional por estado Enumeración

AgentSpace*

ListResourcesFromIntegration Otorga permiso para enumerar los recursos de Integration Enumeración

Integration*

ListSecurityRequirements Otorga permiso para enumerar todos los requisitos de seguridad Enumeración
ListTasks Otorga permiso para enumerar las tareas de pruebas de seguridad asociadas a un trabajo de prueba Enumeración

AgentSpace*

StartCodeRemediation Otorga permiso para iniciar la corrección del código de los hallazgos Escritura

AgentSpace*

StartPentestExecution Otorga permiso para iniciar la ejecución de una prueba de penetración Escritura

AgentSpace*

StartPentestJob Otorga permiso para iniciar la ejecución de una prueba de penetración Escritura

AgentSpace*

StopPentestExecution Otorga permiso para detener la ejecución de una prueba de penetración en ejecución Escritura

AgentSpace*

StopPentestJob Otorga permiso para detener la ejecución de una prueba de penetración en ejecución Escritura

AgentSpace*

ToggleManagedControl Otorga permiso para cambiar el estado Escritura

Control*

ToggleManagedSecurityRequirement Otorga permiso para cambiar el estado de un requisito de seguridad gestionado Escritura

SecurityRequirement*

UpdateAgentInstance Otorga permiso para actualizar el registro de una instancia de agente Escritura

AgentInstance*

UpdateAgentSpace Otorga permiso para actualizar un registro de espacio de agente Escritura

AgentSpace*

UpdateApplication Otorga permiso para actualizar la configuración de la aplicación Escritura

Application*

iam:PassRole

UpdateControl Otorga permiso para actualizar un control gestionado por el cliente Escritura

Control*

UpdateFinding Otorga permiso para actualizar un hallazgo de seguridad existente con nuevos detalles o estados Escritura

AgentSpace*

UpdateIntegratedResources Otorga permiso para actualizar los recursos integrados de una instancia de agente Escritura

AgentSpace*

UpdatePentest Otorga permiso para actualizar una prueba de penetración existente con una configuración o ajustes nuevos Escritura

AgentSpace*

UpdateSecurityRequirement Otorga permiso para actualizar un requisito de seguridad gestionado por el cliente Escritura

SecurityRequirement*

VerifyTargetDomain Otorga permiso para verificar la propiedad de un dominio de destino registrado en una instancia de agente Escritura

AgentSpace*

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}
Control arn:${Partition}:securityagent:${Region}:${Account}:control/${ControlId}
SecurityRequirement arn:${Partition}:securityagent:${Region}:${Account}:security-requirement/${SecurityRequirementId}
Integration arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}
AgentInstance arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}
AgentSpace arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}
Artifact arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/artifact/${ArtifactId}
Pentest arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/pentest/${PentestId}
PentestJob arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/pentest-job/${JobId}
PentestTask arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/pentest-task/${TaskId}
Finding arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/finding/${FindingId}

Claves de condición para AWS Security Agent

securityagent no tiene claves de contexto específicas de un servicio que puedan usarse en el Condition elemento de las declaraciones de política. Para obtener la lista de las claves de contexto globales que están disponibles para todos los servicios, consulte AWS Claves de contexto de condición globales.