Guia de uso da UDM
Este documento fornece o seguinte:
- Descrições detalhadas dos campos de esquema do modelo de dados unificado (UDM)
- Campos obrigatórios e opcionais para tipos de entidade
- Campos obrigatórios e opcionais para cada tipo de evento
Para detalhes sobre campos específicos do UDM (por exemplo, números de tipo enumerado), consulte a lista de campos do Modelo de Dados Unificado.
Formatos de nome de campo do UDM:
- Para a avaliação do mecanismo de regras, o prefixo começa com udm.
- Para o normalizador baseado em configuração (CBN, na sigla em inglês), o prefixo começa com event.idm.read_only_udm.
Preenchimento de metadados de eventos
A seção de metadados de eventos do UDM armazena informações gerais sobre cada evento.
Metadata.event_type
- Finalidade: especifica o tipo do evento. Se um evento tiver vários tipos possíveis, esse valor precisará especificar o tipo mais específico.
- Obrigatório: sim.
- Codificação: precisa ser um dos tipos enumerados
event_typepredefinidos do UDM. - Valores possíveis: as seções a seguir listam todos os valores possíveis para
metadata.event_typeno UDM. Para saber quais são os campos obrigatórios e opcionais de cada categoria, consulte Campos obrigatórios e opcionais para cada tipo de evento.
Eventos de analista
- 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 do dispositivo
Eventos relacionados a atualizações de firmware, configuração ou programa em um dispositivo (como um sistema de controle industrial ou um recurso de tecnologia operacional):
- DEVICE_CONFIG_UPDATE
- DEVICE_FIRMWARE_UPDATE
- DEVICE_PROGRAM_DOWNLOAD
- DEVICE_PROGRAM_UPLOAD
Eventos de e-mail
Eventos relacionados a transações de e-mail e inspeções de segurança de e-mail:
- EMAIL_UNCATEGORIZED
- EMAIL_TRANSACTION
- EMAIL_URL_CLICK (descontinuado)
Eventos não especificados
Valor do marcador para um tipo de evento não inicializado (os eventos definidos como EVENTTYPE_UNSPECIFIED falham na validação do UDM):
- EVENTTYPE_UNSPECIFIED
Eventos de arquivo realizados em um endpoint
- FILE_UNCATEGORIZED
- FILE_COPY (por exemplo, copiar um arquivo para um pen drive)
- FILE_CREATION
- FILE_DELETION
- FILE_MODIFICATION
- FILE_MOVE
- FILE_OPEN (por exemplo, abrir um arquivo pode indicar uma violação de segurança)
- FILE_READ (por exemplo, ler um arquivo de senha)
- FILE_SYNC
Eventos que não se enquadram em nenhuma outra categoria
Eventos que não se enquadram em nenhuma outra categoria, incluindo eventos do sistema operacional sem categoria:
- GENERIC_EVENT
Eventos de atividade em grupo
Eventos relacionados à criação, modificação ou exclusão de grupos de usuários ou do sistema:
- GROUP_UNCATEGORIZED
- GROUP_CREATION
- GROUP_DELETION
- GROUP_MODIFICATION
Eventos de mutex
Eventos relacionados à criação ou ao gerenciamento de um objeto de exclusão mútua (mutex) em um endpoint:
- MUTEX_UNCATEGORIZED
- MUTEX_CREATION
Eventos de telemetria de rede
Eventos de telemetria de rede, que incluem payloads de protocolo brutos, como DHCP e DNS, além de resumos de protocolos como HTTP, SMTP e FTP e eventos de fluxo e conexão de NetFlow e firewalls:
- NETWORK_UNCATEGORIZED
- NETWORK_CONNECTION (por exemplo, detalhes de conexão de rede de um firewall)
- NETWORK_DHCP
- NETWORK_DNS
- NETWORK_FLOW (por exemplo, estatísticas de fluxo agregadas do Netflow)
- NETWORK_FTP
- NETWORK_HTTP
- NETWORK_SMTP
Processar eventos
Qualquer evento relacionado a um processo, como o início de um processo, um processo que cria algo mal-intencionado, um processo que se injeta em outro, uma alteração de uma chave de registro ou a criação de um arquivo mal-intencionado no disco:
- PROCESS_UNCATEGORIZED
- PROCESS_INJECTION
- PROCESS_LAUNCH
- PROCESS_MODULE_LOAD
- PROCESS_OPEN
- PROCESS_PRIVILEGE_ESCALATION
- PROCESS_TERMINATION
Eventos do Registry
Use os seguintes eventos REGISTRY em vez dos eventos SETTING ao lidar com eventos de registro específicos do Microsoft Windows:
- REGISTRY_UNCATEGORIZED
- REGISTRY_CREATION
- REGISTRY_MODIFICATION
- REGISTRY_DELETION
Eventos do recurso
Eventos relacionados à criação, leitura, gravação, exclusão ou alteração de permissões em um recurso:
- RESOURCE_CREATION
- RESOURCE_DELETION
- RESOURCE_PERMISSIONS_CHANGE
- RESOURCE_READ
- RESOURCE_WRITTEN
Eventos orientados à verificação
Os eventos orientados por verificação incluem verificações sob demanda e detecções comportamentais realizadas por produtos de segurança de rede ou de endpoint (como EDR, antivírus, verificadores de vulnerabilidades ou DLP):
- SCAN_UNCATEGORIZED
- SCAN_FILE
- SCAN_HOST
- SCAN_NETWORK
- SCAN_PROCESS
- SCAN_PROCESS_BEHAVIORS (descontinuado)
- SCAN_VULN_HOST
- SCAN_VULN_NETWORK
Eventos de tarefas agendadas (Agendador de Tarefas do Windows, cron etc.)
- SCHEDULED_TASK_UNCATEGORIZED
- SCHEDULED_TASK_CREATION
- SCHEDULED_TASK_DELETION
- SCHEDULED_TASK_DISABLE
- SCHEDULED_TASK_ENABLE
- SCHEDULED_TASK_MODIFICATION
Eventos de serviço
Eventos relacionados à criação, exclusão, modificação, inicialização ou interrupção de um sistema operacional ou serviço de aplicativo:
- SERVICE_UNSPECIFIED
- SERVICE_CREATION
- SERVICE_DELETION
- SERVICE_MODIFICATION
- SERVICE_START
- SERVICE_STOP
Como definir eventos
Para definir os requisitos para eventos, consulte SETTING_UNCATEGORIZED, SETTING_CREATION, SETTING_MODIFICATION, SETTING_DELETION.
Eventos de configuração, incluindo quando uma configuração do sistema é alterada em um endpoint:
- SETTING_UNCATEGORIZED
- SETTING_CREATION
- SETTING_DELETION
- SETTING_MODIFICATION
Mensagens de status de produtos de segurança
Mensagens de status de produtos de segurança para indicar que os agentes estão ativos e enviar dados de versão, impressão digital ou outros tipos:
- STATUS_UNCATEGORIZED
- STATUS_HEARTBEAT (indica que o produto está ativo)
- STATUS_STARTUP
- STATUS_SHUTDOWN
- STATUS_UPDATE (atualização de software ou impressão digital)
Eventos de registro de auditoria do sistema
- SYSTEM_AUDIT_LOG_UNCATEGORIZED
- SYSTEM_AUDIT_LOG_WIPE
Eventos de atividade de autenticação do usuário
- USER_UNCATEGORIZED
- USER_BADGE_IN (por exemplo, quando um usuário usa um crachá físico para entrar em um site)
- 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 (descontinuado)
Metadata.collected_timestamp
- Finalidade: codifica o carimbo de data/hora do GMT quando o evento foi coletado pela infraestrutura de coleta local do fornecedor.
- Codificação: RFC 3339, conforme apropriado para o formato de carimbo de data/hora JSON ou Proto3.
- Exemplo:
- RFC 3339: '2019-09-10T20:32:31-08:00'
- Formato Proto3: '2012-04-23T18:25:43.511Z'
Metadata.event_timestamp
- Finalidade: codifica o carimbo de data/hora do GMT quando o evento foi gerado.
- Obrigatório: sim
- Codificação: RFC 3339, conforme apropriado para o formato de carimbo de data/hora JSON ou Proto3.
- Exemplo:
- RFC 3339: 2019-09-10T20:32:31-08:00
- Formato Proto3: 2012-04-23T18:25:43.511Z
Metadata.description
- Finalidade: descrição legível por humanos do evento.
- Codificação: string alfanumérica, pontuação permitida, máximo de 1.024 bytes
- Exemplo: o arquivo c:\bar\foo.exe foi impedido de acessar o documento confidencial c:\documents\earnings.docx.
Metadata.product_event_type
- Finalidade: nome do evento ou tipo de evento curto, descritivo, legível por humanos e específico do produto.
- Codificação: string alfanumérica, pontuação permitida, máximo de 64 bytes.
- Exemplos:
- Evento de criação de registro
- ProcessRollUp
- Escalonamento de privilégios detectado
- Malware bloqueado
Metadata.product_log_id
- Finalidade: codifica um identificador de evento específico do fornecedor para identificar o evento de forma exclusiva (um GUID). Os usuários podem usar esse identificador para pesquisar o evento em questão no console proprietário do fornecedor.
- Codificação: string alfanumérica que diferencia maiúsculas de minúsculas, pontuação permitida, máximo de 256 bytes.
- Exemplo: ABcd1234-98766
Metadata.product_name
- Finalidade: especifica o nome do produto.
- Codificação: string alfanumérica que diferencia maiúsculas de minúsculas, pontuação permitida, máximo de 256 bytes.
- Exemplos:
- Falcon
- Symantec Endpoint Protection
Metadata.product_version
- Finalidade: especifica a versão do produto.
- Codificação: string alfanumérica, pontos e traços permitidos, máximo de 32 bytes
- Exemplos:
- 1.2.3b
- 10.3:rev1
Metadata.url_back_to_product
- Finalidade: URL que direciona a um site relevante onde é possível ver mais informações sobre esse evento específico (ou a categoria geral do evento).
- Codificação: URL RFC 3986 válido com parâmetros opcionais, como informações de porta etc. É necessário ter um prefixo de protocolo antes do URL (por exemplo, https:// ou http://).
- Exemplo: https://newco.altostrat.com:8080/event_info?event_id=12345
Metadata.vendor_name
- Finalidade: especifica o nome do fornecedor do produto.
- Codificação: string alfanumérica que diferencia maiúsculas de minúsculas, pontuação permitida, máximo de 256 bytes
- Exemplos:
- CrowdStrike
- Symantec
Preenchimento de metadados de substantivos
Nesta seção, a palavra Noun é um termo abrangente usado para representar as seguintes entidades: principal, src, target, intermediary, observer e about. Essas entidades têm atributos comuns, mas representam objetos diferentes em um evento. Para mais informações sobre entidades e o que cada uma representa em um evento, consulte Formatar um evento de UDM.
Noun.asset_id
- Finalidade: identificador exclusivo do dispositivo específico do fornecedor (por exemplo, um GUID gerado ao instalar o software de segurança de endpoint em um novo dispositivo usado para rastrear esse dispositivo exclusivo ao longo do tempo).
- Codificação: (VendorName ou VendorAbbreviation):ID, em que VendorName ou VendorAbbreviation é um nome de fornecedor que não diferencia maiúsculas de minúsculas, como
Carbon BlackouCB, e ID é um identificador de cliente específico do fornecedor que é globalmente exclusivo no ambiente do cliente (por exemplo, um GUID ou um valor exclusivo que identifica um dispositivo exclusivo). VendorName é alfanumérico e tem no máximo 32 caracteres. O ID pode ter no máximo 128 caracteres e incluir caracteres alfanuméricos, traços e pontos. - Exemplo:
CrowdStrike:0bce4259-4ada-48f3-a904-9a526b01311f - Exemplo:
CS:0bce4259-4ada-48f3-a904-9a526b01311f
Noun.email
- Finalidade: endereço de e-mail
- Codificação: formato de endereço de e-mail padrão.
- Exemplo: joaos@test.altostrat.com
Noun.file
- Finalidade: metadados detalhados do arquivo.
- Tipo: objeto
- Consulte Preenchimento de metadados de arquivo.
Noun.hostname
- Finalidade: campo de nome do host ou nome de domínio do cliente. Não inclua se um URL estiver presente.
- Codificação: nome do host RFC 1123 válido.
- Restrição de validação: as strings de nome do host não podem exceder 255 bytes de comprimento para obedecer aos limites de indexação da pesquisa.
- Exemplos:
- userwin10
- www.altostrat.com
Noun.platform
- Finalidade: sistema operacional da plataforma.
- Codificação: tipo enumerado
- Valores possíveis:
- LINUX
- MAC
- WINDOWS
- UNKNOWN_PLATFORM
Noun.platform_patch_level
- Finalidade: nível de patch do sistema operacional da plataforma.
- Codificação: string alfanumérica com pontuação, máximo de 64 caracteres.
- Exemplo: Build 17134.48
Noun.platform_version
- Finalidade: versão do sistema operacional da plataforma.
- Codificação: string alfanumérica com pontuação, máximo de 64 caracteres.
- Exemplo: Microsoft Windows 10 versão 1803
Noun.process
- Finalidade: metadados detalhados do processo.
- Tipo: objeto
- Consulte Preenchimento de metadados de processo.
Noun.ip
- Objetivo:
- Endereço IP único associado a uma conexão de rede.
- Um ou mais endereços IP associados a um dispositivo participante no momento do evento (por exemplo, se um produto de EDR conhece todos os endereços IP associados a um dispositivo, ele pode codificar todos eles nos campos de IP).
- Codificação: string de endereço IPv4 (4 bytes) ou IPv6 (16 bytes) válida (RFC 5942) codificada em ASCII.
- Repetibilidade:
- Se um evento descrever uma conexão de rede específica (por exemplo, srcip:srcport > dstip:dstport), forneça apenas um endereço IP.
- Se um evento descrever uma atividade geral que ocorre em um dispositivo participante, mas não uma conexão de rede específica, forneça todos os endereços IP associados ao dispositivo no momento do evento.
- Exemplos:
- 192.168.1.2
- 2001:db8:1:3::1
Noun.port
- Finalidade: número da porta de rede de origem ou de destino quando uma conexão de rede específica é descrita em um evento.
- Codificação: número de porta TCP/IP válido de 1 a 65.535.
Exemplos:
- 80
- 443
Noun.mac
- Finalidade: um ou mais endereços MAC associados a um dispositivo.
- Codificação: endereço MAC válido de 6 bytes em conformidade com o formato de identificador exclusivo estendido de 48 bits (EUI-48) codificado em ASCII.
- Repetibilidade: é possível fornecer todos os endereços MAC associados ao dispositivo no momento do evento.
- Exemplos:
- 00:24:98:7B:19:02
- 00:00:5e:00:53:2a
Noun.administrative_domain
- Finalidade: domínio ao qual o dispositivo pertence (por exemplo, o domínio do Windows).
- Codificação: string de nome de domínio válida (máximo de 128 caracteres).
- Exemplo: corp.altostrat.com
Noun.registry
- Finalidade: metadados detalhados do registro.
- Tipo: objeto
- Consulte Preenchimento de metadados do Registry.
Noun.url
- Finalidade: URL padrão
- Codificação: URL (RFC 3986). Precisa ter um prefixo de protocolo válido (por exemplo, https:// ou ftp://). Precisa incluir o domínio e o caminho completos. Pode incluir os parâmetros do URL.
- Exemplo: https://foo.altostrat.com/bletch?a=b;c=d
Noun.user
- Finalidade: metadados detalhados do usuário.
- Tipo: objeto
- Consulte Preenchimento de metadados do usuário.
Preenchimento de metadados de autenticação
Authentication.AuthType
- Finalidade: tipo de sistema ao qual um evento de autenticação está associado (UDM do Google Security Operations).
- Codificação: tipo enumerado.
- Valores possíveis:
- AUTHTYPE_UNSPECIFIED
- MACHINE: autenticação de máquina
- PHYSICAL: autenticação física (por exemplo, um leitor de crachás)
- SSO
- TACACS: protocolo da família TACACS para autenticação de sistemas em rede (por exemplo, TACACS ou TACACS+)
- VPN
Authentication.Authentication_Status
- Finalidade: descreve o status de autenticação de um usuário ou de uma credencial específica.
- Codificação: tipo enumerado.
- Valores possíveis:
- UNKNOWN_AUTHENTICATION_STATUS: status de autenticação padrão
- ACTIVE: o método de autenticação está ativo.
- SUSPENDED: o método de autenticação está suspenso ou desativado.
- DELETED: o método de autenticação foi excluído.
- NO_ACTIVE_CREDENTIALS: o método de autenticação não tem credenciais ativas.
Authentication.auth_details
- Finalidade: detalhes de autenticação definidos pelo fornecedor.
- Codificação: string.
Authentication.Mechanism
- Finalidade: mecanismos usados para autenticação.
- Codificação: tipo enumerado.
- Valores possíveis:
- MECHANISM_UNSPECIFIED: mecanismo de autenticação padrão.
- BADGE_READER
- BATCH: autenticação em lote.
- CACHED_INTERACTIVE: autenticação interativa usando credenciais armazenadas em cache.
- HARDWARE_KEY
- LOCAL
- MECHANISM_OTHER: algum outro mecanismo que não está definido aqui.
- NETWORK: autenticação de rede.
- NETWORK_CLEAR_TEXT: autenticação de texto não criptografado de rede.
- NEW_CREDENTIALS: autenticação com novas credenciais.
- OTP
- REMOTE: autenticação remota
- REMOTE_INTERACTIVE: RDP, serviços de terminal, Virtual Network Computing (VNC) etc.
- SERVICE: autenticação de serviço.
- UNLOCK: autenticação de desbloqueio interativo humano direto.
- USERNAME_PASSWORD
Preenchimento de metadados de DHCP
Os campos de metadados do protocolo de controle de host dinâmico (DHCP) capturam informações de registro do protocolo de gerenciamento de rede DHCP.
Dhcp.client_hostname
- Finalidade: nome do host do cliente. Consulte a RFC 2132, Opções de DHCP e extensões de fornecedor BOOTP, para mais informações.
- Codificação: string.
- Restrição de validação: as strings de opção de nome do host não podem exceder 255 bytes de comprimento para obedecer aos limites de indexação da pesquisa.
Dhcp.client_identifier
- Finalidade: identificador do cliente. Consulte a RFC 2132, Opções de DHCP e extensões de fornecedor BOOTP, para mais informações.
- Codificação: bytes.
Dhcp.file
- Finalidade: nome do arquivo da imagem de inicialização.
- Codificação: string.
Dhcp.flags
- Finalidade: valor do campo de flags do DHCP.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.hlen
- Finalidade: tamanho do endereço de hardware.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.hops
- Finalidade: contagem de saltos do DHCP.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.htype
- Finalidade: tipo de endereço de hardware.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.lease_time_seconds
- Finalidade: tempo de concessão solicitado pelo cliente para um endereço IP em segundos. Consulte a RFC 2132, Opções de DHCP e extensões de fornecedor BOOTP, para mais informações.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.opcode
- Finalidade: código de operação BOOTP (consulte a seção 3 da RFC 951).
- Codificação: tipo enumerado.
- Valores possíveis:
- UNKNOWN_OPCODE
- BOOTREQUEST
- BOOTREPLY
Dhcp.requested_address
- Finalidade: identificador do cliente. Consulte a RFC 2132, Opções de DHCP e extensões de fornecedor BOOTP, para mais informações.
- Codificação: endereço IPv4 ou IPv6 válido (RFC 5942) codificado em ASCII.
Dhcp.seconds
- Finalidade: segundos decorridos desde que o cliente iniciou o processo de aquisição ou renovação do endereço.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.sname
- Finalidade: nome do servidor que o cliente solicitou para inicialização.
- Codificação: string.
Dhcp.transaction_id
- Finalidade: ID da transação do cliente.
- Codificação: número inteiro sem assinatura de 32 bits.
Dhcp.type
- Finalidade: tipo de mensagem DHCP. Consulte a RFC 1533 para mais informações.
- Codificação: tipo enumerado.
- Valores possíveis:
- UNKNOWN_MESSAGE_TYPE
- DESCOBRIR
- OFERTA
- SOLICITAÇÃO
- RECUSAR
- CONF
- NAK
- RELEASE
- INFORMAR
- WIN_DELECTED
- WIN_EXPIRED
Dhcp.chaddr
- Finalidade: endereço de hardware do cliente.
- Codificação: endereço MAC.
Dhcp.ciaddr
- Finalidade: endereço IP do cliente.
- Codificação: endereço IPv4 ou IPv6 válido (RFC 5942) codificado em ASCII.
Dhcp.giaddr
- Finalidade: endereço IP do agente de redirecionamento.
- Codificação: endereço IPv4 ou IPv6 válido (RFC 5942) codificado em ASCII.
Dhcp.siaddr
- Finalidade: endereço IP do próximo servidor de bootstrap.
- Codificação: endereço IPv4 ou IPv6 válido (RFC 5942) codificado em ASCII.
Dhcp.yiaddr
- Finalidade: seu endereço IP.
- Codificação: endereço IPv4 ou IPv6 válido (RFC 5942) codificado em ASCII.
Preenchimento de metadados da opção DHCP
Os campos de metadados da opção DHCP capturam as informações de registro da opção DHCP.
Option.code
- Finalidade: armazena o código da opção DHCP. Consulte a RFC 1533, Opções de DHCP e extensões de fornecedor BOOTP, para mais informações.
- Codificação: número inteiro não assinado de 32 bits.
Option.data
- Finalidade: armazena os dados da opção DHCP. Consulte a RFC 1533, Opções de DHCP e extensões de fornecedor BOOTP, para mais informações.
- Codificação: bytes.
Preenchimento de metadados de DNS
Os campos de metadados de DNS capturam informações relacionadas aos pacotes de solicitação e resposta de DNS. Eles têm uma correspondência de um para um com os dados encontrados nos datagramas de solicitação e resposta de DNS.
Dns.authoritative
- Finalidade: defina como verdadeiro para servidores DNS autoritativos.
- Codificação: booleano.
Dns.id
- Finalidade: armazena o identificador da consulta DNS.
- Codificação: número inteiro de 32 bits.
Dns.response
- Finalidade: defina como verdadeiro se o evento for uma resposta de DNS.
- Codificação: booleano.
Dns.opcode
- Finalidade: armazena o OpCode de DNS usado para especificar o tipo de consulta DNS (padrão, inversa, status do servidor etc.).
- Codificação: número inteiro de 32 bits.
Dns.recursion_available
- Finalidade: defina como verdadeiro se uma busca DNS recursiva estiver disponível.
- Codificação: booleano.
Dns.recursion_desired
- Finalidade: definido como verdadeiro se uma busca DNS recursiva for solicitada.
- Codificação: booleano.
Dns.response_code
- Finalidade: armazena o código de resposta do DNS, conforme definido pela RFC 1035, Nomes de domínio: implementação e especificação.
- Codificação: número inteiro de 32 bits.
Dns.truncated
- Finalidade: definido como verdadeiro se for uma resposta de DNS truncada.
- Codificação: booleano.
Dns.questions
- Finalidade: armazena as perguntas da mensagem do protocolo de domínio. Consulte Preenchimento de metadados de consulta DNS.
Dns.answers
- Finalidade: armazena a resposta à consulta de nome de domínio. Consulte Preenchimento de metadados de registro de recurso de DNS.
Dns.authority
- Finalidade: armazena os servidores de nomes de domínio que verificaram a resposta à consulta de nome de domínio. Consulte Preenchimento de metadados de registro de recurso de DNS.
Dns.additional
- Finalidade: armazena os servidores de nomes de domínio adicionais que podem ser usados para verificar a resposta ao domínio. Consulte Preenchimento de metadados de registro de recurso de DNS.
Preenchimento de metadados de consulta DNS
Os campos de metadados de pergunta de DNS capturam as informações contidas na seção de pergunta de uma mensagem de protocolo de domínio.
Question.name
- Finalidade: armazena o nome de domínio.
- Codificação: string.
- Restrição de validação: as strings de consulta de domínio não podem ficar vazias e precisam ter até 255 octetos (bytes), de acordo com as regulamentações do RFC 1035 e os limites de indexação da Pesquisa.
Question.class
- Finalidade: armazena o código que especifica a classe da consulta.
- Codificação: número inteiro de 32 bits.
Question.type
- Finalidade: armazena o código que especifica o tipo da consulta.
- Codificação: número inteiro de 32 bits.
Preenchimento de metadados de registro de recurso DNS
Os campos de metadados do registro de recurso DNS capturam as informações contidas no registro de recurso de uma mensagem de protocolo de domínio.
ResourceRecord.binary_data
- Finalidade: armazena os bytes brutos de qualquer string que não seja UTF8 e que possa ser incluída como parte de uma resposta de DNS. Esse campo só deve ser usado se os dados de resposta retornados pelo servidor DNS não forem UTF8. Caso contrário, coloque a resposta DNS no campo "data". Esse tipo de informação precisa ser armazenado aqui, e não em ResourceRecord.data.
Codificação: bytes.
ResourceRecord.class
- Finalidade: armazena o código que especifica a classe do registro de recurso.
- Codificação: número inteiro de 32 bits.
ResourceRecord.data
- Finalidade: armazena o payload ou a resposta à pergunta de DNS para todas as respostas codificadas no formato UTF-8. Por exemplo, o campo de dados pode retornar o endereço IP da máquina a que o nome de domínio se refere. Se o registro de recurso for de um tipo ou classe diferente, ele poderá conter outro nome de domínio (quando um nome de domínio é redirecionado para outro). Os dados precisam ser armazenados exatamente como estão na resposta do DNS.
- Codificação: string.
ResourceRecord.name
- Finalidade: armazena o nome do proprietário do registro de recurso.
- Codificação: string.
ResourceRecord.ttl
- Finalidade: armazena o intervalo de tempo em que o registro de recurso pode ser armazenado em cache antes que a fonte das informações seja consultada novamente.
- Codificação: número inteiro de 32 bits.
ResourceRecord.type
- Finalidade: armazena o código que especifica o tipo do registro de recurso.
- Codificação: número inteiro de 32 bits.
Preenchimento de metadados de e-mail
A maioria dos campos de metadados de e-mail captura os endereços de e-mail incluídos no cabeçalho da mensagem e precisa estar em conformidade com o formato padrão de endereço de e-mail (local-mailbox@domain), conforme definido no RFC 5322. Por exemplo, frank@email.example.com.
Email.from
- Finalidade: armazena o endereço de e-mail de.
- Codificação: string.
Email.reply_to
- Finalidade: armazena o endereço de e-mail reply_to.
- Codificação: string.
Email.to
- Finalidade: armazena os endereços de e-mail para.
- Codificação: string.
Email.cc
- Finalidade: armazena os endereços de e-mail em Cc.
- Codificação: string.
Email.bcc
- Finalidade: armazena os endereços de e-mail em cco.
- Codificação: string.
Email.mail_id
- Finalidade: armazena o ID do e-mail (ou da mensagem).
- Codificação: string.
- Exemplo: 192544.132632@email.example.com
Email.subject
- Finalidade: armazena a linha de assunto do e-mail.
- Codificação: string.
- Exemplo: "Leia esta mensagem."
Preenchimento de metadados de extensões
Tipos de eventos com metadados integrados que ainda não foram categorizados pelo UDM do Google SecOps.
Extensions.auth
- Finalidade: extensão para os metadados de autenticação.
- Codificação: string.
- Exemplos:
- Metadados de sandbox (todos os comportamentos exibidos por um arquivo, por exemplo, FireEye).
- Dados do controle de acesso à rede (NAC).
- Detalhes do LDAP sobre um usuário (por exemplo, função, organização etc.).
Extensions.auth.auth_details
- Finalidade: especificar os detalhes específicos do fornecedor para o tipo ou mecanismo de autenticação. Os provedores de autenticação geralmente definem tipos como via_mfa ou via_ad, que fornecem informações úteis sobre o tipo de autenticação. Esses tipos ainda podem ser generalizados em auth.type ou auth.mechanism para usabilidade e compatibilidade de regras entre conjuntos de dados.
- Codificação: string.
- Exemplos: via_mfa, via_ad.
Extensions.vulns
- Finalidade: extensão para os metadados de vulnerabilidade.
- Codificação: string.
- Exemplo: dados de verificação de vulnerabilidades do host.
Preenchimento de metadados de arquivos
File.file_metadata
- Finalidade: metadados associados ao arquivo.
- Codificação: string.
- Exemplos:
- Autor
- Número da revisão
- Número da versão
- Data em que a página foi salva
File.full_path
- Finalidade: caminho completo que identifica o local do arquivo no sistema.
- Codificação: string.
- Exemplo: \Program Files\Custom Utilities\Test.exe
File.md5
- Finalidade: valor de hash MD5 do arquivo.
- Codificação: string, hexadecimal em minúsculas.
- Exemplo: 35bf623e7db9bf0d68d0dda764fd9e8c
File.mime_type
- Finalidade: tipo MIME (Multipurpose Internet Mail Extensions) do arquivo.
- Codificação: string.
- Exemplos:
- PE
- script do PowerShell
File.sha1
- Finalidade: valor de hash SHA-1 do arquivo.
- Codificação: string, hexadecimal em minúsculas.
- Exemplo: eb3520d53b45815912f2391b713011453ed8abcf
File.sha256
- Finalidade: valor de hash SHA-256 do arquivo.
- Codificação: string, hexadecimal em minúsculas.
- Exemplo: d7173c568b8985e61b4050f81b3fd8e75bc922d2a0843d7079c81ca4b6e36417
File.size
- Finalidade: tamanho do arquivo.
- Codificação: número inteiro sem sinal de 64 bits.
- Exemplo: 342135
Preenchimento de metadados de FTP
Ftp.command
- Finalidade: armazena o comando FTP.
- Codificação: string.
- Exemplos:
- binary
- excluir
- get
- put
Preenchimento de metadados do grupo
Informações sobre um grupo organizacional. Para representar uma identidade de grupo organizacional válida durante a normalização, é necessário parametrizar pelo menos um atributo de grupo principal especificando um endereço de e-mail em Group.email_addresses ou um identificador de segurança do Windows em Group.windows_sid.
Group.creation_time
- Finalidade: horário de criação do grupo.
- Codificação: RFC 3339, conforme apropriado para o formato de carimbo de data/hora JSON ou Proto3.
Group.email_addresses
- Finalidade: agrupar dados de contato.
- Codificação: e-mail.
Group.group_display_name
- Finalidade: nome de exibição do grupo.
- Codificação: string.
- Exemplos:
- Finanças
- HR
- Marketing
Group.product_object_id
- Finalidade: identificador de objeto de usuário globalmente exclusivo para o produto, como um identificador de objeto LDAP.
- Codificação: string.
Group.windows_sid
- Finalidade: campo de atributo de grupo do identificador de segurança (SID) do Microsoft Windows.
- Codificação: string.
Preenchimento de metadados HTTP
Http.method
- Finalidade: armazena o método de solicitação HTTP. Quando o tráfego ocorre por protocolos de transporte HTTP ou HTTPS, é necessário especificar um método de solicitação ativo. Não é possível deixar o método definido como METHOD_UNSPECIFIED.
- Codificação: string.
- Exemplos:
- GET
- HEAD
- POST
Http.referral_url
- Finalidade: armazena o URL do referenciador de HTTP.
- Codificação: URL RFC 3986 válido.
- Exemplo: https://www.altostrat.com
Http.response_code
- Finalidade: armazena o código de status da resposta HTTP, que indica se uma solicitação HTTP específica foi concluída com sucesso.
- Codificação: número inteiro de 32 bits.
- Exemplos:
- 400
- 404
Http.user_agent
- Finalidade: armazena o cabeçalho da solicitação do user agent, que inclui o tipo de aplicativo, o sistema operacional, o fornecedor ou a versão do software do user agent solicitante. As strings de cabeçalho User-Agent precisam consistir inteiramente em matrizes de caracteres válidas codificadas em UTF-8.
- Codificação: string.
- Exemplos:
- Mozilla/5.0 (X11; Linux x86_64)
- AppleWebKit/534.26 (KHTML, like Gecko)
- Chrome/41.0.2217.0
- Safari/527.33
Preenchimento de metadados de local
Location.city
- Finalidade: armazena o nome da cidade.
- Codificação: string.
- Exemplos:
- Sunnyvale
- Chicago
- Málaga
Location.country_or_region
- Finalidade: armazena o nome do país ou da região do mundo.
- Codificação: string.
- Exemplos:
- Estados Unidos
- Reino Unido
- Espanha
Location.name
- Finalidade: armazena o nome específico da empresa, como um edifício ou campus.
- Codificação: string.
- Exemplos:
- Campus 7B
- Prédio A2
Location.state
- Finalidade: armazena o nome do estado, da província ou do território.
- Codificação: string.
- Exemplos:
- Califórnia
- Illinois
- Ontário
Preenchimento de metadados de rede
Network.application_protocol
- Finalidade: indica o protocolo do aplicativo de rede.
- Codificação: tipo enumerado.
Valores possíveis:
- 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
- INATIVO
- 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
- Finalidade: indica a direção do tráfego de rede.
- Codificação: tipo enumerado.
- Valores possíveis:
- UNKNOWN_DIRECTION
- RECEBIDA
- REALIZADA
- TRANSMISSÃO
Network.email
- Finalidade: especifica o endereço de e-mail do remetente/destinatário.
- Codificação: string.
- Exemplo: jcheng@company.example.com
Network.ip_protocol
- Finalidade: indica o protocolo IP.
- Codificação: tipo enumerado.
- Valores possíveis:
- UNKNOWN_IP_PROTOCOL
- EIGRP: protocolo de roteamento de gateway interior avançado
- ESP: Encapsulating Security Payload
- ETHERIP: encapsulamento de Ethernet dentro de IP
- GRE: encapsulamento de roteamento genérico
- ICMP: Internet Control Message Protocol
- IGMP: protocolo de gerenciamento de grupos da Internet
- IP6IN4: encapsulamento IPv6
- PIM: multicast independente de protocolo
- TCP—protocolo TCP
- UDP: protocolo de datagramas do usuário
- VRRP: protocolo de redundância de roteador virtual
Network.received_bytes
- Finalidade: especifica o número de bytes recebidos.
- Codificação: número inteiro sem sinal de 64 bits.
- Exemplo: 12,453,654,768
Network.sent_bytes
- Finalidade: especifica o número de bytes enviados.
- Codificação: número inteiro sem sinal de 64 bits.
- Exemplo: 7.654.876
Network.session_duration
- Finalidade: armazena a duração da sessão de rede, normalmente retornada em um evento de queda da sessão. Para definir a duração, use network.session_duration.seconds = 1 (tipo int64) ou network.session_duration.nanos = 1 (tipo int32).
- Codificação:
- Número inteiro de 32 bits: para segundos (network.session_duration.seconds).
- Número inteiro de 64 bits: para nanossegundos (network.session_duration.nanos).
Network.session_id
- Finalidade: armazena o identificador da sessão de rede.
- Codificação: string.
- Exemplo: SID:ANON:www.w3.org:j6oAOxCWZh/CD723LGeXlf-01:34
Preenchimento de metadados de processo
Process.command_line
- Finalidade: armazena a string de linha de comando do processo.
- Codificação: string.
- Exemplo: grupo
c:\windows\system32\net.exe.
Process.product_specific_process_id
- Finalidade: armazena o ID de processo específico do produto.
- Codificação: string.
- Exemplos:
MySQL:78778ouCS:90512.
Process.parent_process.product_specific_process_id
- Finalidade: armazena o ID de processo específico do produto para o processo pai.
- Codificação: string.
- Exemplos:
MySQL:78778ouCS:90512.
Process.file
- Finalidade: armazena o nome de arquivo em uso pelo processo.
- Codificação: string.
- Exemplo: report.xls
Process.parent_process
- Finalidade: armazena os detalhes do processo pai.
- Codificação: substantivo (processo)
Process.pid
- Finalidade: armazena o ID de processo.
- Codificação: string.
- Exemplos:
- 308
- 2002
Preenchimento de metadados do Registry
Registry.registry_key
- Finalidade: armazena a chave de registro associada a um aplicativo ou componente do sistema.
- Codificação: string.
- Exemplo: HKEY_LOCAL_MACHINE/SYSTEM/DriverDatabase
Registry.registry_value_name
- Finalidade: armazena o nome do valor de registro associado a um aplicativo ou componente do sistema.
- Codificação: string.
- Exemplo: TEMP
Registry.registry_value_data
- Finalidade: armazena os dados associados a um valor de registro.
- Codificação: string.
- Exemplo: %USERPROFILE%\Local Settings\Temp
Preenchimento de metadados de resultado de segurança
Os metadados do resultado de segurança incluem detalhes sobre riscos e ameaças de segurança encontrados por um sistema de segurança, bem como as ações tomadas para mitigar esses riscos e ameaças.
SecurityResult.about
- Finalidade: forneça uma descrição do resultado de segurança.
- Codificação: substantivo.
SecurityResult.action
- Finalidade: especificar uma ação de segurança.
- Codificação: tipo enumerado.
- Valores possíveis: o UDM do Google SecOps define as seguintes ações de segurança:
- PERMITIR
- ALLOW_WITH_MODIFICATION: o arquivo ou e-mail foi desinfectado ou reescrito e encaminhado.
- BLOQUEAR
- QUARANTINE: armazena para análise posterior (não significa bloqueio).
- UNKNOWN_ACTION
SecurityResult.action_details
- Finalidade: detalhes fornecidos pelo fornecedor sobre a ação realizada em resposta ao incidente de segurança. As ações de segurança geralmente são mais bem traduzidas no campo de UDM mais geral Security_Result.action. No entanto, talvez seja necessário escrever regras para a descrição exata da ação fornecida pelo fornecedor.
- Codificação: string.
- Exemplos: descartar, bloquear, descriptografar, criptografar.
SecurityResult.category
- Finalidade: especificar uma categoria de segurança.
- Codificação: tipo enumerado.
- Valores possíveis: o UDM do Google SecOps define as seguintes categorias de segurança:
- ACL_VIOLATION: tentativa de acesso não autorizado, incluindo tentativa de acesso a arquivos, serviços da Web, processos, objetos da Web etc.
- AUTH_VIOLATION: falha na autenticação, como uma senha incorreta ou uma autenticação de dois fatores incorreta.
- DATA_AT_REST—DLP: dados do sensor encontrados em repouso em uma verificação.
- DATA_DESTRUCTION: tentativa de destruir ou excluir dados.
- DATA_EXFILTRATION—DLP: transmissão de dados do sensor, cópia para pen drive.
- EXPLOIT: tentativas de estouro, codificações de protocolo incorretas, ROP, injeção de SQL etc., tanto na rede quanto no host.
- MAIL_PHISHING: e-mails de phishing, mensagens de chat etc.
- MAIL_SPAM: e-mail, mensagem etc. de spam.
- MAIL_SPOOFING: endereço de e-mail de origem falsificado etc.
- NETWORK_CATEGORIZED_CONTENT
- NETWORK_COMMAND_AND_CONTROL: se o canal de comando e controle for conhecido.
- NETWORK_DENIAL_OF_SERVICE
- NETWORK_MALICIOUS: comando e controle, exploit de rede, atividade suspeita, possível túnel reverso etc.
- NETWORK_SUSPICIOUS: não relacionado à segurança, por exemplo, o URL está vinculado a jogos de azar etc.
- NETWORK_RECON: verificação de porta detectada por um SDI, sondagem por um aplicativo da Web.
- POLICY_VIOLATION: violação da política de segurança, incluindo violações de regras de firewall, proxy e HIPS ou ações de bloqueio de NAC.
- SOFTWARE_MALICIOUS: malware, spyware, rootkits etc.
- SOFTWARE_PUA: app potencialmente indesejado, como adware etc.
- SOFTWARE_SUSPICIOUS
- UNKNOWN_CATEGORY
SecurityResult.confidence
- Finalidade: especificar um nível de confiança em relação a uma ocorrência de segurança, conforme estimado pelo produto.
- Codificação: tipo enumerado.
- Valores possíveis: o UDM do Google SecOps define as seguintes categorias de confiança do produto:
- UNKNOWN_CONFIDENCE
- LOW_CONFIDENCE
- MEDIUM_CONFIDENCE
- HIGH_CONFIDENCE
SecurityResult.confidence_details
- Finalidade: detalhes adicionais sobre a confiança de uma ocorrência de segurança, conforme estimado pelo fornecedor do produto.
- Codificação: string.
SecurityResult.priority
- Finalidade: especificar uma prioridade em relação a uma ocorrência de segurança, conforme estimado pelo fornecedor do produto.
- Codificação: tipo enumerado.
- Valores possíveis: o UDM do Google SecOps define as seguintes categorias de prioridade de produto:
- UNKNOWN_PRIORITY
- LOW_PRIORITY
- MEDIUM_PRIORITY
- HIGH_PRIORITY
SecurityResult.priority_details
- Finalidade: informações específicas do fornecedor sobre a prioridade do resultado de segurança.
- Codificação: string.
SecurityResult.rule_id
- Finalidade: identificador da regra de segurança.
- Codificação: string.
- Exemplos:
- 08123
- 5d2b44d0-5ef6-40f5-a704-47d61d3babbe
SecurityResult.rule_name
- Finalidade: nome da regra de segurança.
- Codificação: string.
- Exemplo: BlockInboundToOracle.
SecurityResult.severity
- Finalidade: gravidade de uma ocorrência de segurança estimada pelo fornecedor do produto usando valores definidos pelo UDM do Google SecOps.
- Codificação: tipo enumerado.
- Valores possíveis: o UDM do Google SecOps define as seguintes gravidades de produto:
- UNKNOWN_SEVERITY: não malicioso
- INFORMATIONAL: não malicioso
- ERRO: não malicioso
- BAIXO: mal-intencionado
- MÉDIA: mal-intencionado
- ALTO: mal-intencionado
SecurityResult.severity_details
- Finalidade: gravidade de uma ocorrência de segurança, conforme estimado pelo fornecedor do produto.
- Codificação: string.
SecurityResult.threat_name
- Finalidade: nome da ameaça à segurança.
- Codificação: string.
- Exemplos:
- W32/File-A
- Slammer
SecurityResult.url_back_to_product
- Finalidade: URL para direcionar você ao console do produto de origem dessa ocorrência de segurança.
- Codificação: string.
Preenchimento de metadados do usuário
User.email_addresses
- Finalidade: armazena os endereços de e-mail do usuário.
- Codificação: string repetida.
- Exemplo: johnlocke@company.example.com
User.employee_id
- Finalidade: armazena o ID de funcionário de recursos humanos do usuário.
- Codificação: string.
- Exemplo: 11223344.
User.first_name
- Finalidade: armazena o nome do usuário.
- Codificação: string.
- Exemplo: João.
User.middle_name
- Finalidade: armazena o nome do meio do usuário.
- Codificação: string.
- Exemplo: Anthony.
User.last_name
- Finalidade: armazena o sobrenome do usuário.
- Codificação: string.
- Exemplo: Locke.
User.group_identifiers
- Finalidade: armazena os ID de grupo (um GUID, OID do LDAP ou similar) associados a um usuário.
- Codificação: string repetida.
- Exemplo: admin-users.
User.phone_numbers
- Finalidade: armazena os números de telefone do usuário.
- Codificação: string repetida.
- Exemplo: 18005550101
User.title
- Finalidade: armazena o cargo do usuário.
- Codificação: string.
- Exemplo: gerente de relacionamento com o cliente.
User.user_display_name
- Finalidade: armazena o nome de exibição do usuário.
- Codificação: string.
- Exemplo: John Locke.
User.userid
- Finalidade: armazena o ID do usuário.
- Codificação: string.
- Exemplo: jlocke.
User.windows_sid
- Finalidade: armazena o identificador de segurança (SID) do Microsoft Windows associado a um usuário.
- Codificação: string.
- Exemplo: S-1-5-21-1180649209-123456789-3582944384-1064
Preenchimento de metadados de vulnerabilidade
Vulnerability.about
- Finalidade: se a vulnerabilidade for sobre um substantivo específico (por exemplo, executável), adicione-o aqui.
- Codificação: substantivo. Consulte Preenchimento de metadados de substantivos.
- Exemplo: executável.
Vulnerability.cvss_base_score
- Finalidade: pontuação base do Sistema de Pontuação de Vulnerabilidades Comuns (CVSS, na sigla em inglês).
- Codificação: usar pontos flutuantes.
- Intervalo: 0,0 a 10,0
- Exemplo: 8,5
Vulnerability.cvss_vector
Finalidade: vetor para as propriedades do CVSS da vulnerabilidade. Uma pontuação do CVSS é composta pelas seguintes métricas:
- Vetor de ataque (AV)
- Complexidade de acesso (AC)
- Autenticação (Au)
- Impacto na confidencialidade (C)
- Impacto na integridade (I)
- Impacto na disponibilidade (A)
Para mais informações, consulte https://nvd.nist.gov/vuln-metrics/cvss/v2-calculator.
Codificação: string.
Exemplo: AV:L/AC:H/Au:N/C:N/I:P/A:C
Vulnerability.cvss_version
- Finalidade: versão do CVSS para a pontuação ou o vetor de vulnerabilidade.
- Codificação: string.
- Exemplo: 3.1
Vulnerability.description
- Finalidade: descrição da vulnerabilidade.
- Codificação: string.
Vulnerability.first_found
- Finalidade: os produtos que mantêm um histórico de verificações de vulnerabilidades precisam preencher first_found com o horário em que a vulnerabilidade desse recurso foi detectada pela primeira vez.
- Codificação: string.
Vulnerability.last_found
- Finalidade: os produtos que mantêm um histórico de verificações de vulnerabilidades precisam preencher last_found com o horário em que a vulnerabilidade desse recurso foi detectada mais recentemente.
- Codificação: string.
Vulnerability.name
- Finalidade: nome da vulnerabilidade.
- Codificação: string.
- Exemplo: versão do SO incompatível detectada.
Vulnerability.scan_end_time
- Finalidade: se a vulnerabilidade foi descoberta durante uma verificação de recursos, preencha esse campo com o horário em que a verificação terminou. Deixe esse campo em branco se o horário de término não estiver disponível ou não for aplicável.
- Codificação: string.
Vulnerability.scan_start_time
- Finalidade: se a vulnerabilidade foi descoberta durante uma verificação de recursos, preencha esse campo com o horário em que a verificação começou. Deixe esse campo em branco se o horário de início não estiver disponível ou não for aplicável.
- Codificação: string.
Vulnerability.severity
- Finalidade: gravidade da vulnerabilidade.
- Codificação: tipo enumerado.
- Valores possíveis:
- UNKNOWN_SEVERITY
- BAIXA
- MEDIUM
- ALTA
Vulnerability.severity_details
- Finalidade: detalhes de gravidade específicos do fornecedor.
- Codificação: string.
Preenchimento de metadados de alerta
idm.is_significant
- Finalidade: especifica se o alerta deve ser exibido no Enterprise Insights.
- Codificação: booleano.
idm.is_alert
- Objetivo: identificar se o evento é um alerta.
- Codificação: booleano.
Campos obrigatórios e opcionais para tipos de entidade
| Tipo de entidade | Requisitos específicos da entidade |
|---|---|
IP_ADDRESS |
|
FILE |
|
DOMAIN_NAME |
|
URL |
|
MUTEX |
|
USER |
|
RESOURCE |
|
CIDR_BLOCK |
|
ASSET |
|
GROUP |
|
AI |
|
Campos obrigatórios e opcionais para cada tipo de evento
Nesta seção, descrevemos os campos obrigatórios e opcionais que precisam ser preenchidos para cada tipo de evento de UDM.
Para detalhes sobre campos específicos do UDM (por exemplo, números de tipo enumerado), consulte a lista de campos do Modelo de Dados Unificado.
DEVICE_CONFIG_UPDATE, DEVICE_FIRMWARE_UPDATE, DEVICE_PROGRAM_DOWNLOAD, DEVICE_PROGRAM_UPLOAD
Campos obrigatórios:
- metadados: inclua os campos obrigatórios (
event_timestampeevent_type). - principal: inclua pelo menos um identificador de máquina (
principal.hostname,principal.ip,principal.macouprincipal.asset_id).
Campos opcionais:
- principal.user: preencha se as informações do usuário estiverem disponíveis para a conta que iniciou a atualização do dispositivo.
- target: preencha com detalhes sobre o dispositivo de destino, o firmware, o recurso de configuração ou o arquivo de programa, se for diferente de
principal. - security_result: descreve qualquer atividade maliciosa ou anômala detectada.
Exemplo de UDM para DEVICE_FIRMWARE_UPDATE
O exemplo a seguir mostra como formatar um evento DEVICE_FIRMWARE_UPDATE para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo em que a atualização de firmware ocorreu.
EMAIL_TRANSACTION, EMAIL_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal: preencha com informações sobre a máquina de origem da mensagem de e-mail (por exemplo, o endereço IP do remetente).
Campos opcionais:
- sobre: URLs, IPs, domínios e anexos de arquivos incorporados ao corpo do e-mail. Observe que about.file.hash não é um campo indexado para hashes de arquivo. As visualizações de hash não serão preenchidas com um hash de anexo normalizado para esse campo.
- securityResult.about: URLs, IPs e arquivos nocivos incorporados ao corpo do e-mail.
- network.email: informações do remetente ou destinatário do e-mail. Observe que network.email não é um campo de alias. Se você precisar de alias e enriquecimento para pesquisa ou detecção, será necessário indexar em principal ou destino usando uma extensão de analisador.
- principal: se houver dados da máquina cliente sobre quem enviou o e-mail, preencha os detalhes do servidor no principal (por exemplo, o processo do cliente, números de porta, nome de usuário etc.).
- target: se houver dados do servidor de e-mail de destino, preencha os detalhes do servidor no destino (por exemplo, o endereço IP).
- intermediary: se houver dados do servidor de e-mail ou do proxy de e-mail, preencha os detalhes do servidor em intermediary.
Observações:
- Nunca preencha principal.email ou target.email.
- Preencha apenas o campo de e-mail em security_result.about ou network.email.
- Os resultados de segurança de nível superior geralmente têm um conjunto de substantivos (opcional para spam).
- EMAIL_URL_CLICK foi marcado como descontinuado.
Exemplo de UDM para EMAIL_TRANSACTION
O exemplo a seguir ilustra como um evento do tipo EMAIL_TRANSACTION seria formatado para o UDM do Google SecOps:
metadata {
event_timestamp: "2023-07-06T06:26:10.448584Z"
event_type: EMAIL_TRANSACTION
}
principal {
ip: "1.2.3.4"
}
Como mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo que originou o e-mail.
FILE_CREATION, FILE_DELETION, FILE_MODIFICATION, FILE_READ, FILE_OPEN e FILE_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal:
- Pelo menos um identificador de máquina.
- (Opcional) Preencha principal.process com informações sobre o processo que acessa o arquivo.
- target:
- Se o arquivo for remoto (por exemplo, compartilhamento SMB), o destino precisará incluir pelo menos um identificador de máquina para a máquina de destino. Caso contrário, todos os identificadores de máquina precisarão estar em branco.
- Preencha target.file com informações sobre o arquivo.
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
- principal.user: preencha se as informações do usuário estiverem disponíveis sobre o processo.
Exemplo de UDM para FILE_MODIFICATION
O exemplo a seguir ilustra como um evento do tipo FILE_MODIFICATION seria formatado para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo em que ocorreu a modificação do arquivo.
- target: informações sobre o arquivo modificado.
FILE_COPY
Campos obrigatórios:
- metadados: inclua os campos obrigatórios conforme descrito.
- principal:
- Pelo menos um identificador de máquina.
- (Opcional) Preencha principal.process com informações sobre o processo que realiza a operação de cópia de arquivos.
- src:
- Preencha src.file com informações sobre o arquivo de origem.
- Se o arquivo for remoto (por exemplo, compartilhamento SMB), src precisará incluir pelo menos um identificador de máquina para a máquina de origem que armazena o arquivo de origem.
- target:
- Preencha target.file com informações sobre o arquivo de destino.
- Se o arquivo for remoto (por exemplo, compartilhamento SMB), o campo target precisará incluir pelo menos um identificador de máquina para a máquina de destino que contém o arquivo de destino.
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
- principal.user: preencha se as informações do usuário estiverem disponíveis sobre o processo.
FILE_MOVE, FILE_SYNC
Campos obrigatórios:
- metadata: informações básicas sobre o evento.
- principal: pelo menos um identificador de máquina (por exemplo,
principal.hostname). - src: preencha
src.file(por exemplo,src.file.full_path) para representar o arquivo original. Este campo é obrigatório paraFILE_MOVEeFILE_COPY. ParaFILE_SYNC, é necessário preencher pelo menossrc.fileoutarget.file(etargetnão pode estar vazio). - target: preencha
target.file(por exemplo,target.file.full_path) para representar o arquivo de destino. Este campo é obrigatório paraFILE_MOVEeFILE_COPY. ParaFILE_SYNC, é necessário preencher pelo menos um dos campossrc.fileoutarget.file.
Exemplo de UDM para FILE_MOVE
O exemplo a seguir ilustra como um evento do tipo FILE_MOVE seria formatado para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo em que o arquivo foi movido.
- src: informações sobre o arquivo de origem.
- target: informações sobre o arquivo de destino.
GENERIC_EVENT
Use GENERIC_EVENT somente quando um evento não se encaixar em nenhuma outra categoria de tipo de evento de UDM.
Campos obrigatórios:
- metadados: inclua os campos obrigatórios (
event_timestampeevent_type).
Campos opcionais:
- metadata.product_event_type e metadata.description: inclua o nome do evento específico do fornecedor e a descrição legível por humanos.
- principal, target, src, intermediary, observer e about: preencha todas as entidades envolvidas no evento. O
GENERIC_EVENTnão impõe requisitos de campo específicos da entidade além da validação padrão de tipo escalar (como endereços IP válidos e nomes de host de até 255 bytes). - security_result: descreve qualquer atividade maliciosa ou anômala detectada.
Exemplo de UDM para GENERIC_EVENT
O exemplo a seguir mostra como formatar um evento GENERIC_EVENT para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadados: informações de contexto e descrição do evento específica do fornecedor.
- principal: informações sobre o dispositivo associado ao evento.
GROUP_CREATION, GROUP_DELETION, GROUP_MODIFICATION, GROUP_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua os campos obrigatórios (
event_timestampeevent_type). - principal: inclua pelo menos um identificador de usuário em
principal.user(userid,windows_sid,email_addressesouemployee_id). - target: preencha
target.groupcom detalhes sobre o grupo que está sendo criado, excluído ou modificado (etarget.userse um usuário estiver sendo adicionado ou removido do grupo). O campotargetnão pode ficar vazio.
Campos opcionais:
- principal: inclua identificadores de máquina para o dispositivo de origem da operação do grupo.
- target.group: inclua identificadores de grupo, como
group_display_name,product_object_id,windows_sidouemail_addresses. - security_result: descreve qualquer atividade mal-intencionada detectada.
Exemplo de UDM para GROUP_MODIFICATION
O exemplo a seguir mostra como formatar um evento GROUP_MODIFICATION para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o usuário que modificou o grupo.
- target: informações sobre o grupo modificado e o usuário afetado.
MUTEX_CREATION, MUTEX_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal:
- Pelo menos um identificador de máquina.
- Preencha principal.process com informações sobre o processo que cria o mutex. A validação do UDM requer um objeto de processo no principal. Não é possível passar na validação de UDM com um processo apenas no destino.
- target:
- Preencha target.resource.
- Preencha target.resource.type com MUTEX.
- Preencha target.resource.name com o nome do mutex criado.
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
- principal.user: preencha se as informações do usuário estiverem disponíveis sobre o processo.
Exemplo de UDM para MUTEX_CREATION
O exemplo a seguir ilustra como um evento do tipo MUTEX_CREATION seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: detalhes do dispositivo e do processo.
- target: informações sobre o mutex.
NETWORK_CONNECTION, NETWORK_FLOW, NETWORK_FTP, NETWORK_SMTP
Campos obrigatórios:
- metadata: event_timestamp
- principal: inclua detalhes sobre a máquina que iniciou a conexão de rede (por exemplo, origem).
- target: inclua detalhes sobre a máquina de destino, se for diferente da máquina principal.
- network: captura detalhes sobre a conexão de rede (portas, protocolo etc.).
Campos opcionais:
- principal.process e target.process: incluem informações de processo associadas ao principal e ao destino da conexão de rede (se disponível).
- principal.user e target.user: incluem informações do usuário associadas ao principal e ao destino da conexão de rede (se disponíveis).
- network: captura detalhes sobre a conexão de rede, incluindo portas e protocolo.
NETWORK_DHCP
Campos obrigatórios:
- metadata: informações básicas sobre o evento.
- principal: pelo menos um identificador de máquina (por exemplo, principal.ip).
- network: é preciso especificar network.application_protocol como DHCP. Também requer que network.dhcp.opcode seja preenchido (por exemplo, BOOTREQUEST ou BOOTREPLY).
Exemplo de UDM para NETWORK_DHCP
O exemplo a seguir ilustra como um evento do tipo NETWORK_DHCP seria formatado para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo que solicita ou recebe a concessão de DHCP.
- network: detalhes sobre a conexão de rede DHCP e o código de operação.
NETWORK_DNS
Campos obrigatórios:
- principal: pelo menos um identificador de máquina (por exemplo, principal.ip).
- network: é necessário especificar network.application_protocol como DNS. Também requer network.dns.questions.name.
- metadata: informações básicas sobre o evento.
Exemplo de UDM para NETWORK_DNS
O exemplo a seguir ilustra como um evento do tipo NETWORK_DNS seria formatado para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo que faz a solicitação de DNS.
- network: detalhes sobre a conexão de rede DNS e o nome de domínio consultado.
NETWORK_HTTP
O tipo de evento NETWORK_HTTP representa uma conexão de rede HTTP de um principal para um servidor da Web de destino.
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- target: representa o servidor da Web. Inclua informações do dispositivo e um número de porta opcional.
- Se um número de porta de destino estiver disponível, especifique apenas um endereço IP além do número de porta associado a essa conexão de rede (embora vários outros identificadores de máquina possam ser fornecidos para o destino).
- Em
target.url, preencha com o URL acessado.
Campos opcionais:
- principal: representa o cliente que inicia a solicitação da Web. Inclua pelo menos um identificador de máquina (por exemplo, nome do host, IP, MAC, identificador de recurso proprietário) ou um identificador de usuário (por exemplo, nome de usuário).
- Se uma conexão de rede específica for descrita e um número de porta do cliente estiver disponível, especifique apenas um endereço IP com o número da porta associado a essa conexão de rede (embora outros identificadores de máquina possam ser fornecidos para descrever melhor o dispositivo participante).
- Se não houver uma porta de origem disponível, especifique todos os endereços IP e MAC, identificadores de recursos e valores de nome do host que descrevem o dispositivo principal.
- network e network.http: inclui detalhes sobre a conexão de rede HTTP. Preencha os seguintes campos:
- network.ip_protocol
- network.application_protocol
- network.http.method
- about: representa outras entidades encontradas na transação HTTP (por exemplo, um arquivo enviado ou baixado).
- intermediary: representa um servidor proxy (se for diferente do principal ou do destino).
- metadata: preencha os outros campos de metadados.
- network: preencha outros campos de rede.
- network.email: se a conexão de rede HTTP tiver sido originada de um URL que apareceu em uma mensagem de e-mail, preencha network.email com os detalhes.
- observer: representa um sniffer passivo (se houver).
- security_result: adicione um ou mais itens ao campo security_result para representar a atividade mal-intencionada detectada.
Exemplo de UDM para NETWORK_HTTP
O exemplo a seguir ilustra como um evento de antivírus Sophos do tipo NETWORK_HTTP seria convertido para o formato UDM do Google SecOps.
Este é o evento original do antivírus 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
Veja como formatar as mesmas informações no Proto3 usando a sintaxe UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: dispositivo de segurança que detectou o evento.
- dispositivo de destino que recebeu o software malicioso.
- network: informações de rede sobre o host malicioso.
- security_result: detalhes de segurança sobre o software malicioso.
- additional: informações do fornecedor fora do escopo do UDM.
PROCESS_INJECTION, PROCESS_LAUNCH, PROCESS_OPEN, PROCESS_TERMINATION, PROCESS_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal:
- Pelo menos um identificador de máquina.
- Para eventos de injeção e encerramento de processos, se disponíveis, principal.process precisa incluir informações sobre o processo que inicia a ação (por exemplo, para um evento de inicialização de processo, principal.process precisa incluir detalhes sobre o processo pai, se disponível).
- target:
- target.process: inclui informações sobre o processo que está sendo injetado, aberto, iniciado ou encerrado.
- Se o processo de destino for remoto, o destino precisará incluir pelo menos um identificador de máquina para a máquina de destino (por exemplo, um endereço IP, MAC, nome do host ou identificador de recurso de terceiros).
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
- principal.user e target.user: preencha o processo de inicialização (principal) e o processo de destino se as informações do usuário estiverem disponíveis.
Exemplo de UDM para PROCESS_LAUNCH
O exemplo a seguir ilustra como formatar um evento PROCESS_LAUNCH usando a sintaxe de UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: detalhes do dispositivo.
- target: detalhes do processo.
PROCESS_MODULE_LOAD
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal:
- Inclua pelo menos um identificador de máquina (em
principaloutarget). - principal.process: preencha com informações sobre o processo que está carregando o módulo.
- Inclua pelo menos um identificador de máquina (em
- target:
- target.process: preencha com informações sobre o processo do módulo carregado, incluindo pelo menos um de
target.process.file(por exemplo, a DLL ou o objeto compartilhado) outarget.process.product_specific_process_id.
- target.process: preencha com informações sobre o processo do módulo carregado, incluindo pelo menos um de
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
- principal.user: preencha se as informações do usuário estiverem disponíveis sobre o processo.
Exemplo de UDM para PROCESS_MODULE_LOAD
O exemplo a seguir ilustra como formatar um evento PROCESS_MODULE_LOAD usando a sintaxe de UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: detalhes sobre o dispositivo e o processo que carrega o módulo.
- target: detalhes do processo e do módulo.
PROCESS_PRIVILEGE_ESCALATION
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal:
- Inclua pelo menos um identificador de máquina (em
principaloutarget). - principal.process: preencha com informações sobre o processo que inicia o escalonamento de privilégios.
- principal.user: preencha com informações sobre o usuário que está iniciando o escalonamento de privilégios, incluindo pelo menos um identificador de usuário.
- Inclua pelo menos um identificador de máquina (em
- target: preencha com informações sobre o destino do escalonamento de privilégios (por exemplo,
target.processpara o processo com privilégios escalonados). O campotargetnão pode ficar vazio.
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
Exemplo de UDM para PROCESS_PRIVILEGE_ESCALATION
O exemplo a seguir ilustra como um evento do tipo PROCESS_PRIVILEGE_ESCALATION seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: detalhes sobre o dispositivo, o usuário e o processo que inicia o escalonamento.
- target: detalhes sobre o processo que está sendo escalonado.
REGISTRY_CREATION, REGISTRY_MODIFICATION, REGISTRY_DELETION, REGISTRY_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal:
- Pelo menos um identificador de máquina.
- Se um processo de modo de usuário realizar a modificação do registro, principal.process precisará incluir informações sobre o processo que modifica o registro.
- Se um processo do kernel realizar a modificação do registro, o principal não poderá incluir informações do processo.
- target:
- target.registry: se o registro de destino for remoto, o destino precisará incluir pelo menos um identificador para a máquina de destino (por exemplo, um endereço IP, MAC, nome do host ou identificador de recurso de terceiros).
- target.registry.registry_key: todos os eventos de registro precisam incluir a chave de registro afetada.
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada. Por exemplo, uma chave de registro inválida.
- principal.user: preencha se as informações do usuário estiverem disponíveis sobre o processo.
Exemplo de UDM para REGISTRY_MODIFICATION
O exemplo a seguir ilustra como formatar um evento REGISTRY_MODIFICATION no Proto3 usando a sintaxe do UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: detalhes do dispositivo, do usuário e do processo.
- target: entrada do registro afetada pela modificação.
RECURSO
Tipos de evento:
- 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 obrigatórios:
- metadata: event_timestamp e informações de contexto sobre o evento.
- observer: captura informações sobre o próprio scanner. Se o scanner for remoto, os detalhes da máquina precisarão ser capturados pelo campo do observador. Para um scanner local, deixe em branco.
- target: captura informações sobre a máquina que contém o objeto que está sendo verificado. Se um arquivo estiver sendo verificado, target.file precisará capturar informações sobre o arquivo verificado. Se um processo estiver sendo verificado, target.process precisará capturar informações sobre o processo verificado.
- extensions: para SCAN_VULN_HOST e SCAN_VULN_NETWORK, defina a vulnerabilidade usando o campo extensions.vuln.
Campos opcionais:
- principal: representa o dispositivo que inicia a conexão e inclui pelo menos um identificador de máquina (por exemplo, nome do host, endereço IP, endereço MAC, identificador de recurso reservado) ou um identificador de usuário.
- target: os detalhes do usuário sobre o objeto de destino (por exemplo, criador do arquivo ou proprietário do processo) precisam ser capturados em target.user.
- security_result: descreve a atividade maliciosa detectada.
Exemplo de UDM para SCAN_HOST
O exemplo a seguir ilustra como um evento do tipo SCAN_HOST seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- target: dispositivo que recebeu o software malicioso.
- observer: dispositivo que observa e informa sobre o evento em questão.
- security_result: detalhes de segurança sobre o software malicioso.
Exemplo de UDM para SCAN_VULN_HOST
O exemplo a seguir ilustra como um evento do tipo SCAN_VULN_HOST seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: dispositivo que recebeu o software malicioso.
- extensions: detalhes da vulnerabilidade.
SCHEDULED_TASK_CREATION, SCHEDULED_TASK_DELETION, SCHEDULED_TASK_DISABLE, SCHEDULED_TASK_ENABLE, SCHEDULED_TASK_MODIFICATION, SCHEDULED_TASK_UNCATEGORIZED
Campos obrigatórios:
- principal: para todos os eventos SCHEDULED_TASK, o principal precisa incluir um identificador de máquina e um identificador de usuário.
- target: inclua um
target.resourceválido comtarget.resource.resource_typedefinido comoTASK.
Campos opcionais:
- security_result: descreve a atividade maliciosa detectada.
Exemplo de UDM para SCHEDULED_TASK_CREATION
O exemplo a seguir ilustra como um evento do tipo SCHEDULED_TASK_CREATION pode ser formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: dispositivo que programou a tarefa suspeita.
- target: software visado pela tarefa suspeita.
- intermediary: intermediário envolvido na tarefa suspeita.
- security_result: detalhes de segurança sobre a tarefa suspeita.
SETTING_UNCATEGORIZED, SETTING_CREATION, SETTING_MODIFICATION, SETTING_DELETION
Campos obrigatórios:
principal: precisa estar presente, não estar vazio e incluir um identificador de máquina.
target: precisa estar presente, não estar vazio e incluir um recurso com
target.resource.resource_typeespecificado comoSETTING.
Exemplo de UDM para o tipo de evento SETTING_MODIFICATION
O exemplo a seguir ilustra como um evento do tipo SETTING_MODIFICATION seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- principal: informações sobre o dispositivo em que a modificação da configuração ocorreu.
- target: detalhes sobre o recurso de configuração.
SERVICE_UNSPECIFIED, SERVICE_CREATION, SERVICE_DELETION, SERVICE_MODIFICATION, SERVICE_START, SERVICE_STOP
Campos obrigatórios:
- metadados: inclua os campos obrigatórios (
event_timestampeevent_type). - principal: inclua pelo menos um identificador de máquina (
principal.hostname,principal.ip,principal.macouprincipal.asset_id). - target: especifique pelo menos um dos atributos
target.processoutarget.application.
Campos opcionais:
- target.user: preencha se as informações do usuário estiverem disponíveis para a conta de serviço ou o usuário de destino.
- target.resource: preencha com os detalhes do recurso de serviço (por exemplo,
resource_type: SERVICE).
Exemplo de UDM para SERVICE_UNSPECIFIED
O exemplo a seguir ilustra como um evento do tipo SERVICE_UNSPECIFIED seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias do UDM:
- metadata: informações de contexto sobre o evento.
- principal: detalhes do dispositivo e do local.
- target: nome do host e identificador de usuário.
- application: nome do aplicativo e tipo de recurso.
STATUS_HEARTBEAT, STATUS_STARTUP, STATUS_SHUTDOWN, STATUS_UNCATEGORIZED, STATUS_UPDATE
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal: pelo menos um identificador de máquina (endereço IP ou endereço MAC, nome do host ou identificador de recurso).
Exemplo de UDM para STATUS_HEARTBEAT
O exemplo a seguir ilustra como um evento do tipo STATUS_HEARTBEAT seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: detalhes do dispositivo e do local.
- intermediary: endereço IP do dispositivo.
- security_result: detalhes do resultado de segurança.
SYSTEM_AUDIT_LOG_UNCATEGORIZED, SYSTEM_AUDIT_LOG_WIPE
Campos obrigatórios:
- principal: inclua um identificador de usuário para quem realizou a operação no registro e um identificador de máquina para a máquina em que o registro está ou estava (no caso de limpeza) armazenado.
Exemplo de UDM para SYSTEM_AUDIT_LOG_WIPE
O exemplo a seguir ilustra como um evento do tipo SYSTEM_AUDIT_LOG_WIPE seria formatado para o UDM do 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 mostrado neste exemplo, o evento foi dividido nas seguintes categorias de UDM:
- metadata: informações de contexto sobre o evento.
- principal: detalhes do dispositivo e do usuário.
USER_BADGE_IN
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- target: precisa incluir pelo menos um identificador de máquina (por exemplo, target.hostname).
- extensions: o mecanismo de autenticação precisa ser fornecido em extensions.auth.type.
Exemplo de UDM para USER_BADGE_IN
O exemplo a seguir ilustra como um evento do tipo USER_BADGE_IN seria formatado para o UDM do 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 mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- target: informações sobre o dispositivo ou local em que o registro de entrada ocorreu.
- extensions: detalhes sobre o mecanismo de autenticação usado.
USER_CHANGE_PASSWORD, USER_CHANGE_PERMISSIONS
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- target: não pode ficar em branco. Preencha
targetcom informações sobre a conta de usuário modificada (target.user) ou a máquina, o aplicativo ou o recurso de destino em que a alteração ocorreu. - target.user ou principal.user: preencha pelo menos um dos campos
target.user(a conta de usuário que foi modificada) ouprincipal.user(o usuário que iniciou a mudança) com um identificador de usuário (userid,windows_sid,email_addressesouemployee_id).
Campos opcionais:
- principal: se você fornecer o identificador de usuário em
target.user,principal.userserá opcional. Se a conta de usuário for modificada de um local remoto, preenchaprincipalcom informações sobre a máquina de onde a modificação se originou. - intermediary: para logins de SSO,
intermediaryprecisa incluir pelo menos um identificador de máquina para o servidor de SSO, se disponível.
USER_COMMUNICATION
Campos obrigatórios:
- principal: preencha o campo principal.user com detalhes associados à comunicação iniciada pelo usuário (remetente), como uma mensagem de chat no Google Chat ou Slack, uma videoconferência ou chamada de voz no Zoom ou Google Meet ou uma conexão VoIP.
Campos opcionais:
- target: (recomendado) preencha o campo target.user com informações sobre o usuário de destino (receptor) do recurso de comunicação na nuvem. Preencha o campo target.application com informações sobre o aplicativo de comunicação em nuvem de destino.
USER_CREATION, USER_DELETION
Campos obrigatórios:
- metadados: inclua
event_timestampeevent_type. - principal: inclua pelo menos um identificador de usuário válido em
principal.user(userid,windows_sid,email_addressesouemployee_id, até 256 caracteres) para a conta que iniciou a criação ou exclusão. Setarget.applicationnão estiver definido,principaltambém precisará incluir pelo menos um identificador de máquina (hostname,ip,macouasset_id). - target: inclua pelo menos um identificador de usuário válido em
target.user(até 256 caracteres) para a conta de usuário que está sendo criada ou excluída. Seprincipalnão incluir um identificador de máquina, preenchatarget.application.
Campos opcionais:
- principal.process: detalhes do processo da máquina em que a solicitação de criação ou exclusão do usuário foi iniciada.
- target: informações sobre a máquina de destino (se for diferente da máquina principal).
USER_LOGIN, USER_LOGOUT
Campos obrigatórios:
- metadados: inclua os campos obrigatórios.
- principal: para atividades de usuários remotos (por exemplo, login remoto), preencha o principal com informações sobre a máquina que originou a atividade do usuário. Para atividade do usuário local (por exemplo, login local), não defina principal.
- target: preencha target.user com informações sobre o usuário que fez login ou logout. Se principal não estiver definido (por exemplo, login local), target também precisará incluir pelo menos um identificador de máquina que identifique a máquina de destino. Para atividades do usuário de máquina para máquina (por exemplo, login remoto, SSO, serviço em nuvem, VPN), o destino precisa incluir informações sobre o aplicativo, a máquina ou o servidor de VPN de destino.
- intermediary: para logins de SSO, o intermediário precisa incluir pelo menos um identificador de máquina para o servidor de SSO, se disponível.
- network e network.http: se o login ocorrer por HTTP, coloque todos os detalhes disponíveis em network.ip_protocol, network.application_protocol e network.http.
- Extensão authentication: precisa identificar o tipo de sistema de autenticação relacionado ao evento (por exemplo, máquina, SSO ou VPN) e o mecanismo empregado (nome de usuário e senha, OTP etc.).
- security_result: adicione um campo security_result para representar o status de login em caso de falha. Especifique security_result.category com o valor AUTH_VIOLATION se a autenticação falhar.
Exemplo de UDM para USER_LOGIN
O exemplo a seguir ilustra como um evento do tipo USER_LOGIN seria formatado para o UDM do Google SecOps:
{
"metadata": {
"event_timestamp": "2023-07-05T20:48:50.657334Z",
"event_type": "USER_LOGIN"
},
"target": {
"user": {
"userid": "jamon"
}
},
"extensions": {
"auth": {
"type": "MACHINE"
}
}
}
Como mostrado neste exemplo, o evento é dividido nas seguintes categorias de UDM:
- metadata: informações básicas sobre o evento.
- target: informações sobre o usuário que está fazendo login.
- extensions: detalhes sobre o mecanismo de autenticação usado.
USER_RESOURCE_ACCESS
Campos obrigatórios:
- principal: preencha o campo principal.user com detalhes sobre as tentativas de acessar um recurso de nuvem (por exemplo, um caso do Salesforce, uma agenda do Office365, um documento do Google ou um tíquete do ServiceNow).
- target: preencha o campo target.resource com informações sobre o recurso de nuvem de destino.
Campos opcionais:
- target.application: (recomendado) preencha o campo target.application com informações sobre o aplicativo de nuvem de destino.
USER_RESOURCE_CREATION, USER_RESOURCE_DELETION
Campos obrigatórios:
- principal: preencha o campo principal.user com detalhes associados ao usuário criado em um recurso de nuvem (por exemplo, um caso do Salesforce, uma agenda do Office 365, um documento do Google ou um tíquete do ServiceNow).
- target: preencha o campo target.resource com informações sobre o recurso de nuvem de destino.
Campos opcionais:
- target.application: (recomendado) preencha o campo target.application com informações sobre o aplicativo de nuvem de destino.
USER_RESOURCE_UPDATE_CONTENT
Campos obrigatórios:
- principal: preencha o campo principal.user com detalhes associados ao usuário cujo conteúdo foi atualizado em um recurso de nuvem (por exemplo, um caso do Salesforce, uma agenda do Office365, um documento do Google ou um tíquete do ServiceNow).
- target: preencha o campo target.resource com informações sobre o recurso de nuvem de destino.
Campos opcionais:
- target.application: (recomendado) preencha o campo target.application com informações sobre o aplicativo de nuvem de destino.
USER_RESOURCE_UPDATE_PERMISSIONS
Campos obrigatórios:
- principal: preencha o campo principal.user com detalhes associados ao usuário cujas permissões foram atualizadas em um recurso de nuvem (por exemplo, um caso do Salesforce, uma agenda do Office 365, um documento do Google ou um tíquete do ServiceNow).
- target: preencha o campo target.resource com informações sobre o recurso de nuvem de destino.
Campos opcionais:
- target.application: (recomendado) preencha o campo target.application com informações sobre o aplicativo de nuvem de destino.
USER_UNCATEGORIZED
Campos obrigatórios:
- metadados: inclua
event_timestampeevent_type. - principal ou target:
- Se
targetnão estiver preenchido,principalprecisará incluir pelo menos um identificador de usuário válido emprincipal.user(userid,windows_sid,email_addressesouemployee_id, até 256 caracteres) ou pelo menos um identificador de máquina (hostname,ip,macouasset_id). - Se
targetestiver preenchido, você precisará preencher pelo menos um dos seguintes campos: um identificador de usuário emtarget.user, um identificador de máquina emtargetou um identificador de usuário válido emprincipal.user.
- Se
Campos opcionais:
- principal.process: detalhes do processo associados à atividade do usuário.
- security_result: descreve qualquer atividade maliciosa ou anômala detectada.