Cisco 무선 LAN 컨트롤러 (WLC) 로그 수집

파서 버전: 12.0

다음에서 지원:

이 문서에서는 Bindplane 에이전트를 사용하여 Cisco Wireless LAN Controller (WLC) 로그를 Google Security Operations로 수집하는 방법을 설명합니다.

파서는 grok 패턴을 사용하여 Cisco WLC syslog 메시지에서 필드를 추출하고 DHCP, 인증, 네트워크 이벤트를 비롯한 다양한 로그 형식을 처리합니다. 추출된 필드를 통합 데이터 모델 (UDM)에 매핑하고 mnemonic 및 메시지 콘텐츠를 기반으로 이벤트 유형을 결정합니다.

시작하기 전에

다음 기본 요건이 충족되었는지 확인합니다.

  • Google SecOps 인스턴스
  • Windows Server 2016 이상 또는 systemd가 설치된 Linux 호스트
  • Bindplane 에이전트와 Cisco WLC 간의 네트워크 연결
  • 프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
  • Cisco WLC에 대한 액세스 권한

Google SecOps 수집 인증 파일 가져오기

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 수집 에이전트로 이동합니다.
  3. 데이터 수집 인증 파일 다운로드
  4. Bindplane 에이전트가 설치될 시스템에 파일을 안전하게 저장합니다.

Google SecOps 고객 ID 가져오기

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 프로필로 이동합니다.
  3. 조직 세부정보 섹션에서 고객 ID를 복사하여 저장합니다.

Bindplane 에이전트 설치

다음 안내에 따라 Windows 또는 Linux 운영체제에 Bindplane 에이전트를 설치합니다.

Windows 설치

  1. 명령 프롬프트 또는 PowerShell을 관리자로 엽니다.
  2. 다음 명령어를 실행합니다.

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. 설치가 완료될 때까지 기다립니다.

  4. 다음을 실행하여 설치를 확인합니다.

    sc query observiq-otel-collector
    

    서비스가 실행 중으로 표시되어야 합니다.

Linux 설치

  1. 루트 또는 sudo 권한으로 터미널을 엽니다.
  2. 다음 명령어를 실행합니다.

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. 설치가 완료될 때까지 기다립니다.

  4. 다음을 실행하여 설치를 확인합니다.

    sudo systemctl status observiq-otel-collector
    

    서비스가 활성 (실행 중)으로 표시되어야 합니다.

추가 설치 리소스

추가 설치 옵션 및 문제 해결은 Bindplane 에이전트 설치 가이드를 참고하세요.

syslog를 수집하여 Google SecOps로 전송하도록 Bindplane 에이전트 구성

구성 파일 찾기

  • Linux:

    sudo nano /etc/bindplane-agent/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

구성 파일 설정

  • config.yaml의 전체 콘텐츠를 다음 구성으로 바꿉니다.

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/cisco_wireless:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: CISCO_WIRELESS
            raw_log_field: body
    
    service:
        pipelines:
            logs/cisco_wireless_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/cisco_wireless
    

구성 매개변수

다음 자리표시자를 바꿉니다.

  • 수신기 구성:

    • listen_address: 리슨할 IP 주소 및 포트입니다.
      • 0.0.0.0: 모든 인터페이스에서 수신 대기 (권장)
      • 포트 514는 표준 syslog 포트입니다 (Linux에서 루트 필요, 루트가 아닌 경우 1514 사용).
  • 내보내기 도구 구성:

    • creds_file_path: 수집 인증 파일의 전체 경로입니다.
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: Google SecOps 콘솔에서 복사한 고객 ID
    • endpoint: 지역 엔드포인트 URL:
      • 미국: malachiteingestion-pa.googleapis.com
      • 유럽: europe-malachiteingestion-pa.googleapis.com
      • 아시아: asia-southeast1-malachiteingestion-pa.googleapis.com
      • 전체 목록은 리전 엔드포인트를 참고하세요.

구성 파일 저장

  • 수정 후 파일을 저장합니다.
    • Linux: Ctrl+O, Enter, Ctrl+X 순으로 누릅니다.
    • Windows: 파일 > 저장을 클릭합니다.

