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:
-
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
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 | |||
| AddControl | Otorga permiso para añadir un control gestionado por el cliente | Escritura | |||
| BatchDeletePentests | Otorga permiso para eliminar varias pruebas de penetración en una sola solicitud | Escritura | |||
| BatchGetAgentInstances | Otorga permiso para recuperar varias instancias de agente en una sola solicitud | Lectura | |||
| BatchGetArtifactMetadata | Otorga permiso para recuperar uno o más registros de metadatos de artefactos para la instancia de agente determinada | Lectura | |||
| BatchGetFindings | Otorga permiso para recuperar varios resultados de pruebas de seguridad en una sola solicitud | Lectura | |||
| BatchGetPentestJobs | Otorga permiso para recuperar varios trabajos de pruebas de seguridad en una sola solicitud | Lectura | |||
| BatchGetPentests | Otorga permiso para recuperar varias pruebas de penetración en una sola solicitud | Lectura | |||
| BatchGetSecurityTestContentMetadata | Otorga permiso para recuperar varios metadatos del contenido de las pruebas de seguridad en una sola solicitud | Lectura | |||
| BatchGetTasks | Otorga permiso para recuperar varias tareas de pruebas de seguridad en una sola solicitud | Lectura | |||
| CreateAgentInstance | Otorga permiso para crear un registro de instancias de agente | Escritura | |||
| CreateApplication | Otorga permiso para crear una aplicación nueva | Escritura |
iam:PassRole sso:CreateApplication |
||
| CreateDocumentReview | Otorga permiso para crear una revisión de documentos | Escritura | |||
| CreateIntegration | Otorga permiso para crear una integración de pruebas de seguridad | Escritura | |||
| CreateMembership | Otorga permiso para añadir un solo miembro a una instancia de agente con un rol específico | Escritura | |||
| CreateOneTimeLoginSession | Otorga permiso para crear una sesión de inicio de sesión única | Escritura | |||
| CreatePentest | Otorga permiso para crear una nueva configuración de prueba de penetración | Escritura | |||
| DeleteAgentInstance | Otorga permiso para eliminar el registro de una instancia de agente | Escritura | |||
| DeleteApplication | Otorga permiso para eliminar la aplicación | Escritura | |||
| DeleteArtifact | Otorga permiso para eliminar un Artefacto | Escritura | |||
| DeleteControl | Otorga permiso para eliminar un control gestionado por el cliente | Escritura | |||
| DeleteIntegration | Otorga permiso para eliminar la integración de una aplicación | Escritura | |||
| DeleteMembership | Otorga permiso para eliminar un solo miembro asociado a una instancia de agente | Escritura | |||
| 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 | |||
| GetApplication | Otorga permiso para obtener los detalles de la solicitud por identificador de la aplicación | Lectura | |||
| GetArtifact | Otorga permiso para recuperar un Artefacto para la Instancia de Agente dada | Lectura | |||
| GetCodeReviewTask | Otorga permiso para recuperar una tarea de revisión de código | Lectura | |||
| GetControl | Otorga permiso para recuperar un control | Lectura | |||
| GetDocReviewTask | Otorga permiso para recuperar una tarea de revisión de documentos | Lectura | |||
| GetDocumentReview | Otorga permiso para obtener el estado de la revisión de documentos de la instancia de agente asociada | Lectura | |||
| GetDocumentReviewArtifact | Otorga permiso para obtener un artefacto de revisión de documentos para un documento específico | Lectura | |||
| GetIntegration | Otorga permiso para obtener los metadatos de la integración por ID | Lectura | |||
| GetLoginSessionCredentials | Otorga permiso para recuperar las credenciales de una sesión de inicio de sesión única | Lectura | |||
| HandleOneTimeLoginSession | Otorga permiso para procesar e invalidar una sesión de inicio de sesión único | Escritura | |||
| InitiateProviderRegistration | Otorga permiso para iniciar el registro de la aplicación Security Agent para el proveedor en cuestión (por ejemplo: GitHub) | Escritura | |||
| ListAgentInstanceTasks | Otorga permiso para enumerar las tareas de una instancia de agente específica | Enumeración | |||
| ListAgentInstances | Otorga permiso para enumerar las instancias 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 | |||
| ListControls | Otorga permiso para enumerar todos los controles | Enumeración | |||
| 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 | |||
| ListDocumentReviewComments | Otorga permiso para enumerar los comentarios de revisión de documentos | Enumeración | |||
| ListDocumentReviews | Otorga permiso para enumerar todas las revisiones de documentos del proyecto en cuestión | Enumeración | |||
| ListFindings | Otorga permiso para enumerar los hallazgos con soporte de filtrado y paginación | Enumeración | |||
| ListIntegratedResources | Otorga permiso para enumerar los recursos integrados para una instancia de agente | Enumeración | |||
| 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 | |||
| ListPentestJobsForPentest | Otorga permiso para publicar los trabajos de prueba de penetración asociados a una prueba de penetración | Enumeración | |||
| ListPentests | Otorga permiso para enumerar las pruebas de penetración con el filtrado opcional por estado | Enumeración | |||
| ListResourcesFromIntegration | Otorga permiso para enumerar los recursos de Integration | Enumeración | |||
| ListTasks | Otorga permiso para enumerar las tareas de pruebas de seguridad asociadas a un trabajo de prueba pendiente | Enumeración | |||
| StartCodeRemediation | Otorga permiso para iniciar la corrección del código de los hallazgos | Escritura | |||
| StartPentestExecution | Otorga permiso para iniciar la ejecución de una prueba de penetración | Escritura | |||
| StopPentestExecution | Otorga permiso para detener la ejecución de una prueba de penetración en ejecución | Escritura | |||
| ToggleManagedControl | Otorga permiso para cambiar el estado | Escritura | |||
| UpdateAgentInstance | Otorga permiso para actualizar el registro de una instancia de agente | Escritura | |||
| UpdateApplication | Otorga permiso para actualizar la configuración de la aplicación | Escritura |
iam:PassRole |
||
| UpdateControl | Otorga permiso para actualizar un control gestionado por el cliente | Escritura | |||
| UpdateFinding | Otorga permiso para actualizar un hallazgo de seguridad existente con nuevos detalles o estados | Escritura | |||
| UpdateIntegratedResources | Otorga permiso para actualizar los recursos integrados de una instancia de agente | Escritura | |||
| UpdatePentest | Otorga permiso para actualizar una prueba de penetración existente con una configuración o ajustes nuevos | Escritura | |||
| VerifyTargetDomain | Otorga permiso para verificar la propiedad de un dominio de destino registrado en una instancia de agente | Escritura |
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}
|
|
| 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}
|
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.
