Akamai Guardicore Segmentation(이전 명칭: Guardicore Centra) 로그 수집

다음에서 지원:

이 문서에서는 HTTP 출력이 있는 Akamai Unified Log Streamer(ULS)를 사용하여 Google Security Operations에 로그를 푸시하도록 Akamai Guardicore Segmentation(이전의 Guardicore Centra)을 구성하는 방법을 설명합니다.

Guardicore Centra는 데이터 센터, 클라우드 환경, 엔드포인트에 제로 트러스트 네트워크 보안을 제공하는 마이크로 세분화 플랫폼입니다. 애플리케이션 종속 항목에 대한 가시성, 디셉션 기술을 통한 침해 탐지, 측면 이동을 방지하고 위협을 억제하는 세분화된 세분화 제어 기능을 제공합니다.

시작하기 전에

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

  • Google SecOps 인스턴스
  • Guardicore Centra 인스턴스(클라우드 또는 온프레미스)
  • Akamai ULS를 실행할 Linux 서버(최소: vCPU 1개, RAM 1GB, 디스크 500MB)
  • ULS 서버에 Python 3.9 이상 설치
  • 읽기 전용 API 사용자를 만들기 위한 Guardicore Centra에 대한 관리자 액세스 권한
  • ULS 서버에서 Google SecOps 수집 엔드포인트로의 아웃바운드 HTTPS 액세스
  • Google Cloud 콘솔에 액세스(API 키 생성용)

Google SecOps에서 피드 만들기

  1. 설정 > 데이터 관리 > 피드로 이동합니다. SIEM 전용 플랫폼을 사용하는 경우 설정 > 피드로 이동합니다.
  2. 새 피드 추가를 클릭합니다.
  3. 다음 페이지에서 단일 피드 구성을 클릭합니다.
  4. 피드 이름 필드에 피드 이름을 입력합니다. 예를 들면 Guardicore Centra Logs입니다.
  5. 소스 유형으로 웹훅을 선택합니다.
  6. 로그 유형으로 Guardicore Centra를 선택합니다.
  7. 다음을 클릭합니다.
  8. 다음 입력 파라미터의 값을 지정합니다.
    • 분할 구분 기호: \n를 입력하여 여러 줄 이벤트를 분할합니다(ULS는 줄바꿈으로 구분된 JSON을 전송함).
    • 애셋 네임스페이스: 애셋 네임스페이스입니다.
    • 수집 라벨: 이 피드의 이벤트에 적용할 라벨입니다.
  9. 다음을 클릭합니다.
  10. 확정 화면에서 새 피드 구성을 검토한 다음 제출을 클릭합니다.

보안 비밀 키 생성 및 저장

피드를 만든 후 다음과 같이 인증을 위한 보안 비밀 키를 생성해야 합니다.

  1. 피드 세부정보 페이지에서 보안 비밀 키 생성을 클릭합니다.
  2. 대화상자에 보안 비밀 키가 표시됩니다.
  3. 보안 비밀 키를 복사하여 안전하게 저장합니다.

피드 엔드포인트 URL 가져오기

  1. 피드의 세부정보 탭으로 이동합니다.
  2. 엔드포인트 정보 섹션에서 피드 엔드포인트 URL을 복사합니다.
  3. URL 형식은 다음 중 하나입니다.

    https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs
    

    또는

    https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs
    
  4. 다음 단계를 위해 이 URL을 저장합니다.

  5. 완료를 클릭합니다.

Google Cloud API 키 만들기

Google SecOps에는 인증을 위한 API 키가 필요합니다. Google Cloud 콘솔에서 제한된 API 키를 만듭니다.

API 키 만들기

  1. Google Cloud 콘솔 사용자 인증 정보 페이지로 이동합니다.
  2. 프로젝트를 선택합니다. Google SecOps 인스턴스와 연결된 프로젝트입니다.
  3. 사용자 인증 정보 만들기 > API 키를 클릭합니다.
  4. API 키가 생성되어 대화상자에 표시됩니다.
  5. API 키 수정을 클릭하여 키를 제한합니다.

