Recopila registros de Tanium Discover

Compatible con:

En este documento, se explica cómo transferir registros de Tanium Discover a Google Security Operations con Amazon S3 a través de la capacidad de exportación nativa de S3 de Tanium Connect. Tanium Discover detecta automáticamente las interfaces de red y los recursos en todo tu entorno, lo que proporciona visibilidad de los extremos administrados y no administrados, los dispositivos de red y otros sistemas conectados. El analizador extrae campos de los registros JSON, transforma campos específicos, como direcciones MAC y la información del SO, y los asigna al UDM. Controla varios tipos de datos, agrega metadatos, como detalles del proveedor y del producto, y combina los campos extraídos en la estructura final del evento de UDM.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Acceso con privilegios a Tanium Connect y Tanium Console
  • Tanium Discover 2.11 o una versión posterior instalada y configurada
  • Acceso con privilegios a AWS (S3, IAM)

Configura el bucket de AWS S3 y la IAM para Google SecOps

  1. Crea un bucket de Amazon S3 siguiendo esta guía del usuario: Cómo crear un bucket
  2. Guarda el Nombre y la Región del bucket para consultarlos en el futuro (por ejemplo, tanium-discover-logs).
  3. Crea un usuario siguiendo esta guía del usuario: Crea un usuario de IAM.
  4. Selecciona el usuario creado.
  5. Selecciona la pestaña Credenciales de seguridad.
  6. Haz clic en Crear clave de acceso en la sección Claves de acceso.
  7. Selecciona Servicio de terceros como el Caso de uso.
  8. Haz clic en Siguiente.
  9. Opcional: Agrega una etiqueta de descripción.
  10. Haz clic en Crear clave de acceso.
  11. Haz clic en Download CSV file para guardar la Access Key y la Secret Access Key para usarlas más adelante.
  12. Haz clic en Listo.
  13. Selecciona la pestaña Permisos.
  14. Haz clic en Agregar permisos en la sección Políticas de permisos.
  15. Selecciona Agregar permisos.
  16. Selecciona Adjuntar políticas directamente.
  17. Busca y selecciona la política AmazonS3FullAccess.
  18. Haz clic en Siguiente.
  19. Haz clic en Agregar permisos.

Configura los permisos en el bucket de Amazon S3

  1. En la consola de Amazon S3, elige el bucket que creaste antes.
  2. Haz clic en Permisos > Política de bucket.
  3. En el Editor de políticas de bucket, agrega la siguiente política:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::YOUR_ACCOUNT_ID:user/tanium-connect-s3-user"
          },
          "Action": [
            "s3:PutObject",
            "s3:PutObjectAcl",
            "s3:GetObject",
            "s3:ListBucket"
          ],
          "Resource": [
            "arn:aws:s3:::tanium-discover-logs",
            "arn:aws:s3:::tanium-discover-logs/*"
          ]
        }
      ]
    }
    
  4. Reemplaza las siguientes variables:

    • Cambia YOUR_ACCOUNT_ID por el ID de tu cuenta de AWS.
    • Cambia tanium-discover-logs por el nombre real de tu bucket si es diferente.
    • Cambia tanium-connect-s3-user por tu nombre de usuario de IAM real si es diferente.
  5. Haz clic en Guardar.