변경사항을 적용하려면 Bindplane 에이전트를 다시 시작하세요.

  • Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 명령어를 실행합니다.

    sudo systemctl restart observiq-otel-collector
    
    1. 서비스가 실행 중인지 확인합니다.

      sudo systemctl status observiq-otel-collector
      
    2. 로그에서 오류를 확인합니다.

      sudo journalctl -u observiq-otel-collector -f
      
  • Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 옵션 중 하나를 선택하세요.

    • 관리자 권한으로 명령 프롬프트 또는 PowerShell:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • 서비스 콘솔:

      1. Win+R 키를 누르고 services.msc를 입력한 다음 Enter 키를 누릅니다.
      2. observIQ OpenTelemetry Collector를 찾습니다.
      3. 마우스 오른쪽 버튼을 클릭하고 다시 시작을 선택합니다.
      4. 서비스가 실행 중인지 확인합니다.

        sc query observiq-otel-collector
        
      5. 로그에서 오류를 확인합니다.

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Cisco WLC에서 syslog 구성

  1. WLC 웹 UI에 로그인합니다.
  2. 관리 > 로그 > 구성으로 이동합니다.
  3. Syslog 서버 IP 주소 필드에 Bindplane 에이전트 IP 주소를 입력합니다.
  4. 추가를 클릭합니다.
  5. 다음 구성 세부정보를 제공합니다.
    • Syslog 심각도: 정보를 선택합니다.
    • Syslog Facility: Local Use 0을 선택합니다.
  6. 적용을 클릭합니다.
  7. Save Configuration(구성 저장)을 클릭합니다.

UDM 매핑 테이블

