Coletar dados de syslog do Apple macOS

Compatível com:

Google SecOps SIEM

Observação: esse recurso é coberto pelos Termos de ofertas pré-disponibilidade geral dos Termos específicos do serviço de operações de segurança do Google. Os recursos pré-GA podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as diretrizes do serviço de suporte técnico do Google Security Operations e os Termos específicos do serviço do Google Security Operations.

Esse analisador usa padrões grok para extrair campos de mensagens syslog do Apple macOS e preencher o modelo de dados unificado (UDM, na sigla em inglês) com os valores extraídos, incluindo carimbo de data/hora, nome do host, host intermediário, linha de comando, ID do processo e descrição. O analisador categoriza o evento como STATUS_UPDATE se um nome de host estiver presente. Caso contrário, ele atribui a categoria GENERIC_EVENT ao evento. Por fim, o analisador enriquece o evento do UDM com informações do fornecedor e do produto.

Antes de começar

• Verifique se você tem uma instância do Google Security Operations.
• Confira se você tem acesso root ao host do Auditd.
• Verifique se você instalou o rsyslog no host do Auditd.
• Verifique se você tem um host do Windows 2012 SP2 ou posterior ou um host do Linux com systemd.
• Se estiver executando por trás de um proxy, verifique se as portas do firewall estão abertas.

Receber o arquivo de autenticação de ingestão do Google SecOps

1. Faça login no console do Google SecOps.
2. Acesse Configurações do SIEM > Agente de coleta.
3. Faça o download do arquivo de autenticação de transferência.

Receber o ID de cliente do Google SecOps

1. Faça login no console do Google SecOps.
2. Acesse Configurações do SIEM > Perfil.
3. Copie e salve o ID do cliente na seção Detalhes da organização.

Instalar o agente do BindPlane

1. Para a instalação do Windows, execute o seguinte script:
   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet.
2. Para a instalação do Linux, execute o seguinte script:
   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh.
3. Outras opções de instalação podem ser encontradas neste guia de instalação.

Configurar o agente BindPlane para ingerir o Syslog e enviar ao Google SecOps

1. Acesse a máquina em que o BindPlane está instalado.

2. Edite o arquivo config.yaml da seguinte forma:

   receivers:
     tcplog:
       # Replace the below port <54525> and IP <0.0.0.0> with your specific values
       listen_address: "0.0.0.0:54525" 
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the creds location below according the placement of the credentials file you downloaded
           creds: '{ json file for creds }'
           # Replace <customer_id> below with your actual ID that you copied
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # You can apply ingestion labels below as preferred
           ingestion_labels:
           log_type: SYSLOG
           namespace: auditd
           raw_log_field: body
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - tcplog
               exporters:
                   - chronicle/chronicle_w_labels
   

3. Reinicie o BindPlane Agent para aplicar as mudanças usando o seguinte comando: sudo systemctl bindplane restart

Como exportar o Syslog do macOS

1. Instale o syslog-ng usando o Homebrew:

   brew install syslog-ng
   

2. Configure o syslog-ng:

   • Edite o arquivo syslog-ng.conf (geralmente localizado em /usr/local/etc/syslog-ng/syslog-ng.conf):

   sudo vi /usr/local/etc/syslog-ng/syslog-ng.conf
   

   • Adicione o seguinte bloco de configuração.
     • Dependendo da configuração do BindPlane, você pode mudar o método de entrega para tcp ou deixá-lo como udp.
     • Substitua <BindPlaneAgent_IP> e <BindPlaneAgent_Port> pelo endereço IP e pela porta reais do agente do BindPlane:

   source s_local { system(); internal(); };
   destination d_secops { tcp("<BindPlaneAgent_IP>:<BindPlaneAgent_Port>"); };
   log { source(s_local); destination(d_secops); };
   

3. Reinicie o serviço syslog-ng:

   brew services restart syslog-ng
   

4. Verifique o status de syslog-ng. Ele deve aparecer como "iniciado":syslog-ng

   brew services list
   

Tabela de mapeamento do UDM

Campo de registro	Mapeamento do UDM	Lógica
dados	read_only_udm.metadata.description	O valor do campo description é extraído do campo data no registro bruto usando um padrão grok.
dados	read_only_udm.principal.hostname	O nome do host é extraído do campo data usando um padrão grok.
dados	read_only_udm.intermediary.hostname	O nome do host intermediário é extraído do campo data usando um padrão grok.
dados	read_only_udm.principal.process.command_line	A linha de comando do processo é extraída do campo data usando um padrão grok.
dados	read_only_udm.principal.process.pid	O ID do processo é extraído do campo data usando um padrão grok.
dados	read_only_udm.metadata.event_timestamp	O carimbo de data/hora do evento é extraído do campo data usando um padrão grok e convertido em um objeto de carimbo de data/hora. Fixado em "MacOS" no analisador. Fixado em "Apple" no analisador. Defina como "STATUS_UPDATE" se um nome de host for extraído dos registros. Caso contrário, defina como "GENERIC_EVENT".
log_type	read_only_udm.metadata.log_type	Mapeado diretamente do campo log_type do registro bruto.

Alterações

2022-05-04

• Parser recém-criado.