Integra AWS S3 con Google SecOps

En este documento, se describe cómo integrar AWS S3 con Google Security Operations.

Casos de uso

  1. Administra buckets
  2. Descarga archivos de buckets
  3. Sube archivos a buckets

Antes de comenzar

Antes de configurar la integración de AWS S3 en Google SecOps, verifica que tu entorno de red y tus 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 S3.

  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 S3 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 agente remoto al extremo regional de AWS S3 (s3.<region>.amazonaws.com o s3.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 S3 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 un 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 bucket necesarios para tus flujos de trabajo automatizados y rota las credenciales de forma periódica.

    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 S3 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
Descarga un archivo de un bucket s3:GetObject s3:ListAllMyBuckets Descarga un objeto de un bucket de S3. Recurso: arn:aws:s3:::<bucket-name>/*.
Obtén la política de bucket s3:GetBucketPolicy s3:ListAllMyBuckets Recupera la política de acceso del bucket. Recurso: arn:aws:s3:::<bucket-name>.
Enumera objetos de bucket s3:ListBucket s3:ListAllMyBuckets Enumera los objetos dentro de un bucket de S3. Recurso: arn:aws:s3:::<bucket-name>.
Enumera buckets s3:ListAllMyBuckets — Enumera todos los buckets de S3 que pertenecen a la cuenta. Recurso: *.
Ping s3:ListAllMyBuckets — Valida la conectividad de la integración. Recurso: *.
Establece la política del bucket s3:PutBucketPolicy s3:ListAllMyBuckets Establece o modifica una política de bucket de S3. Recurso: arn:aws:s3:::<bucket-name>.
Sube un archivo al bucket s3:PutObject s3:ListAllMyBuckets Sube un objeto a un bucket de S3. Recurso: arn:aws:s3:::<bucket-name>/*.

Referencia rápida (ActionName:Permission)

Usa la siguiente referencia rápida para revisar los permisos necesarios para cada acción:

Ping: s3:ListAllMyBuckets
Download File From Bucket: s3:GetObject, s3:ListAllMyBuckets
Get Bucket Policy: s3:GetBucketPolicy, s3:ListAllMyBuckets
List Bucket Objects: s3:ListBucket, s3:ListAllMyBuckets
List Buckets: s3:ListAllMyBuckets
Set Bucket Policy: s3:PutBucketPolicy, s3:ListAllMyBuckets
Upload File To Bucket: s3:PutObject, s3:ListAllMyBuckets

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 S3 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": "SecOpsS3Discovery",
      "Effect": "Allow",
      "Action": [
        "s3:ListAllMyBuckets"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsS3BucketOperations",
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket",
        "s3:GetBucketPolicy",
        "s3:PutBucketPolicy"
      ],
      "Resource": "arn:aws:s3:::*"
    },
    {
      "Sid": "SecOpsS3ObjectOperations",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject"
      ],
      "Resource": "arn:aws:s3:::*/*"
    }
  ]
}

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.
Ejecuta de forma remota Casilla de verificación Desmarcado No Marca el campo para ejecutar la integración configurada de forma remota. Una vez que se marca, aparece la opción para seleccionar el usuario remoto (agente).

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.

Descarga un archivo de un bucket

Descarga el archivo del bucket en AWS S3.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Ruta de acceso al archivo del bucket String s3://{bucket_name}/{file_name} Sí Especifica la ruta de acceso al archivo en el bucket. Ejemplo: s3://siemplify/syslog/log.txt
Ruta de descarga String N/A Sí Especifica la ruta de acceso en la que se descargará el archivo.

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
{
"bucket_file_path": "s3://testsiemplify/test/123.txt"
"download_path": "/usr/bin/share/download.txt"
}

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 código de estado == 200 (is_success = true) "Successfully downloaded '{0}' from AWS S3".format(bucket_file_path)

Si se muestra otro código de estado (is_success=false): "Action wasn't able to download '{0}' from AWS S3. Motivo: Ya existe un archivo con esa ruta de descarga".

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, errores del SDK, entre otros: "Error executing action "Download File From Bucket". Reason: {0}''.format(error.Stacktrace)

General

Obtén la política del bucket

Recupera información sobre la política del bucket de AWS S3.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del bucket String N/A Sí Especifica el nombre del bucket del que se recuperará la información de la política.

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
{
    "Policy": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AddPerm",
                "Effect": "Allow",
                "Principal": "*",
                "Action": "s3:GetObject",
                "Resource": "arn:aws:s3:::testsiemplify/*"
            }
        ]
    }
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 código de estado == 200 (is_success = true) "Successfully retrieved information about the policy of the "{0}" bucket in AWS S3".format(bucket_name)

Si se muestra otro código de estado (is_success=false): "Action wasn't able to return information about the policy of the '{0}' bucket in AWS S3".format(bucket_name)

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Get Bucket Policy". Reason: {0}''.format(error.Stacktrace)

General

