MongoDB 로그 수집

다음에서 지원:

이 문서에서는 Bindplane을 사용하여 MongoDB 로그를 Google Security Operations로 수집하는 방법을 설명합니다.

MongoDB는 CRUD 작업, 인증 이벤트, 데이터베이스 명령어, 복제본 세트 작업의 감사 로그를 생성하는 NoSQL 문서 데이터베이스입니다. MongoDB는 구조화된 JSON 로그 파일을 로컬로 작성하며, Bindplane 에이전트는 파일 시스템에서 직접 수집할 수 있습니다.

시작하기 전에

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

  • Google SecOps 인스턴스
  • Windows Server 2016 이상 또는 systemd가 설치된 Linux 호스트
  • Bindplane 에이전트와 MongoDB 서버 간의 네트워크 연결
  • 프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
  • MongoDB 서버에 대한 권한 있는 액세스 (루트 또는 데이터베이스 관리자 역할)
  • 감사 로깅이 사용 설정된 MongoDB Enterprise 또는 MongoDB Community Edition

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

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 수집 에이전트로 이동합니다.
  3. 데이터 수집 인증 파일을 다운로드합니다. 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
    

서비스가 RUNNING으로 표시됩니다.

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 에이전트 설치 가이드를 참고하세요.

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

구성 파일 찾기

  • Linux:

    sudo systemctl status observiq-otel-collector
    
  • Windows:

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

구성 파일 설정

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

    receivers:
        filelog:
            include:
                - /var/log/mongodb/auditLog.json
            start_at: beginning
    
    exporters:
        chronicle/mongodb:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: MONGO_DB
            raw_log_field: body
            ingestion_labels:
                env: production
    
    service:
        pipelines:
            logs/mongodb_to_chronicle:
                receivers:
                    - filelog
                exporters:
                    - chronicle/mongodb
    

구성 매개변수

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

  • 수신기 구성:

    • filelog: 디스크에서 로그 파일을 수집하는 수신기 유형
    • include: 모니터링할 파일 경로 목록:
      • Linux: /var/log/mongodb/auditLog.json (기본 MongoDB 감사 로그 경로)
      • Windows: C:\data\log\auditLog.json 또는 구성된 감사 로그 경로
    • start_at: 기존 로그를 읽으려면 beginning로 설정하고 새 항목만 읽으려면 end로 설정합니다.
  • 내보내기 도구 구성:

    • mongodb: 내보내기 도구의 설명 이름
    • creds_file_path: 데이터 수집 인증 파일의 전체 경로:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <customer_id>: 이전 단계의 고객 ID
    • endpoint: 지역 엔드포인트 URL:
      • 미국: malachiteingestion-pa.googleapis.com
      • 유럽: europe-malachiteingestion-pa.googleapis.com
      • 아시아: asia-southeast1-malachiteingestion-pa.googleapis.com
      • 전체 목록은 리전 엔드포인트를 참고하세요.
    • MONGO_DB: Chronicle에 표시되는 로그 유형
    • ingestion_labels: YAML 형식의 선택적 라벨 (예: env: production)
  • 파이프라인 구성:

    • mongodb_to_chronicle: 파이프라인을 설명하는 이름입니다.

구성 파일 저장

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

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

Linux에서 Bindplane 에이전트를 다시 시작하려면 다음을 실행하세요.

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

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

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

    sudo journalctl -u observiq-otel-collector -f
    

Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 안내를 따르세요.

  1. 다음 옵션 중 하나를 선택합니다.

    • 관리자 권한으로 명령 프롬프트 또는 PowerShell을 실행합니다.
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • 서비스 콘솔:
      1. Win+R를 누르고 services.msc를 입력한 다음 Enter 키를 누릅니다.
      2. observIQ OpenTelemetry Collector를 찾습니다.
      3. 마우스 오른쪽 버튼을 클릭하고 다시 시작을 선택합니다.
  2. 서비스가 실행 중인지 확인합니다.

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

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