Configura Tanium Connect para la exportación a S3

  1. Accede a la consola de Tanium como administrador.
  2. Ve a Tanium Connect > Connections.
  3. Haz clic en Create Connection.
  4. En la sección Información general, proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa un nombre descriptivo (por ejemplo, Tanium Discover to S3).
    • Descripción: Ingresa una descripción significativa (por ejemplo, Export Tanium Discover interface data to S3 for Google SecOps ingestion).
    • Habilitar: Selecciona esta opción para habilitar la conexión.
    • Nivel de registro: Selecciona Información (predeterminado) o ajústalo según sea necesario.
  5. En la sección Configuración, en Fuente, selecciona Tanium Discover.
  6. Establece la configuración de la fuente de descubrimiento:
    • Tipo de informe: Selecciona el tipo de interfaces que quieres exportar:
      • Todas: Exporta todas las interfaces de Descubre.
      • Administradas: Exporta las interfaces que tienen instalado el cliente de Tanium.
      • No administradas: Exporta las interfaces que no tienen instalado el cliente de Tanium.
      • Con etiqueta: Exporta todas las interfaces que tienen una etiqueta aplicada.
      • Sin etiquetar: Exporta interfaces que no tengan ninguna etiqueta aplicada.
      • Ignoradas: Exporta las interfaces marcadas como ignoradas.
      • No administrable: Exporta las interfaces que se marcaron como no administrables.
  7. En Destino, selecciona AWS S3.
  8. Proporciona los siguientes detalles de configuración:
    • Nombre del destino: Ingresa un nombre (por ejemplo, Google SecOps S3 Bucket).
    • Clave de acceso de AWS: Ingresa el ID de la clave de acceso del usuario de IAM que creaste antes.
    • Clave secreta de AWS: Ingresa la clave de acceso secreta del usuario de IAM que creaste antes.
    • Nombre del bucket: Ingresa el nombre de tu bucket de S3 (por ejemplo, tanium-discover-logs).
    • Ruta de acceso del bucket: Opcional. Ingresa un prefijo de ruta de acceso (por ejemplo, tanium/discover/).
    • Región: Selecciona la región de AWS en la que reside tu bucket (por ejemplo, us-east-1).
  9. En la sección Formato, configura el formato de salida:
    • Tipo de formato: Selecciona JSON.
    • Incluir encabezados de columna: Selecciona esta opción si quieres que se incluyan los encabezados de columna.
    • Generar documento: Desmarca esta opción para enviar datos JSON sin procesar.
  10. Opcional: En la sección Configurar salida, configura los filtros:
    • Filtro: Puedes usar filtros para exportar etiquetas específicas. Por ejemplo, si deseas exportar todas las interfaces etiquetadas con "Interfaz perdida", aplica un filtro de expresión regular y escribe "Interfaz perdida" como el texto que debe coincidir en la columna de destino Etiquetas.
    • Columnas personalizadas: Agrega las columnas personalizadas que sean relevantes para tu caso de uso.
  11. En la sección Programación, configura cuándo se ejecuta la conexión:
    • Tipo de programa: Selecciona Cron.
    • Expresión cron: Ingresa una expresión cron para las exportaciones periódicas (por ejemplo, 0 */6 * * * para cada 6 horas).
    • Fecha de inicio: Establece la fecha de inicio de la programación.
  12. Haz clic en Guardar cambios.
  13. En la página Descripción general de Connect, ve a Conexiones.
  14. Haz clic en la conexión que creaste (Tanium Discover a S3).
  15. Haz clic en Ejecutar ahora para probar la conexión.
  16. Confirma que quieres ejecutar la conexión.
  17. Supervisa el estado de la conexión y verifica que los datos de la interfaz de Discover se exporten a tu bucket de S3.

Opcional: Crea un usuario y claves de IAM de solo lectura para Google SecOps

  1. Ve a AWS Console > IAM > Users > Add users.
  2. Haz clic en Agregar usuarios.
  3. Proporciona los siguientes detalles de configuración:
    • Usuario: Ingresa secops-reader.
    • Tipo de acceso: Selecciona Clave de acceso: Acceso programático.
  4. Haz clic en Create user.
  5. Adjunta la política de lectura mínima (personalizada): Users > secops-reader > Permissions > Add permissions > Attach policies directly > Create policy.
  6. En el editor de JSON, ingresa la siguiente política:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject"],
          "Resource": "arn:aws:s3:::tanium-discover-logs/*"
        },
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::tanium-discover-logs"
        }
      ]
    }
    
  7. Configura el nombre como secops-reader-policy.

  8. Ve a Crear política > buscar/seleccionar > Siguiente > Agregar permisos.

  9. Ve a Security credentials > Access keys > Create access key.

  10. Descarga el archivo CSV (estos valores se ingresan en el feed).

Configura un feed en Google SecOps para transferir registros de Tanium Discover

  1. Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
  2. Haz clic en + Agregar feed nuevo.
  3. En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo, Tanium Discover logs).
  4. Selecciona Amazon S3 V2 como el Tipo de fuente.
  5. Selecciona Tanium Discover como el Tipo de registro.
  6. Haz clic en Siguiente.
  7. Especifica valores para los siguientes parámetros de entrada:
    • URI de S3: s3://tanium-discover-logs/tanium/discover/ (ajusta la ruta de acceso si usaste un nombre de bucket o una ruta de acceso diferentes).
    • Opciones de eliminación de la fuente: Selecciona la opción de eliminación según tu preferencia.
    • Antigüedad máxima del archivo: Incluye los archivos modificados en la última cantidad de días. El valor predeterminado es 180 días.
    • ID de clave de acceso: Es la clave de acceso del usuario con acceso al bucket de S3 (del usuario con acceso de lectura que se creó anteriormente).
    • Clave de acceso secreta: Es la clave secreta del usuario con acceso al bucket de S3 (del usuario con acceso de lectura que se creó anteriormente).
    • Espacio de nombres del recurso: Es el espacio de nombres del recurso.
    • Etiquetas de transferencia: Es la etiqueta que se aplicará a los eventos de este feed.
  8. Haz clic en Siguiente.
  9. Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
