OPNsense 방화벽 로그 수집
이 문서에서는 Bindplane 에이전트를 사용하여 OPNsense 방화벽 로그를 Google Security Operations에 수집하는 방법을 설명합니다.
OPNsense는 방화벽 규칙 일치, 네트워크 연결, 시스템 이벤트에 대한 syslog 메시지를 생성하는 오픈소스 방화벽 및 라우팅 플랫폼입니다. 파서는 grok 및 CSV 파싱을 사용하여 CSV 형식의 filterlog 메시지에서 필드를 추출하고 통합 데이터 모델 (UDM)에 매핑합니다.
시작하기 전에
다음 기본 요건이 충족되었는지 확인합니다.
- Google SecOps 인스턴스
- Windows Server 2016 이상 또는
systemd가 설치된 Linux 호스트 - Bindplane 에이전트와 OPNsense 방화벽 간의 네트워크 연결
- 프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
- OPNsense 웹 인터페이스에 대한 관리 액세스
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 /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
구성 파일 설정
config.yaml의 전체 콘텐츠를 다음 구성으로 바꿉니다.receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/opnsense: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: OPNSENSE raw_log_field: body service: pipelines: logs/opnsense_to_chronicle: receivers: - udplog exporters: - chronicle/opnsense
구성 매개변수
다음 자리표시자를 바꿉니다.
수신기 구성:
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"
OPNsense에 시스템 로그 서버 구성 추가
- OPNsense 웹 인터페이스에 로그인합니다.
- 시스템 > 설정 > 로깅으로 이동합니다.
- 원격 로깅 섹션에서 체크박스를 선택하여 원격 시스템로그 서버에 로그 보내기를 사용 설정합니다.
- 원격 시스템 로그 서버 필드에 포트를 포함한 시스템 로그 서버의 IP 주소를 입력합니다 (예:
10.10.10.10:514). - syslog 기능으로 Local0을 선택합니다.
- syslog 수준을 Alert로 설정합니다.
- 저장을 클릭하여 변경사항을 적용합니다.
UDM 매핑 테이블
| 로그 필드 | UDM 매핑 | 로직 |
|---|---|---|
column1 |
security_result.rule_id |
column1에서 직접 매핑됩니다. |
column10 |
additional.fields[].key: 'tos'additional.fields[].value.string_value: column10 값 |
column10에서 직접 매핑되며, 키가 'tos'인 additional.fields 아래에 중첩됩니다. |
column12 |
additional.fields[].key: 'ttl'additional.fields[].value.string_value: column12 값 |
column12에서 직접 매핑되며, 키가 'ttl'인 additional.fields 아래에 중첩됩니다. |
column13 |
additional.fields[].key: 'Id'additional.fields[].value.string_value: column13의 값 |
column13에서 직접 매핑되며, 키가 'Id'인 additional.fields 아래에 중첩됩니다. |
column14 |
additional.fields[].key: 'offset'additional.fields[].value.string_value: column14 값 |
column14에서 직접 매핑되며, 키가 'offset'인 additional.fields 아래에 중첩됩니다. |
column15 |
additional.fields[].key: 'flags'additional.fields[].value.string_value: column15 값 |
column15에서 직접 매핑되며, 키가 'flags'인 additional.fields 아래에 중첩됩니다. |
column17 |
network.ip_protocol |
대문자로 변환한 후 column17에서 직접 매핑됩니다. |
column18 |
network.received_bytes |
부호 없는 정수로 변환한 후 column18에서 직접 매핑됩니다. |
column19 |
principal.ip |
column19에서 직접 매핑됩니다. |
column20 |
target.ip |
column20에서 직접 매핑됩니다. |
column21 |
principal.port (column17이 TCP 또는 UDP인 경우)additional.fields[].key: 'data_length'additional.fields[].value.string_value: 추출된 값 (column17이 ICMP, GRE, ESP 또는 IGMP인 경우) |
column17이 TCP/UDP인 경우 column21에서 직접 매핑되고 정수로 변환됩니다. 그렇지 않으면 grok을 사용하여 'datalength' 값이 추출되고 키 'data_length'와 함께 additional.fields에 배치됩니다. |
column22 |
target.port |
column17이 TCP 또는 UDP인 경우 column22에서 직접 매핑되고 정수로 변환됩니다. |
column24 |
additional.fields[].key: 'tcp_flags'additional.fields[].value.string_value: column24 값 |
column17이 TCP인 경우 column24에서 직접 매핑되며, 키가 'tcp_flags'인 additional.fields 아래에 중첩됩니다. |
column29 |
additional.fields[].key: 'tcp_options'additional.fields[].value.string_value: column29 값 |
column17이 TCP인 경우 column29에서 직접 매핑되며, 키가 'tcp_options'인 additional.fields 아래에 중첩됩니다. |
column4 |
additional.fields[].key: 'tracker'additional.fields[].value.string_value: column4의 값 |
column4에서 직접 매핑되며, 키가 'tracker'인 additional.fields 아래에 중첩됩니다. |
column5 |
additional.fields[].key: '인터페이스'additional.fields[].value.string_value: column5의 값 |
column5에서 직접 매핑되며, 키가 'interface'인 additional.fields 아래에 중첩됩니다. |
column6 |
security_result.rule_type |
column6에서 직접 매핑됩니다. |
column7 |
security_result.action |
column7에서 매핑됨 'block'인 경우 대문자 'BLOCK'으로 변환됩니다. '통과'인 경우 '허용'으로 설정합니다. |
column8 |
network.direction |
column8에서 매핑됨 'in'인 경우 'INBOUND'로 설정합니다. 'out'인 경우 'OUTBOUND'로 설정합니다. |
domain |
principal.administrative_domain |
grok에서 추출한 domain에서 직접 매핑됩니다. 주 구성원 및 대상 IP 주소가 모두 있는 경우 'NETWORK_CONNECTION'으로 설정하고, 그렇지 않으면 'GENERIC_EVENT'로 설정합니다. 'OPNSENSE'로 하드코딩됨 'OPNSENSE'로 하드코딩됨 |
message |
다양한 필드 | grok 및 csv 필터를 사용하여 파싱하여 다양한 필드를 추출합니다. 구체적인 매핑은 다른 행을 참고하세요. |
ts |
metadata.event_timestamp.seconds, timestamp.seconds |
grok을 사용하여 메시지 필드에서 파싱한 후 타임스탬프로 변환됩니다. 초 값은 metadata.event_timestamp.seconds와 timestamp.seconds를 모두 채우는 데 사용됩니다. |
application |
principal.application |
grok에서 추출한 application에서 직접 매핑됩니다. |
column27 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column2 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column3 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column11 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column26 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column28 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column25 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column16 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
column9 |
event.idm.read_only_udm.additional.fields |
변경 로그에서 매핑됨 |
변경 로그
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.