감사 로그를 생성하도록 MongoDB 구성

  1. 관리자 또는 루트 권한으로 MongoDB 서버에 로그인합니다.
  2. MongoDB 구성 파일 (mongod.conf)을 엽니다. 기본 위치는 다음과 같습니다.
    • Linux: /etc/mongod.conf
    • Windows: C:\Program Files\MongoDB\Server\<version>\bin\mongod.cfg
  3. 감사 로깅이 사용 설정되어 있는지 확인합니다. mongod.conf 파일에서 다음 설정을 확인합니다.

    • auditLog.destination가 file로 설정되어 있습니다.
    • auditLog.format가 JSON로 설정되어 있습니다.
    • auditLog.path (예: /var/log/mongodb/auditLog.json)를 확인합니다.

    • 감사 로깅이 사용 설정되어 있지 않으면 mongod.conf에 다음을 추가합니다.

      auditLog:
        destination: file
        format: JSON
        path: /var/log/mongodb/auditLog.json
      
  4. MongoDB 서비스를 다시 시작하여 구성을 적용합니다.

    • Linux:

      sudo systemctl restart mongod
      
    • Windows:

      net stop MongoDB && net start MongoDB
      
  5. 감사 로그 파일이 구성된 경로 (예: /var/log/mongodb/auditLog.json)에 기록되고 있는지 확인합니다.

  6. config.yaml의 Bindplane 에이전트 include 경로가 mongod.conf에 구성된 auditLog.path와 일치하는지 확인합니다.

UDM 매핑 테이블

