Apache 로그 수집
이 문서에서는 Bindplane 에이전트를 사용하여 Apache 로그를 Google Security Operations로 수집하는 방법을 설명합니다.
Apache HTTP 서버는 HTTP 요청을 처리하고 액세스 및 오류 로그를 생성하는 오픈소스 웹 서버입니다. 파서는 표준 결합/일반 로그 형식과 JSON 형식 로그를 모두 처리하여 HTTP 요청 세부정보, 응답 코드, 클라이언트 정보를 추출합니다.
시작하기 전에
다음 기본 요건이 충족되었는지 확인합니다.
- Google SecOps 인스턴스
- Windows Server 2016 이상 또는
systemd가 설치된 Linux 호스트 - Bindplane 에이전트와 Apache 서버 간의 네트워크 연결
- 프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
- Apache 서버에 대한 액세스 권한 (루트 또는 sudo)
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서비스가 active (running)으로 표시되어야 합니다.
추가 설치 리소스
추가 설치 옵션 및 문제 해결은 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/apache: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: APACHE raw_log_field: body service: pipelines: logs/apache_to_chronicle: receivers: - udplog exporters: - chronicle/apache
구성 매개변수
다음 자리표시자를 바꿉니다.
수신기 구성:
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"
Apache에서 syslog 구성
- SSH를 사용하여 Apache를 호스팅하는 서버에 로그인합니다.
/etc/rsyslog.d/아래에02-apache2.conf이라는 파일을 만듭니다.vim /etc/rsyslog.d/02-apache2.conf아래 코드를 파일에 추가합니다.
module(load="imfile" PollingInterval="10" statefile.directory="/var/spool/rsyslog") input(type="imfile" File="/var/log/apache2/access.log" Tag="http_access" Severity="info" Facility="local6") Local6.info @<BINDPLANE_IP>:<BINDPLANE_PORT> module(load="imfile" PollingInterval="10" statefile.directory="/var/spool/rsyslog") input(type="imfile" File="/var/log/apache2/error.log" Tag="http_error" Severity="error" Facility="local7") Local7.error @<BINDPLANE_IP>:<BINDPLANE_PORT><BINDPLANE_IP>및<BINDPLANE_PORT>를 Bindplane 에이전트에 대해 구성된 IP 주소 및 포트로 바꿉니다.- TCP 프로토콜을 사용하는 경우 호스트 행에
@를 추가합니다 (예:@@<BINDPLANE_IP>:<BINDPLANE_PORT>).
rsyslog 서비스를 다시 시작합니다.
sudo service rsyslog restart
UDM 매핑 테이블
| 로그 필드 | UDM 매핑 | 논리 |
|---|---|---|
bytes |
network.received_bytes |
클라이언트로부터 수신된 바이트입니다. |
bytes |
network.sent_bytes |
클라이언트로 전송된 바이트입니다. |
bytes_out |
network.sent_bytes |
클라이언트로 전송된 바이트입니다. |
bytes_received |
network.received_bytes |
클라이언트로부터 수신된 바이트입니다. |
Content |
network.http.method |
'Content' 필드에서 추출된 HTTP 메서드입니다. |
Content |
target.url |
'콘텐츠' 필드에서 추출된 타겟 URL입니다. |
cookie |
additional.fields.value.string_value |
'cookie' 필드의 값입니다. |
dest_ip |
target.ip |
타겟의 IP 주소입니다. |
dest_name |
target.hostname |
타겟의 호스트 이름입니다. |
dest_port |
target.port |
타겟의 포트입니다. |
description |
metadata.description |
이벤트의 설명으로 |
duration_microseconds |
additional.fields.value.string_value |
'duration_microseconds' 필드의 값입니다. |
file_full_path |
target.file.full_path |
타겟 파일의 전체 경로입니다. |
hostname |
target.hostname |
타겟의 호스트 이름입니다. |
http_content_type |
additional.fields.value.string_value |
'http_content_type' 필드의 값입니다. |
http_host |
principal.hostname |
주 구성원의 호스트 이름입니다. |
http_method |
network.http.method |
HTTP 메서드 |
http_referrer |
network.http.referral_url |
HTTP 리퍼러 URL입니다. |
http_user_agent |
network.http.user_agent |
HTTP 사용자 에이전트입니다. |
ID |
metadata.id |
이벤트 ID입니다. |
insertId |
metadata.product_log_id |
제품 로그 ID입니다. |
ip |
principal.ip |
주체의 IP 주소입니다. |
jsonPayload.cIP |
target.ip |
타겟의 IP 주소입니다. |
jsonPayload.cPort |
target.port |
타겟의 포트입니다. |
jsonPayload.csBytes |
network.sent_bytes |
클라이언트로 전송된 바이트입니다. |
jsonPayload.csMethod |
network.http.method |
HTTP 메서드 |
jsonPayload.csMimeType |
target.file.mime_type |
타겟 파일의 MIME 유형입니다. |
jsonPayload.csReferer |
network.http.referral_url |
HTTP 리퍼러 URL입니다. |
jsonPayload.csURL |
target.url |
타겟 URL입니다. |
jsonPayload.csUserAgent |
network.http.user_agent |
HTTP 사용자 에이전트입니다. |
jsonPayload.sHierarchy |
additional.fields.value.string_value |
'sHierarchy' 필드의 값입니다. |
jsonPayload.sHostname |
principal.hostname |
주 구성원의 호스트 이름입니다. |
jsonPayload.sIP |
principal.ip |
주체의 IP 주소입니다. |
jsonPayload.scBytes |
network.received_bytes |
클라이언트로부터 수신된 바이트입니다. |
jsonPayload.scHTTPStatus |
network.http.response_code |
HTTP 응답 코드입니다. |
jsonPayload.scResultCode |
additional.fields.value.string_value |
'scResultCode' 필드의 값입니다. |
LastStatus |
network.http.response_code |
HTTP 응답 코드입니다. |
log_level |
security_result.severity |
보안 결과의 심각도입니다. |
logName |
security_result.category_details |
보안 결과의 카테고리 세부정보입니다. |
method |
network.http.method |
HTTP 메서드 |
pid |
principal.process.pid |
주 구성원의 프로세스 ID입니다. |
Port |
target.port |
타겟의 포트입니다. |
proto |
network.application_protocol |
애플리케이션 프로토콜입니다. |
referer |
network.http.referral_url |
HTTP 리퍼러 URL입니다. |
RemoteHost |
principal.ip |
주체의 IP 주소입니다. |
RemoteUser |
principal.user.userid |
주체의 사용자 ID입니다. |
resource.labels.instance_id |
target.resource.product_object_id |
타겟 리소스의 제품 객체 ID입니다. |
resource.labels.project_id |
target.resource.attribute.labels.value |
'project_id' 라벨의 값입니다. |
resource.labels.zone |
target.resource.attribute.cloud.availability_zone |
타겟 리소스의 가용성 영역입니다. |
resource.type |
target.resource.resource_type |
타겟의 리소스 유형입니다. |
response |
network.http.response_code |
HTTP 응답 코드입니다. |
SizeBytes |
network.received_bytes |
클라이언트로부터 수신된 바이트입니다. |
src_ip |
principal.ip |
주체의 IP 주소입니다. |
src_port |
principal.port |
주 구성원의 포트입니다. |
ssl_cipher |
network.tls.cipher |
TLS 암호입니다. |
ssl_version |
network.tls.version_protocol |
TLS 버전 프로토콜입니다. |
status |
network.http.response_code |
HTTP 응답 코드입니다. |
target |
target.url |
타겟 URL입니다. |
target_ip |
target.ip |
타겟의 IP 주소입니다. |
target_port |
target.port |
타겟의 포트입니다. |
time |
metadata.event_timestamp |
이벤트 타임스탬프입니다. |
uri_path |
target.process.file.full_path |
타겟 파일의 전체 경로입니다. |
user |
principal.user.userid |
주체의 사용자 ID입니다. |
useragent |
network.http.user_agent |
HTTP 사용자 에이전트입니다. |
version_protocol |
network.tls.version_protocol |
TLS 버전 프로토콜입니다. |
Workername |
principal.hostname |
주 구성원의 호스트 이름입니다. |
x_forwarded_for |
'X-Forwarded-For' 헤더의 값입니다. | |
metadata.log_type |
값은 파서 코드에서 'APACHE'로 설정됩니다. | |
metadata.product_name |
값은 파서 코드에서 'Apache Web Server'로 설정됩니다. | |
metadata.vendor_name |
값은 파서 코드에서 'Apache'로 설정됩니다. | |
metadata.event_type |
값은 주 구성원 및 타겟 정보의 존재 여부에 따라 결정됩니다. 주 구성원과 대상이 모두 있는 경우 이벤트 유형은 'NETWORK_HTTP'로 설정됩니다. 주 구성원만 있는 경우 이벤트 유형이 'STATUS_UPDATE'로 설정됩니다. 그렇지 않으면 'GENERIC_EVENT'로 설정됩니다. | |
additional.fields.key |
키는 필드에 따라 파서 코드에서 'keep_alive', 'duration_microseconds', 'cookie', 'http_content_type', 'sHierarchy', 'scResultCode'로 설정됩니다. | |
target.port |
'proto' 필드가 'HTTP'인 경우 포트는 80으로 설정됩니다. 'proto' 필드가 'HTTPS'인 경우 포트는 443으로 설정됩니다. 'proto' 필드가 'FTP'인 경우 포트는 21로 설정됩니다. | |
target.resource.attribute.labels.key |
키는 파서 코드에서 'project_id'로 설정됩니다. |
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.