API 키 제한

  1. API 키 설정 페이지에서 다음을 수행합니다.
    • 이름: 설명이 포함된 이름을 입력합니다(예: Google SecOps Guardicore Webhook API Key).
  2. API 제한사항에서 다음을 실행합니다.
    1. 키 제한을 선택합니다.
    2. API 선택 드롭다운에서 Chronicle API를 검색하고 선택합니다.
  3. 저장을 클릭합니다.
  4. 페이지 상단의 API 키 필드에서 API 키 값을 복사합니다.
  5. API 키를 안전하게 저장합니다.

Guardicore Centra 사용자 인증 정보 구성

Guardicore Centra에서 읽기 전용 API 사용자 만들기

ULS는 포털 사용자를 사용하여 Centra API에 인증합니다. 다음과 같이 관리자 계정을 사용하는 대신 읽기 전용 권한이 있는 전용 사용자를 만듭니다.

  1. Guardicore Centra 관리 콘솔에 로그인합니다.
  2. 관리 > 사용자로 이동합니다.
  3. Create User(사용자 만들기)를 클릭합니다.
  4. 다음 구성 세부정보를 제공합니다.
    • 사용자 이름: 통합 사용자의 이름을 입력합니다(예: secops-uls).
    • 비밀번호: 비밀번호를 입력합니다.
    • 권한 스키마: 지원(읽기 전용 액세스)을 선택합니다.
  5. 저장을 클릭합니다.
  6. 로그아웃한 후 신규 사용자로 로그인하고 필수 비밀번호 변경을 완료합니다.
  7. Centra 관리 콘솔의 호스트 이름(https:// 제외)을 기록해 둡니다. ULS는 이를 API 호스트 이름으로 사용합니다.

Guardicore 인증을 위한 .edgerc 파일 만들기

Akamai ULS는 .edgerc 파일의 gc_hostname, gc_username, gc_password 키에서 Guardicore 사용자 인증 정보를 읽습니다.

  1. ULS 서버에서 다음과 같이 홈 디렉터리에 .edgerc 파일을 만듭니다.

    nano ~/.edgerc
    
  2. 다음 구성을 추가합니다.

    [default]
    gc_hostname = your-instance.cloud.guardicore.com
    gc_username = your_username
    gc_password = your_password
    

    다음 값을 바꿉니다.

    • your-instance.cloud.guardicore.com - Guardicore Centra 관리 호스트 이름(https:// 제외)
    • your_username - 이전 섹션에서 만든 읽기 전용 API 사용자의 사용자 이름
    • your_password - 해당 사용자의 비밀번호

    예:

    [default]
    gc_hostname = cus-1234.cloud.guardicore.com
    gc_username = secops-uls
    gc_password = MySecurePassword123
    
  3. 저장하고 파일을 닫습니다.

  4. 다음과 같이 적절한 권한을 설정합니다.

    chmod 600 ~/.edgerc
    

Akamai ULS 설치

GitHub에서 ULS 설치

  1. ULS 서버에서 다음과 같이 ULS 저장소를 클론합니다.

    git clone https://github.com/akamai/uls.git
    cd uls
    
  2. Python 종속 항목 설치

    pip3 install -r requirements.txt
    
  3. Guardicore 로그 가져오기 도구 모듈(gc-logs)을 ULS 체크아웃의 ext 디렉터리에 설치합니다.

    git clone -q --depth 1 -b v0.0.8 --single-branch https://github.com/MikeSchiessl/gc-logs.git ext/cli-gc
    pip3 install -r ext/cli-gc/bin/requirements.txt
    
  4. 설치를 확인합니다.

    python3 bin/uls.py --help
    

Google SecOps에 로그를 전송하도록 ULS 구성

Google SecOps 웹훅 URL 구성

  • 다음과 같이 Google SecOps 엔드포인트 URL과 API 키를 결합합니다.

    <ENDPOINT_URL>?key=<API_KEY>
    
  • 예:

    https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=AIzaSyD...
    

Guardicore NETLOG 피드에 대해 ULS 실행

NETLOG 피드에는 Guardicore 에이전트의 네트워크 흐름 로그가 포함됩니다.

  1. 다음 명령어를 사용하여 ULS를 실행합니다.

    python3 bin/uls.py \
        --input gc \
        --feed NETLOG \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • 다음 값을 바꿉니다.
      • YOUR_API_KEY - 이전에 만든 Google Cloud API 키
      • YOUR_SECRET_KEY - 이전에 생성된 Google SecOps 보안 비밀 키
  2. ULS가 NETLOG 이벤트를 Google SecOps로 스트리밍하기 시작합니다.

Guardicore INCIDENT 피드에 대해 ULS 실행

INCIDENT 피드에는 Guardicore에서 감지한 보안 사고가 포함되어 있습니다.

  1. 다음 명령어를 사용하여 ULS를 실행합니다.

    python3 bin/uls.py \
        --input gc \
        --feed INCIDENT \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • 다음 값을 바꿉니다.
      • YOUR_API_KEY - 이전에 만든 Google Cloud API 키
      • YOUR_SECRET_KEY - 이전에 생성된 Google SecOps 보안 비밀 키
  2. ULS가 INCIDENT 이벤트를 Google SecOps로 스트리밍하기 시작합니다.

Guardicore AGENT 피드에 대해 ULS 실행

AGENT 피드에는 에이전트 상태 및 상태 정보가 포함됩니다.

  1. 다음 명령어를 사용하여 ULS를 실행합니다.

    python3 bin/uls.py \
        --input gc \
        --feed AGENT \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • 다음 값을 바꿉니다.
      • YOUR_API_KEY - 이전에 만든 Google Cloud API 키
      • YOUR_SECRET_KEY - 이전에 생성된 Google SecOps 보안 비밀 키
  2. ULS가 AGENT 이벤트를 Google SecOps로 스트리밍하기 시작합니다.

Guardicore SYSTEM 피드에 ULS 실행

SYSTEM 피드에는 시스템 알림 및 이벤트가 포함됩니다.

  1. 다음 명령어를 사용하여 ULS를 실행합니다.

    python3 bin/uls.py \
        --input gc \
        --feed SYSTEM \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • 다음 값을 바꿉니다.
      • YOUR_API_KEY - 이전에 만든 Google Cloud API 키
      • YOUR_SECRET_KEY - 이전에 생성된 Google SecOps 보안 비밀 키
  2. ULS가 SYSTEM 이벤트를 Google SecOps로 스트리밍하기 시작합니다.

Guardicore AUDIT 피드에 대해 ULS 실행

AUDIT 피드에는 관리 작업의 감사 로그가 포함됩니다.

  1. 다음 명령어를 사용하여 ULS를 실행합니다.

    python3 bin/uls.py \
        --input gc \
        --feed AUDIT \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s'
    
    • 다음 값을 바꿉니다.
      • YOUR_API_KEY - 이전에 만든 Google Cloud API 키
      • YOUR_SECRET_KEY - 이전에 생성된 Google SecOps 보안 비밀 키
  2. ULS가 AUDIT 이벤트를 Google SecOps로 스트리밍하기 시작합니다.

ULS를 백그라운드 서비스로 실행

ULS가 계속 실행되도록 하려면 systemd 서비스로 구성합니다.

NETLOG 피드의 systemd 서비스 파일 만들기

  1. 서비스 파일을 만듭니다.

    sudo nano /etc/systemd/system/uls-guardicore-netlog.service
    
  2. 다음 콘텐츠를 추가합니다.

    [Unit]
    Description=Akamai ULS - Guardicore NETLOG
    After=network.target
    
    [Service]
    Type=simple
    User=root
    WorkingDirectory=/root/uls
    ExecStart=/usr/bin/python3 /root/uls/bin/uls.py --input gc --feed NETLOG --output http --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' --httpformat '%%s'
    Restart=always
    RestartSec=10
    
    [Install]
    WantedBy=multi-user.target
    
    • 다음 값을 바꿉니다.
      • /root/uls - ULS 저장소를 클론한 경로
      • YOUR_API_KEY - Google Cloud API 키
      • YOUR_SECRET_KEY - Google SecOps 보안 비밀 키
  3. 저장하고 파일을 닫습니다.

  4. 서비스를 사용 설정하고 시작합니다.

    sudo systemctl daemon-reload
    sudo systemctl enable uls-guardicore-netlog.service
    sudo systemctl start uls-guardicore-netlog.service
    
  5. 서비스 상태를 확인합니다.

    sudo systemctl status uls-guardicore-netlog.service
    

다른 피드에 대한 추가 서비스 만들기

수집하려는 각 피드(INCIDENT, AGENT, SYSTEM, AUDIT)에 대해 이전 단계를 반복하여 다음과 같이 별도의 서비스 파일을 만듭니다.

  • /etc/systemd/system/uls-guardicore-incident.service
  • /etc/systemd/system/uls-guardicore-agent.service
  • /etc/systemd/system/uls-guardicore-system.service
  • /etc/systemd/system/uls-guardicore-audit.service

각 파일에서 --feed 매개변수와 서비스 이름을 적절하게 변경합니다.

로그 수집 확인

  1. 로그가 수집되고 처리될 때까지 5~10분 정도 기다립니다.
  2. Google SecOps 콘솔에서 검색으로 이동합니다.
  3. 다음 UDM 검색어를 실행합니다.

    metadata.vendor_name = "Guardicore"
    
  4. 로그가 성공적으로 수집되면 검색 결과에 Guardicore 이벤트가 표시됩니다.

  5. 특정 피드 유형을 검색할 수도 있습니다.

    metadata.vendor_name = "Guardicore" AND metadata.product_name = "Centra"
    

문제 해결

ULS 연결 오류

ULS가 Guardicore에 연결되지 않으면 다음을 수행합니다.

  1. .edgerc 파일에 올바른 호스트 이름과 사용자 인증 정보가 포함되어 있는지 확인합니다.
  2. 다음과 같이 Guardicore 인스턴스에 대한 연결을 테스트합니다.

    curl -u "username:password" https://your-instance.cloud.guardicore.com/api/v3.0/visibility
    
  3. ULS 서버에서 Guardicore 인스턴스에 액세스할 수 있는지 확인합니다.

ULS HTTP 출력 오류

ULS에서 Google SecOps로 로그를 전송하지 못하면 다음을 수행합니다.

  1. API 및 보안 비밀 키가 올바른지 확인합니다.
  2. Google SecOps 엔드포인트 URL이 리전에 맞게 올바른지 확인합니다.
  3. ULS 서버에서 아웃바운드 HTTPS 연결을 확인합니다.

    curl -I https://malachiteingestion-pa.googleapis.com
    
  4. ULS 로그에서 오류 메시지를 검토합니다.

    sudo journalctl -u uls-guardicore-netlog.service -f
    

플랫폼에 로그가 표시되지 않음

Google SecOps에 로그가 표시되지 않으면 다음을 수행합니다.

  1. 설정 > 데이터 관리 > 피드에서 웹훅 피드가 활성 상태인지 확인합니다.
  2. 피드의 상태 탭에서 처리 오류를 확인합니다.
  3. 피드 구성에서 분할 구분 기호가 \n로 설정되어 있는지 확인합니다.
  4. 로그 유형이 Guardicore Centra로 설정되어 있는지 확인합니다.

자체 서명 인증서 오류

Guardicore 인스턴스에서 자체 서명 인증서를 사용하는 경우 SSL 확인 오류로 인해 ULS가 실패할 수 있습니다. SSL 확인을 우회하려면(프로덕션에는 권장되지 않음) 다음을 수행합니다.

  • ULS 명령어에 --httpinsecure 플래그를 추가합니다.

    python3 bin/uls.py \
        --input gc \
        --feed NETLOG \
        --output http \
        --httpurl "https://<REGION>-chronicle.googleapis.com/v1alpha/projects/<PROJECT_NUMBER>/locations/<REGION>/instances/<INSTANCE_ID>/feeds/<FEED_ID>:importPushLogs?key=YOUR_API_KEY" \
        --httpauthheader '{"X-Webhook-Access-Key": "YOUR_SECRET_KEY"}' \
        --httpformat '%s' \
        --httpinsecure
    

사용 가능한 Guardicore 피드

Akamai ULS는 다음 Guardicore 피드를 지원합니다.

피드 이름 설명 ULS 피드 매개변수
NETLOG Guardicore 에이전트의 네트워크 흐름 로그 NETLOG
INCIDENT Guardicore에서 감지한 보안 사고 INCIDENT
AGENT 에이전트 상태 및 상태 정보 AGENT
SYSTEM 시스템 알림** 시스템 수준 알림 및 이벤트
AUDIT Logs 관리 작업 및 구성 변경 AUDIT

인증 방법 참조

Google SecOps 웹훅 피드는 여러 인증 방법을 지원합니다. Akamai ULS는 URL의 API 키와 헤더의 보안 비밀 키를 사용하는 하이브리드 메서드를 사용합니다.

ULS에서 사용하는 메서드: 하이브리드(URL + 헤더)

  • 요청 형식:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    X-Webhook-Access-Key: <SECRET_KEY>
    
    {"event": "data", "timestamp": "2025-01-15T10:30:00Z"}
    
  • ULS 명령어 형식:

    --httpurl "<ENDPOINT_URL>?key=<API_KEY>"
    --httpauthheader '{"X-Webhook-Access-Key": "<SECRET_KEY>"}'
    

인증 헤더 이름

Google SecOps는 인증을 위해 다음 헤더 이름을 허용합니다.

API 키:

  • X-goog-api-key(권장)
  • X-goog-api-key(대소문자를 구분하지 않음)

보안 비밀 키:

  • X-Webhook-Access-Key(권장)
  • X-Webhook-Access-Key(대소문자를 구분하지 않음)

웹훅 한도 및 권장사항

요청 한도

한도 값
최대 단일 로그 줄 1MB
최대 QPS(초당 쿼리 수) 15,000
요청 제한 시간 90초
재시도 동작 발신자가 관리합니다. 버스트 한도를 초과하면 Google SecOps에서 HTTP 429를 반환합니다. 전송 시스템은 버퍼링하고 다시 시도해야 합니다.

권장사항

  • 안정성과 문제 해결을 개선하기 위해 각 피드 유형에 대해 별도의 ULS 인스턴스를 실행합니다.
  • systemd를 사용하여 ULS 서비스 상태를 모니터링하고 서비스 실패에 대한 알림을 설정합니다.
  • Guardicore 사용자 인증 정보를 주기적으로 순환하고 .edgerc 파일을 업데이트합니다.
  • Guardicore에서 읽기 전용 API 액세스 권한이 있는 전용 서비스 계정을 사용합니다.
  • 디스크 공간 문제를 방지하기 위해 ULS 로그의 로그 순환을 구성합니다.
  • 부하 분산이 있는 여러 서버에서 ULS를 실행하여 장애 조치 시나리오를 테스트합니다.

UDM 매핑 테이블

다음 표에는 Guardicore Centra 로그의 로그 필드와 해당 UDM 필드가 나와 있습니다.

로그 필드 UDM 필드 설명
timestamp metadata.event_timestamp 이벤트 타임스탬프
source_ip principal.ip 소스 IP 주소
destination_ip target.ip 대상 IP 주소
source_port principal.port 소스 포트 번호
destination_port target.port 대상 포트 번호
protocol network.ip_protocol 네트워크 프로토콜
action security_result.action 취한 보안 조치
severity security_result.severity 이벤트 심각도
user principal.user.userid 사용자 이름
hostname principal.hostname 소스 호스트 이름
process_name principal.process.file.full_path 프로세스 이름
incident_id security_result.detection_fields.key 사고 식별자
description security_result.description 이벤트 설명

변경 로그

이 파서의 변경 로그 보기

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