Coletar registros do Cisco APIC

Compatível com:

Este documento explica como ingerir registros do Cisco APIC no Google Security Operations usando o Bindplane. O analisador extrai campos dos registros formatados do syslog. Ele usa grok e/ou kv para analisar a mensagem de registro e 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 2016 ou mais recente ou um host Linux com systemd
  • Se você estiver executando por trás de um proxy, verifique se as portas do firewall estão abertas de acordo com os requisitos do agente Bindplane.
  • Acesso privilegiado ao console de gerenciamento do Cisco APIC

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 > Agentes de coleta.
  3. Baixe o arquivo de autenticação de ingestão. Salve o arquivo de forma segura no sistema em que o Bindplane será instalado.

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

Instalação do Windows

  1. Abra o Prompt de Comando ou o PowerShell como administrador.

  2. Execute este comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

Instalação do Linux

  1. Abra um terminal com privilégios de root ou sudo.

  2. Execute este comando:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

Outros recursos de instalação

Configurar o agente do Bindplane para ingerir o Syslog e enviar ao Google SecOps

  1. Acesse o arquivo de configuração:

    1. Localize o arquivo config.yaml. Normalmente, ele fica no diretório /etc/bindplane-agent/ no Linux ou no diretório de instalação no Windows.
    2. Abra o arquivo usando um editor de texto (por exemplo, nano, vi ou Bloco de Notas).

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

    receivers:
  udplog:
    # Replace the port and IP address as required
    listen_address: "0.0.0.0:514"

exporters:
  chronicle/chronicle_w_labels:
    compression: gzip
    # Adjust the path to the credentials file you downloaded in Step 1
    creds_file_path: '/path/to/ingestion-authentication-file.json'
    # Replace with your actual customer ID from Step 2
    customer_id: YOUR_CUSTOMER_ID
    endpoint: malachiteingestion-pa.googleapis.com
    # Specify the log type that matches your Chronicle feed configuration
    # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup
    log_type: 'CISCO_APIC'
    raw_log_field: body
    ingestion_labels:

service:
  pipelines:
    logs/source0__chronicle_w_labels-0:
      receivers:
        - udplog
      exporters:
        - chronicle/chronicle_w_labels
    • Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.
    • Substitua <customer_id> pelo ID do cliente real.
    • Atualize /path/to/ingestion-authentication-file.json para o caminho em que o arquivo de autenticação foi salvo na seção Receber arquivo de autenticação de ingestão do Google SecOps.
    • Verifique se o valor log_type corresponde ao tipo de registro selecionado na configuração do feed do Google SecOps.

Reinicie o agente do Bindplane para aplicar as mudanças

  • Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:

    sudo systemctl restart bindplane-agent

  • Para reiniciar o agente do Bindplane no Windows, use o console Serviços ou insira o seguinte comando:

    net stop BindPlaneAgent && net start BindPlaneAgent

Configurar o encaminhamento do Syslog no Cisco APIC

Configurar contratos de gerenciamento

  1. Faça login no console do Cisco APIC.
  2. Acesse Locatários > mgmt > Políticas de segurança.
  3. Verifique se os contratos de gerenciamento permitem UDP na porta 514:
    • Para gerenciamento fora da banda: verifique se o contrato OOB permite a porta UDP 514.
    • Para gerenciamento em banda: verifique se o contrato INB permite a porta UDP 514.
  4. Se necessário, crie ou modifique filtros para permitir a porta UDP 514 para o EPG de gerenciamento selecionado.

Criar grupo de destino de monitoramento do Syslog

  1. Acesse Administrador > Coletores de dados externos > Destinos de monitoramento > Syslog.
  2. Clique no sinal + para Criar grupo de destino de monitoramento do Syslog.
  3. Informe os seguintes detalhes de configuração:
    • Nome: insira um nome descritivo, por exemplo, Google SecOps Syslog.
    • Descrição: insira uma descrição (por exemplo, Syslog destination for Google SecOps).
    • Estado do administrador: selecione ativado.
    • Formato: selecione aci (recomendado) ou nxos.
  4. Clique em Próxima.
  5. Na seção Criar destino remoto do Syslog, forneça os seguintes detalhes de configuração:
    • Nome do host/IP: insira o endereço IP do agente do BindPlane.
    • Nome: insira um nome descritivo para o destino.
    • Estado do administrador: selecione ativado.
    • Gravidade: selecione Informações (ou o nível de gravidade de sua preferência).
    • Porta: digite 514 (ou a porta configurada no agente do BindPlane).
    • EPG de gerenciamento: selecione o EPG de gerenciamento adequado:
      • padrão (fora da banda) para gerenciamento OOB
      • inb-default para gerenciamento in-band
    • Instalação de encaminhamento: selecione local7 (ou sua instalação preferida).
  6. Clique em OK.
  7. Revise a configuração e clique em Concluir.

Configurar a origem do syslog da política de tecido

  1. Acesse Fabric > Políticas do Fabric > Políticas de monitoramento.
  2. Expanda padrão e selecione Callhome/SNMP/Syslog.
  3. Clique no sinal + para criar uma origem do syslog.
  4. Informe os seguintes detalhes de configuração:
    • Nome da origem: insira um nome (por exemplo, fabric-syslog-source).
    • Gravidade mínima: selecione informação.
    • Incluir: selecione Marcar tudo para incluir registros de auditoria, eventos, falhas e sessões.
    • Grupo de destino: selecione o grupo de destino de monitoramento do syslog criado anteriormente.
  5. Clique em Enviar.

Configurar a origem syslog da política comum

  1. Acesse Fabric > Políticas do Fabric > Políticas de monitoramento.
  2. Abra common e selecione Callhome/SNMP/Syslog.
  3. Clique em + para criar uma origem syslog.
  4. Informe os seguintes detalhes de configuração:
    • Nome da origem: insira um nome (por exemplo, common-syslog-source).
    • Gravidade mínima: selecione informação.
    • Incluir: selecione Marcar tudo para incluir registros de auditoria, eventos, falhas e sessões.
    • Grupo de destino: selecione o grupo de destino de monitoramento do syslog criado anteriormente.
  5. Clique em Enviar.

Configurar a origem syslog da política de acesso

  1. Acesse Fabric > Políticas de acesso > Políticas de monitoramento.
  2. Expanda padrão e selecione Callhome/SNMP/Syslog.
  3. Clique no sinal + para criar uma origem do syslog.
  4. Informe os seguintes detalhes de configuração:
    • Nome da origem: insira um nome (por exemplo, access-syslog-source).
    • Gravidade mínima: selecione informação.
    • Incluir: selecione Marcar tudo para incluir registros de auditoria, eventos, falhas e sessões.
    • Grupo de destino: selecione o grupo de destino de monitoramento do syslog criado anteriormente.
  5. Clique em Enviar.

Configurar a política de mensagens do sistema (opcional)

  1. Acesse Fabric > Políticas do Fabric > Políticas de monitoramento.
  2. Expanda common > Políticas de mensagens do sistema.
  3. Selecione Política para mensagens de syslog do sistema.
  4. Selecione a unidade padrão.
  5. Mude a Gravidade para Informações.
  6. Clique em Atualizar.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.