로그 필드 UDM 매핑 로직
action_data read_only_udm.security_result.action_details action_data 필드에서 직접 매핑됩니다.
data read_only_udm.metadata.description 일부 처리 (예: 타임스탬프, 추가 문자 삭제) 후 data 필드에서 직접 매핑됩니다. 로그 메시지 시작 부분의 타임스탬프에서 추출됩니다. 파서에서 다양한 형식을 처리합니다. cisco_wireless.include 파일 내의 복잡한 로직을 사용하여 mnemonic 및 messageToProcess 필드를 기반으로 결정됩니다. 'CISCO_WIRELESS'로 설정합니다. facility, cisco_severity, mnemonic 필드의 연결입니다. 사용 가능한 경우 로그 메시지에서 추출됩니다. 'CISCO_WIRELESS'로 설정합니다. 사용 가능한 경우 version 필드에서 추출됩니다. 'CISCO'로 설정합니다. 이벤트가 DHCP와 관련된 경우 'DHCP'로 설정됩니다. 방송 네트워크 이벤트의 경우 'BROADCAST'로 설정됩니다. UDP 네트워크 이벤트의 경우 'UDP'로 설정합니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 로그 형식에 따라 wlc_controller 또는 hostname 필드에서 매핑됩니다. 설명 또는 MessageSourceAddress에서 추출됩니다(사용 가능한 경우). 로그 형식에 따라 wlc_controller 또는 hostname 필드에서 매핑됩니다. 설명 또는 MessageSourceAddress에서 추출됩니다(사용 가능한 경우). 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 사용 가능한 경우 SourceModuleName 및 SourceModuleType 필드에서 생성됩니다. 사용자 ID가 이메일 주소와 유사한 경우 read_only_udm.principal.user.userid에서 매핑됩니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 이벤트 유형과 설명을 기반으로 결정됩니다. 이벤트 유형과 설명을 기반으로 결정됩니다. 가능한 경우 설명 내의 특정 필드에서 생성됩니다. 가능한 경우 설명에서 추출됩니다. 여러 필드의 정보를 결합하기도 합니다. cisco_severity 필드 및 이벤트 유형을 기반으로 결정됩니다. read_only_udm.security_result.severity 필드에서 파생됩니다. 설명과 이벤트 유형에서 파생된 보안 결과의 간결한 요약입니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 가능한 경우 설명에서 추출됩니다. 설정 수정 이벤트의 경우 'SETTING'으로 설정됩니다. 가능한 경우 설명에서 추출됩니다.
event_data read_only_udm.metadata.product_event_type event_data 필드에서 직접 매핑됩니다.
event_id read_only_udm.metadata.product_log_id event_id 필드에서 직접 매핑됩니다.
event_ts read_only_udm.metadata.event_timestamp event_ts 필드에서 직접 매핑됩니다.
facility read_only_udm.metadata.product_event_type facility 필드에서 직접 매핑됩니다.
hostname read_only_udm.principal.hostname hostname 필드에서 직접 매핑됩니다.
hostname read_only_udm.target.hostname hostname 필드에서 직접 매핑됩니다.
inter_mac read_only_udm.intermediary.mac inter_mac 필드에서 직접 매핑됩니다.
intermediary_hostname read_only_udm.intermediary.hostname intermediary_hostname 필드에서 직접 매핑됩니다.
kv_data read_only_udm.principal.resource.attribute.labels 키-값 쌍으로 파싱되고 라벨을 채우는 데 사용됩니다.
log_message read_only_udm.security_result.description log_message 필드에서 직접 매핑됩니다.
MessageSourceAddress read_only_udm.principal.asset.ip MessageSourceAddress 필드에서 직접 매핑됩니다.
MessageSourceAddress read_only_udm.principal.ip MessageSourceAddress 필드에서 직접 매핑됩니다.
messageToProcess read_only_udm.metadata.description 일부 처리 후 messageToProcess 필드에서 직접 매핑됩니다.
mnemonic read_only_udm.metadata.event_type 이벤트 유형을 결정하기 위해 다른 필드와 함께 사용됩니다.
mnemonic read_only_udm.metadata.product_event_type mnemonic 필드에서 직접 매핑됩니다.
severity_data read_only_udm.security_result.severity severity_data 필드에서 enum 값으로 변환된 후 매핑됩니다.
SourceModuleName read_only_udm.principal.resource.attribute.labels SourceModuleName 필드에서 직접 매핑됩니다.
SourceModuleType read_only_udm.principal.resource.attribute.labels SourceModuleType 필드에서 직접 매핑됩니다.
timestamp read_only_udm.metadata.event_timestamp timestamp 필드에서 직접 매핑됩니다.
version read_only_udm.metadata.product_version version 필드에서 직접 매핑됩니다.
wlc_controller read_only_udm.principal.hostname wlc_controller 필드에서 직접 매핑됩니다.
wlc_controller read_only_udm.target.hostname wlc_controller 필드에서 직접 매핑됩니다.
mnemonic event.idm.read_only_udm.metadata.product_event_type 변경 로그에서 매핑됨
urlHolder event.idm.read_only_udm.target.url 변경 로그에서 매핑됨
syslog_sequence event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
userid event.idm.read_only_udm.principal.user.userid 변경 로그에서 매핑됨
principal_mac event.idm.read_only_udm.principal.mac 변경 로그에서 매핑됨
obs_host event.idm.read_only_udm.observer.hostname 변경 로그에서 매핑됨
obs_desc event.idm.read_only_udm.observer.labels 변경 로그에서 매핑됨
addr event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
component_status event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
ecc event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
multipleErrorsDetected event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
rep[0] event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
rep[1] event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
rep[2] event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
suppressed_times event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
valid event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
interface event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
event_id event.idm.read_only_udm.metadata.product_log_id 변경 로그에서 매핑됨
principal_hostname event.idm.read_only_udm.principal.hostname 및 event.idm.read_only_udm.principal.asset.hostname 변경 로그에서 매핑됨
wlc_controller event.idm.read_only_udm.principal.hostname 및 event.idm.read_only_udm.principal.asset.hostname 변경 로그에서 매핑됨
src_ip_1 event.idm.read_only_udm.principal.ip 변경 로그에서 매핑됨
src_ip_2 event.idm.read_only_udm.principal.ip 변경 로그에서 매핑됨
mac1 event.idm.read_only_udm.principal.mac 변경 로그에서 매핑됨
mac2 event.idm.read_only_udm.principal.mac 변경 로그에서 매핑됨
slot event.idm.read_only_udm.security_result.detection_fields 변경 로그에서 매핑됨
username event.idm.read_only_udm.principal.user.userid 변경 로그에서 매핑됨
src_ip event.idm.read_only_udm.principal.ip 및 event.idm.read_only_udm.principal.asset.ip 변경 로그에서 매핑됨
ssid event.idm.read_only_udm.security_result.detection_fields 변경 로그에서 매핑됨
SourceModuleName" and "SourceModuleType principal.resource.attribute.labels 변경 로그에서 매핑됨
client_host", and "hostname principal.hostname 변경 로그에서 매핑됨
client_ip principal.ip 변경 로그에서 매핑됨
client_mac principal.mac 변경 로그에서 매핑됨
ap_ip target.ip 변경 로그에서 매핑됨
ap_mac target.mac 변경 로그에서 매핑됨
messageToProcess" and "description metadata.description 변경 로그에서 매핑됨
inter_url intermediary.url 변경 로그에서 매핑됨
inter_ip intermediary.ip 변경 로그에서 매핑됨
sec_desc security_result.description 변경 로그에서 매핑됨
latest_version", "current_version", "certificate", "expiry_date", "clostest_sensor", "ssid", "client", "xid", "failure_reason", "auth_failure_reason", and "interface security_result.detection_fields 변경 로그에서 매핑됨
action_data security_result.acion_details 변경 로그에서 매핑됨
username principal.user.userid 변경 로그에서 매핑됨
vendor", and "RSSI principal.resource.attribute.labels 변경 로그에서 매핑됨
vendor", "security_setting", "channel", "protocol", and "RSSI target.resource.attribute.labels 변경 로그에서 매핑됨
msg1 metadata.description 변경 로그에서 매핑됨
wlc_controller event.idm.read_only_udm.principal.hostname 변경 로그에서 매핑됨
event.idm.read_only_udm.metadata.event_type USER_RESOURCE_ACCESS 변경 로그에서 매핑됨

변경 로그

이 파서의 변경 로그 보기

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.