Coletar registros do Microsoft Defender para IoT (CyberX)
Este documento explica como ingerir registros do Microsoft Defender para IoT (CyberX) no Google Security Operations usando o Bindplane.
O Microsoft Defender para IoT (antigo CyberX) é uma plataforma de segurança de IoT/OT sem agente que oferece descoberta de recursos, gestão de vulnerabilidades e monitoramento contínuo de ameaças para sistemas de controle industrial (ICS) e ambientes de tecnologia operacional (OT). Ele detecta comportamentos anômalos e ameaças conhecidas em redes de IoT/TO sem afetar os processos operacionais. O analisador extrai campos do syslog do CyberX e de registros formatados em chave-valor. Ele usa grok e/ou kv para analisar a mensagem de registro e, em seguida, mapeia esses valores para o modelo de dados unificado (UDM). Ele também define valores de metadados padrão para a origem e o tipo do evento.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps
- Windows Server 2016 ou mais recente ou host Linux com
systemd - Se estiver executando por trás de um proxy, verifique se as portas do firewall estão abertas de acordo com os requisitos do agente do Bindplane.
- Acesso privilegiado ao console do sensor do Microsoft Defender para IoT
Receber credenciais do Google SecOps para o agente do Bindplane
Para autenticar o agente do Bindplane no Google SecOps, escolha um dos seguintes métodos:
- Novas implantações: use a API Chronicle (opção 1).
- Implantações legadas: continue usando o arquivo de autenticação de ingestão (opção 2) até que a API Ingestion seja desativada em 20 de julho de 2027.
Opção 1: criar uma conta de serviço para a API Chronicle (recomendado)
- Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
- Acesse IAM e administrador > Contas de serviço.
- Clique em Criar conta de serviço.
- Informe os seguintes detalhes de configuração:
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
bindplane-ingest). - Descrição da conta de serviço: insira uma descrição (por exemplo,
Bindplane agent log ingestion).
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
- Clique em Criar e continuar.
- Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
- Clique em Continuar e depois em Concluído.
- Clique na conta de serviço que você criou e acesse a guia Chaves.
- Clique em Adicionar chave > Criar nova chave.
- Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
- Salve o arquivo de chave como
ingestion-auth.jsonno diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.jsonno Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonno Windows) ou atualizecreds_file_pathemconfig.yamlpara corresponder ao caminho em que você o salvou. - Acesse IAM e administrador > Configurações e copie o Número do projeto. Você vai precisar dele para configurar o exportador.
Opção 2: fazer o download do arquivo de autenticação de ingestão (legado)
- Faça login no console do Google SecOps.
- Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
- Faça o download do arquivo de autenticação de ingestão.
- Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.
Receber o ID de cliente do Google SecOps
- Faça login no console do Google SecOps.
- Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
- Copie e salve o ID de cliente na seção Detalhes da organização.
Instalar o agente do BindPlane
Instale o agente do Bindplane no seu sistema operacional Windows ou Linux de acordo com as instruções a seguir.
Instalação do Windows
- Abra o Prompt de comando ou o PowerShell como administrador.
Execute este comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietAguarde a conclusão da instalação.
Execute o seguinte comando para confirmar a instalação:
sc query observiq-otel-collector
O serviço precisa aparecer como RUNNING.
Instalação do Linux
- Abra um terminal com privilégios de raiz ou sudo.
Execute este comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shAguarde a conclusão da instalação.
Execute o seguinte comando para confirmar a instalação:
sudo systemctl status observiq-otel-collector
O serviço precisa aparecer como active (running).
Outros recursos de instalação
Para mais opções de instalação e solução de problemas, consulte o guia de instalação do agente do BindPlane.
Configurar o agente do Bindplane para ingerir o syslog e enviar ao Google SecOps
Localize o arquivo de configuração.
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Editar o arquivo de configuração
Substitua todo o conteúdo de
config.yamlpela seguinte configuração:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: chronicle.googleapis.com log_type: 'CYBERX' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
Parâmetros de configuração
Substitua os seguintes marcadores de posição:
Configuração do receptor:
udplog: useudplogpara syslog UDP outcplogpara syslog TCP.0.0.0.0: endereço IP para detectar (0.0.0.0para detectar em todas as interfaces)514: número da porta a ser detectada (porta syslog padrão)
Configuração do exportador:
creds_file_path: caminho completo para o arquivo de chave JSON da conta de serviço (opção 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
YOUR_CUSTOMER_ID: ID de cliente da seção "Receber ID de cliente"location: substitua<LOCATION>pela região da sua instância do Google SecOps (por exemplo,us,europeouasia-southeast1). O exportador prefixachronicle.googleapis.comcom esse valor. Consulte Endpoints regionais para ver a lista completa.project: substitua<PROJECT_NUMBER>pelo número do projeto em IAM e administrador > Configurações.endpoint: mantenha definido comochronicle.googleapis.com.log_type: tipo de registro exatamente como aparece no Google SecOps (CYBERX)
Exportador da API de ingestão legada
Se você usar o arquivo de autenticação de ingestão da Opção 2, substitua o bloco
exporterspelo seguinte. Definacreds_file_pathcomo o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substituamalachiteingestion-pa.googleapis.compelo endpoint regional (por exemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/chronicle_w_labels: compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: 'CYBERX' raw_log_field: body ingestion_labels:
Salve o arquivo de configuração.
- Depois de editar, salve o arquivo:
- Linux: pressione
Ctrl+O, depoisEntere, em seguida,Ctrl+X. - Windows: clique em Arquivo > Salvar.
- Linux: pressione
Reinicie o agente do BindPlane para aplicar as mudanças:
Para reiniciar o agente do BindPlane no Linux:
Execute este comando:
sudo systemctl restart observiq-otel-collectorVerifique se o serviço está em execução:
sudo systemctl status observiq-otel-collectorVerifique se há erros nos registros:
sudo journalctl -u observiq-otel-collector -f
Para reiniciar o agente do BindPlane no Windows:
Escolha uma das seguintes opções:
- Prompt de comando ou PowerShell como administrador:
net stop observiq-otel-collector && net start observiq-otel-collector- Console de serviços:
- Pressione
Win+R, digiteservices.msce pressione Enter. - Localize o coletor do OpenTelemetry da observIQ.
- Clique com o botão direito do mouse e selecione Reiniciar.
- Pressione
Verifique se o serviço está em execução:
sc query observiq-otel-collectorVerifique se há erros nos registros:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Configurar o encaminhamento de syslog no Microsoft Defender para IoT
- Faça login no console do sensor de TO do Microsoft Defender para IoT como um usuário administrador.
- Selecione Encaminhamento no menu à esquerda.
- Clique em + Criar nova regra.
- No painel Adicionar regra de encaminhamento, forneça os seguintes detalhes:
- Nome da regra: insira um nome descritivo (por exemplo,
Google-SecOps-Bindplane). - Nível mínimo de alerta: selecione Baixo para encaminhar todos os níveis de gravidade ou selecione um nível mais alto para filtrar.
- Qualquer protocolo detectado: ative para encaminhar alertas de todo o tráfego de protocolo ou desative e selecione protocolos específicos.
- Tráfego detectado por qualquer mecanismo: ative para encaminhar alertas de todos os mecanismos de detecção ou desative e selecione mecanismos específicos.
- Nome da regra: insira um nome descritivo (por exemplo,
Na área Ações, configure o servidor syslog:
- Servidor: selecione Servidor SYSLOG (formato CEF).
- Host: insira o endereço IP do host do agente do BindPlane.
- Porta: insira
514. - Fuso horário: selecione UTC (recomendado).
Clique em Salvar. A regra é listada na página Encaminhamento.
Verifique a regra selecionando o menu "opções" (...) dela e clicando em Enviar mensagem de teste.
Verifique os registros do agente do BindPlane para confirmar se as mensagens do syslog estão sendo recebidas.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
| Máscara de acesso | security_result.detection_fields.value | Valor de access_mask de access_request_kvdata analisado |
| Domínio da conta | principal.administrative_domain | Valor de principal_domain do principal_kvdata analisado |
| Domínio da conta | target.administrative_domain | Valor de target_domain do target_kvdata analisado. |
| Nome da conta | principal.user.userid | Valor de principal_account_name de principal_kvdata analisado |
| Nome da conta | target.user.userid | Valor de target_account_name de target_kvdata analisado |
| ação | security_result.action_details | Valor da ação |
| ação | security_result.action | Derivado. Se a ação for "accept", "passthrough", "pass", "permit", "detected" ou "close", mapeie para "ALLOW". Se a ação for "deny", "dropped" ou "blocked", mapeie para "BLOCK". Se a ação for "timeout", mapeie para "FAIL". Caso contrário, mapeie para "UNKNOWN_ACTION". |
| Nome do algoritmo | security_result.detection_fields.value | Valor de algorithm_name do cryptographic_kvdata analisado |
| app | target.application | Valor do serviço se app_protocol_output estiver vazio |
| appcat | security_result.detection_fields.value | Valor de appcat |
| Nome do aplicativo | principal.application | Valor de application_name |
| Pacote de autenticação | security_result.about.resource.name | Valor de authentication_package |
| Alerta do Azure Defender para IoT | security_result.detection_fields.value | Valor de azure_defender_for_iot_alert |
| canal | security_result.detection_fields.value | Valor do canal |
| Endereço do cliente | principal.ip, principal.asset.ip | Valor de source_ip |
| Porta de cliente | principal.port | Valor de source_port |
| craction | security_result.detection_fields.value | Valor da ação de conversão |
| As credenciais do Gerenciador de credenciais foram salvas em backup | security_result.description | Valor da descrição |
| As credenciais do Gerenciador de credenciais foram lidas. | security_result.description | Valor da descrição |
| crscore | security_result.severity_details | Valor de crscore |
| crlevel | security_result.severity, security_result.severity_details | Valor de crlevel. Se crlevel for "HIGH", "MEDIUM", "LOW" ou "CRITICAL", mapeie para a gravidade correspondente do UDM. |
| Operação criptográfica | metadata.description | Valor de product_desc |
| Nome da plataforma CyberX | security_result.detection_fields.value | Valor de cyberx_platform_name |
| Descrição | security_result.description | Valor da descrição se a mensagem estiver vazia |
| Destino | target.ip, target.asset.ip ou target.hostname | Se o destino for um endereço IP, mapeie para target.ip e target.asset.ip. Caso contrário, mapeie para target.hostname. |
| Endereço de destino | target.ip, target.asset.ip | Valor de destination_ip de network_information analisado |
| DRA de destino | target.resource.name | Valor de destination_dra |
| IP de destino | target.ip, target.asset.ip | Valor de destination_ip |
| Porta de destino | target.port | Valor de destination_port de network_information analisado |
| devid | principal.resource.product_object_id | Valor de devid |
| devname | principal.resource.name | Valor de devname |
| Direção | network.direction | Se a direção for "incoming", "inbound" ou "response", mapeie para "INBOUND". Se a direção for "outgoing", "outbound" ou "request", mapeie para "OUTBOUND". |
| dstip | target.ip, target.asset.ip | Valor de dstip se destination_ip estiver vazio |
| dstcountry | target.location.country_or_region | Valor de dstcountry |
| dstintf | security_result.detection_fields.value | Valor de dstintf |
| dstintfrole | security_result.detection_fields.value | Valor de dstintfrole |
| dstosname | target.platform | Valor de dstosname se for "WINDOWS", "LINUX" ou "MAC". |
| dstport | target.port | Valor de dstport se destination_port estiver vazio |
| dstswversion | target.platform_version | Valor de dstswversion |
| duration | network.session_duration.seconds | Valor da duração |
| event_id | security_result.rule_name | Usado para criar o nome da regra como "EventID: %{event_id}" |
| event_in_sequence | security_result.detection_fields.value | Valor de event_in_sequence |
| ID do ambiente de execução do filtro | security_result.detection_fields.value | Valor de filter_run_time_id de filter_information analisado |
| Filiação a grupo | security_result.detection_fields.value | Valor de group_membership se event_id não for 4627 |
| Filiação a grupo | target.user.group_identifiers | Valores de group_membership analisado se event_id for 4627 |
| handle_id | security_result.detection_fields.value | Valor de handle_id do object_kvdata analisado |
| ID do identificador | security_result.detection_fields.value | Valor de handle_id do object_kvdata analisado |
| impersonation_level | security_result.detection_fields.value | Valor de impersonation_level de logon_information_kvdata analisado |
| Comprimento da chave | security_result.detection_fields.value | Valor de key_length do auth_kvdata analisado |
| Nome da chave | security_result.detection_fields.value | Valor de key_name do cryptographic_kvdata analisado |
| Tipo de chave | security_result.detection_fields.value | Valor de key_type do cryptographic_kvdata analisado |
| palavras-chave | security_result.detection_fields.value | Valor das palavras-chave |
| Nome da camada | security_result.detection_fields.value | Valor de layer_name de filter_information analisado |
| ID do ambiente de execução da camada | security_result.detection_fields.value | Valor de layer_run_time_id de filter_information analisado |
| logid | metadata.product_log_id | Valor de logid |
| GUID de login | principal.resource.product_object_id | Valor de logon_guid |
| ID de login | security_result.detection_fields.value | Valor de logon_id |
| logon_type | event.idm.read_only_udm.extensions.auth.mechanism | Derivado. Se logon_type for "3", mapeie para "NETWORK". Se for "4", mapeie para "BATCH". Se for "5", mapeie para "SERVICE". Se for "8", mapeie para "NETWORK_CLEAR_TEXT". Se for "9", mapeie para "NEW_CREDENTIALS". Se for "10", mapeie para "REMOTE_INTERACTIVE". Se for "11", mapeie para "CACHED_INTERACTIVE". Caso contrário, se não estiver vazio, mapeie para "MECHANISM_OTHER". |
| Conta de logon | security_result.detection_fields.value | Valor de logon_id da análise grok |
| Processo de login | security_result.detection_fields.value | Valor de logon_process de auth_kvdata analisado |
| Marcador obrigatório | security_result.detection_fields.value | Valor de mandatory_label |
| mastersrcmac | principal.mac | Valor de mastersrcmac |
| Mensagem | security_result.description | Valor da mensagem |
| new_process_id | target.process.pid | Valor de new_process_id de process_kvdata analisado |
| new_process_name | target.process.file.full_path | Valor de new_process_name de process_kvdata analisado |
| Nome do objeto | security_result.detection_fields.value | Valor de object_name do object_kvdata analisado |
| Servidor de objetos | security_result.detection_fields.value | Valor de object_server do object_kvdata analisado |
| Tipo de objeto | security_result.detection_fields.value | Valor de object_type do object_kvdata analisado |
| osname | principal.platform | Valor de osname se for "WINDOWS", "LINUX" ou "MAC". |
| Nome do pacote (somente NTLM) | security_result.detection_fields.value | Valor de package_name do auth_kvdata analisado |
| policyid | security_result.rule_id | Valor de policyid |
| policyname | security_result.rule_name | Valor de policyname |
| policytype | security_result.rule_type | Valor de policytype |
| ID de processo | principal.process.pid | Valor de process_id |
| Nome do processo | principal.process.file.full_path | Valor de creator_process_name de process_kvdata analisado |
| profile_changed | security_result.detection_fields.value | Valor de profile_changed |
| Perfil alterado | security_result.detection_fields.value | Valor de profile_changed da análise do grok |
| proto | network.ip_protocol | Se proto for "17", mapeie para "UDP". Se "6" ou o subtipo for "wad", mapeie para "TCP". Se for "41", mapeie para "IP6IN4". Se o serviço for "PING", o protocolo for "1" ou o serviço contiver "ICMP", mapeie para "ICMP". |
| Protocolo | network.application_protocol | Valor de app_protocol_output derivado de Protocol |
| Nome do provedor | security_result.detection_fields.value | Valor de provider_name de provider_kvdata ou cryptographic_kvdata analisado |
| rcvdbyte | network.received_bytes | Valor de rcvdbyte |
| rcvdpkt | security_result.detection_fields.value | Valor de rcvdpkt |
| restricted_admin_mode | security_result.detection_fields.value | Valor de restricted_admin_mode de logon_information_kvdata analisado |
| Código de retorno | security_result.detection_fields.value | Valor de return_code do cryptographic_kvdata analisado |
| resposta | security_result.detection_fields.value | Valor da resposta |
| rule_id | security_result.rule_id | Valor de rule_id |
| ID de segurança | principal.user.windows_sid | Valor de principal_security_id do principal_kvdata analisado |
| ID de segurança | target.user.windows_sid | Valor de target_security_id do target_kvdata analisado |
| sentbyte | network.sent_bytes | Valor de sentbyte |
| sentpkt | security_result.detection_fields.value | Valor de sentpkt |
| serviço | network.application_protocol ou target.application | Valor de app_protocol_output derivado do serviço. Se app_protocol_output estiver vazio, mapeie para target.application. |
| ID do serviço | security_result.detection_fields.value | Valor de service_id do service_kvdata analisado |
| Nome do serviço | security_result.detection_fields.value | Valor de service_name de service_kvdata analisado |
| sessionid | network.session_id | Valor de sessionid |
| Gravidade | security_result.severity, security_result.severity_details | Se a gravidade for "ERROR" ou "CRITICAL", mapeie para a gravidade correspondente do UDM. Se for "INFO", mapeie para "INFORMATIONAL". Se for "MINOR", mapeie para "LOW". Se for "WARNING", mapeie para "MEDIUM". Se for "MAJOR", mapeie para "HIGH". Além disso, mapeie o valor bruto para severity_details. |
| gravidade, | security_result.severity, security_result.severity_details | Se a gravidade for "1", "2" ou "3", mapeie para "LOW". Se for "4", "5" ou "6", mapeie para "MEDIUM". Se for "7", "8" ou "9", mapeie para "HIGH". Além disso, mapeie o valor bruto para severity_details. |
| Nome do compartilhamento | security_result.detection_fields.value | Valor de share_name de share_information_kvdata analisado |
| Caminho de compartilhamento | security_result.detection_fields.value | Valor de share_path de share_information_kvdata analisado |
| Origem | principal.ip, principal.asset.ip ou principal.hostname, principal.asset.hostname | Se a origem for um endereço IP, mapeie para principal.ip e principal.asset.ip. Caso contrário, mapeie para principal.hostname e principal.asset.hostname. |
| Endereço de origem | principal.ip, principal.asset.ip | Valor de source_ip de network_information analisado |
| DRA de origem | principal.resource.name | Valor de source_dra |
| IP de origem | principal.ip | Valor de source_ip |
| Endereço de rede de origem | principal.ip, principal.asset.ip | Valor de source_ip |
| Porta de origem | principal.port | Valor de source_port de network_information analisado |
| Estação de trabalho de origem | workstation_name | Valor de source_workstation_name |
| srcip | source_ip | Valor de srcip se source_ip estiver vazio |
| srccountry | principal.location.country_or_region | Valor de srccountry |
| srcmac | principal.mac | Valor de srcmac |
| srcname | principal.hostname, principal.asset.hostname | Valor de srcname |
| srcport | source_port | Valor de srcport se source_port estiver vazio |
| srcswversion | principal.platform_version | Valor de srcswversion |
| Código de status | network.http.response_code | Valor de status_code |
| Tipo de elevação do token | security_result.detection_fields.value | Valor de token_elevation_type |
| transited_services | security_result.detection_fields.value | Valor de transited_services de auth_kvdata analisado |
| transip | principal.nat_ip | Valor de transip |
| transport | principal.nat_port | Valor do transporte |
| tipo | metadata.product_event_type | Usado com o subtipo para criar metadata.product_event_type |
| Tipo | security_result.detection_fields.value | Valor do tipo |
| UUID | metadata.product_log_id | Valor do UUID |
| vd | principal.administrative_domain | Valor de vd |
| virtual_account | security_result.detection_fields.value | Valor de virtual_account de logon_information_kvdata analisado |
| Nome da estação de trabalho | principal.hostname, principal.asset.hostname | Valor de workstation_name se nenhum outro identificador principal estiver presente |
| metadata.event_type | metadata.event_type | Derivado. Se principal_present e target_present forem verdadeiros, mapeie para "NETWORK_CONNECTION". Se user_present for verdadeiro, mapeie para "USER_RESOURCE_ACCESS". Se principal_present for verdadeiro, mapeie para "STATUS_UPDATE". Caso contrário, mapeie para "GENERIC_EVENT". |
| metadata.log_type | metadata.log_type | Fixado no código como "CYBERX" |
| metadata.product_name | metadata.product_name | Fixado no código como "CYBERX" |
| metadata.vendor_name | metadata.vendor_name | Fixado no código como "CYBERX" |
| metadata.event_timestamp | metadata.event_timestamp | Copiado do campo de carimbo de data/hora de nível superior ou derivado dos campos eventtime ou de data e hora. |
intermediary_hostname |
event.idm.read_only_udm.intermediary.hostname |
Mapeado do registro de alterações |
type |
event.idm.read_only_udm.security_result.detection_fields |
Mapeado do registro de alterações |
protocol |
event.idm.read_only_udm.network.application_protocol |
Mapeado do registro de alterações |
UUID |
event.idm.read_only_udm.metadata.product_log_id |
Mapeado do registro de alterações |
product_version_x |
metadata.product_version |
Mapeado do registro de alterações |
pro_event_type |
metadata.product_event_type |
Mapeado do registro de alterações |
title |
security_result.description |
Mapeado do registro de alterações |
msg |
metadata.description |
Mapeado do registro de alterações |
client_ip |
principal.ip |
Mapeado do registro de alterações |
src_ip |
principal.ip |
Mapeado do registro de alterações |
dst_ip |
target.ip |
Mapeado do registro de alterações |
src_mac |
principal.mac |
Mapeado do registro de alterações |
timestamp" and "ts |
metadata.event_timestamp |
Mapeado do registro de alterações |
source_ip2 |
principal.ip |
Mapeado do registro de alterações |
destination_ip2 |
target.ip |
Mapeado do registro de alterações |
Registro de alterações
Confira o registro de alterações deste analisador
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.