Guía de uso de UDM
En este documento, se proporciona lo siguiente:
- Descripciones detalladas de los campos del esquema del modelo de datos unificado (UDM)
- Campos obligatorios y opcionales para los tipos de entidades
- Campos obligatorios y opcionales para cada tipo de evento
Para obtener detalles sobre campos de UDM específicos (por ejemplo, números de enumeración), consulta la lista de campos del modelo de datos unificado.
Formatos de nombres de campos de UDM:
- Para la evaluación del motor de reglas, el prefijo comienza con udm.
- Para el normalizador basado en la configuración (CBN), el prefijo comienza con event.idm.read_only_udm.
Propagación de metadatos de eventos
La sección de metadatos de eventos para eventos de UDM almacena información general sobre cada evento.
Metadata.event_type
- Propósito: Especifica el tipo de evento. Si un evento tiene varios tipos posibles, este valor debe especificar el tipo más específico.
- Obligatorio: Sí.
- Codificación: Debe ser uno de los tipos enumerados de
event_typede UDM predefinidos. - Valores posibles: En las siguientes secciones, se enumeran todos los valores posibles para
metadata.event_typedentro del UDM. Para conocer los campos obligatorios y opcionales de cada categoría, consulta Campos obligatorios y opcionales para cada tipo de evento.
Eventos para analistas
- ANALYST_ADD_COMMENT
- ANALYST_UPDATE_PRIORITY
- ANALYST_UPDATE_REASON
- ANALYST_UPDATE_REPUTATION
- ANALYST_UPDATE_RISK_SCORE
- ANALYST_UPDATE_ROOT_CAUSE
- ANALYST_UPDATE_SEVERITY_SCORE
- ANALYST_UPDATE_STATUS
- ANALYST_UPDATE_VERDICT
Eventos del dispositivo
Eventos relacionados con actualizaciones de firmware, configuración o programas en un dispositivo (como un sistema de control industrial o un recurso de tecnología operativa):
- DEVICE_CONFIG_UPDATE
- DEVICE_FIRMWARE_UPDATE
- DEVICE_PROGRAM_DOWNLOAD
- DEVICE_PROGRAM_UPLOAD
Eventos de correo electrónico
Eventos relacionados con las transacciones de correo electrónico y las inspecciones de seguridad de correo electrónico:
- EMAIL_UNCATEGORIZED
- EMAIL_TRANSACTION
- EMAIL_URL_CLICK (obsoleto)
Eventos que no se especifican
Es el valor de marcador de posición para un tipo de evento sin inicializar (los eventos establecidos en EVENTTYPE_UNSPECIFIED no pasan la validación de UDM):
- EVENTTYPE_UNSPECIFIED
Eventos de archivo realizados en un extremo
- FILE_UNCATEGORIZED
- FILE_COPY (por ejemplo, copiar un archivo en una unidad de memoria USB)
- FILE_CREATION
- FILE_DELETION
- FILE_MODIFICATION
- FILE_MOVE
- FILE_OPEN (por ejemplo, abrir un archivo podría indicar una violación de la seguridad)
- FILE_READ (por ejemplo, leer un archivo de contraseñas)
- FILE_SYNC
Eventos que no se incluyen en ninguna otra categoría
Son eventos que no se incluyen en ninguna otra categoría, incluidos los eventos del sistema operativo sin clasificar:
- GENERIC_EVENT
Eventos de actividad grupal
Eventos relacionados con la creación, modificación o eliminación de grupos de usuarios o del sistema:
- GROUP_UNCATEGORIZED
- GROUP_CREATION
- GROUP_DELETION
- GROUP_MODIFICATION
Eventos de exclusión mutua
Eventos relacionados con la creación o administración de un objeto de exclusión mutua (mutex) en un extremo:
- MUTEX_UNCATEGORIZED
- MUTEX_CREATION
Eventos de telemetría de red
Eventos de telemetría de red, que incluyen cargas útiles de protocolo sin procesar, como DHCP y DNS, así como resúmenes de protocolos como HTTP, SMTP y FTP, y eventos de flujo y conexión de NetFlow y firewalls:
- NETWORK_UNCATEGORIZED
- NETWORK_CONNECTION (por ejemplo, detalles de la conexión de red de un firewall)
- NETWORK_DHCP
- NETWORK_DNS
- NETWORK_FLOW (por ejemplo, estadísticas de flujo agregadas de Netflow)
- NETWORK_FTP
- NETWORK_HTTP
- NETWORK_SMTP
Procesa eventos
Cualquier evento relacionado con un proceso, como el inicio de un proceso, un proceso que crea algo malicioso, un proceso que se inserta en otro proceso, un cambio de una clave de registro o la creación de un archivo malicioso en el disco:
- PROCESS_UNCATEGORIZED
- PROCESS_INJECTION
- PROCESS_LAUNCH
- PROCESS_MODULE_LOAD
- PROCESS_OPEN
- PROCESS_PRIVILEGE_ESCALATION
- PROCESS_TERMINATION
Eventos de registro
Usa los siguientes eventos de REGISTRY en lugar de los eventos de SETTING cuando se trate de eventos de registro específicos de Microsoft Windows:
- REGISTRY_UNCATEGORIZED
- REGISTRY_CREATION
- REGISTRY_MODIFICATION
- REGISTRY_DELETION
Eventos de recursos
Eventos relacionados con la creación, lectura, escritura, eliminación o cambio de permisos en un recurso:
- RESOURCE_CREATION
- RESOURCE_DELETION
- RESOURCE_PERMISSIONS_CHANGE
- RESOURCE_READ
- RESOURCE_WRITTEN
Eventos orientados al análisis
Los eventos orientados a análisis incluyen análisis a pedido y detecciones de comportamiento que realizan los productos de seguridad de red o de extremos (como EDR, antivirus, escáneres de vulnerabilidades o DLP):
- SCAN_UNCATEGORIZED
- SCAN_FILE
- SCAN_HOST
- SCAN_NETWORK
- SCAN_PROCESS
- SCAN_PROCESS_BEHAVIORS (obsoleto)
- SCAN_VULN_HOST
- SCAN_VULN_NETWORK
Eventos de tareas programadas (Programador de tareas de Windows, cron, etc.)
- SCHEDULED_TASK_UNCATEGORIZED
- SCHEDULED_TASK_CREATION
- SCHEDULED_TASK_DELETION
- SCHEDULED_TASK_DISABLE
- SCHEDULED_TASK_ENABLE
- SCHEDULED_TASK_MODIFICATION
Eventos de servicio
Eventos relacionados con la creación, eliminación, modificación, inicio o detención de un servicio de sistema operativo o aplicación:
- SERVICE_UNSPECIFIED
- SERVICE_CREATION
- SERVICE_DELETION
- SERVICE_MODIFICATION
- SERVICE_START
- SERVICE_STOP
Eventos de configuración
Para establecer los requisitos de los eventos, consulta SETTING_UNCATEGORIZED, SETTING_CREATION, SETTING_MODIFICATION, SETTING_DELETION.
Eventos de configuración, incluido cuando se cambia un parámetro de configuración del sistema en un extremo:
- SETTING_UNCATEGORIZED
- SETTING_CREATION
- SETTING_DELETION
- SETTING_MODIFICATION
Mensajes de estado de los productos de seguridad
Mensajes de estado de productos de seguridad para indicar que los agentes están activos y para enviar datos de versión, huella digital o de otro tipo:
- STATUS_UNCATEGORIZED
- STATUS_HEARTBEAT (indica que el producto está activo)
- STATUS_STARTUP
- STATUS_SHUTDOWN
- STATUS_UPDATE (actualización de software o huella digital)
Eventos de registro de auditoría del sistema
- SYSTEM_AUDIT_LOG_UNCATEGORIZED
- SYSTEM_AUDIT_LOG_WIPE
Eventos de actividad de autenticación de usuarios
- USER_UNCATEGORIZED
- USER_BADGE_IN (por ejemplo, cuando un usuario ingresa físicamente a un sitio con su credencial)
- USER_CHANGE_PASSWORD
- USER_CHANGE_PERMISSIONS
- USER_COMMUNICATION
- USER_CREATION
- USER_DELETION
- USER_LOGIN
- USER_LOGOUT
- USER_RESOURCE_ACCESS
- USER_RESOURCE_CREATION
- USER_RESOURCE_DELETION
- USER_RESOURCE_UPDATE_CONTENT
- USER_RESOURCE_UPDATE_PERMISSIONS
- USER_STATS (obsoleto)
Metadata.collected_timestamp
- Propósito: Codifica la marca de tiempo GMT en la que la infraestructura de recopilación local del proveedor recopiló el evento.
- Codificación: RFC 3339, según corresponda para el formato de marca de tiempo JSON o Proto3.
- Ejemplo:
- RFC 3339: '2019-09-10T20:32:31-08:00'
- Formato de Proto3: '2012-04-23T18:25:43.511Z'
Metadata.event_timestamp
- Propósito: Codifica la marca de tiempo de GMT cuando se generó el evento.
- Obligatorio: Sí
- Codificación: RFC 3339, según corresponda para el formato de marca de tiempo JSON o Proto3.
- Ejemplo:
- RFC 3339: 2019-09-10T20:32:31-08:00
- Formato de Proto3: 2012-04-23T18:25:43.511Z
Metadata.description
- Propósito: Es una descripción legible por humanos del evento.
- Codificación: Cadena alfanumérica, se permite puntuación, 1,024 bytes como máximo
- Ejemplo: Se bloqueó el acceso del archivo c:\bar\foo.exe al documento sensible c:\documents\earnings.docx.
Metadata.product_event_type
- Propósito: Es el nombre o tipo de evento breve, descriptivo, legible por humanos y específico del producto.
- Codificación: Cadena alfanumérica, se permite puntuación, 64 bytes como máximo.
- Ejemplos:
- Evento de creación de registro
- ProcessRollUp
- Se detectó una elevación de privilegios
- Malware bloqueado
Metadata.product_log_id
- Propósito: Codifica un identificador de evento específico del proveedor para identificar el evento de forma única (un GUID). Los usuarios pueden usar este identificador para buscar el evento en cuestión en la consola de propiedad del proveedor.
- Codificación: Cadena alfanumérica que distingue mayúsculas de minúsculas, se permite la puntuación, 256 bytes como máximo.
- Ejemplo: ABcd1234-98766
Metadata.product_name
- Propósito: Especifica el nombre del producto.
- Codificación: Cadena alfanumérica que distingue mayúsculas de minúsculas, se permite la puntuación, 256 bytes como máximo.
- Ejemplos:
- Falcon
- Symantec Endpoint Protection
Metadata.product_version
- Propósito: Especifica la versión del producto.
- Codificación: Cadena alfanumérica, se permiten puntos y guiones, 32 bytes como máximo
- Ejemplos:
- 1.2.3b
- 10.3:rev1
Metadata.url_back_to_product
- Propósito: Es la URL que vincula a un sitio web pertinente en el que puedes ver más información sobre este evento específico (o la categoría general del evento).
- Codificación: URL válida según el estándar RFC 3986 con parámetros opcionales, como información del puerto, etc. Debe tener un prefijo de protocolo antes de la URL (por ejemplo, https:// o http://).
- Ejemplo: https://newco.altostrat.com:8080/event_info?event_id=12345
Metadata.vendor_name
- Propósito: Especifica el nombre del proveedor del producto.
- Codificación: Cadena alfanumérica que distingue mayúsculas de minúsculas, se permite la puntuación, 256 bytes como máximo
- Ejemplos:
- CrowdStrike
- Symantec
Propagación de metadatos de sustantivos
En esta sección, la palabra Sustantivo es un término general que se usa para representar las siguientes entidades: principal, src, target, intermediary, observer y about. Estas entidades tienen atributos comunes, pero representan objetos diferentes en un evento. Para obtener más información sobre las entidades y lo que cada una representa en un evento, consulta Cómo dar formato a un evento de UDM.
Noun.asset_id
- Propósito: Identificador único del dispositivo específico del proveedor (por ejemplo, un GUID que se genera cuando se instala un software de seguridad de extremos en un dispositivo nuevo que se usa para hacer un seguimiento de ese dispositivo único a lo largo del tiempo).
- Codificación: (VendorName o VendorAbbreviation):ID, donde VendorName o VendorAbbreviation es un nombre de proveedor que no distingue mayúsculas de minúsculas, como
Carbon BlackoCB, y el ID es un identificador de cliente específico del proveedor que es único a nivel global en el entorno de su cliente (por ejemplo, un GUID o un valor único que identifica un dispositivo único). VendorName es alfanumérico y no tiene más de 32 caracteres. El ID puede tener un máximo de 128 caracteres y puede incluir caracteres alfanuméricos, guiones y puntos. - Ejemplo:
CrowdStrike:0bce4259-4ada-48f3-a904-9a526b01311f - Ejemplo:
CS:0bce4259-4ada-48f3-a904-9a526b01311f
Noun.email
- Propósito: Dirección de correo electrónico
- Codificación: Es el formato estándar de la dirección de correo electrónico.
- Ejemplo: juans@test.altostrat.com
Noun.file
- Propósito: Metadatos detallados de los archivos.
- Tipo: Objeto
- Consulta Propagación de metadatos de archivos.
Noun.hostname
- Propósito: Campo de nombre de host o nombre de dominio del cliente. No incluyas este atributo si hay una URL presente.
- Codificación: Nombre de host RFC 1123 válido.
- Restricción de validación: Las cadenas de nombres de host no deben superar los 255 bytes de longitud para cumplir con los límites de indexación de la búsqueda.
- Ejemplos:
- userwin10
- www.altostrat.com
Noun.platform
- Propósito: Sistema operativo de la plataforma.
- Codificación: Enum
- Valores posibles:
- LINUX
- MAC
- WINDOWS
- UNKNOWN_PLATFORM
Noun.platform_patch_level
- Propósito: Es el nivel de parche del sistema operativo de la plataforma.
- Codificación: Cadena alfanumérica con puntuación, 64 caracteres como máximo.
- Ejemplo: Compilación 17134.48
Noun.platform_version
- Propósito: Versión del sistema operativo de la plataforma.
- Codificación: Cadena alfanumérica con puntuación, 64 caracteres como máximo.
- Ejemplo: Microsoft Windows 10, versión 1803
Noun.process
- Propósito: Metadatos detallados del proceso.
- Tipo: Objeto
- Consulta Propagación de metadatos de Process.
Noun.ip
- Objetivo:
- Es una dirección IP única asociada con una conexión de red.
- Una o más direcciones IP asociadas con un dispositivo participante en el momento del evento (por ejemplo, si un producto de EDR conoce todas las direcciones IP asociadas con un dispositivo, puede codificarlas todas en los campos de IP).
- Codificación: Cadena de dirección IPv4 (4 bytes) o IPv6 (16 bytes) válida (RFC 5942) codificada en ASCII.
- Repetibilidad:
- Si un evento describe una conexión de red específica (por ejemplo, srcip:srcport > dstip:dstport), debes proporcionar solo una dirección IP.
- Si un evento describe la actividad general que ocurre en un dispositivo participante, pero no una conexión de red específica, puedes proporcionar todas las direcciones IP asociadas para el dispositivo en el momento del evento.
- Ejemplos:
- 192.168.1.2
- 2001:db8:1:3::1
Noun.port
- Propósito: Es el número de puerto de red de origen o destino cuando se describe una conexión de red específica dentro de un evento.
- Codificación: Número de puerto TCP/IP válido del 1 al 65,535.
Ejemplos:
- 80
- 443
Noun.mac
- Propósito: Una o más direcciones MAC asociadas con un dispositivo.
- Codificación: Dirección MAC válida de 6 bytes que cumple con el formato de identificador único extendido de 48 bits (EUI-48) codificado en ASCII.
- Repetibilidad: Puedes proporcionar todas las direcciones MAC asociadas para el dispositivo en el momento del evento.
- Ejemplos:
- 00:24:98:7B:19:02
- 00:00:5e:00:53:2a
Noun.administrative_domain
- Propósito: Es el dominio al que pertenece el dispositivo (por ejemplo, el dominio de Windows).
- Codificación: Cadena de nombre de dominio válida (128 caracteres como máximo).
- Ejemplo: corp.altostrat.com
Noun.registry
- Propósito: Metadatos detallados del registro.
- Tipo: Objeto
- Consulta Propagación de metadatos del registro
Noun.url
- Propósito: URL estándar
- Codificación: URL (RFC 3986). Debe tener un prefijo de protocolo válido (por ejemplo, https:// o ftp://). Debe incluir el dominio y la ruta de acceso completos. Puede incluir los parámetros de la URL.
- Ejemplo: https://foo.altostrat.com/bletch?a=b;c=d
Noun.user
- Propósito: Metadatos detallados del usuario.
- Tipo: Objeto
- Consulta Propagación de metadatos de usuarios.
Propagación de metadatos de autenticación
Authentication.AuthType
- Propósito: Tipo de sistema con el que se asocia un evento de autenticación (UDM de Google Security Operations).
- Codificación: Tipo enumerado.
- Valores posibles:
- AUTHTYPE_UNSPECIFIED
- MACHINE: Autenticación de máquinas
- PHYSICAL: Autenticación física (por ejemplo, un lector de tarjetas de identificación)
- SSO
- TACACS: Protocolo de la familia TACACS para la autenticación de sistemas en red (por ejemplo, TACACS o TACACS+)
- VPN
Authentication.Authentication_Status
- Propósito: Describe el estado de autenticación de un usuario o una credencial específica.
- Codificación: Tipo enumerado.
- Valores posibles:
- UNKNOWN_AUTHENTICATION_STATUS: Estado de autenticación predeterminado
- ACTIVE: El método de autenticación está en estado activo.
- SUSPENDED: El método de autenticación está en un estado suspendido o inhabilitado.
- DELETED: Se borró el método de autenticación
- NO_ACTIVE_CREDENTIALS: El método de autenticación no tiene credenciales activas.
Authentication.auth_details
- Propósito: Detalles de autenticación definidos por el proveedor.
- Codificación: Cadena.
Authentication.Mechanism
- Propósito: Mecanismos que se usan para la autenticación.
- Codificación: Tipo enumerado.
- Valores posibles:
- MECHANISM_UNSPECIFIED: Es el mecanismo de autenticación predeterminado.
- BADGE_READER
- BATCH: Autenticación por lotes.
- CACHED_INTERACTIVE: Autenticación interactiva con credenciales almacenadas en caché.
- HARDWARE_KEY
- LOCAL
- MECHANISM_OTHER: Es algún otro mecanismo que no se define aquí.
- NETWORK: Autenticación de red.
- NETWORK_CLEAR_TEXT: Autenticación de texto sin encriptar de la red.
- NEW_CREDENTIALS: Autenticación con credenciales nuevas.
- OTP
- REMOTE: Autenticación remota
- REMOTE_INTERACTIVE: RDP, servicios de terminal, computación de red virtual (VNC), etcétera.
- SERVICE: Autenticación del servicio.
- UNLOCK: Autenticación de desbloqueo interactiva directa con humanos.
- USERNAME_PASSWORD
Propagación de metadatos de DHCP
Los campos de metadatos del protocolo de control dinámico de host (DHCP) capturan la información de registro del protocolo de administración de red DHCP.
Dhcp.client_hostname
- Propósito: Es el nombre de host del cliente. Consulta RFC 2132, Opciones de DHCP y extensiones de proveedor de BOOTP, para obtener más información.
- Codificación: Cadena.
- Restricción de validación: Las cadenas de opciones de nombre de host no deben superar los 255 bytes de longitud para cumplir con los límites de indexación de la búsqueda.
Dhcp.client_identifier
- Propósito: Identificador del cliente. Consulta RFC 2132, Opciones de DHCP y extensiones de proveedor de BOOTP, para obtener más información.
- Codificación: Bytes.
Dhcp.file
- Propósito: Es el nombre de archivo de la imagen de arranque.
- Codificación: Cadena.
Dhcp.flags
- Propósito: Es el valor del campo de marcas de DHCP.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.hlen
- Propósito: Longitud de la dirección de hardware.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.hops
- Propósito: Recuento de saltos de DHCP.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.htype
- Propósito: Tipo de dirección de hardware.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.lease_time_seconds
- Propósito: Es el tiempo de arrendamiento solicitado por el cliente para una dirección IP, en segundos. Consulta RFC 2132, Opciones de DHCP y extensiones de proveedor de BOOTP, para obtener más información.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.opcode
- Propósito: Código de operación de BOOTP (consulta la sección 3 de RFC 951).
- Codificación: Tipo enumerado.
- Valores posibles:
- UNKNOWN_OPCODE
- BOOTREQUEST
- BOOTREPLY
Dhcp.requested_address
- Propósito: Identificador del cliente. Consulta RFC 2132, Opciones de DHCP y extensiones de proveedor de BOOTP, para obtener más información.
- Codificación: Dirección IPv4 o IPv6 válida (RFC 5942) codificada en ASCII.
Dhcp.seconds
- Propósito: Indica los segundos transcurridos desde que el cliente comenzó el proceso de adquisición o renovación de la dirección.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.sname
- Propósito: Es el nombre del servidor desde el que el cliente solicitó iniciar.
- Codificación: Cadena.
Dhcp.transaction_id
- Propósito: ID de transacción del cliente.
- Codificación: Número entero de 32 bits sin firma.
Dhcp.type
- Propósito: Tipo de mensaje de DHCP. Consulta RFC 1533 para obtener más información.
- Codificación: Tipo enumerado.
- Valores posibles:
- UNKNOWN_MESSAGE_TYPE
- DESCUBRE
- OFERTA
- SOLICITUD
- RECHAZAR
- Conf.
- NAK
- RELEASE
- INFORMAR
- WIN_DELECTED
- WIN_EXPIRED
Dhcp.chaddr
- Propósito: Es la dirección de hardware del cliente.
- Codificación: Dirección MAC.
Dhcp.ciaddr
- Propósito: Dirección IP del cliente.
- Codificación: Dirección IPv4 o IPv6 válida (RFC 5942) codificada en ASCII.
Dhcp.giaddr
- Propósito: Es la dirección IP del agente de retransmisión.
- Codificación: Dirección IPv4 o IPv6 válida (RFC 5942) codificada en ASCII.
Dhcp.siaddr
- Propósito: Dirección IP del siguiente servidor de arranque.
- Codificación: Dirección IPv4 o IPv6 válida (RFC 5942) codificada en ASCII.
Dhcp.yiaddr
- Propósito: Tu dirección IP.
- Codificación: Dirección IPv4 o IPv6 válida (RFC 5942) codificada en ASCII.
Propagación de metadatos de la opción de DHCP
Los campos de metadatos de la opción de DHCP capturan la información de registro de la opción de DHCP.
Option.code
- Propósito: Almacena el código de opción de DHCP. Consulta RFC 1533, Opciones de DHCP y extensiones de proveedor de BOOTP, para obtener más información.
- Codificación: Número entero de 32 bits sin firma.
Option.data
- Propósito: Almacena los datos de la opción de DHCP. Consulta RFC 1533, Opciones de DHCP y extensiones de proveedor de BOOTP, para obtener más información.
- Codificación: Bytes.
Propagación de metadatos de DNS
Los campos de metadatos de DNS capturan información relacionada con los paquetes de solicitud y respuesta de DNS. Tienen una correspondencia uno a uno con los datos que se encuentran en los datagramas de solicitud y respuesta de DNS.
Dns.authoritative
- Propósito: Se establece como verdadero para los servidores DNS autorizados.
- Codificación: Booleano.
Dns.id
- Propósito: Almacena el identificador de la consulta de DNS.
- Codificación: Número entero de 32 bits.
Dns.response
- Purpose: Se establece como verdadero si el evento es una respuesta de DNS.
- Codificación: Booleano.
Dns.opcode
- Propósito: Almacena el OpCode de DNS que se usa para especificar el tipo de consulta de DNS (estándar, inversa, estado del servidor, etc.).
- Codificación: Número entero de 32 bits.
Dns.recursion_available
- Propósito: Se establece como verdadero si hay una búsqueda de DNS recursiva disponible.
- Codificación: Booleano.
Dns.recursion_desired
- Propósito: Se establece como verdadero si se solicita una búsqueda de DNS recursiva.
- Codificación: Booleano.
Dns.response_code
- Propósito: Almacena el código de respuesta de DNS según lo define el RFC 1035, Nombres de dominio: Implementación y especificación.
- Codificación: Número entero de 32 bits.
Dns.truncated
- Propósito: Se establece como verdadero si se trata de una respuesta de DNS truncada.
- Codificación: Booleano.
Dns.questions
- Propósito: Almacena las preguntas de los mensajes del protocolo de dominio. Consulta Propagación de metadatos de preguntas de DNS.
Dns.answers
- Propósito: Almacena la respuesta a la consulta del nombre de dominio. Consulta Propagación de metadatos de registros de recursos DNS.
Dns.authority
- Propósito: Almacena los servidores de nombres de dominio que verificaron la respuesta a la consulta de nombre de dominio. Consulta Propagación de metadatos de registros de recursos DNS.
Dns.additional
- Propósito: Almacena los servidores de nombres de dominio adicionales que se pueden usar para verificar la respuesta al dominio. Consulta Propagación de metadatos de registros de recursos DNS.
Propagación de metadatos de preguntas de DNS
Los campos de metadatos de la pregunta de DNS capturan la información que se encuentra en la sección de preguntas de un mensaje de protocolo de dominio.
Question.name
- Propósito: Almacena el nombre de dominio.
- Codificación: Cadena.
- Restricción de validación: Las cadenas de consulta de dominio no pueden permanecer vacías y deben tener 255 octetos (bytes) o menos de conformidad con las reglamentaciones de RFC 1035 y los límites de indexación de la Búsqueda.
Question.class
- Purpose: Almacena el código que especifica la clase de la consulta.
- Codificación: Número entero de 32 bits.
Question.type
- Purpose: Almacena el código que especifica el tipo de consulta.
- Codificación: Número entero de 32 bits.
Propagación de metadatos de registros de recursos de DNS
Los campos de metadatos del registro de recursos de DNS capturan la información contenida en el registro de recursos de un mensaje de protocolo de dominio.
ResourceRecord.binary_data
- Propósito: Almacena los bytes sin procesar de cualquier cadena que no sea UTF8 y que se pueda incluir como parte de una respuesta de DNS. Este campo solo se debe usar si los datos de respuesta que devuelve el servidor DNS contienen datos que no son UTF8. De lo contrario, coloca la respuesta de DNS en el campo "data". Este tipo de información se debe almacenar aquí, en lugar de en ResourceRecord.data.
Codificación: Bytes.
ResourceRecord.class
- Propósito: Almacena el código que especifica la clase del registro de recursos.
- Codificación: Número entero de 32 bits.
ResourceRecord.data
- Propósito: Almacena la carga útil o la respuesta a la pregunta de DNS para todas las respuestas codificadas en formato UTF-8. Por ejemplo, el campo de datos podría devolver la dirección IP de la máquina a la que se refiere el nombre de dominio. Si el registro de recursos es de un tipo o una clase diferente, puede contener otro nombre de dominio (cuando un nombre de dominio se redirecciona a otro). Los datos se deben almacenar tal como están en la respuesta del DNS.
- Codificación: Cadena.
ResourceRecord.name
- Propósito: Almacena el nombre del propietario del registro de recursos.
- Codificación: Cadena.
ResourceRecord.ttl
- Propósito: Almacena el intervalo de tiempo durante el cual se puede almacenar en caché el registro de recursos antes de que se deba volver a consultar la fuente de la información.
- Codificación: Número entero de 32 bits.
ResourceRecord.type
- Propósito: Almacena el código que especifica el tipo de registro de recurso.
- Codificación: Número entero de 32 bits.
Propagación de metadatos de correo electrónico
La mayoría de los campos de metadatos de correo electrónico capturan las direcciones de correo electrónico incluidas en el encabezado del mensaje y deben cumplir con el formato estándar de dirección de correo electrónico (buzón-local@dominio) según se define en RFC 5322. Por ejemplo, frank@email.example.com.
Email.from
- Propósito: Almacena la dirección de correo electrónico from.
- Codificación: Cadena.
Email.reply_to
- Propósito: Almacena la dirección de correo electrónico reply_to.
- Codificación: Cadena.
Email.to
- Propósito: Almacena las direcciones de correo electrónico para.
- Codificación: Cadena.
Email.cc
- Propósito: Almacena las direcciones de correo electrónico en cc.
- Codificación: Cadena.
Email.bcc
- Propósito: Almacena las direcciones de correo electrónico de Cco.
- Codificación: Cadena.
Email.mail_id
- Propósito: Almacena el ID del correo (o mensaje).
- Codificación: Cadena.
- Ejemplo: 192544.132632@email.example.com
Email.subject
- Propósito: Almacena el asunto del correo electrónico.
- Codificación: Cadena.
- Ejemplo: "Lee este mensaje".
Propagación de metadatos de extensiones
Son tipos de eventos con metadatos integrados que aún no están categorizados por el UDM de Google SecOps.
Extensions.auth
- Propósito: Extensión de los metadatos de autenticación.
- Codificación: Cadena.
- Ejemplos:
- Metadatos de la zona de pruebas (todos los comportamientos que muestra un archivo, por ejemplo, FireEye)
- Datos de control de acceso a la red (NAC)
- Son los detalles de LDAP sobre un usuario (por ejemplo, rol, organización, etcétera).
Extensions.auth.auth_details
- Propósito: Especifica los detalles específicos del proveedor para el tipo o mecanismo de autenticación. Los proveedores de autenticación suelen definir tipos como via_mfa o via_ad que proporcionan información útil sobre el tipo de autenticación. Estos tipos aún se pueden generalizar en auth.type o auth.mechanism para mejorar la usabilidad y la compatibilidad de las reglas entre conjuntos de datos.
- Codificación: Cadena.
- Ejemplos: via_mfa, via_ad.
Extensions.vulns
- Propósito: Extensión de los metadatos de vulnerabilidad.
- Codificación: Cadena.
- Ejemplo: Datos de análisis de vulnerabilidades del host.
Propagación de metadatos de archivos
File.file_metadata
- Propósito: Son los metadatos asociados con el archivo.
- Codificación: Cadena.
- Ejemplos:
- Autor
- Número de revisión
- Número de versión
- Fecha de último guardado
File.full_path
- Propósito: Es la ruta de acceso completa que identifica la ubicación del archivo en el sistema.
- Codificación: Cadena.
- Ejemplo: \Program Files\Custom Utilities\Test.exe
File.md5
- Propósito: Es el valor de hash MD5 del archivo.
- Codificación: Cadena, hexadecimal en minúsculas.
- Ejemplo: 35bf623e7db9bf0d68d0dda764fd9e8c
File.mime_type
- Propósito: Es el tipo de extensiones multipropósito de correo de Internet (MIME) para el archivo.
- Codificación: Cadena.
- Ejemplos:
- PE
- secuencia de comandos de PowerShell
File.sha1
- Propósito: Es el valor de hash SHA-1 del archivo.
- Codificación: Cadena, hexadecimal en minúsculas.
- Ejemplo: eb3520d53b45815912f2391b713011453ed8abcf
File.sha256
- Propósito: Es el valor de hash SHA-256 del archivo.
- Codificación: Cadena, hexadecimal en minúsculas.
- Ejemplo: d7173c568b8985e61b4050f81b3fd8e75bc922d2a0843d7079c81ca4b6e36417
File.size
- Propósito: Es el tamaño del archivo.
- Codificación: Número entero de 64 bits sin firma.
- Ejemplo: 342135
Propagación de metadatos de FTP
Ftp.command
- Propósito: Almacena el comando de FTP.
- Codificación: Cadena.
- Ejemplos:
- objeto binario
- borrar
- get
- put
Datos de los metadatos del grupo
Es la información sobre un grupo organizativo. Para representar una identidad de grupo organizativo válida durante la normalización, debes parametrizar al menos un atributo de grupo principal especificando una dirección de correo electrónico en Group.email_addresses o un identificador de seguridad de Windows en Group.windows_sid.
Group.creation_time
- Propósito: Es la hora de creación del grupo.
- Codificación: RFC 3339, según corresponda para el formato de marca de tiempo JSON o Proto3.
Group.email_addresses
- Propósito: Agrupar la información de contacto.
- Codificación: Correo electrónico.
Group.group_display_name
- Propósito: Es el nombre visible del grupo.
- Codificación: Cadena.
- Ejemplos:
- Finanzas
- RR.HH.
- Marketing
Group.product_object_id
- Propósito: Es el identificador de objeto de usuario único a nivel global para el producto, como un identificador de objeto LDAP.
- Codificación: Cadena.
Group.windows_sid
- Propósito: Campo de atributo de grupo del identificador de seguridad (SID) de Microsoft Windows.
- Codificación: Cadena.
Propagación de metadatos HTTP
Http.method
- Propósito: Almacena el método de solicitud HTTP. Cuando el tráfico se produce a través de los protocolos de transporte HTTP o HTTPS, debes especificar un método de solicitud activo; no puedes dejar el método configurado como METHOD_UNSPECIFIED.
- Codificación: Cadena.
- Ejemplos:
- GET
- HEAD
- POST
Http.referral_url
- Propósito: Almacena la URL del HTTP referer.
- Codificación: URL válida según el RFC 3986.
- Ejemplo: https://www.altostrat.com
Http.response_code
- Propósito: Almacena el código de estado de la respuesta HTTP, que indica si una solicitud HTTP específica se completó correctamente.
- Codificación: Número entero de 32 bits.
- Ejemplos:
- 400
- 404
Http.user_agent
- Propósito: Almacena el encabezado de la solicitud del usuario-agente, que incluye el tipo de aplicación, el sistema operativo, el proveedor de software o la versión de software del usuario-agente del software solicitante. Las cadenas de encabezado de usuario-agente deben consistir por completo en arrays de caracteres codificados en UTF-8 válidos.
- Codificación: Cadena.
- Ejemplos:
- Mozilla/5.0 (X11; Linux x86_64)
- AppleWebKit/534.26 (KHTML, like Gecko)
- Chrome/41.0.2217.0
- Safari/527.33
Propagación de metadatos de ubicación
Location.city
- Propósito: Almacena el nombre de la ciudad.
- Codificación: Cadena.
- Ejemplos:
- Sunnyvale
- Chicago
- Málaga
Location.country_or_region
- Propósito: Almacena el nombre del país o la región del mundo.
- Codificación: Cadena.
- Ejemplos:
- Estados Unidos
- Reino Unido
- España
Location.name
- Propósito: Almacena el nombre específico de la empresa, como un edificio o un campus.
- Codificación: Cadena.
- Ejemplos:
- Campus 7B
- Edificio A2
Location.state
- Propósito: Almacena el nombre del estado, la provincia o el territorio.
- Codificación: Cadena.
- Ejemplos:
- California
- Illinois
- Ontario
Propagación de metadatos de red
Network.application_protocol
- Propósito: Indica el protocolo de aplicación de red.
- Codificación: Tipo enumerado.
Valores posibles:
- UNKNOWN_APPLICATION_PROTOCOL
- AFP
- APPC
- AMQP
- ATOM
- BEEP
- BITCOIN
- BIT_TORRENT
- CFDP
- CIP
- COAP
- COTP
- DCERPC
- DDS
- DEVICE_NET
- DHCP
- DICOM
- DNP3
- DNS
- E_DONKEY
- ENRP
- FAST_TRACK
- DEDO
- FREENET
- FTAM
- GOOSE
- GOPHER
- GRPC
- HL7
- H323
- HTTP
- HTTPS
- IEC104
- IRCP
- KADEMLIA
- KRB5
- LDAP
- LPD
- MIME
- MMS
- MODBUS
- MQTT
- NETCONF
- NFS
- NIS
- NNTP
- NTCIP
- NTP
- OSCAR
- PNRP
- PTP
- QUIC
- RDP
- RELP
- RIP
- RLOGIN
- RPC
- RTMP
- RTP
- RTPS
- RTSP
- SAP
- SDP
- SIP
- SLP
- SMB
- SMTP
- SNMP
- SNTP
- SSH
- SSMS
- STYX
- SV
- TCAP
- TDS
- TOR
- TSP
- VTP
- WHOIS
- WEB_DAV
- X400
- X500
- XMPP
Network.direction
- Propósito: Indica la dirección del tráfico de red.
- Codificación: Tipo enumerado.
- Valores posibles:
- UNKNOWN_DIRECTION
- ENTRANTE
- SALIENTE
- BROADCAST
Network.email
- Propósito: Especifica la dirección de correo electrónico del remitente o destinatario.
- Codificación: Cadena.
- Ejemplo: jcheng@company.example.com
Network.ip_protocol
- Propósito: Indica el protocolo IP.
- Codificación: Tipo enumerado.
- Valores posibles:
- UNKNOWN_IP_PROTOCOL
- EIGRP: Protocolo de enrutamiento de puerta de enlace interior mejorado
- ESP: Carga útil de seguridad de encapsulación
- ETHERIP: Encapsulamiento de Ethernet dentro de IP
- GRE: Encapsulamiento de enrutamiento genérico
- ICMP: Protocolo de mensajes de control de Internet
- IGMP: Protocolo de administración de grupos de Internet
- IP6IN4: Encapsulamiento de IPv6
- PIM: Protocolo de multidifusión independiente
- TCP: Protocolo de control de transmisión
- UDP: Protocolo de datagramas de usuario
- VRRP: Protocolo de redundancia de router virtual
Network.received_bytes
- Propósito: Especifica la cantidad de bytes recibidos.
- Codificación: Número entero de 64 bits sin firma.
- Ejemplo: 12,453,654,768
Network.sent_bytes
- Propósito: Especifica la cantidad de bytes enviados.
- Codificación: Número entero de 64 bits sin firma.
- Ejemplo: 7,654,876
Network.session_duration
- Propósito: Almacena la duración de la sesión de red, que suele devolverse en un evento de interrupción de la sesión. Para establecer la duración, puedes configurar network.session_duration.seconds = 1 (tipo int64) o network.session_duration.nanos = 1 (tipo int32).
- Codificación:
- Número entero de 32 bits: Para los segundos (network.session_duration.seconds).
- Número entero de 64 bits: Para nanosegundos (network.session_duration.nanos).
Network.session_id
- Propósito: Almacena el identificador de la sesión de red.
- Codificación: Cadena.
- Ejemplo: SID:ANON:www.w3.org:j6oAOxCWZh/CD723LGeXlf-01:34
Propagación de metadatos de Process
Process.command_line
- Propósito: Almacena la cadena de la línea de comandos para el proceso.
- Codificación: Cadena.
- Ejemplo: Grupo
c:\windows\system32\net.exe.
Process.product_specific_process_id
- Propósito: Almacena el ID de proceso específico del producto.
- Codificación: Cadena.
- Ejemplos:
MySQL:78778oCS:90512
Process.parent_process.product_specific_process_id
- Propósito: Almacena el ID de proceso específico del producto para el proceso superior.
- Codificación: Cadena.
- Ejemplos:
MySQL:78778oCS:90512
Process.file
- Purpose: Almacena el nombre del archivo que usa el proceso.
- Codificación: Cadena.
- Ejemplo: report.xls
Process.parent_process
- Propósito: Almacena los detalles del proceso superior.
- Codificación: Sustantivo (proceso)
Process.pid
- Propósito: Almacena el ID de proceso.
- Codificación: Cadena.
- Ejemplos:
- 308
- 2002
Propagación de metadatos de Registry
Registry.registry_key
- Propósito: Almacena la clave de registro asociada con una aplicación o un componente del sistema.
- Codificación: Cadena.
- Ejemplo: HKEY_LOCAL_MACHINE/SYSTEM/DriverDatabase
Registry.registry_value_name
- Propósito: Almacena el nombre del valor de registro asociado con una aplicación o un componente del sistema.
- Codificación: Cadena.
- Ejemplo: TEMP
Registry.registry_value_data
- Propósito: Almacena los datos asociados con un valor de registro.
- Codificación: Cadena.
- Ejemplo: %USERPROFILE%\Local Settings\Temp
Propagación de los metadatos de Security Result
Los metadatos de Security Result incluyen detalles sobre los riesgos y las amenazas de seguridad que encontró un sistema de seguridad, así como las acciones que se tomaron para mitigar esos riesgos y amenazas.
SecurityResult.about
- Propósito: Proporciona una descripción del resultado de seguridad.
- Codificación: Sustantivo.
SecurityResult.action
- Propósito: Especifica una acción de seguridad.
- Codificación: Tipo enumerado.
- Valores posibles: El UDM de Google SecOps define las siguientes acciones de seguridad:
- PERMITIR
- ALLOW_WITH_MODIFICATION: El archivo o correo electrónico se desinfectó o reescribió, y se reenvió de todos modos.
- BLOQUEAR
- CUARENTENA: Almacena para un análisis posterior (no significa bloquear).
- UNKNOWN_ACTION
SecurityResult.action_details
- Propósito: Son los detalles que proporciona el proveedor sobre la acción que se tomó como resultado del incidente de seguridad. Las acciones de seguridad suelen traducirse mejor en el campo de UDM más general Security_Result.action. Sin embargo, es posible que debas escribir reglas para la descripción exacta de la acción que proporciona el proveedor.
- Codificación: Cadena.
- Ejemplos: descartar, bloquear, desencriptar, encriptar.
SecurityResult.category
- Propósito: Especifica una categoría de seguridad.
- Codificación: Es una enumeración.
- Valores posibles: El UDM de Google SecOps define las siguientes categorías de seguridad:
- ACL_VIOLATION: Se intentó acceder sin autorización, incluido el intento de acceso a archivos, servicios web, procesos, objetos web, etcétera.
- AUTH_VIOLATION: Se produjo un error de autenticación, como una contraseña incorrecta o una autenticación de dos factores incorrecta.
- DATA_AT_REST—DLP: Datos de sensores encontrados en reposo en un análisis.
- DATA_DESTRUCTION: Intento de destruir o borrar datos.
- DATA_EXFILTRATION—DLP: transmisión de datos de sensores, copia a unidad de memoria USB.
- EXPLOIT: Intentos de desbordamiento, codificaciones de protocolo incorrectas, ROP, inyección de SQL, etc., tanto en la red como en el host.
- MAIL_PHISHING: Correo electrónico de phishing, mensajes de chat, etc.
- MAIL_SPAM: Correo electrónico, mensaje, etc. de spam
- MAIL_SPOOFING: Dirección de correo electrónico de origen falsificada, etc.
- NETWORK_CATEGORIZED_CONTENT
- NETWORK_COMMAND_AND_CONTROL: Si se conoce el canal de comando y control.
- NETWORK_DENIAL_OF_SERVICE
- NETWORK_MALICIOUS: Comando y control, exploit de red, actividad sospechosa, posible túnel inverso, etcétera.
- NETWORK_SUSPICIOUS: No se relaciona con la seguridad, por ejemplo, la URL está vinculada a juegos de apuestas, etc.
- NETWORK_RECON: Análisis de puertos detectado por un IDS, sondeo por una aplicación web.
- POLICY_VIOLATION: Incumplimiento de política de seguridad, incluidos los incumplimientos de las reglas de firewall, proxy y HIPS, o las acciones de bloqueo de NAC.
- SOFTWARE_MALICIOUS: Software malicioso, software espía, rootkits, etcétera.
- SOFTWARE_PUA: Aplicación potencialmente no deseada, como software con anuncios, etc.
- SOFTWARE_SUSPICIOUS
- UNKNOWN_CATEGORY
SecurityResult.confidence
- Propósito: Especifica un nivel de confianza con respecto a un evento de seguridad según lo estimado por el producto.
- Codificación: Es una enumeración.
- Valores posibles: El UDM de Google SecOps define las siguientes categorías de confianza del producto:
- UNKNOWN_CONFIDENCE
- LOW_CONFIDENCE
- MEDIUM_CONFIDENCE
- HIGH_CONFIDENCE
SecurityResult.confidence_details
- Propósito: Proporciona detalles adicionales sobre la confianza de un evento de seguridad según la estimación del proveedor del producto.
- Codificación: Cadena.
SecurityResult.priority
- Propósito: Especifica una prioridad con respecto a un evento de seguridad según lo estimado por el proveedor del producto.
- Codificación: Es una enumeración.
- Valores posibles: El UDM de Google SecOps define las siguientes categorías de prioridad de los productos:
- UNKNOWN_PRIORITY
- LOW_PRIORITY
- MEDIUM_PRIORITY
- HIGH_PRIORITY
SecurityResult.priority_details
- Purpose: Información específica del proveedor sobre la prioridad del resultado de seguridad.
- Codificación: Cadena.
SecurityResult.rule_id
- Propósito: Es el identificador de la regla de seguridad.
- Codificación: Cadena.
- Ejemplos:
- 08123
- 5d2b44d0-5ef6-40f5-a704-47d61d3babbe
SecurityResult.rule_name
- Propósito: Es el nombre de la regla de seguridad.
- Codificación: Cadena.
- Ejemplo: BlockInboundToOracle.
SecurityResult.severity
- Propósito: Es la gravedad de un evento de seguridad según la estimación del proveedor del producto con los valores definidos por el UDM de Google SecOps.
- Codificación: Es una enumeración.
- Valores posibles: El UDM de Google SecOps define los siguientes niveles de gravedad de los productos:
- UNKNOWN_SEVERITY: No malicioso
- INFORMATIVA: No es malicioso
- ERROR: No es malicioso
- BAJO: Malicioso
- MEDIA: Malicioso
- ALTO: Malicioso
SecurityResult.severity_details
- Propósito: Gravedad de un evento de seguridad según la estimación del proveedor del producto.
- Codificación: Cadena.
SecurityResult.threat_name
- Propósito: Es el nombre de la amenaza de seguridad.
- Codificación: Cadena.
- Ejemplos:
- W32/File-A
- Slammer
SecurityResult.url_back_to_product
- Propósito: Es la URL que te dirige a la consola del producto de origen para este evento de seguridad.
- Codificación: Cadena.
Propagación de metadatos de usuarios
User.email_addresses
- Propósito: Almacena las direcciones de correo electrónico del usuario.
- Codificación: Cadena repetida.
- Ejemplo: johnlocke@company.example.com
User.employee_id
- Propósito: Almacena el ID de empleado de recursos humanos del usuario.
- Codificación: Cadena.
- Ejemplo: 11223344.
User.first_name
- Propósito: Almacena el nombre del usuario.
- Codificación: Cadena.
- Ejemplo: Juan.
User.middle_name
- Propósito: Almacena el segundo nombre del usuario.
- Codificación: Cadena.
- Ejemplo: Anthony.
User.last_name
- Propósito: Almacena el apellido del usuario.
- Codificación: Cadena.
- Ejemplo: Locke.
User.group_identifiers
- Propósito: Almacena los IDs de grupo (un GUID, un OID de LDAP o similar) asociados con un usuario.
- Codificación: Cadena repetida.
- Ejemplo: admin-users.
User.phone_numbers
- Propósito: Almacena los números de teléfono del usuario.
- Codificación: Cadena repetida.
- Ejemplo: 18005550101
User.title
- Propósito: Almacena el cargo del usuario.
- Codificación: Cadena.
- Ejemplo: Administrador de relaciones con clientes.
User.user_display_name
- Propósito: Almacena el nombre visible del usuario.
- Codificación: Cadena.
- Ejemplo: John Locke.
User.userid
- Propósito: Almacena el ID de usuario.
- Codificación: Cadena.
- Ejemplo: jlocke.
User.windows_sid
- Propósito: Almacena el identificador de seguridad (SID) de Microsoft Windows asociado a un usuario.
- Codificación: Cadena.
- Ejemplo: S-1-5-21-1180649209-123456789-3582944384-1064
Propagación de metadatos de vulnerabilidades
Vulnerability.about
- Propósito: Si la vulnerabilidad se trata de un sustantivo específico (por ejemplo, ejecutable), agrégalo aquí.
- Codificación: Sustantivo. Consulta Cómo se completan los metadatos de Noun.
- Ejemplo: ejecutable.
Vulnerability.cvss_base_score
- Propósito: Es la puntuación base del Common Vulnerability Scoring System (CVSS).
- Codificación: Punto flotante.
- Rango: De 0.0 a 10.0
- Ejemplo: 8.5
Vulnerability.cvss_vector
Propósito: Vector para las propiedades de CVSS de la vulnerabilidad. Una puntuación de CVSS se compone de las siguientes métricas:
- Vector de ataque (AV)
- Complejidad de acceso (AC)
- Autenticación (Au)
- Impacto en la confidencialidad (C)
- Impacto en la integridad (I)
- Impacto en la disponibilidad (A)
Para obtener más información, consulta https://nvd.nist.gov/vuln-metrics/cvss/v2-calculator.
Codificación: Cadena.
Ejemplo: AV:L/AC:H/Au:N/C:N/I:P/A:C
Vulnerability.cvss_version
- Propósito: Es la versión de CVSS para la puntuación o el vector de vulnerabilidad.
- Codificación: Cadena.
- Ejemplo: 3.1
Vulnerability.description
- Propósito: Es la descripción de la vulnerabilidad.
- Codificación: Cadena.
Vulnerability.first_found
- Propósito: Los productos que mantienen un historial de análisis de vulnerabilidades deben propagar first_found con la hora en que se detectó por primera vez la vulnerabilidad de este recurso.
- Codificación: Cadena.
Vulnerability.last_found
- Propósito: Los productos que mantienen un historial de análisis de vulnerabilidades deben completar last_found con la hora en que se detectó más recientemente la vulnerabilidad de este recurso.
- Codificación: Cadena.
Vulnerability.name
- Propósito: Es el nombre de la vulnerabilidad.
- Codificación: Cadena.
- Ejemplo: Se detectó una versión del SO no compatible.
Vulnerability.scan_end_time
- Propósito: Si la vulnerabilidad se descubrió durante un análisis de recursos, completa este campo con la hora en que finalizó el análisis. Deja este campo vacío si la hora de finalización no está disponible o no corresponde.
- Codificación: Cadena.
Vulnerability.scan_start_time
- Propósito: Si la vulnerabilidad se descubrió durante un análisis de recursos, completa este campo con la hora en que comenzó el análisis. Deja este campo vacío si la hora de inicio no está disponible o no corresponde.
- Codificación: Cadena.
Vulnerability.severity
- Propósito: Gravedad de la vulnerabilidad.
- Codificación: Tipo enumerado.
- Valores posibles:
- UNKNOWN_SEVERITY
- BAJO
- MEDIO
- ALTO
Vulnerability.severity_details
- Propósito: Detalles de gravedad específicos del proveedor.
- Codificación: Cadena.
Propagación de metadatos de alertas
idm.is_significant
- Propósito: Especifica si se debe mostrar la alerta en Estadísticas empresariales.
- Codificación: Booleano.
idm.is_alert
- Propósito: Identifica si el evento es una alerta.
- Codificación: Booleano.
Campos obligatorios y opcionales para los tipos de entidades
| Tipo de entidad | Requisitos específicos de la entidad |
|---|---|
IP_ADDRESS |
|
FILE |
|
DOMAIN_NAME |
|
URL |
|
MUTEX |
|
USER |
|
RESOURCE |
|
CIDR_BLOCK |
|
ASSET |
|
GROUP |
|
AI |
|
Campos obligatorios y opcionales para cada tipo de evento
En esta sección, se describen los campos obligatorios y opcionales que se deben completar para cada tipo de evento de UDM.
Para obtener detalles sobre campos de UDM específicos (por ejemplo, números de enumeración), consulta la lista de campos del modelo de datos unificado.
DEVICE_CONFIG_UPDATE, DEVICE_FIRMWARE_UPDATE, DEVICE_PROGRAM_DOWNLOAD, DEVICE_PROGRAM_UPLOAD
Campos obligatorios:
- metadata: Incluye los campos obligatorios (
event_timestampyevent_type). - principal: Incluye al menos un identificador de máquina (
principal.hostname,principal.ip,principal.macoprincipal.asset_id).
Campos opcionales:
- principal.user: Se completa si la información del usuario está disponible para la cuenta que inició la actualización del dispositivo.
- target: Se completa con detalles sobre el dispositivo de destino, el firmware, el recurso de configuración o el archivo de programa si es diferente de
principal. - security_result: Describe cualquier actividad maliciosa o anómala detectada.
Ejemplo de UDM para DEVICE_FIRMWARE_UPDATE
En el siguiente ejemplo, se muestra cómo dar formato a un evento DEVICE_FIRMWARE_UPDATE para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2025-03-10T14:22:05.000000Z",
"event_type": "DEVICE_FIRMWARE_UPDATE"
},
"principal": {
"hostname": "plc-controller-01",
"ip": [
"10.20.30.40"
]
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Información sobre el dispositivo en el que se produjo la actualización de firmware.
EMAIL_TRANSACTION, EMAIL_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal: Se completa con información sobre la máquina de la que se originó el mensaje de correo electrónico (por ejemplo, la dirección IP del remitente).
Campos opcionales:
- about: URLs, IPs, dominios y cualquier archivo adjunto incorporado en el cuerpo del correo electrónico. Ten en cuenta que about.file.hash no es un campo indexado para los hashes de archivos. Las vistas de hash no se propagarán a partir de un hash de archivo adjunto normalizado para este campo.
- securityResult.about: URLs, IPs y archivos incorrectos incorporados en el cuerpo del correo electrónico.
- network.email: Información del remitente o destinatario del correo electrónico. Ten en cuenta que network.email no es un campo de alias. Si necesitas alias y enriquecimiento para la búsqueda o la detección, deberás indexar en la entidad principal o de destino con una extensión de analizador.
- principal: Si hay datos de la máquina cliente sobre quién envió el correo electrónico, completa los detalles del servidor en principal (por ejemplo, el proceso del cliente, los números de puerto, el nombre de usuario, etc.).
- target: Si hay datos del servidor de correo electrónico de destino, completa los detalles del servidor en el destino (por ejemplo, la dirección IP).
- intermediary: Si hay datos del servidor de correo o del proxy de correo, propaga los detalles del servidor en intermediary.
Notas:
- Nunca propagues principal.email ni target.email.
- Solo propaga el campo de correo electrónico en security_result.about o network.email.
- Los resultados de seguridad de nivel superior suelen tener un conjunto de sustantivos (opcional para el spam).
- EMAIL_URL_CLICK se marcó como obsoleto.
Ejemplo de UDM para EMAIL_TRANSACTION
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo EMAIL_TRANSACTION para el UDM de Google SecOps:
metadata {
event_timestamp: "2023-07-06T06:26:10.448584Z"
event_type: EMAIL_TRANSACTION
}
principal {
ip: "1.2.3.4"
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Es la información sobre el dispositivo que originó el correo electrónico.
FILE_CREATION, FILE_DELETION, FILE_MODIFICATION, FILE_READ, FILE_OPEN y FILE_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal:
- Al menos un identificador de máquina.
- (Opcional) Completa principal.process con información sobre el proceso que accede al archivo.
- target:
- Si el archivo es remoto (por ejemplo, un recurso compartido de SMB), el destino debe incluir al menos un identificador de máquina para la máquina de destino; de lo contrario, todos los identificadores de máquina deben estar en blanco.
- Propaga target.file con información sobre el archivo.
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
- principal.user: Se completa si hay información del usuario disponible sobre el proceso.
Ejemplo de UDM para FILE_MODIFICATION
En el siguiente ejemplo, se muestra cómo se formatearía un evento de tipo FILE_MODIFICATION para el UDM de Google SecOps:
metadata {
event_timestamp: "2023-07-03T12:14:38.164507Z"
event_type: FILE_MODIFICATION
}
principal {
hostname: "pinguino-01"
}
target {
file {
full_path: "foo.bar"
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Información sobre el dispositivo en el que se produjo la modificación del archivo.
- target: Es la información sobre el archivo modificado.
FILE_COPY
Campos obligatorios:
- metadata: Incluye los campos obligatorios como se describe.
- principal:
- Al menos un identificador de máquina.
- (Opcional) Completa principal.process con información sobre el proceso que realiza la operación de copia de archivos.
- src:
- Completa src.file con información sobre el archivo de origen.
- Si el archivo es remoto (por ejemplo, un recurso compartido de SMB), src debe incluir al menos un identificador de máquina para la máquina de origen que almacena el archivo de origen.
- target:
- Completa target.file con información sobre el archivo de destino.
- Si el archivo es remoto (por ejemplo, un recurso compartido de SMB), el campo target debe incluir al menos un identificador de máquina para la máquina de destino que contiene el archivo de destino.
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
- principal.user: Se completa si hay información del usuario disponible sobre el proceso.
FILE_MOVE, FILE_SYNC
Campos obligatorios:
- metadata: Es la información de contexto sobre el evento.
- principal: Al menos un identificador de máquina (por ejemplo,
principal.hostname). - src: Completa
src.file(por ejemplo,src.file.full_path) para representar el archivo original. Este campo es obligatorio paraFILE_MOVEyFILE_COPY. ParaFILE_SYNC, debes completar al menos uno de los campossrc.fileotarget.file(ytargetno debe estar vacío). - target: Completa
target.file(por ejemplo,target.file.full_path) para representar el archivo de destino. Este campo es obligatorio paraFILE_MOVEyFILE_COPY. ParaFILE_SYNC, debes completar al menos uno de los campossrc.fileotarget.file.
Ejemplo de UDM para FILE_MOVE
En el siguiente ejemplo, se muestra cómo se formatearía un evento de tipo FILE_MOVE para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-03T12:45:02.557878Z",
"event_type": "FILE_MOVE"
},
"src": {
"file": {
"full_path": "foo.bar"
}
},
"principal": {
"hostname": "pinguino-01"
},
"target": {
"file": {
"full_path": "foo.bar"
}
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Información sobre el dispositivo en el que se produjo el movimiento del archivo.
- src: Información sobre el archivo de origen.
- target: Información sobre el archivo de destino.
GENERIC_EVENT
Usa GENERIC_EVENT solo cuando un evento no se ajuste a ninguna otra categoría de tipo de evento de UDM.
Campos obligatorios:
- metadata: Incluye los campos obligatorios (
event_timestampyevent_type).
Campos opcionales:
- metadata.product_event_type y metadata.description: Incluye el nombre del evento específico del proveedor y la descripción legible por humanos.
- principal, target, src, intermediary, observer y about: Completa las entidades involucradas en el evento.
GENERIC_EVENTno aplica requisitos de campos específicos de la entidad más allá de la validación de tipo escalar estándar (como direcciones IP y nombres de host válidos de hasta 255 bytes). - security_result: Describe cualquier actividad maliciosa o anómala detectada.
Ejemplo de UDM para GENERIC_EVENT
En el siguiente ejemplo, se muestra cómo dar formato a un evento GENERIC_EVENT para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2025-03-10T15:00:00.000000Z",
"event_type": "GENERIC_EVENT",
"product_event_type": "CustomAuditEvent",
"description": "Custom audit event recorded on host"
},
"principal": {
"hostname": "workstation-01"
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Información de contexto y descripción específica del proveedor del evento.
- principal: Es la información sobre el dispositivo asociado con el evento.
GROUP_CREATION, GROUP_DELETION, GROUP_MODIFICATION, GROUP_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye los campos obligatorios (
event_timestampyevent_type). - principal: Incluye al menos un identificador de usuario en
principal.user(userid,windows_sid,email_addressesoemployee_id). - target: Completa
target.groupcon detalles sobre el grupo que se crea, borra o modifica (ytarget.usersi se agrega o quita un usuario del grupo). El campotargetno debe estar vacío.
Campos opcionales:
- principal: Incluye identificadores de máquina para el dispositivo desde el que se originó la operación de grupo.
- target.group: Incluye identificadores de grupo, como
group_display_name,product_object_id,windows_sidoemail_addresses. - security_result: Describe cualquier actividad maliciosa detectada.
Ejemplo de UDM para GROUP_MODIFICATION
En el siguiente ejemplo, se muestra cómo dar formato a un evento GROUP_MODIFICATION para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2025-03-10T16:10:00.000000Z",
"event_type": "GROUP_MODIFICATION"
},
"principal": {
"user": {
"userid": "admin_user"
}
},
"target": {
"group": {
"group_display_name": "Domain Admins",
"windows_sid": "S-1-5-21-3623811015-3361044348-30300820-512"
},
"user": {
"userid": "jdoe"
}
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Información sobre el usuario que modificó el grupo.
- target: Información sobre el grupo modificado y el usuario afectado.
MUTEX_CREATION, MUTEX_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal:
- Al menos un identificador de máquina.
- Completa principal.process con información sobre el proceso que crea la exclusión mutua. La validación de UDM requiere un objeto de proceso en la entidad principal. No puedes aprobar la validación de UDM con un proceso solo en el destino.
- target:
- Propaga target.resource.
- Completa target.resource.type con MUTEX.
- Completa target.resource.name con el nombre de la exclusión mutua creada.
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
- principal.user: Se completa si hay información del usuario disponible sobre el proceso.
Ejemplo de UDM para MUTEX_CREATION
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo MUTEX_CREATION para el UDM de Google SecOps:
metadata {
event_timestamp: "2020-01-01T13:27:41+00:00"
event_type: MUTEX_CREATION
vendor_name: "Microsoft"
product_name: "Windows"
}
principal {
hostname: "test.altostrat.com"
process {
pid: "0xc45"
file {
full_path: "C:\\Windows\\regedit.exe"
}
}
}
target {
resource {
type: "MUTEX"
name: "test-mutex"
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Detalles del dispositivo y del proceso.
- target: Información sobre la exclusión mutua.
NETWORK_CONNECTION, NETWORK_FLOW, NETWORK_FTP, NETWORK_SMTP
Campos obligatorios:
- metadata: event_timestamp
- principal: Incluye detalles sobre la máquina que inició la conexión de red (por ejemplo, la fuente).
- target: Incluye detalles sobre la máquina de destino si es diferente de la máquina principal.
- network: Captura detalles sobre la conexión de red (puertos, protocolo, etc.).
Campos opcionales:
- principal.process y target.process: Incluyen información del proceso asociada con la principal y el destino de la conexión de red (si está disponible).
- principal.user y target.user: Incluyen información del usuario asociada con la principal y el destino de la conexión de red (si está disponible).
- network: Captura detalles sobre la conexión de red, incluidos los puertos y el protocolo.
NETWORK_DHCP
Campos obligatorios:
- metadata: Es la información de contexto sobre el evento.
- principal: Al menos un identificador de máquina (por ejemplo, principal.ip).
- network: Debe especificar network.application_protocol como DHCP. También requiere que se complete network.dhcp.opcode (por ejemplo, BOOTREQUEST o BOOTREPLY).
Ejemplo de UDM para NETWORK_DHCP
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo NETWORK_DHCP para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-04T18:52:22.142364Z",
"event_type": "NETWORK_DHCP"
},
"principal": {
"ip": [
"1.2.3.4"
]
},
"network": {
"application_protocol": "DHCP",
"dhcp": {
"opcode": "BOOTREPLY"
}
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Información sobre el dispositivo que solicita o recibe la asignación de DHCP.
- network: Detalles sobre la conexión de red DHCP y el código de operación.
NETWORK_DNS
Campos obligatorios:
- principal: Al menos un identificador de máquina (por ejemplo, principal.ip).
- network: Debe especificar network.application_protocol como DNS. También requiere network.dns.questions.name.
- metadata: Es la información de contexto sobre el evento.
Ejemplo de UDM para NETWORK_DNS
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo NETWORK_DNS para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-04T18:54:15.943301Z",
"event_type": "NETWORK_DNS"
},
"principal": {
"ip": [
"1.2.3.4"
]
},
"network": {
"application_protocol": "DNS",
"dns": {
"questions": {
"name": "www.acme.com"
}
}
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Es la información sobre el dispositivo que realiza la solicitud de DNS.
- network: Son detalles sobre la conexión de red de DNS y el nombre de dominio consultado.
NETWORK_HTTP
El tipo de evento NETWORK_HTTP representa una conexión de red HTTP de un principal a un servidor web de destino.
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- target: Representa el servidor web. Incluye la información del dispositivo y un número de puerto opcional.
- Si hay un número de puerto de destino disponible, especifica solo una dirección IP además del número de puerto asociado con esa conexión de red (aunque se podrían proporcionar varios identificadores de máquina para el destino).
- En
target.url, completa con la URL a la que se accedió.
Campos opcionales:
- principal: Representa al cliente que inicia la solicitud web. Incluye al menos un identificador de máquina (por ejemplo, nombre de host, IP, MAC o identificador de recurso de propiedad) o un identificador de usuario (por ejemplo, nombre de usuario).
- Si se describe una conexión de red específica y hay un número de puerto de cliente disponible, especifica solo una dirección IP junto con el número de puerto asociado a esa conexión de red (aunque se podrían proporcionar otros identificadores de máquina para describir mejor el dispositivo participante).
- Si no hay ningún puerto de origen disponible, puedes especificar todas las direcciones IP y MAC, los identificadores de recursos y los valores de nombre de host que describen el dispositivo principal.
- network y network.http: Incluye detalles sobre la conexión de red
HTTP. Debes completar los siguientes campos:
- network.ip_protocol
- network.application_protocol
- network.http.method
- about: Representa otras entidades que se encuentran en la transacción HTTP (por ejemplo, un archivo subido o descargado).
- intermediary: Representa un servidor proxy (si es diferente de la principal o el destino).
- metadata: Completa los otros campos de metadatos.
- network: Propaga otros campos de red.
- network.email: Si la conexión de red HTTP se originó a partir de una URL que apareció en un mensaje de correo electrónico, completa network.email con los detalles.
- observer: Representa un rastreador pasivo (si está presente).
- security_result: Agrega uno o más elementos al campo security_result para representar la actividad maliciosa detectada.
Ejemplo de UDM para NETWORK_HTTP
En el siguiente ejemplo, se ilustra cómo se convertiría un evento de antivirus de Sophos del tipo NETWORK_HTTP al formato de UDM de Google SecOps.
El siguiente es el evento original del antivirus Sophos:
date=2013-08-07 time=13:27:41 timezone="GMT" device_name="CC500ia" device_id= C070123456-ABCDE log_id=030906208001 log_type="Anti-Virus" log_component="HTTP" log_subtype="Virus" status="" priority=Critical fw_rule_id=0 user_name="john.smith" iap=7 av_policy_name="" virus="TR/ElderadoB.A.78" url="altostrat.fr/img/logo.gif" domainname="altostrat.fr" src_ip=10.10.2.10 src_port=60671 src_country_code= dst_ip=203.0.113.31 dst_port=80 dst_country_code=FRA
A continuación, se muestra cómo dar formato a la misma información en Proto3 con la sintaxis de UDM de Google SecOps:
metadata {
event_timestamp: "2013-08-07T13:27:41+00:00"
event_type: NETWORK_HTTP
product_name: "Sophos Antivirus"
product_log_id: "030906208001"
}
principal {
hostname: "CC500ia"
asset_id: "Sophos.AV:C070123456-ABCDE"
ip: "10.10.2.10"
port: 60671
user { userid: "john.smith" }
}
target {
hostname: "altostrat.fr"
ip: "203.0.113.31"
port: 80
url: "altostrat.fr/img/logo.gif"
}
network {
ip_protocol: TCP
}
security_result {
about {
url: "altostrat.fr/img/logo.gif"
category: SOFTWARE_MALICIOUS
category_details: "Virus"
threat_name: "TR/ElderadoB.A.78"
severity: HIGH # Google Security Operations-normalized severity
severity_details: "Critical" # Vendor-specific severity string
}
}
additional { "dst_country_code" : "FRA", "iap" : "7" "fw_rule_id" : "0" }
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Es el dispositivo de seguridad que detectó el evento.
- target: Es el dispositivo que recibió el software malicioso.
- network: Información de red sobre el host malicioso.
- security_result: Son los detalles de seguridad sobre el software malicioso.
- additional: Información del proveedor fuera del alcance del UDM.
PROCESS_INJECTION, PROCESS_LAUNCH, PROCESS_OPEN, PROCESS_TERMINATION, PROCESS_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal:
- Al menos un identificador de máquina.
- En el caso de los eventos de inserción y finalización de procesos, si están disponibles, principal.process debe incluir información sobre el proceso que inicia la acción (por ejemplo, para un evento de inicio de proceso, principal.process debe incluir detalles sobre el proceso superior si está disponible).
- target:
- target.process: Incluye información sobre el proceso que se está insertando, abriendo, iniciando o finalizando.
- Si el proceso de destino es remoto, el destino debe incluir al menos un identificador de máquina para la máquina de destino (por ejemplo, una dirección IP, MAC, nombre de host o identificador de recurso de terceros).
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
- principal.user y target.user: Completa el proceso de inicio (principal) y el proceso de destino si la información del usuario está disponible.
Ejemplo de UDM para PROCESS_LAUNCH
En el siguiente ejemplo, se muestra cómo dar formato a un evento PROCESS_LAUNCH con la sintaxis de UDM de Google SecOps:
metadata {
event_timestamp: "2020-01-01T13:27:41+00:00"
event_type: PROCESS_LAUNCH
vendor_name: "Microsoft"
product_name: "Windows"
}
principal {
hostname: "altostrat.com"
}
target {
process {
pid: "0xc45"
file {
full_path: "C:\\Windows\\regedit.exe"
}
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Detalles del dispositivo.
- target: Son los detalles del proceso.
PROCESS_MODULE_LOAD
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal:
- Incluye al menos un identificador de máquina (en
principalotarget). - principal.process: Se completa con información sobre el proceso que carga el módulo.
- Incluye al menos un identificador de máquina (en
- target:
- target.process: Se completa con información sobre el proceso del módulo cargado, incluido al menos uno de
target.process.file(por ejemplo, la DLL o el objeto compartido) otarget.process.product_specific_process_id.
- target.process: Se completa con información sobre el proceso del módulo cargado, incluido al menos uno de
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
- principal.user: Se completa si hay información del usuario disponible sobre el proceso.
Ejemplo de UDM para PROCESS_MODULE_LOAD
En el siguiente ejemplo, se ilustra cómo dar formato a un evento PROCESS_MODULE_LOAD con la sintaxis de UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-03T20:40:29.854097Z",
"event_type": "PROCESS_MODULE_LOAD"
},
"principal": {
"hostname": "pinguino-01",
"process": {
"file": {
"full_path": "foo.bar"
}
}
},
"target": {
"process": {
"file": {
"full_path": "foo.bar"
}
}
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Son detalles sobre el dispositivo y el proceso que carga el módulo.
- target: Detalles del proceso y del módulo.
PROCESS_PRIVILEGE_ESCALATION
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal:
- Incluye al menos un identificador de máquina (en
principalotarget). - principal.process: Se completa con información sobre el proceso que inicia la elevación de privilegios.
- principal.user: Se completa con información sobre el usuario que inicia la elevación de privilegios, incluido al menos un identificador de usuario.
- Incluye al menos un identificador de máquina (en
- target: Se completa con información sobre el objetivo de la elevación de privilegios (por ejemplo,
target.processpara el proceso con privilegios elevados). El campotargetno debe estar vacío.
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
Ejemplo de UDM para PROCESS_PRIVILEGE_ESCALATION
En el siguiente ejemplo, se muestra cómo se formatearía un evento del tipo PROCESS_PRIVILEGE_ESCALATION para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-04T19:04:12.573338Z",
"event_type": "PROCESS_PRIVILEGE_ESCALATION"
},
"principal": {
"user": {
"userid": "pinguino"
},
"hostname": "pinguino-01",
"process": {
"file": {
"full_path": "foo.bar"
}
}
},
"target": {
"process": {
"file": {
"full_path": "foo.bar"
}
}
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Son detalles sobre el dispositivo, el usuario y el proceso que inicia el escalamiento.
- target: Detalles sobre el proceso que se escala.
REGISTRY_CREATION, REGISTRY_MODIFICATION, REGISTRY_DELETION, REGISTRY_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal:
- Al menos un identificador de máquina.
- Si un proceso en modo de usuario realiza la modificación del registro, principal.process debe incluir información sobre el proceso que modifica el registro.
- Si un proceso del kernel realiza la modificación del registro, la principal no debe incluir información del proceso.
- target:
- target.registry: Si el registro de destino es remoto, el destino debe incluir al menos un identificador para la máquina de destino (por ejemplo, una dirección IP, una MAC, un nombre de host o un identificador de recurso de terceros).
- target.registry.registry_key: Todos los eventos de registro deben incluir la clave de registro afectada.
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada. Por ejemplo, una clave de registro incorrecta.
- principal.user: Se completa si hay información del usuario disponible sobre el proceso.
Ejemplo de UDM para REGISTRY_MODIFICATION
En el siguiente ejemplo, se ilustra cómo dar formato a un evento REGISTRY_MODIFICATION en Proto3 con la sintaxis de UDM de Google SecOps:
metadata {
event_timestamp: "2020-01-01T13:27:41+00:00"
event_type: REGISTRY_MODIFICATION
vendor_name: "Microsoft"
product_name: "Windows"
}
principal {
hostname: "test-win"
user {
userid: "test"
windows_sid: "ABCDEFGH-123456789-1111111-1000"
}
process {
pid: "0xc45"
file {
full_path: "C:\\Windows\\regedit.exe"
}
}
}
target {
registry {
registry_key: "\\REGISTRY\\USER\\TEST_USER\\Control Panel\\PowerCfg\\PowerPolicy"
registry_value_name: "Description"
registry_value_data: "For extending battery life."
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Detalles del dispositivo, el usuario y el proceso.
- target: Es la entrada de registro afectada por la modificación.
RECURSO
Tipos de eventos:
- RESOURCE_CREATION
- RESOURCE_DELETION
- RESOURCE_PERMISSIONS_CHANGE
- RESOURCE_READ
- RESOURCE_WRITTEN
Evento de UDM mínimo:
{
"metadata": {
"event_timestamp": "2023-07-04T20:19:53.394745Z",
"event_type": "RESOURCE_CREATION"
},
"principal": {
"user": {
"userid": "pinguino"
}
},
"target": {
"resource": {
"name": "foo.bar"
}
}
}
SCAN_FILE, SCAN_HOST, SCAN_PROCESS, SCAN_VULN_HOST, SCAN_VULN_NETWORK
Para SCAN_FILE:
{
"metadata": {
"event_timestamp": "2023-07-06T06:57:08.443142Z",
"event_type": "SCAN_FILE"
},
"principal": {
"hostname": "pinguino-01"
},
"target": {
"file": {
"full_path": "foo.bar"
}
}
}
Para SCAN_PROCESS:
{
"metadata": {
"event_timestamp": "2023-07-06T06:59:17.690425Z",
"event_type": "SCAN_PROCESS"
},
"principal": {
"hostname": "pinguino-01"
},
"target": {
"process": {
"file": {
"full_path": "foo.bar"
}
}
}
}
Campos obligatorios:
- metadata: event_timestamp y la información de contexto sobre el evento.
- observer: Captura información sobre el escáner. Si el escáner es remoto, los detalles de la máquina deben capturarse en el campo observer. Para un analizador local, deja el campo vacío.
- target: Captura información sobre la máquina que contiene el objeto que se analiza. Si se analiza un archivo, target.file debe capturar información sobre el archivo analizado. Si se analiza un proceso, target.process debe capturar información sobre el proceso analizado.
- extensions: Para SCAN_VULN_HOST y SCAN_VULN_NETWORK, define la vulnerabilidad con el campo extensions.vuln.
Campos opcionales:
- principal: Representa el dispositivo que inicia la conexión y, además, incluye al menos un identificador de máquina (por ejemplo, nombre de host, dirección IP, dirección MAC o identificador de recurso de propiedad) o un identificador de usuario.
- target: Los detalles del usuario sobre el objeto de destino (por ejemplo, el creador del archivo o el propietario del proceso) se deben capturar en target.user.
- security_result: Describe la actividad maliciosa detectada.
Ejemplo de UDM para SCAN_HOST
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo SCAN_HOST para el UDM de Google SecOps:
metadata: {
event_timestamp: {
seconds: 1571386978
}
event_type: SCAN_HOST
vendor_name: "vendor"
product_name: "product"
product_version: "1.0"
}
target: {
hostname: "testHost"
asset_id: "asset"
ip: "192.168.200.200"
}
observer: {
hostname: "testObserver"
ip: "192.168.100.100"
}
security_result: {
severity: LOW
confidence: HIGH_CONFIDENCE
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- target: Es el dispositivo que recibió el software malicioso.
- observer: Es el dispositivo que observa y, luego, informa el evento en cuestión.
- security_result: Son los detalles de seguridad sobre el software malicioso.
Ejemplo de UDM para SCAN_VULN_HOST
En el siguiente ejemplo, se muestra cómo se formatearía un evento del tipo SCAN_VULN_HOST para la UDM de Google SecOps:
metadata: {
event_timestamp: "2025-05-09T12:59:52.45298Z",
event_type: 18005,
product_name: "TestProduct",
vendor_name: "TestVendor"
},
principal {
asset_id: "TEST:Mwl8ABcd",
ip: "127.0.0.3",
hostname: "TEST-Localhost",
mac: ["02:00:00:00:00:01"]
},
extensions: {
vulns: {
vulnerabilities: [
{
cve_id: "CVE-6l9VxQmz",
vendor_vulnerability_id: "TEST:7gmCmFWX",
name: "CVE pA7DzwPU",
severity: 2,
vendor: "TestVendor",
last_found: "2025-05-09T14:59:52.45300Z",
first_found: "2025-05-09T13:59:52.45300Z"
}
]
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Es el dispositivo que recibió el software malicioso.
- extensions: Son los detalles de la vulnerabilidad.
SCHEDULED_TASK_CREATION, SCHEDULED_TASK_DELETION, SCHEDULED_TASK_DISABLE, SCHEDULED_TASK_ENABLE, SCHEDULED_TASK_MODIFICATION, SCHEDULED_TASK_UNCATEGORIZED
Campos obligatorios:
- principal: Para todos los eventos SCHEDULED_TASK, la principal debe incluir un identificador de máquina y un identificador de usuario.
- target: Incluye un
target.resourceválido contarget.resource.resource_typeestablecido enTASK.
Campos opcionales:
- security_result: Describe la actividad maliciosa detectada.
Ejemplo de UDM para SCHEDULED_TASK_CREATION
En el siguiente ejemplo, se muestra cómo se podría dar formato a un evento del tipo SCHEDULED_TASK_CREATION para el UDM de Google SecOps:
metadata: {
event_timestamp: {
seconds: 1577577998
}
event_type: SCHEDULED_TASK_CREATION
vendor_name: "Microsoft"
product_name: "Windows"
}
principal: {
hostname: "fake-host.altostrat.com"
user: {
userid: "TestUser"
windows_sid: "AB123CDE"
}
process {
pid: "1234"
}
}
target: {
resource: {
resource_type: TASK
name: "\\Adobe Acrobat Update Task"
}
}
intermediary: {
hostname: "fake-intermediary.altostrat.com"
}
security_result: {
rule_name: "EventID: 6789"
summary: "A scheduled task was created."
severity: INFORMATIONAL
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Es el dispositivo que programó la tarea sospechosa.
- target: Es el software al que se dirige la tarea sospechosa.
- intermediary: Es el intermediario involucrado en la tarea sospechosa.
- security_result: Detalles de seguridad sobre la tarea sospechosa.
SETTING_UNCATEGORIZED, SETTING_CREATION, SETTING_MODIFICATION, SETTING_DELETION
Campos obligatorios:
principal: Debe estar presente, no estar vacío y, además, incluir un identificador de máquina.
target: Debe estar presente, no estar vacío y, además, incluir un recurso con
target.resource.resource_typeespecificado comoSETTING.
Ejemplo de UDM para el tipo de evento SETTING_MODIFICATION
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo SETTING_MODIFICATION para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-05T14:15:27.070909Z",
"event_type": "SETTING_MODIFICATION"
},
"principal": {
"hostname": "foo.bar"
},
"target": {
"resource": {
"resource_type": "SETTING",
"name": "foo.bar"
}
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- principal: Información sobre el dispositivo en el que se produjo la modificación de la configuración.
- target: Son los detalles sobre el recurso de configuración.
SERVICE_UNSPECIFIED, SERVICE_CREATION, SERVICE_DELETION, SERVICE_MODIFICATION, SERVICE_START, SERVICE_STOP
Campos obligatorios:
- metadata: Incluye los campos obligatorios (
event_timestampyevent_type). - principal: Incluye al menos un identificador de máquina (
principal.hostname,principal.ip,principal.macoprincipal.asset_id). - target: Especifica al menos uno de los atributos
target.processotarget.application.
Campos opcionales:
- target.user: Se completa si la información del usuario está disponible para la cuenta de servicio o el usuario de destino.
- target.resource: Se completa con los detalles del recurso del servicio (por ejemplo,
resource_type: SERVICE).
Ejemplo de UDM para SERVICE_UNSPECIFIED
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo SERVICE_UNSPECIFIED para el UDM de Google SecOps:
metadata: {
event_timestamp: {
seconds: 1595656745
nanos: 832000000
}
event_type: SERVICE_UNSPECIFIED
vendor_name: "Preempt"
product_name: "PREEMPT_AUTH"
product_event_type: "SERVICE_ACCESS"
description: "Remote Procedures (RPC)"
}
principal: {
hostname: "XXX-YYY-ZZZ"
ip: "10.10.10.10"
}
target: {
hostname: "TestHost"
user: {
userid: "ORG\\User"
user_display_name: "user name"
}
application: "application.name"
resource: {
resource_type: SERVICE
name: "RPC"
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Detalles del dispositivo y la ubicación.
- target: Es el nombre de host y el identificador de usuario.
- application: Es el nombre de la aplicación y el tipo de recurso.
STATUS_HEARTBEAT, STATUS_STARTUP, STATUS_SHUTDOWN, STATUS_UNCATEGORIZED, STATUS_UPDATE
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal: Al menos un identificador de máquina (DIRECCIÓN IP o dirección MAC, nombre de host o identificador de recurso).
Ejemplo de UDM para STATUS_HEARTBEAT
En el siguiente ejemplo, se ilustra cómo se formatearía un evento de tipo STATUS_HEARTBEAT para el UDM de Google SecOps:
metadata: {
event_timestamp: {
seconds: 1588180305
}
event_type: STATUS_HEARTBEAT
vendor_name: "DMP"
product_name: "ENTRE"
}
principal: {
hostname: "testHost"
location: {
name: "Building 1"
}
}
intermediary: {
ip: "8.8.8.8"
}
security_result: {
summary: "Event - Locked"
description: "description"
severity: LOW
severity_details: "INFO"
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Detalles del dispositivo y la ubicación.
- intermediary: Dirección IP del dispositivo.
- security_result: Detalles del resultado de seguridad.
SYSTEM_AUDIT_LOG_UNCATEGORIZED, SYSTEM_AUDIT_LOG_WIPE
Campos obligatorios:
- principal: Incluye un identificador de usuario para el usuario que realizó la operación en el registro y un identificador de máquina para la máquina en la que se almacena o se almacenó el registro (en el caso de la eliminación).
Ejemplo de UDM para SYSTEM_AUDIT_LOG_WIPE
En el siguiente ejemplo, se muestra cómo se formatearía un evento del tipo SYSTEM_AUDIT_LOG_WIPE para el UDM de Google SecOps:
metadata {
event_timestamp: "2020-01-01T13:27:41+00:00"
event_type: SYSTEM_AUDIT_LOG_WIPE
vendor_name: "Microsoft"
product_name: "Windows"
}
principal {
hostname: "altostrat.com"
user {
userid: "test"
windows_sid: "ABCDEFGH-123456789-1111111-1000"
}
}
Como se muestra en este ejemplo, el evento se dividió en las siguientes categorías de UDM:
- metadata: Información de contexto sobre el evento.
- principal: Detalles del dispositivo y del usuario.
USER_BADGE_IN
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- target: Debe incluir al menos un identificador de máquina (por ejemplo, target.hostname).
- extensions: El mecanismo de autenticación se debe proporcionar en extensions.auth.type.
Ejemplo de UDM para USER_BADGE_IN
En el siguiente ejemplo, se ilustra cómo se formatearía un evento del tipo USER_BADGE_IN para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-05T20:31:18.303584Z",
"event_type": "USER_BADGE_IN"
},
"target": {
"hostname": "jamon-01"
},
"extensions": {
"auth": {
"type": "MACHINE"
}
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- target: Información sobre el dispositivo o la ubicación en la que se produjo el ingreso con credencial.
- extensions: Son los detalles sobre el mecanismo de autenticación que se usó.
USER_CHANGE_PASSWORD, USER_CHANGE_PERMISSIONS
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- target: No debe estar vacío. Completa
targetcon información sobre la cuenta de usuario modificada (target.user) o la máquina, la aplicación o el recurso de destino en el que se produjo el cambio. - target.user o principal.user: Completa al menos uno de los campos
target.user(la cuenta de usuario que se modificó) oprincipal.user(el usuario que inició el cambio) con un identificador de usuario (userid,windows_sid,email_addressesoemployee_id).
Campos opcionales:
- principal: Si proporcionas el identificador de usuario en
target.user,principal.useres opcional. Si la cuenta de usuario se modifica desde una ubicación remota, propagaprincipalcon información sobre la máquina desde la que se originó la modificación. - intermediary: En el caso de los accesos con SSO,
intermediarydebe incluir al menos un identificador de máquina para el servidor de SSO, si está disponible.
USER_COMMUNICATION
Campos obligatorios:
- principal: Completa el campo principal.user con detalles asociados con la comunicación iniciada por el usuario (remitente), como un mensaje de chat en Google Chat o Slack, una videoconferencia o conferencia de voz en Zoom o Google Meet, o una conexión de VoIP.
Campos opcionales:
- target: (Recomendado) Completa el campo target.user con información sobre el usuario objetivo (receptor) del recurso de comunicación en la nube. Completa el campo target.application con información sobre la aplicación de comunicación en la nube de destino.
USER_CREATION, USER_DELETION
Campos obligatorios:
- metadata: Incluye
event_timestampyevent_type. - principal: Incluye al menos un identificador de usuario válido en
principal.user(userid,windows_sid,email_addressesoemployee_id, de hasta 256 caracteres) para la cuenta que inició la creación o eliminación. Si no se establecetarget.application,principaltambién debe incluir al menos un identificador de máquina (hostname,ip,macoasset_id). - target: Incluye al menos un identificador de usuario válido en
target.user(hasta 256 caracteres) para la cuenta de usuario que se creará o borrará. Siprincipalno incluye un identificador de máquina, completatarget.application.
Campos opcionales:
- principal.process: Son los detalles del proceso de la máquina en la que se inició la solicitud de creación o eliminación del usuario.
- target: Es la información sobre la máquina de destino (si es diferente de la máquina principal).
USER_LOGIN, USER_LOGOUT
Campos obligatorios:
- metadata: Incluye los campos obligatorios.
- principal: Para la actividad remota del usuario (por ejemplo, el acceso remoto), completa el campo principal con información sobre la máquina que origina la actividad del usuario. Para la actividad del usuario local (por ejemplo, el acceso local), no configures principal.
- target: Completa target.user con información sobre el usuario que accedió o salió. Si no se establece la principal (por ejemplo, acceso local), el destino también debe incluir al menos un identificador de máquina que identifique la máquina de destino. Para la actividad del usuario de máquina a máquina (por ejemplo, acceso remoto, SSO, servicio en la nube o VPN), el destino debe incluir información sobre la aplicación, la máquina o el servidor de VPN de destino.
- intermediary: En el caso de los accesos con SSO, el intermediario debe incluir al menos un identificador de máquina para el servidor de SSO, si está disponible.
- network y network.http: Si el acceso se produce a través de HTTP, debes colocar todos los detalles disponibles en network.ip_protocol, network.application_protocol y network.http.
- Extensión de autenticación: Debe identificar el tipo de sistema de autenticación con el que se relaciona el evento (por ejemplo, máquina, SSO o VPN) y el mecanismo empleado (nombre de usuario y contraseña, OTP, etcétera).
- security_result: Agrega un campo security_result para representar el estado de acceso si falla. Especifica security_result.category con el valor AUTH_VIOLATION si falla la autenticación.
Ejemplo de UDM para USER_LOGIN
En el siguiente ejemplo, se muestra cómo se formatearía un evento de tipo USER_LOGIN para el UDM de Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-05T20:48:50.657334Z",
"event_type": "USER_LOGIN"
},
"target": {
"user": {
"userid": "jamon"
}
},
"extensions": {
"auth": {
"type": "MACHINE"
}
}
}
Como se muestra en este ejemplo, el evento se divide en las siguientes categorías de UDM:
- metadata: Es la información de contexto sobre el evento.
- target: Información sobre el usuario conectado.
- extensions: Son los detalles sobre el mecanismo de autenticación que se usó.
USER_RESOURCE_ACCESS
Campos obligatorios:
- principal: Completa el campo principal.user con detalles sobre los intentos de acceder a un recurso de la nube (por ejemplo, un caso de Salesforce, un calendario de Office365, un documento de Google o un ticket de ServiceNow).
- target: Completa el campo target.resource con información sobre el recurso de nube de destino.
Campos opcionales:
- target.application: (Recomendado) Completa el campo target.application con información sobre la aplicación de nube de destino.
USER_RESOURCE_CREATION, USER_RESOURCE_DELETION
Campos obligatorios:
- principal: Completa el campo principal.user con los detalles asociados con el usuario creado dentro de un recurso de nube (por ejemplo, un caso de Salesforce, un calendario de Office 365, un documento de Google o un ticket de ServiceNow).
- target: Completa el campo target.resource con información sobre el recurso de nube de destino.
Campos opcionales:
- target.application: (Recomendado) Completa el campo target.application con información sobre la aplicación de nube de destino.
USER_RESOURCE_UPDATE_CONTENT
Campos obligatorios:
- principal: Completa el campo principal.user con los detalles asociados con el usuario cuyo contenido se actualizó en un recurso de nube (por ejemplo, un caso de Salesforce, un calendario de Office365, un documento de Google o un ticket de ServiceNow).
- target: Completa el campo target.resource con información sobre el recurso de nube de destino.
Campos opcionales:
- target.application: (Recomendado) Completa el campo target.application con información sobre la aplicación de nube de destino.
USER_RESOURCE_UPDATE_PERMISSIONS
Campos obligatorios:
- principal: Completa el campo principal.user con los detalles asociados con el usuario cuyos permisos se actualizaron en un recurso de nube (por ejemplo, un caso de Salesforce, un calendario de Office 365, un documento de Google o un ticket de ServiceNow).
- target: Completa el campo target.resource con información sobre el recurso de nube de destino.
Campos opcionales:
- target.application: (Recomendado) Completa el campo target.application con información sobre la aplicación de nube de destino.
USER_UNCATEGORIZED
Campos obligatorios:
- metadata: Incluye
event_timestampyevent_type. - principal o target:
- Si no se completa
target,principaldebe incluir al menos un identificador de usuario válido enprincipal.user(userid,windows_sid,email_addressesoemployee_id, de hasta 256 caracteres) o al menos un identificador de máquina (hostname,ip,macoasset_id). - Si se completa
target, debes completar al menos uno de los siguientes campos: un identificador de usuario entarget.user, un identificador de máquina entargeto un identificador de usuario válido enprincipal.user.
- Si no se completa
Campos opcionales:
- principal.process: Son los detalles del proceso asociados con la actividad del usuario.
- security_result: Describe cualquier actividad maliciosa o anómala detectada.