NGINX 로그 수집

이 NGINX 파서는 JSON 및 syslog 형식의 로그를 처리합니다. 다양한 로그 형식에서 필드를 추출하고 UDM 형식으로 정규화합니다. 파서는 사용자 로그인 및 HTTP 요청을 비롯한 서버 관리 및 네트워크 활동에 관한 메타데이터로 이벤트를 보강합니다. 또한 SSH 이벤트의 로직을 처리하고 추출된 데이터를 기반으로 UDM 필드를 채웁니다.

시작하기 전에

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

• Google SecOps 인스턴스
• NGINX가 실행 중이고 로그를 생성함
• NGINX 호스트 머신에 대한 루트 액세스 권한

Google SecOps 처리 인증 파일 가져오기

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

Google SecOps 고객 ID 가져오기

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

Bindplane 에이전트 설치

Windows 설치

1. 관리자 권한으로 명령 프롬프트 또는 PowerShell을 엽니다.

2. 다음 명령어를 실행합니다.

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

Linux 설치

1. 루트 또는 sudo 권한으로 터미널을 엽니다.

2. 다음 명령어를 실행합니다.

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

추가 설치 리소스

• 추가 설치 옵션은 이 설치 가이드를 참고하세요.

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

1. 구성 파일에 액세스합니다.

   1. config.yaml 파일을 찾습니다. 일반적으로 Linux의 /etc/bindplane-agent/ 디렉터리 또는 Windows의 설치 디렉터리에 있습니다.
   2. 텍스트 편집기 (예: nano, vi, 메모장)를 사용하여 파일을 엽니다.

2. 다음과 같이 config.yaml 파일을 수정합니다.

   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: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           ingestion_labels:
               log_type: 'NGINX'
               raw_log_field: body
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

3. 인프라에서 필요에 따라 포트와 IP 주소를 바꿉니다.

4. <customer_id>를 실제 고객 ID로 바꿉니다.

5. Google SecOps 처리 인증 파일 가져오기 섹션에서 인증 파일이 저장된 경로로 /path/to/ingestion-authentication-file.json를 업데이트합니다.

Bindplane 에이전트를 다시 시작하여 변경사항 적용

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

  sudo systemctl restart bindplane-agent
  

• Windows에서 Bindplane 에이전트를 다시 시작하려면 서비스 콘솔을 사용하거나 다음 명령어를 입력하면 됩니다.

  net stop BindPlaneAgent && net start BindPlaneAgent
  

NGINX 로그 파일 위치 식별

1. 일반적으로 NGINX 로그는 다음 위치에 저장됩니다.
   • 액세스 로그: /var/log/nginx/access.log
   • 오류 로그: /var/log/nginx/error.log
2. 관리자 사용자 인증 정보를 사용하여 NGINX 호스트에 액세스합니다.

3. 다음 명령어를 실행하고 NGINX 호스트에서 로그의 경로를 찾습니다.

   sudo cat /etc/nginx/nginx.conf | grep log
   

로그를 Bindplane로 전달하도록 NGINX 구성

1. NGINX 구성 파일 (예: /etc/nginx/nginx.conf)을 엽니다.

   sudo vi /etc/nginx/nginx.conf
   

2. 구성을 수정하여 <BINDPLANE_SERVER> 및 <BINDPLANE_PORT>를 값으로 바꿉니다.

   http {
       access_log syslog:server=<BINDPLANE_SERVER>:<BINDPLANE_PORT>,facility=local7,tag=nginx_access;
       error_log syslog:server=<BINDPLANE_SERVER>:<BINDPLANE_PORT>,facility=local7,tag=nginx_error;
   }
   

3. NGINX를 다시 시작하여 변경사항을 적용합니다.

   sudo systemctl reload nginx
   

UDM 매핑 표

변경사항

2022-09-10

• 기본 파서를 만들고 고객별 파서를 삭제했습니다.
• 최초 파서 출시

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