Enumera los objetos del bucket

Permite que el usuario desactive una cuenta de usuario. El cuerpo de la solicitud contiene el usuario que se inhabilitará. La propiedad de cuenta habilitada de la cuenta debe establecerse en false.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del bucket String N/A Sí Especifica el nombre del bucket del que se recuperarán los objetos.
Cantidad máxima de objetos que se mostrarán Número entero N/A No Especifica cuántos objetos se deben mostrar.

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
"Contents": [
        {
            "Key": "text.txt",
            "LastModified": %Y-%m-%dT%H:%M:%S,
            "ETag": "d41d8cd98f00b204e9800998ecf8427e",
            "Size": 0,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "lab_aws",
                "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
            }
        },
        {
            "Key": "text_1.txt",
            "LastModified": %Y-%m-%dT%H:%M:%S,
            "ETag": "d41d8cd98f00b204e9800998ecf8427e",
            "Size": 0,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "lab_aws",
                "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
            }
        }
    ]
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 código de estado == 200 (is_success = true) "Successfully returned objects of the "{0}" bucket in AWS S3".format(bucket_name)

Si hay otro código de estado (is_success=false): "Action wasn't able to return objects of the '{0}' bucket in AWS S3".format(bucket_name)

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "List Bucket Objects". Reason: {0}''.format(error.Stacktrace)

General
Tabla del muro de casos

Nombre de la tabla: Objetos del bucket '{0}'

Columnas:

  • Key (asignada como Key)
  • Última modificación (asignada como LastModified)
  • Tamaño (bytes) (asignado como Tamaño)
  • Propietario (asignado como Owner/DisplayName)
  • Clase de almacenamiento (asignada como clase de almacenamiento)
General

Enumera buckets

Recuperar una lista de buckets de AWS S3

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
{
    "Buckets": [
        {
            "CreationDate": %Y-%m-%dT%H:%M:%S,
            "Name": "testsiemplify"
        }
    ],
    "Owner": {
        "DisplayName": "lab_aws",
        "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
    },
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 código de estado == 200 (is_success = true) "Successfully listed available buckets in AWS S3".

Si hay otro código de estado (is_success=false): "Action wasn't able to list available buckets in AWS S3.

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error al ejecutar la acción "Listar buckets". Reason: {0}''.format(error.Stacktrace)

General

Ping

Prueba la conectividad con AWS S3 con los parámetros proporcionados en la página de configuración de la integración en la página del Centro de contenido de Google SecOps.

Casos de uso

Prueba la conectividad.

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, haz lo siguiente:

"Se estableció correctamente la conexión con el servidor de AWS S3 con los parámetros de conexión proporcionados".

La acción debería fallar y detener la ejecución de una guía:

De lo contrario, haz lo siguiente:

"No se pudo establecer la conexión con el servidor de AWS S3. Error is {0}".format(exception.stacktrace)

General

Establece la política del bucket

Establece una política en el bucket de AWS S3.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del bucket String N/A Sí Especifica el nombre del bucket en el que deseas actualizar la política.
Objeto JSON de la política String N/A Sí Especifica el objeto JSON de la política que deseas establecer para el bucket. Puedes encontrar ejemplos aquí: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html.

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
bucket_policy = {
    'Version': '2012-10-17',
    'Statement': [{
        'Sid': 'AddPerm',
        'Effect': 'Allow',
        'Principal': '*',
        'Action': ['s3:GetObject'],
        'Resource': f'arn:aws:s3:::{bucket_name}/*'
    }]
}
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:

If status code == 204 (is_success = true) "Successfully updated policy of the "{0}" bucket in AWS S3".format(bucket_name)

Si hay otro código de estado (is_success=false): "Action wasn't able to update the policy of the '{0}' bucket in AWS S3".format(bucket_name)

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error al ejecutar la acción "Establecer política de bucket". Reason: {0}''.format(error.Stacktrace)

Sube un archivo al bucket

Sube un archivo al bucket en AWS S3.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Ruta de acceso al archivo String N/A Sí Especifica la ruta de acceso al archivo que se debe subir.
Ruta de carga del bucket String s3://{bucket_name}/{file_name} Sí Especifica la ruta de acceso en el bucket a la que se debe subir la ruta de acceso. Ejemplo: s3://siemplify/syslog/log.txt

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
{
"bucket_upload_path": "s3://testsiemplify/test/123.txt"
"file_path": "/usr/bin/share/download.txt"
}
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 código de estado == 200 (is_success = true) "Successfully uploaded '{0}' to AWS S3 {1} bucket".format(file_path, bucket name aka first string after s3://)

Si el archivo no existe (is_success = false) "Action wasn't able to upload '{0}' to AWS S3. Motivo: No existe el archivo con esa ruta de carga".

La acción debería fallar y detener la ejecución de una guía:

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, errores del SDK, entre otros: "Error executing action "Upload File To Bucket". Reason: {0}''.format(error.Stacktrace)

General

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.