CentralizedNmap principal.asset.attribute.labels.key El analizador asigna el valor "CentralizedNmap".
CentralizedNmap principal.asset.attribute.labels.value Se toma directamente del campo CentralizedNmap en el registro sin procesar y se convierte en una cadena.
IpAddress principal.asset.ip Se toma directamente del campo IpAddress en el registro sin procesar.
IpAddress principal.ip Se toma directamente del campo IpAddress en el registro sin procesar.
Labels principal.asset.attribute.labels.key El analizador asigna el valor "Labels".
Labels principal.asset.attribute.labels.value Se toma directamente del campo Labels en el registro sin procesar.
MacAddress principal.asset.mac Se toma directamente del campo MacAddress en el registro sin procesar, los guiones se reemplazan por dos puntos y el valor se convierte en minúsculas.
MacAddress principal.asset.product_object_id Concatena "TANIUM:" con el campo MacAddress (después de convertirlo a minúsculas y reemplazar los guiones por dos puntos).
MacAddress principal.mac Se toma directamente del campo MacAddress en el registro sin procesar, los guiones se reemplazan por dos puntos y el valor se convierte en minúsculas.
MacOrganization principal.asset.attribute.labels.key El analizador asigna el valor "MacOrganization".
MacOrganization principal.asset.attribute.labels.value Se toma directamente del campo MacOrganization en el registro sin procesar y se convierte en una cadena.
Managed principal.asset.attribute.labels.key El analizador asigna el valor "Administrado".
Managed principal.asset.attribute.labels.value Se toma directamente del campo Managed en el registro sin procesar y se convierte en una cadena.
Os principal.asset.platform_software.platform Si Os es "Windows", el valor se establece en "WINDOWS". Si Os es "Linux", el valor se establece en "LINUX". De lo contrario, el valor se establece en "UNKNOWN_PLATFORM".
Os principal.platform Si Os es "Windows", el valor se establece en "WINDOWS". Si Os es "Linux", el valor se establece en "LINUX". De lo contrario, el valor se establece en "UNKNOWN_PLATFORM".
OsGeneration principal.asset.platform_software.platform_version Se toma directamente del campo OsGeneration en el registro sin procesar y se convierte en una cadena.
OsGeneration principal.platform_version Se toma directamente del campo OsGeneration en el registro sin procesar y se convierte en una cadena.
Ports principal.asset.attribute.labels.key El analizador asigna el valor "Puertos".
Ports principal.asset.attribute.labels.value Se toma directamente del campo Ports en el registro sin procesar.
Profile principal.asset.attribute.labels.key El analizador asigna el valor "Profile".
Profile principal.asset.attribute.labels.value Se toma directamente del campo Profile en el registro sin procesar.
TaniumComputerId principal.asset.attribute.labels.key El analizador asigna el valor "TaniumComputerId".
TaniumComputerId principal.asset.attribute.labels.value Se toma directamente del campo TaniumComputerId en el registro sin procesar y se convierte en una cadena.
Unmanageable principal.asset.attribute.labels.key El analizador asigna el valor "Unmanageable".
Unmanageable principal.asset.attribute.labels.value Se toma directamente del campo Unmanageable en el registro sin procesar y se convierte en una cadena. Se toma del campo time en el registro sin procesar, se analiza y se convierte en segundos de ciclo. El analizador asigna el valor "SCAN_NETWORK". El analizador asigna el valor "TANIUM_DISCOVER". El analizador asigna el valor "Descubre". El analizador asigna el valor "Tanium". Se toma directamente del campo HostName en el registro sin procesar. Se toma del campo time en el registro sin procesar, se analiza y se convierte en segundos de ciclo.

Registro de cambios

Consulta el registro de cambios de este analizador

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