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

  1. Protege las instancias de Amazon Elastic Compute Cloud (Amazon EC2)

    1. Crea grupos de seguridad para restringir el acceso a Internet entrante y saliente a Amazon EC2.
    2. Asigna una nueva dirección IP elástica
    3. Asocia una nueva dirección IP elástica
  2. 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:

  1. Verifica la línea de visión de la red entre Google SecOps y los extremos de servicio regionales de AWS EC2.

  2. 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.

  3. 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 puerto 443/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 Owner y el valor TeamA, especifica Owner:TeamA. Puedes especificar varias combinaciones de par clave-valor separándolas con comas.

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:

  • Si se enumeraron correctamente las instancias(is_success = true): "Successfully described Amazon EC2 instances."
  • Si no hay valores disponibles(is_success = false): "No se encontraron instancias en Amazon EC2"

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 Owner y el valor TeamA, ingresa Owner:TeamA. Puedes usar filtros de etiquetas separados por comas, como Name:Name1,Owner:TeamA. Los grupos que se devuelvan deben coincidir con todos los filtros.

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:

  • Si se enumeran correctamente los grupos(is_success = true): "Successfully described Amazon EC2 security groups."
  • Si no hay valores disponibles(is_success = false): "No se encontraron grupos de seguridad en Amazon EC2"

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:

  • Si el estado actual de todas o algunas instancias es diferente de pendiente o en ejecución (Is_success = false): No se pueden iniciar las siguientes instancias desde su estado actual: <failed_instance ids>
  • Si el estado actual es pendiente, la acción aún está en curso: Continuando… las instancias solicitadas aún están pendientes
  • Si el estado actual es en ejecución (is_success=true): Imprime: Se iniciaron correctamente las siguientes instancias: <running_instance ids>
  • Si una de las instancias no es válida (is_success =false): Las siguientes instancias no son válidas: <not valid ids>. Vuelve a intentarlo.

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:

  • Si el estado actual de todas o algunas instancias es diferente de shutting-down o terminated (Is_success = false): No se pueden finalizar las siguientes instancias desde su estado actual: <failed_instance ids>
  • Si el estado actual es shutting-down: (is_success=true) → la acción sigue en curso: Continuando… las instancias solicitadas aún se están cerrando
  • Si el estado actual es finalizado (is_success=true): Se finalizaron correctamente las siguientes instancias: <stopped_instance ids>
  • Si una de las instancias no es válida (is_success =false): Las siguientes instancias no son válidas: <not valid ids>. Vuelve a intentarlo.

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.