Integra AWS S3 con Google SecOps
En este documento, se describe cómo integrar AWS S3 con Google Security Operations.
Casos de uso
- Administra buckets
- Descarga archivos de buckets
- 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:
Verifica la línea de visión de la red entre Google SecOps y los extremos de servicio regionales de AWS S3.
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 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.comos3.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 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:
|
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.