로그 필드 UDM 매핑 로직
ctx, connectionId, connectionCount, attr.protocol, attr.storage.data.bytesRead, attr.storage.data.timeReadingMicros, attr.command.$readPreference.mode, attr.queryHash, param_old, cluster_node, param.indexName, temp_db_value additional.fields 조건에 따라 다양한 필드에서 병합됨
db_mechanism, param.mechanism extensions.auth.auth_details 비어 있지 않으면 db_mechanism의 값, 그렇지 않으면 param.mechanism
extensions.auth.mechanism 'MECHANISM_OTHER'로 설정
extensions.auth.type 'AUTHTYPE_UNSPECIFIED'로 설정
lb_hostname, src_hostname intermediary.hostname 비어 있지 않으면 lb_hostname의 값, 비어 있으면 src_hostname
lb_port, src_port intermediary.port 비어 있지 않은 경우 lb_port의 값, 그렇지 않으면 src_port (정수로 변환됨)
msg metadata.description 값이 직접 복사됨
metadata.event_type msg_atype, category, param_passwordChanged, param_command, remote_ip 조건을 기반으로 설정
msg_atype, category metadata.product_event_type 비어 있지 않은 경우 msg_atype의 값, 비어 있는 경우 카테고리
id, type, traceId metadata.product_log_id 비어 있지 않으면 ID의 값, 비어 있으면 유형이 '04'인 경우 uuid.$binary, 그렇지 않으면 traceId
metadata.product_name 'MongoDB Enterprise'로 설정
metadata.vendor_name 'MongoDB'로 설정
application_name principal.application 값이 직접 복사됨
accessLog.hostname principal.asset.hostname 값이 직접 복사됨
remote_ip principal.asset.ip 값이 직접 복사됨
software_label principal.asset.software software_label에서 병합됨
accessLog.hostname principal.hostname 값이 직접 복사됨
remote_ip principal.ip 값이 직접 복사됨
os_type principal.platform Windows와 일치하는 경우 WINDOWS로 설정, osx 또는 mac과 일치하는 경우 MAC으로 설정, Linux와 일치하는 경우 LINUX로 설정
os_name, param.clientMetadata.os.name principal.platform_patch_level 비어 있지 않으면 os_name의 값, 비어 있으면 param.clientMetadata.os.name
os_version, param.clientMetadata.os.version principal.platform_version 비어 있지 않은 경우 os_version의 값, 그렇지 않은 경우 param.clientMetadata.os.version
remote_port principal.port 정수로 변환됨
principal_userid principal.user.userid 값이 직접 복사됨
sr_action security_result.action 값이 직접 복사됨
param.reason, param.indexBuildState security_result.description msg_atype == 'logout'인 경우 param.reason의 값, msg_atype이 ['createIndex', 'dropIndex']인 경우 param.indexBuildState의 값
심각도, 수준 security_result.severity 심각도가 ['i', 'I'] 이거나 수준이 ['INFO', 'DEBUG']인 경우 INFORMATIONAL로 설정됩니다. 심각도가 ['e', 'E'] 이거나 수준이 'ERROR'인 경우 ERROR로 설정됩니다. 심각도가 ['w', 'W', 'f', 'F']인 경우 MEDIUM으로 설정됩니다.
msg_result, attr.error, attr.planSummary, reason, attr.msg_data security_result.summary msg_result, attr.error, attr.planSummary, reason, attr.msg_data 조건에 따라 설정
db_value target.administrative_domain 값이 직접 복사됨
application_name target.application 값이 직접 복사됨
local_ip target.asset.ip 값이 직접 복사됨
host_group target.group.group_display_name 값이 직접 복사됨
local_ip target.ip 값이 직접 복사됨
local_port target.port 정수로 변환됨
old_name_label, cluster_node_label, mode_label, query_hash_label, bytes_read_label, time_reading_micro_label, environment_label, area_label target.resource.attribute.labels 다양한 라벨 필드에서 병합됨
param_ns, db_value, param_new, param.args.find target.resource.name msg_atype 및 param_command 조건에 따라 설정
target.resource.resource_subtype 데이터베이스/사용자 이벤트의 경우 'MongoDB 데이터베이스', 컬렉션 이벤트의 경우 'MongoDB 컬렉션', 색인 이벤트의 경우 'MongoDB 색인'으로 설정됩니다.
target.resource.resource_type 데이터베이스/사용자 이벤트의 경우 'DATABASE', 컬렉션/색인 이벤트의 경우 'TABLE'로 설정됩니다.
db_user, param.user target.user.userid 비어 있지 않으면 db_user의 값, 비어 있으면 param.user
service.name event.idm.read_only_udm.target.application 변경 로그에서 매핑됨
host.name event.idm.read_only_udm.principal.hostname 변경 로그에서 매핑됨
host.name event.idm.read_only_udm.principal.asset.hostname 변경 로그에서 매핑됨
mongodb.group.id event.idm.read_only_udm.principal.group.product_object_id 변경 로그에서 매핑됨
mongodb.cluster.name event.idm.read_only_udm.target.resource.attribute.labels 변경 로그에서 매핑됨
mongodb.customer.cluster.name event.idm.read_only_udm.target.resource.attribute.labels 변경 로그에서 매핑됨
timestamp event.idm.read_only_udm.metadata.event_timestamp 변경 로그에서 매핑됨
ts.date event.idm.read_only_udm.metadata.event_timestamp 변경 로그에서 매핑됨
uuid.binary event.idm.read_only_udm.metadata.product_log_id 변경 로그에서 매핑됨
users.1.user event.idm.read_only_udm.principal.user.userid 변경 로그에서 매핑됨
remote.ip event.idm.read_only_udm.principal.ip 및 event.idm.read_only_udm.principal.asset.ip 변경 로그에서 매핑됨
remote.port event.idm.read_only_udm.principal.port 변경 로그에서 매핑됨
local.ip event.idm.read_only_udm.target.ip 및 event.idm.read_only_udm.target.asset.ip 변경 로그에서 매핑됨
local.port event.idm.read_only_udm.target.port 변경 로그에서 매핑됨
roles.role event.idm.read_only_udm.principal.user.attribute.roles 변경 로그에서 매핑됨
param.args.client.application.name event.idm.read_only_udm.principal.application 변경 로그에서 매핑됨
param.args.client.os.type event.idm.read_only_udm.principal.asset.platform_software.platform 변경 로그에서 매핑됨
param.args.client.os.version event.idm.read_only_udm.principal.platform_version 변경 로그에서 매핑됨
param.args.client.os.architecture event.idm.read_only_udm.principal.asset.hardware 변경 로그에서 매핑됨
atype event.idm.read_only_udm.metadata.product_event_type 변경 로그에서 매핑됨
param.command event.idm.read_only_udm.metadata.product_event_type 변경 로그에서 매핑됨
param.ns event.idm.read_only_udm.target.resource.name 변경 로그에서 매핑됨
result event.idm.read_only_udm.security_result.action 변경 로그에서 매핑됨
mongodb.log.type event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.db event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
uuid.type event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.clientOperationKey.type event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.clientOperationKey.binary event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.aggregate event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.mayBypassWriteBlocking event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.configTime.timestamp.t event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.topologyTime.timestamp.t event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.audit event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.cursor.batchSize.numberLong event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.includeQueryStatsMetrics event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.fromMongos event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.readConcern.provenance event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.readConcern.level event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.writeConcern.provenance event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.writeConcern.level event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.client.platform event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.client.driver.name event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.client.driver.version event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.client.os.name event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.clusterTime event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.lsid.id.type event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.lsid.uid.binary event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.users.1.db event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.client.mongos.version event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.writeConcern.w event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.writeConcern.wtimeout event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.lsid.uid.type event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.pipeline.1.match.managedClusterType event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.pipeline.2.group.n.sum.const event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.pipeline.2.group._id.const event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.client.mongos.client.port event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
param.args.audit.impersonatedRoles event.idm.read_only_udm.principal.user.attribute.roles 변경 로그에서 매핑됨
param.args.audit.impersonatedUser event.idm.read_only_udm.principal.user.attribute.labels 변경 로그에서 매핑됨
param.args.client.mongos.client event.idm.read_only_udm.principal.ip 및 event.idm.read_only_udm.principal.asset.ip 변경 로그에서 매핑됨
param.args.client.mongos.host event.idm.read_only_udm.intermediary.ip 변경 로그에서 매핑됨
param.args.client.mongos.host event.idm.read_only_udm.intermediary.port 변경 로그에서 매핑됨
accessLog.authResult additional.fields 변경 로그에서 매핑됨
accessLog.authSource additional.fields 변경 로그에서 매핑됨
accessLog.failureReason additional.fields 변경 로그에서 매핑됨
accessLog.groupId target.resource.product_object_id 변경 로그에서 매핑됨
accessLog.ipAddress intermediary.ip 변경 로그에서 매핑됨
accessLog.logLine.t.$date additional.fields 변경 로그에서 매핑됨
accessLog.logLine.s additional.fields 변경 로그에서 매핑됨
accessLog.logLine.c additional.fields 변경 로그에서 매핑됨
accessLog.logLine.id additional.fields 변경 로그에서 매핑됨
accessLog.logLine.ctx additional.fields 변경 로그에서 매핑됨
accessLog.logLine.msg additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.client additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.isSpeculative additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.isClusterMember additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.mechanism additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.user additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.db additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.result additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.metrics.conversation_duration.micros additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.metrics.conversation_duration.summary.step additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.metrics.conversation_duration.summary.step_total additional.fields 변경 로그에서 매핑됨
accessLog.logLine.attr.metrics.conversation_duration.summary.duration_micros additional.fields 변경 로그에서 매핑됨
accessLog.username target.user.user_display_name 변경 로그에서 매핑됨
accessLog.timestamp additional.fields 변경 로그에서 매핑됨
roles.db principal.user.attribute.roles 변경 로그에서 매핑됨
roles.db target.user.attribute.roles 변경 로그에서 매핑됨

변경 로그

이 파서의 변경 로그 보기

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