Coletar registros do IBM Informix
Este documento explica como ingerir registros do IBM Informix no Google Security Operations usando o agente do Bindplane.
O IBM Informix é um sistema de gerenciamento de banco de dados relacional de alto desempenho que oferece recursos abrangentes de geração de registros de auditoria por meio do recurso de auditoria segura. A funcionalidade de auditoria para syslog (ASL, na sigla em inglês) permite que os registros de auditoria sejam enviados ao daemon do syslog para geração de registros centralizada e integração com o SIEM.
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 um host Linux com
systemd - Conectividade de rede entre o agente do Bindplane e o servidor IBM Informix
- 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 administrativo ao servidor IBM Informix com o papel de AAO (Audit Administrator Officer)
- IBM Informix 12.10 ou mais recente (a funcionalidade ASL foi introduzida na versão 12.10)
- Máscaras de auditoria configuradas para os usuários ou eventos que você quer monitorar
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-collectorO 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-collectorO 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/informix: 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: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: chronicle.googleapis.com log_type: INFORMIX raw_log_field: body ingestion_labels: env: production source: informix_audit service: pipelines: logs/informix_to_chronicle: receivers: - udplog exporters: - chronicle/informixSubstitua os seguintes marcadores de posição:
Configuração do receptor:
listen_address: endereço IP e porta a serem detectados:0.0.0.0:514para detectar todas as interfaces na porta 514 (porta syslog padrão)- Use a porta
1514ou uma superior se estiver executando como usuário raiz no Linux. - Ajuste o número da porta para corresponder à configuração do syslog do Informix
Configuração do exportador:
creds_file_path: caminho completo para o arquivo de chave JSON da conta de serviço (opção 1). Salve o arquivo de credenciais comoingestion-auth.jsonem um dos seguintes locais:- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: substituaYOUR_CUSTOMER_IDpelo ID de cliente da etapa anterior.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: definido comoINFORMIXingestion_labels: rótulos opcionais para categorizar registros (personalize conforme necessário)
Exemplo de configuração para syslog TCP
Se você preferir o TCP para uma entrega confiável, use esta configuração:
receivers: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/informix: 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: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: chronicle.googleapis.com log_type: INFORMIX raw_log_field: body service: pipelines: logs/informix_to_chronicle: receivers: - tcplog exporters: - chronicle/informix
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/informix: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: INFORMIX raw_log_field: body ingestion_labels: env: production source: informix_audit
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.
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-collectorConsole 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 do IBM Informix
Criar máscaras de auditoria
Antes de ativar a auditoria, é preciso criar máscaras de auditoria para definir quais eventos serão auditados para quais usuários.
Conecte-se ao servidor IBM Informix como um usuário com o papel AAO.
Crie uma máscara de auditoria padrão para todos os usuários auditarem eventos comuns do banco de dados:
onaudit -a -u _default -e +OPDB,GRDB,CRTB,ALTB,DRTBEsse comando cria a máscara
_defaulte audita os seguintes eventos:- OPDB: banco de dados aberto
- GRDB: conceder acesso ao banco de dados
- CRTB: criar tabela
- ALTB: Alter Table
- DRTB: descartar tabela
Para ativar a auditoria no nível da linha para modificações de dados, crie uma máscara com eventos no nível da linha:
onaudit -a -u _require -e +DLRW,INRW,UPRW,RDRWEsse comando cria a máscara
_requiree audita:- DLRW: excluir linha
- INRW: inserir linha
- UPRW: atualizar linha
- RDRW: ler linha
Para criar uma máscara para um usuário específico, substitua
_defaultpelo nome de usuário:onaudit -a -u username -e +OPDB,GRDB,CRTB,ALTB,DRTB,DLRW,INRW,UPRWVerifique se as máscaras de auditoria foram criadas:
onaudit -o
Ativar a auditoria para o Syslog (ASL)
Ative a auditoria do ASL e configure os parâmetros do syslog:
onaudit -E on -F LOG_LOCAL0 -I informix_audit -P LOG_INFOEsse comando:
-E on: ativa a funcionalidade de auditoria para Syslog.-F LOG_LOCAL0: define o recurso syslog como LOG_LOCAL0 (recomendado para filtragem)-I informix_audit: define o identificador do syslog comoinformix_audit(aparece nas mensagens do syslog)-P LOG_INFO: define a prioridade do syslog como LOG_INFO.
Ative a auditoria obrigatória para administradores de banco de dados:
onaudit -A on -S onEsse comando:
-A on: ativa a auditoria obrigatória para o grupo DBSA (administrador do servidor de banco de dados)-S on: ativa a auditoria obrigatória para o grupo DBSSO (Database Security Officer)
Se você quiser ativar a auditoria no nível da linha para tabelas com a flag AUDIT:
onaudit -R 1Isso define o parâmetro ADTROWS como 1, permitindo a auditoria seletiva no nível da linha.
Verifique a configuração de auditoria:
onaudit -cA saída vai mostrar:
ADT_SYSLOG_ENABLED = 1ADT_SYSLOG_FACILITY = LOG_LOCAL0ADT_SYSLOG_IDENTIFIER = informix_auditADT_SYSLOG_PRIORITY = LOG_INFOADT_DBSA = 1(se estiverem ativados)ADT_DBSSO = 1(se estiverem ativados)
Configurar o daemon do syslog para encaminhar ao agente do Bindplane
A funcionalidade ASL do Informix envia registros de auditoria para o daemon syslog local. É preciso configurar o daemon do syslog para encaminhar essas mensagens ao agente do Bindplane.
Para rsyslog (mais comum no Linux):
Crie um novo arquivo de configuração do rsyslog:
sudo nano /etc/rsyslog.d/30-informix-audit.confAdicione a seguinte configuração para encaminhar os registros de auditoria do Informix:
# Forward Informix audit logs to Bindplane agent local0.* @127.0.0.1:514Se você configurou um recurso diferente no comando
onaudit -F, substitualocal0pelo seu recurso (por exemplo,local1,local2etc.).Se o agente do Bindplane estiver em um servidor diferente, substitua
127.0.0.1pelo endereço IP do agente do Bindplane.Para encaminhamento de TCP (mais confiável), use
@@em vez de@:local0.* @@127.0.0.1:514Salve o arquivo e reinicie o rsyslog:
sudo systemctl restart rsyslogVerifique se o rsyslog está em execução:
sudo systemctl status rsyslog
Para syslog-ng:
Edite o arquivo de configuração do syslog-ng:
sudo nano /etc/syslog-ng/syslog-ng.confAdicione a seguinte configuração:
# Define destination for Bindplane agent destination d_bindplane { udp("127.0.0.1" port(514)); }; # Filter for Informix audit logs filter f_informix { facility(local0); }; # Log path to forward Informix logs log { source(s_src); filter(f_informix); destination(d_bindplane); };Salve o arquivo e reinicie o syslog-ng:
sudo systemctl restart syslog-ng
Testar a configuração
Gere um evento de auditoria de teste conectando-se a um banco de dados:
dbaccess stores_demoEm seguida, saia do banco de dados.
Verifique os registros agênticos do Bindplane para confirmar se os registros de auditoria estão sendo recebidos:
Linux:
sudo journalctl -u observiq-otel-collector -f | grep informixWindows:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr informixTambém é possível usar o utilitário
onshowauditpara visualizar registros de auditoria dos arquivos syslog:onshowaudit -f /var/log/syslog -u your_username
Formato do registro de auditoria
Os registros de auditoria do Informix enviados por syslog têm o seguinte formato:
Jan 12 11:59:21 hostname informix_audit: ONLN|2021-01-12 18:59:21.512|hostname|31055|servername|username|0:OPDB:stores_demo:0:-O formato inclui:
- Carimbo de data/hora e nome do host do syslog (adicionados pelo daemon do syslog)
- Identificador do Syslog (configurado com a opção
-I) - Status do servidor (ONLN = on-line)
- Carimbo de data/hora do Informix
- Nome do host
- ID de processo
- Nome do servidor
- Nome de usuário
- Código e detalhes do evento (delimitados por barra vertical)
Outras opções de configuração
Para definir as opções do syslog:
onaudit -O LOG_NDELAY,LOG_PIDOpções disponíveis:
LOG_NDELAY: abre a conexão imediatamente (padrão)LOG_ODELAY: atrasa a abertura da conexão (mutuamente exclusivo com LOG_NDELAY)LOG_PID: incluir o ID de processo nas mensagensLOG_CONS: gravar no console se o syslog não estiver disponívelLOG_PERROR: grava em stderr e syslog.
Para mudar o caminho do arquivo de auditoria (para auditoria clássica):
onaudit -p /path/to/audit/directoryPara definir o tamanho máximo do arquivo de auditoria:
onaudit -s 50000000Isso define o tamanho máximo como 50 MB (valor em bytes).
Para iniciar um novo arquivo de auditoria manualmente:
onaudit -nPara definir o modo de tratamento de erros:
onaudit -e 1
Modos de erro:
0: continuar o processamento e registrar o erro (padrão)1: suspende a linha de execução até que o registro de auditoria possa ser gravado.3: encerra o servidor.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
| id, dequeue_count, RequestId | about.labels | Mesclado com rótulos para "ID da mensagem", "Contagem de remoção da fila", "ID da solicitação" |
| timestamp | metadata.event_timestamp | Convertido usando o formato: yyyy-MM-dd HH:mm:ss.SSS |
| tipo | metadata.event_type | Defina como "GENERIC_EVENT" se type == "ERROR", caso contrário, defina como "SYSTEM_AUDIT_LOG_UNCATEGORIZED" |
| serverName | principal.asset.asset_id | Concatenado de "PRODUCT_SPECIFIC_ID: " e serverName se type != 'ERROR' |
| hostName | principal.hostname | Valor copiado diretamente se type != 'ERROR' |
| processId | principal.process.pid | Valor copiado diretamente se type != 'ERROR' |
| eventOutput, eventName | principal.resource.attribute.labels | Mesclado com rótulos para "Saída do evento", "Nome do evento" |
| dbName | principal.resource.name | Valor copiado diretamente se data != "" |
| principal.resource.type | Defina como "DATABASE" se data != "" | |
| userName | principal.user.userid | Valor copiado diretamente se type != 'ERROR' |
| errorCode, type | security_result.action | Defina como "BLOCK" se type == "ERROR", caso contrário, "ALLOW" se errorCode == "0", caso contrário, "BLOCK" |
| Exceção | security_result.description | Valor copiado diretamente se kv_data_1 != "" |
| ErrorCode | security_result.rule_name | Valor copiado diretamente se kv_data_1 != "" |
| descrição | security_result.summary | Valor copiado diretamente se description != "" |
| blob_name, file_name | target.file.full_path | Valor de blob_name se type == 'ERROR', caso contrário, file_name |
| metadata.product_name | Defina como "INFORMIX". | |
| metadata.vendor_name | Defina como "IBM". |
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.