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 수집 인증 파일 가져오기
- Google SecOps 콘솔에 로그인합니다.
- SIEM 설정 > 수집 에이전트로 이동합니다.
- 데이터 수집 인증 파일 다운로드
Bindplane 에이전트가 설치될 시스템에 파일을 안전하게 저장합니다.
Google SecOps 고객 ID 가져오기
- Google SecOps 콘솔에 로그인합니다.
- SIEM 설정 > 프로필로 이동합니다.
조직 세부정보 섹션에서 고객 ID를 복사하여 저장합니다.
Bindplane 에이전트 설치
다음 안내에 따라 Windows 또는 Linux 운영체제에 Bindplane 에이전트를 설치합니다.
Windows 설치
- 명령 프롬프트 또는 PowerShell을 관리자로 엽니다.
다음 명령어를 실행합니다.
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet설치가 완료될 때까지 기다립니다.
다음을 실행하여 설치를 확인합니다.
sc query observiq-otel-collector서비스가 실행 중으로 표시되어야 합니다.
Linux 설치
- 루트 또는 sudo 권한으로 터미널을 엽니다.
다음 명령어를 실행합니다.
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh설치가 완료될 때까지 기다립니다.
다음을 실행하여 설치를 확인합니다.
sudo systemctl status observiq-otel-collector서비스가 활성 (실행 중)으로 표시되어야 합니다.
추가 설치 리소스
추가 설치 옵션 및 문제 해결은 Bindplane 에이전트 설치 가이드를 참고하세요.
syslog를 수집하여 Google SecOps로 전송하도록 Bindplane 에이전트 구성
구성 파일 찾기
Linux:
sudo nano /etc/bindplane-agent/config.yamlWindows:
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
- Linux:
customer_id: Google SecOps 콘솔에서 복사한 고객 IDendpoint: 지역 엔드포인트 URL:- 미국:
malachiteingestion-pa.googleapis.com - 유럽:
europe-malachiteingestion-pa.googleapis.com - 아시아:
asia-southeast1-malachiteingestion-pa.googleapis.com - 전체 목록은 리전 엔드포인트를 참고하세요.
- 미국:
구성 파일 저장
- 수정 후 파일을 저장합니다.
- Linux:
Ctrl+O,Enter,Ctrl+X순으로 누릅니다. - Windows: 파일 > 저장을 클릭합니다.
- Linux:
변경사항을 적용하려면 Bindplane 에이전트를 다시 시작하세요.
Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 명령어를 실행합니다.
sudo systemctl restart observiq-otel-collector서비스가 실행 중인지 확인합니다.
sudo systemctl status observiq-otel-collector로그에서 오류를 확인합니다.
sudo journalctl -u observiq-otel-collector -f
Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 옵션 중 하나를 선택하세요.
관리자 권한으로 명령 프롬프트 또는 PowerShell:
net stop observiq-otel-collector && net start observiq-otel-collector서비스 콘솔:
Win+R키를 누르고services.msc를 입력한 다음 Enter 키를 누릅니다.- observIQ OpenTelemetry Collector를 찾습니다.
- 마우스 오른쪽 버튼을 클릭하고 다시 시작을 선택합니다.
서비스가 실행 중인지 확인합니다.
sc query observiq-otel-collector로그에서 오류를 확인합니다.
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Cisco WLC에서 syslog 구성
- WLC 웹 UI에 로그인합니다.
- 관리 > 로그 > 구성으로 이동합니다.
- Syslog 서버 IP 주소 필드에 Bindplane 에이전트 IP 주소를 입력합니다.
- 추가를 클릭합니다.
- 다음 구성 세부정보를 제공합니다.
- Syslog 심각도: 정보를 선택합니다.
- Syslog Facility: Local Use 0을 선택합니다.
- 적용을 클릭합니다.
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 전문가에게 문의하여 답변을 받으세요.