Integra Amazon EC2 en Google SecOps
En este documento, se describe cómo integrar AWS Elastic Compute Cloud (Amazon EC2) con Google Security Operations.
Casos de uso
Protege las instancias de Amazon Elastic Compute Cloud (Amazon EC2)
- Crea grupos de seguridad para restringir el acceso a Internet entrante y saliente a Amazon EC2.
- Asigna una nueva dirección IP elástica
- Asocia una nueva dirección IP elástica
Administración de recursos: Usa etiquetas personalizadas de instancias para hacer un seguimiento de los recursos de AWS y, también, identificarlos.
Antes de comenzar
Antes de configurar la integración de AWS Elastic Compute Cloud (EC2) en Google SecOps, verifica que tu entorno de red y las credenciales de AWS cumplan con todos los requisitos previos operativos.
Para preparar tu entorno para la integración, asegúrate de completar lo siguiente:
Verifica la línea de visión de la red entre Google SecOps y los extremos de servicio regionales de AWS EC2.
Obtén credenciales de la API programática de AWS (un ID de clave de acceso y una clave de acceso secreta) con los permisos de IAM adecuados.
Configura y prueba la instancia de integración en Google SecOps.
Requisitos de red
Google SecOps se comunica directamente con el servicio de AWS EC2
a través de las APIs de REST de HTTPS y el SDK de AWS para Python (boto3).
Asegúrate de que tu entorno de red cumpla con las siguientes reglas de conectividad:
Acceso HTTPS saliente: Habilita la comunicación HTTPS saliente desde tu instancia de Google SecOps o el agente remoto al extremo regional de AWS EC2 (
ec2.<region>.amazonaws.com) a través del puerto443/TCP.Para obtener más información, consulta Extremos de servicio de AWS en la documentación de AWS.
Configuración del proxy: Si tu organización enruta el tráfico saliente a través de un proxy HTTP/HTTPS, configura las variables de proxy de entorno estándar (
HTTP_PROXY,HTTPS_PROXY,NO_PROXY) en el servidor de Google SecOps o en el host del agente remoto.
Autenticación y credenciales
La integración de AWS EC2 requiere credenciales de API programáticas para autenticar solicitudes con la versión 4 de la firma de AWS.
Asegúrate de que tu entorno de AWS cumpla con los siguientes requisitos de autenticación:
Credenciales programáticas: Obtén un ID de clave de acceso de AWS y una clave secreta de AWS válidos asociados con un usuario o rol de IAM de AWS.
Para obtener información sobre cómo crear identidades de IAM y generar credenciales, consulta Administra claves de acceso para usuarios de IAM e Identidades de IAM en la documentación de AWS.
Privilegio mínimo: Restringe los permisos solo a las acciones y los recursos de procesamiento necesarios para tus flujos de trabajo automatizados y rota las credenciales periódicamente.
Para obtener detalles sobre las recomendaciones de seguridad, consulta Prácticas recomendadas de seguridad en IAM en la documentación de AWS.
Configura los permisos de acción
Otorga a la identidad de IAM de AWS que se autentica los permisos específicos necesarios para las acciones que ejecutan tus guías de Google SecOps.
Consulta los permisos mínimos para las acciones de AWS Elastic Compute Cloud (EC2) en la siguiente tabla:
| Nombre de la acción | Permiso de IAM de AWS obligatorio
(ActionName:Permission) |
Permiso de requisito previo | Descripción/Permiso del recurso |
|---|---|---|---|
| Authorize Security Group Egress | ec2:AuthorizeSecurityGroupEgress |
ec2:DescribeRegions |
Agrega reglas de salida a un grupo de seguridad de EC2. Recurso: ARN del grupo de seguridad de destino. |
| Autoriza la entrada del grupo de seguridad | ec2:AuthorizeSecurityGroupIngress |
ec2:DescribeRegions |
Agrega reglas de entrada a un grupo de seguridad de EC2. Recurso: ARN del grupo de seguridad de destino. |
| Crea etiquetas | ec2:CreateTags |
ec2:DescribeRegions |
Agrega o reemplaza etiquetas en los recursos de EC2. Resource: ARN del recurso de EC2 de destino. |
| Enumera instancias | ec2:DescribeInstances |
ec2:DescribeRegions |
Recupera el estado y los metadatos de las instancias de EC2. Recurso:
*. |
| Enumera los grupos de seguridad | ec2:DescribeSecurityGroups |
— | Recupera las configuraciones y reglas de los grupos de seguridad. Recurso:
*. |
| Ping | ec2:DescribeRegions |
— | Valida la conectividad de la integración. Recurso: *. |
| Revoke Security Group Egress | ec2:RevokeSecurityGroupEgress |
ec2:DescribeRegions |
Quita las reglas de salida de un grupo de seguridad de EC2. Recurso: ARN del grupo de seguridad de destino. |
| Revoca la entrada del grupo de seguridad | ec2:RevokeSecurityGroupIngress |
ec2:DescribeRegions |
Quita las reglas de entrada de un grupo de seguridad de EC2. Recurso: ARN del grupo de seguridad de destino. |
| Inicia la instancia | ec2:StartInstances |
— | Inicia instancias de EC2 detenidas. Recurso: ARN de la instancia de EC2 de destino. |
| Detén la instancia | ec2:StopInstances |
— | Detiene las instancias de EC2 en ejecución. Recurso: ARN de la instancia de EC2 de destino. |
| Tomar instantánea | ec2:CreateSnapshots |
ec2:DescribeRegions |
Crea instantáneas de EBS de un momento determinado para los volúmenes de instancias. Recurso: ARN de instancia y volumen. |
| Finalizar instancia | ec2:TerminateInstances |
— | Cierra y finaliza las instancias de EC2. Recurso: ARN de la instancia de EC2 de destino. |
Referencia rápida (ActionName:Permission)
Usa la siguiente referencia rápida para revisar los permisos necesarios para cada acción:
Ping: ec2:DescribeRegions
Authorize Security Group Egress: ec2:AuthorizeSecurityGroupEgress, ec2:DescribeRegions
Authorize Security Group Ingress: ec2:AuthorizeSecurityGroupIngress, ec2:DescribeRegions
Create Tags: ec2:CreateTags, ec2:DescribeRegions
List Instances: ec2:DescribeInstances, ec2:DescribeRegions
List Security Groups: ec2:DescribeSecurityGroups
Revoke Security Group Egress: ec2:RevokeSecurityGroupEgress, ec2:DescribeRegions
Revoke Security Group Ingress: ec2:RevokeSecurityGroupIngress, ec2:DescribeRegions
Start Instance: ec2:StartInstances
Stop Instance: ec2:StopInstances
Take Snapshot: ec2:CreateSnapshots, ec2:DescribeRegions
Terminate Instance: ec2:TerminateInstances
Ejemplo de política de IAM (privilegio mínimo)
En la siguiente política de ejemplo, se muestran los permisos necesarios para ejecutar todas las acciones de AWS EC2 en Google SecOps.
Para obtener instrucciones sobre cómo crear y adjuntar políticas de IAM, consulta Crea políticas de IAM en la documentación de AWS.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "SecOpsEC2Discovery",
"Effect": "Allow",
"Action": [
"ec2:DescribeRegions",
"ec2:DescribeInstances",
"ec2:DescribeSecurityGroups"
],
"Resource": "*"
},
{
"Sid": "SecOpsEC2InstanceRemediation",
"Effect": "Allow",
"Action": [
"ec2:StartInstances",
"ec2:StopInstances",
"ec2:TerminateInstances",
"ec2:CreateTags",
"ec2:CreateSnapshots"
],
"Resource": "*"
},
{
"Sid": "SecOpsEC2SecurityGroupManagement",
"Effect": "Allow",
"Action": [
"ec2:AuthorizeSecurityGroupIngress",
"ec2:RevokeSecurityGroupIngress",
"ec2:AuthorizeSecurityGroupEgress",
"ec2:RevokeSecurityGroupEgress"
],
"Resource": "arn:aws:ec2:*:*:security-group/*"
}
]
}
Parámetros de integración
Usa los siguientes parámetros para configurar la integración:
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| ID de clave de acceso de AWS | String | N/A | Sí | Es el ID de la clave de acceso de AWS que se usará en la integración. |
| Clave secreta de AWS | Contraseña | N/A | Sí | La clave secreta de AWS que se usará en la integración. |
| Región predeterminada de AWS | String | N/A | Sí | Es la región predeterminada de AWS que se usará en la integración, por ejemplo, us-west-2. |
Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.
Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.
Acciones
Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.
Autoriza la salida del grupo de seguridad
Agrega la regla de salida especificada a un grupo de seguridad para usarla con una VPC. Una regla de salida permite que las instancias envíen tráfico a los rangos de direcciones CIDR IPv4 o IPv6 especificados. Los cambios en las reglas se propagan a las instancias afectadas lo más rápido posible. Sin embargo, es posible que se produzca una pequeña demora.
Para obtener más información sobre los límites de los grupos de seguridad de VPC, consulta Límites de Amazon VPC.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| IDs de grupos de seguridad | String | N/A | Sí | Uno o más IDs de grupos de seguridad. Separados por comas. Nota para el desarrollador: Cada ID en una solicitud independiente |
| Protocolo IP | DDL | todos | No | Es el nombre del protocolo IP. Usa "all" para especificar todos los protocolos. Si especificas "all", se permitirá el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. Valores posibles: tcp , udp , icmp, all Nota para el desarrollador: "all" equivale a -1 en el código |
| Del puerto | Número entero | No | El inicio del rango de puertos para los protocolos TCP y UDP, o un número de tipo ICMP. | |
| Al puerto | Número entero | No | El final del rango de puertos para los protocolos TCP y UDP permite el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. | |
| Rangos de IP: CidrIP | String | N/A | No | El rango CIDR de IPv4. Para especificar una sola dirección IPv4, usa la longitud de prefijo /32. |
| Rangos de IPv6: CidrIP | String | N/A | No | Es el rango CIDR de IPv6. Para especificar una sola dirección IPv6, usa la longitud de prefijo /128. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se agregaron correctamente las reglas de salida especificadas a al menos un grupo de seguridad (o a todos) (is_success = true): "Successfully added the specified egress rule to the following security groups: {group_ids}" Si no se pudieron agregar las reglas de salida especificadas debido a un error de regla de permisos (puerto no válido,etcétera): (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Motivo: Se estableció un conjunto de permisos de IP no válido. Para obtener más detalles, consulta los registros". Si no se pudieron agregar las reglas de salida especificadas debido a un ID de grupo de seguridad no válido (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Motivo: Se proporcionó un ID de grupo de seguridad no válido. Para obtener más detalles, consulta los registros.`` Si no se pudieron agregar las reglas de salida especificadas a todos los grupos: is_success=false La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave o del SDK, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error executing action "Authorize Security Group Egress". Reason: {0}''.format(error.Stacktrace) |
General |
Autoriza la entrada del grupo de seguridad
Agrega la regla de entrada especificada a un grupo de seguridad. Una regla de entrada permite que las instancias reciban tráfico de los rangos de direcciones CIDR IPv4 o IPv6 especificados. Los cambios en las reglas se propagan a las instancias afectadas lo más rápido posible. Sin embargo, es posible que se produzca una pequeña demora.
Para obtener más información sobre los límites de los grupos de seguridad de VPC, consulta Límites de Amazon VPC.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| IDs de grupos de seguridad | String | N/A | Sí | Uno o más IDs de grupos de seguridad. Separados por comas. Nota para el desarrollador: Cada ID en una solicitud independiente |
| Protocolo IP | DDL | todos | No | Es el nombre del protocolo IP. Usa "all" para especificar todos los protocolos. Si especificas "all", se permitirá el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. Valores posibles: tcp , udp , icmp, all Nota para el desarrollador: "all" equivale a -1 en el código |
| Del puerto | Número entero | No | El inicio del rango de puertos para los protocolos TCP y UDP, o un número de tipo ICMP. | |
| Al puerto | Número entero | No | El final del rango de puertos para los protocolos TCP y UDP permite el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. | |
| Rangos de IP: CidrIP | String | N/A | No | La dirección IPv4 en formato CIDR. Para especificar una sola dirección IPv4, usa la longitud de prefijo /32. |
| Rangos de IPv6: CidrIP | String | N/A | No | Es el rango CIDR de IPv6. Para especificar una sola dirección IPv6, usa la longitud de prefijo /128. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se agregaron correctamente las reglas de entrada especificadas a al menos un grupo de seguridad (si todas se actualizaron correctamente, is_success = true): "Successfully added the specified ingress rule to the following security groups: {group_ids}" Si no se pudieron agregar las reglas de entrada especificadas debido a un error de regla de permisos (puerto no válido,etcétera) (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Motivo: Se estableció un conjunto de permisos de IP no válido. Para obtener más detalles, consulta los registros". Si no se pudieron agregar las reglas de entrada especificadas debido a un ID de grupo de seguridad no válido (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Motivo: Se proporcionó un ID de grupo de seguridad no válido. Para obtener más detalles, consulta los registros.`` La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave o del SDK, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error executing action "Authorize Security Group Ingress". Reason: {0}''.format(error.Stacktrace) |
General |
Crear etiquetas
Una etiqueta es un rótulo que asignas a un recurso de AWS. Cada etiqueta consta de una clave y un valor opcional. Puedes usar etiquetas para buscar y filtrar tus recursos o hacer un seguimiento de tus costos de AWS. Agrega o reemplaza solo las etiquetas especificadas para los recursos de Amazon EC2 indicados. Cuando especificas una clave de etiqueta existente, el valor se reemplaza por el nuevo. Cada recurso puede tener un máximo de 50 etiquetas. Las claves de etiqueta deben ser únicas por recurso.
Para obtener más información sobre las etiquetas, consulta Etiqueta tus recursos en la Guía del usuario de Amazon Elastic Compute Cloud.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| IDs de recursos | String | N/A | Sí | Uno o más IDs de recursos. Separados por comas. |
| Etiquetas | String | N/A | Sí | Es la combinación de par clave-valor de una etiqueta que se asignará al recurso. Por
ejemplo, para agregar a todos los recursos especificados una etiqueta con la clave Puedes agregar o reemplazar las etiquetas especificadas. Las claves de etiqueta deben ser únicas por recurso. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se realiza correctamente: "Se agregaron correctamente las etiquetas {tags_list} a los siguientes recursos: "resource_ids" Para los IDs de recursos no válidos (is_success = false): "No se pudieron agregar las etiquetas {tag_list} a los siguientes recursos: {resource_ids}. Motivo: ID de recurso no válido Si el recurso tiene más de 50 etiquetas (is_success = false): "No se pudieron agregar las etiquetas {tag_list} a los siguientes recursos: {resource_ids}. Motivo: El recurso puede tener un máximo de 50 etiquetas. Si la clave de etiqueta no es única (is_success = false): "No se pudieron agregar las etiquetas {tag_list} a los siguientes recursos: {resource_ids}. Motivo: Las claves de etiqueta deben ser únicas por recurso. Si la etiqueta proporcionada tiene un formato no válido (es decir, solo clave o solo valor sin la estructura completa de clave:valor) (is_success = false): "No se pudieron agregar las etiquetas {invalid_tags} a los siguientes recursos: {ids}. Motivo: El formato no es válido. La etiqueta debe incluir la clave y el valor. La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave o del SDK, como credenciales incorrectas, falta de conexión con el servidor, etcétera: "Error al ejecutar la acción "Crear etiquetas". Reason: {0}''.format(error.Stacktrace) |
General |
Enumerar instancias
Describe las instancias especificadas o todas las instancias.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| ID de instancia | String | N/A | No | Uno o más IDs de instancia. Si especificas IDs de instancia, el resultado incluirá información solo para las instancias especificadas. Este parámetro no se puede usar con el parámetro "Max Results". Los IDs de instancia tienen prioridad sobre el parámetro "Max Result". |
| Filtros de etiquetas | String | N/A | No | Es la combinación de clave-valor de una etiqueta asignada al recurso. Por ejemplo, para encontrar todos los recursos que tienen una etiqueta con la clave propietario y el valor TeamA, especifica Owner:TeamA. Filtros de etiquetas separados por comas. Ejemplo: Name:Name1,Owner:TeamA. Las instancias que se devuelvan se ajustarán a todos los filtros. |
| Cantidad máxima de resultados | Número entero | 50 | No | Especifica cuántas instancias se deben mostrar. El valor predeterminado es 50. El máximo es 1,000. El parámetro "IDs de instancia" no se puede usar con el parámetro "Resultados máximos". Los IDs de instancia tienen prioridad sobre el parámetro "Max Result". |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Resultado de JSON
"EC2_Instances": [
{
"AmiLaunchIndex":0,
"ImageId":"ami-047a51fa27710816e",
"InstanceId":"i-044c08c5bfe1a7f98",
"InstanceType":"t2.micro",
"KeyName":"\"Key\": \"Test\", \"Value\":\"Test\"",
"LaunchTime":"2021-1-30",
"Monitoring":{
"State":"disabled"
},
"Placement":{
"AvailabilityZone":"us-east-1d",
"GroupName":"",
"Tenancy":"default"
},
"PrivateDnsName":"ip-192-0-2-220.ec2.internal",
"PrivateIpAddress":"192.0.2.220",
"ProductCodes":[
],
"PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
"PublicIpAddress":"192.0.2.218",
"State":{
"Code":16,
"Name":"running"
},
"StateTransitionReason":"",
"SubnetId":"subnet-1b1fda3a",
"VpcId":"vpc-ID",
"Architecture":"x86_64",
"BlockDeviceMappings":[
{
"DeviceName":"/dev/xvda",
"Ebs":{
"AttachTime":"2021-1-30",
"DeleteOnTermination":true,
"Status":"attached",
"VolumeId":"vol-00f70681a43e5d86e"
}
}
],
"ClientToken":"",
"EbsOptimized":false,
"EnaSupport":true,
"Hypervisor":"xen",
"NetworkInterfaces":[
{
"Association":{
"IpOwnerId":"amazon",
"PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
"PublicIp":"192.0.2.218"
},
"Attachment":{
"AttachTime":"",
"AttachmentId":"eni-attach-06bc5e5901ce99ef2",
"DeleteOnTermination":true,
"DeviceIndex":0,
"Status":"attached",
"NetworkCardIndex":0
},
"Description":"",
"Groups":[
{
"GroupName":"launch-wizard-2",
"GroupId":"sg-001700ccddac4189a"
}
],
"Ipv6Addresses":[
],
"MacAddress":"12:34:56:ab:cd:ef",
"NetworkInterfaceId":"eni-020fa83efd417e32d",
"OwnerId":"ID",
"PrivateDnsName":"ip-192-0-2-220.ec2.internal",
"PrivateIpAddress":"192.0.2.220",
"PrivateIpAddresses":[
{
"Association":{
"IpOwnerId":"amazon",
"PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
"PublicIp":"192.0.2.218"
},
"Primary":true,
"PrivateDnsName":"ip-192-0-2-220.ec2.internal",
"PrivateIpAddress":"192.0.2.220"
}
],
"SourceDestCheck":true,
"Status":"in-use",
"SubnetId":"subnet-1b1fda3a",
"VpcId":"vpc-ID",
"InterfaceType":"interface"
}
],
"RootDeviceName":"/dev/xvda",
"RootDeviceType":"ebs",
"SecurityGroups":[
{
"GroupName":"launch-wizard-2",
"GroupId":"sg-001700ccddac4189a"
}
],
"SourceDestCheck":true,
"Tags":[
{
"Key":"Owner",
"Value":"Example"
},
{
"Key":"Name",
"Value":"Example test"
}
],
"VirtualizationType":"hvm",
"CpuOptions":{
"CoreCount":1,
"ThreadsPerCore":1
},
"CapacityReservationSpecification":{
"CapacityReservationPreference":"open"
},
"HibernationOptions":{
"Configured":false
},
"MetadataOptions":{
"State":"applied",
"HttpTokens":"optional",
"HttpPutResponseHopLimit":1,
"HttpEndpoint":"enabled"
},
"EnclaveOptions":{
"Enabled":false
}
}
]
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave, un ID de instancia no válido o un error del SDK, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error executing action "List Instances". Reason: {0}''.format(error.Stacktrace) |
General |
| Tabla del muro de casos | Nombre de la tabla: Instancias de Amazon EC2 Columnas de la tabla: ID Estado Tipo Zona de disponibilidad DNS IPv4 público Dirección IPv4 pública Supervisión Nombre del grupo de seguridad Nombre de la clave Hora de lanzamiento |
Enumera los grupos de seguridad
Describe los grupos de seguridad especificados o todos tus grupos de seguridad. Un grupo de seguridad se usa con instancias en la plataforma EC2-Classic o en una VPC específica.
Para obtener más información, consulta Grupos de seguridad de Amazon EC2.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Nombres de los grupos de seguridad | String | N/A | Falso | Uno o más nombres de grupos de seguridad [solo EC2-Classic y VPC predeterminada]. Separados por comas.Si especificas nombres de grupos de seguridad, el resultado incluirá información solo para los nombres especificados. |
| IDs de grupos de seguridad | String | N/A | Falso | Uno o más IDs de grupos de seguridad. Separados por comas.Si especificas los IDs de los grupos de seguridad, el resultado incluirá información solo para los IDs especificados. Obligatorio para los grupos de seguridad en una VPC no predeterminada. |
| Filtros de etiquetas | String | N/A | Falso | Es la combinación de par clave-valor de una etiqueta asignada al grupo de seguridad. Por
ejemplo, para encontrar todos los grupos con una etiqueta que incluya la clave |
| Cantidad máxima de resultados | Número entero | 50 | Falso | Es la cantidad de grupos de seguridad que se devolverán. El valor predeterminado es 50.
El valor máximo es 1000.
Nota: Los parámetros "IDs de grupos de seguridad" y "Nombres de grupos de seguridad" no se pueden
usar con el parámetro "Resultados máximos". |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Resultado de JSON
"EC2_Security_Groups": [
{
"Description":"launch-wizard-2 created 2021-01-30T19:37:11.523+02:00",
"GroupName":"launch-wizard-2",
"IpPermissions":[
{
"FromPort":22,
"IpProtocol":"tcp",
"IpRanges":[
{
"CidrIp":"192.0.2.0/0"
}
],
"Ipv6Ranges":[
],
"PrefixListIds":[
],
"ToPort":22,
"UserIdGroupPairs":[
]
}
],
"OwnerId":"582302349248",
"GroupId":"sg-001700ccddac4189a",
"IpPermissionsEgress":[
{
"IpProtocol":"-1",
"IpRanges":[
{
"CidrIp":"192.0.2.0/0"
}
],
"Ipv6Ranges":[
],
"PrefixListIds":[
],
"UserIdGroupPairs":[
]
}
],
"Tags":[
{
"Key":"Team",
"Value":"A-Team"
},
{
"Key":"Owner",
"Value":"Example"
}
],
"VpcId":"vpc-ID"
}
]
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave, un ID o nombre de grupo no válido, o un error del SDK, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error executing action "List Security Groups". Reason: {0}''.format(error.Stacktrace) |
General |
| Tabla del muro de casos | Nombre de la tabla: Instancias de Amazon EC2 Columnas de la tabla: ID del grupo de seguridad Nombre del grupo de seguridad ID de VPC Descripción ID del propietario |
Ping
Prueba la conectividad con AWS EC2.
Parámetros
N/A
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se realiza correctamente: "Successfully connected to the Amazon EC2 with the provided connection parameters!" La acción debería fallar y detener la ejecución de una guía: Si no se realiza correctamente, aparecerá el mensaje "Failed to connect to the Amazon EC2 server! Error is {0}".format(exception.stacktrace) |
General |
Revoke Security Group Egress
Quita las reglas de salida especificadas de un grupo de seguridad para EC2-VPC. Esta acción no se aplica a los grupos de seguridad que se usan en EC2-Classic. Para quitar una regla, los valores que especifiques (por ejemplo, los puertos) deben coincidir exactamente con los valores de la regla existente. Los cambios en las reglas se propagan a las instancias dentro del grupo de seguridad lo más rápido posible. Sin embargo, es posible que se produzca un pequeño retraso.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| IDs de grupos de seguridad | String | N/A | Sí | Uno o más IDs de grupos de seguridad. Separados por comas. Nota para el desarrollador: Cada ID en una solicitud independiente |
| Protocolo IP | DDL | todos | No | Es el nombre del protocolo IP. Usa "all" para especificar todos los protocolos. Si especificas "all", se permitirá el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. Valores posibles: tcp , udp , icmp, all Nota para el desarrollador: "all" equivale a -1 en el código |
| Del puerto | Número entero | No | El inicio del rango de puertos para los protocolos TCP y UDP, o un número de tipo ICMP. | |
| Al puerto | Número entero | No | El final del rango de puertos para los protocolos TCP y UDP permite el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. | |
| Rangos de IP: CidrIP | String | N/A | No | La dirección IPv4 en formato CIDR. Para especificar una sola dirección IPv4, usa la longitud de prefijo /32. |
| Rangos de IPv6: CidrIP | String | N/A | No | Es el rango CIDR de IPv6. Para especificar una sola dirección IPv6, usa la longitud de prefijo /128. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se revocaron correctamente las reglas de salida especificadas de al menos uno (o todos) los grupos de seguridad (is_success = true): "Successfully revoked the specified egress rule from the following security groups: {group_ids}" Si no se pudieron revocar las reglas de salida especificadas debido a un error de regla de permisos (puerto no válido como 205,etcétera): (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Motivo: Se estableció un conjunto de permisos de IP no válido. Para obtener más detalles, consulta los registros". Si no se pudieron revocar las reglas de salida especificadas debido a un ID de grupo de seguridad no válido (is_success =false): "No se pudo revocar la regla de salida especificada de los siguientes grupos de seguridad: {group_ids}. Motivo: Se proporcionó un ID de grupo de seguridad no válido. Para obtener más detalles, consulta los registros.`` La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave o del SDK, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error al ejecutar la acción "Revocar salida del grupo de seguridad". Reason: {0}''.format(error.Stacktrace) |
Gener |
Revoca la entrada del grupo de seguridad
Quita las reglas de entrada especificadas (reglas de entrada) de un grupo de seguridad. Para quitar una regla, los valores que especifiques (por ejemplo, los puertos) deben coincidir exactamente con los valores de la regla existente. Los cambios en las reglas se propagan a las instancias dentro del grupo de seguridad lo más rápido posible. Sin embargo, es posible que se produzca una pequeña demora.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| IDs de grupos de seguridad | String | N/A | Sí | Uno o más IDs de grupos de seguridad. Separados por comas. Nota para el desarrollador: Cada ID en una solicitud independiente |
| Protocolo IP | DDL | todos | No | Es el nombre del protocolo IP. Usa "all" para especificar todos los protocolos. Si especificas "all", se permitirá el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. Valores posibles: tcp , udp , icmp, all Nota para el desarrollador: "all" equivale a -1 en el código |
| Del puerto | Número entero | No | El inicio del rango de puertos para los protocolos TCP y UDP, o un número de tipo ICMP. | |
| Al puerto | Número entero | No | El final del rango de puertos para los protocolos TCP y UDP permite el tráfico en todos los puertos, independientemente del rango de puertos que especifiques. | |
| Rangos de IP: CidrIP | String | N/A | No | La dirección IPv4 en formato CIDR. Para especificar una sola dirección IPv4, usa la longitud de prefijo /32. |
| Rangos de IPv6: CidrIP | String | N/A | No | Es el rango CIDR de IPv6. Para especificar una sola dirección IPv6, usa la longitud de prefijo /128. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se revocaron correctamente las reglas de entrada especificadas para al menos uno (o todos) los grupos de seguridad (is_success = true): "Successfully revoked the specified ingress rule from the following security groups: {group_ids}" Si no se pudieron revocar las reglas de entrada especificadas debido a un error de regla de permisos (puerto no válido como 205,etc.): (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Motivo: Se estableció un conjunto de permisos de IP no válido. Para obtener más detalles, consulta los registros". Si no se pudieron revocar las reglas de entrada especificadas debido a un ID de grupo de seguridad no válido (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Motivo: Se proporcionó un ID de grupo de seguridad no válido. Para obtener más detalles, consulta los registros.`` La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave o del SDK, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Revoke Security Group Ingress". Reason: {0}''.format(error.Stacktrace) |
General |
Iniciar instancia
Inicia una instancia respaldada por Amazon Elastic Block Store (Amazon EBS) que detuviste anteriormente. La instancia puede tardar unos minutos en entrar en el estado de ejecución. Ten en cuenta que no puedes iniciar una instancia respaldada por un almacén de instancias. Para obtener más información sobre las instancias respaldadas por el almacén de instancias, consulta Almacenamiento para el dispositivo raíz.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| ID de instancia | String | N/A | Sí | Uno o más IDs de instancia. Separados por comas |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Resultado de JSON
[
{
"CurrentState": "pending",
"InstanceId": "string",
"PreviousState":"stopped"
}
]
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de una guía: Si se produce un error grave o del SDK, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Start Instance". Reason: {0}''.format(error.Stacktrace) |
General |
Detener instancia
Detiene una instancia respaldada por Amazon EBS. Cuando detienes una instancia, el sistema intenta cerrarla de forma forzada después de un breve retraso. Es posible que la instancia tarde unos minutos en detenerse. Puedes reiniciar la instancia en cualquier momento. No puedes detener una instancia respaldada por un almacén de instancias, sino que debes finalizarla. Para obtener más información sobre las instancias respaldadas por el almacén de instancias, consulta https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| ID de instancia | String | N/A | Sí | Es una lista separada por comas de los IDs de instancia. |
| Force | Bool | N/A | No | Si se selecciona, la acción realiza un apagado forzado (duro), lo que detiene
la instancia de inmediato sin permitir que vacíe las cachés o los metadatos del sistema de archivos.
Este proceso requiere procedimientos obligatorios de verificación y reparación del sistema de archivos antes de que la instancia pueda reanudar su funcionamiento. No se recomienda para instancias de Windows.
No está habilitada de forma predeterminada. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Tomar una instantánea
Toma una instantánea de la instancia.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| ID de instancia | String | N/A | Sí | Especifica el ID de instancia. |
| Descripción | String | N/A | No | Especifica la descripción de la instantánea. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Resultado de JSON
{
"EC2_Snapshot": [
{
"Description": "",
"Tags": [],
"Encrypted": false,
"VolumeId": "vol-ID",
"State": "pending",
"VolumeSize": 8,
"StartTime": "2022-11-13 15:45:44.795000+00:00",
"Progress": "",
"OwnerId": "OWNER_ID",
"SnapshotId": "snap-ID"
}
]
}
Finalizar instancia
Finaliza una instancia.
Las instancias finalizadas no se pueden reiniciar. Solo se pueden finalizar las instancias respaldadas por el almacén de instancias. Para obtener más información sobre las instancias respaldadas por el almacén de instancias, consulta Almacenamiento para el dispositivo raíz.
Si finalizas una instancia más de una vez, todas las llamadas se realizan correctamente. Si especificas varias instancias y la solicitud falla (por ejemplo, debido a un solo ID de instancia incorrecto), no se finaliza ninguna de las instancias.
Las instancias finalizadas permanecen visibles después de la finalización (durante aproximadamente una hora). De forma predeterminada, Amazon EC2 borra todos los volúmenes de EBS que se adjuntaron cuando se inició la instancia. Los volúmenes conectados después del inicio de la instancia siguen ejecutándose. Para obtener más información, consulta la guía del usuario de Amazon.
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| ID de instancia | String | N/A | Sí | Uno o más IDs de instancia. Separados por comas. |
Fecha de ejecución
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| is_success | Verdadero o falso | is_success:False |
Resultado de JSON
"StoppingInstances": [
{
"CurrentState": "shutting-down",
"InstanceId": "string",
"PreviousState":"running"
}
]
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de una guía: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Terminate Instance". Reason: {0}''.format(error.Stacktrace) |
General |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.