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에서 피드 만들기
- 설정 > 데이터 관리 > 피드로 이동합니다. SIEM 전용 플랫폼을 사용하는 경우 설정 > 피드로 이동합니다.
- 새 피드 추가를 클릭합니다.
- 다음 페이지에서 단일 피드 구성을 클릭합니다.
- 피드 이름 필드에 피드 이름을 입력합니다. 예를 들면
Guardicore Centra Logs입니다. - 소스 유형으로 웹훅을 선택합니다.
- 로그 유형으로 Guardicore Centra를 선택합니다.
- 다음을 클릭합니다.
- 다음 입력 파라미터의 값을 지정합니다.
- 분할 구분 기호:
\n를 입력하여 여러 줄 이벤트를 분할합니다(ULS는 줄바꿈으로 구분된 JSON을 전송함). - 애셋 네임스페이스: 애셋 네임스페이스입니다.
- 수집 라벨: 이 피드의 이벤트에 적용할 라벨입니다.
- 분할 구분 기호:
- 다음을 클릭합니다.
- 확정 화면에서 새 피드 구성을 검토한 다음 제출을 클릭합니다.
보안 비밀 키 생성 및 저장
피드를 만든 후 다음과 같이 인증을 위한 보안 비밀 키를 생성해야 합니다.
- 피드 세부정보 페이지에서 보안 비밀 키 생성을 클릭합니다.
- 대화상자에 보안 비밀 키가 표시됩니다.
- 보안 비밀 키를 복사하여 안전하게 저장합니다.
피드 엔드포인트 URL 가져오기
- 피드의 세부정보 탭으로 이동합니다.
- 엔드포인트 정보 섹션에서 피드 엔드포인트 URL을 복사합니다.
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다음 단계를 위해 이 URL을 저장합니다.
완료를 클릭합니다.
Google Cloud API 키 만들기
Google SecOps에는 인증을 위한 API 키가 필요합니다. Google Cloud 콘솔에서 제한된 API 키를 만듭니다.
API 키 만들기
- Google Cloud 콘솔 사용자 인증 정보 페이지로 이동합니다.
- 프로젝트를 선택합니다. Google SecOps 인스턴스와 연결된 프로젝트입니다.
- 사용자 인증 정보 만들기 > API 키를 클릭합니다.
- API 키가 생성되어 대화상자에 표시됩니다.
- API 키 수정을 클릭하여 키를 제한합니다.
API 키 제한
- API 키 설정 페이지에서 다음을 수행합니다.
- 이름: 설명이 포함된 이름을 입력합니다(예:
Google SecOps Guardicore Webhook API Key).
- 이름: 설명이 포함된 이름을 입력합니다(예:
- API 제한사항에서 다음을 실행합니다.
- 키 제한을 선택합니다.
- API 선택 드롭다운에서 Chronicle API를 검색하고 선택합니다.
- 저장을 클릭합니다.
- 페이지 상단의 API 키 필드에서 API 키 값을 복사합니다.
- API 키를 안전하게 저장합니다.
Guardicore Centra 사용자 인증 정보 구성
Guardicore Centra에서 읽기 전용 API 사용자 만들기
ULS는 포털 사용자를 사용하여 Centra API에 인증합니다. 다음과 같이 관리자 계정을 사용하는 대신 읽기 전용 권한이 있는 전용 사용자를 만듭니다.
- Guardicore Centra 관리 콘솔에 로그인합니다.
- 관리 > 사용자로 이동합니다.
- Create User(사용자 만들기)를 클릭합니다.
- 다음 구성 세부정보를 제공합니다.
- 사용자 이름: 통합 사용자의 이름을 입력합니다(예:
secops-uls). - 비밀번호: 비밀번호를 입력합니다.
- 권한 스키마: 지원(읽기 전용 액세스)을 선택합니다.
- 사용자 이름: 통합 사용자의 이름을 입력합니다(예:
- 저장을 클릭합니다.
- 로그아웃한 후 신규 사용자로 로그인하고 필수 비밀번호 변경을 완료합니다.
- Centra 관리 콘솔의 호스트 이름(
https://제외)을 기록해 둡니다. ULS는 이를 API 호스트 이름으로 사용합니다.
Guardicore 인증을 위한 .edgerc 파일 만들기
Akamai ULS는 .edgerc 파일의 gc_hostname, gc_username, gc_password 키에서 Guardicore 사용자 인증 정보를 읽습니다.
ULS 서버에서 다음과 같이 홈 디렉터리에
.edgerc파일을 만듭니다.nano ~/.edgerc다음 구성을 추가합니다.
[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저장하고 파일을 닫습니다.
다음과 같이 적절한 권한을 설정합니다.
chmod 600 ~/.edgerc
Akamai ULS 설치
GitHub에서 ULS 설치
ULS 서버에서 다음과 같이 ULS 저장소를 클론합니다.
git clone https://github.com/akamai/uls.git cd ulsPython 종속 항목 설치
pip3 install -r requirements.txtGuardicore 로그 가져오기 도구 모듈(
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설치를 확인합니다.
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 에이전트의 네트워크 흐름 로그가 포함됩니다.
다음 명령어를 사용하여 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 보안 비밀 키
- 다음 값을 바꿉니다.
ULS가
NETLOG이벤트를 Google SecOps로 스트리밍하기 시작합니다.
Guardicore INCIDENT 피드에 대해 ULS 실행
INCIDENT 피드에는 Guardicore에서 감지한 보안 사고가 포함되어 있습니다.
다음 명령어를 사용하여 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 보안 비밀 키
- 다음 값을 바꿉니다.
ULS가
INCIDENT이벤트를 Google SecOps로 스트리밍하기 시작합니다.
Guardicore AGENT 피드에 대해 ULS 실행
AGENT 피드에는 에이전트 상태 및 상태 정보가 포함됩니다.
다음 명령어를 사용하여 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 보안 비밀 키
- 다음 값을 바꿉니다.
ULS가
AGENT이벤트를 Google SecOps로 스트리밍하기 시작합니다.
Guardicore SYSTEM 피드에 ULS 실행
SYSTEM 피드에는 시스템 알림 및 이벤트가 포함됩니다.
다음 명령어를 사용하여 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 보안 비밀 키
- 다음 값을 바꿉니다.
ULS가
SYSTEM이벤트를 Google SecOps로 스트리밍하기 시작합니다.
Guardicore AUDIT 피드에 대해 ULS 실행
AUDIT 피드에는 관리 작업의 감사 로그가 포함됩니다.
다음 명령어를 사용하여 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 보안 비밀 키
- 다음 값을 바꿉니다.
ULS가
AUDIT이벤트를 Google SecOps로 스트리밍하기 시작합니다.
ULS를 백그라운드 서비스로 실행
ULS가 계속 실행되도록 하려면 systemd 서비스로 구성합니다.
NETLOG 피드의 systemd 서비스 파일 만들기
서비스 파일을 만듭니다.
sudo nano /etc/systemd/system/uls-guardicore-netlog.service다음 콘텐츠를 추가합니다.
[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 보안 비밀 키
- 다음 값을 바꿉니다.
저장하고 파일을 닫습니다.
서비스를 사용 설정하고 시작합니다.
sudo systemctl daemon-reload sudo systemctl enable uls-guardicore-netlog.service sudo systemctl start uls-guardicore-netlog.service서비스 상태를 확인합니다.
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 매개변수와 서비스 이름을 적절하게 변경합니다.
로그 수집 확인
- 로그가 수집되고 처리될 때까지 5~10분 정도 기다립니다.
- Google SecOps 콘솔에서 검색으로 이동합니다.
다음 UDM 검색어를 실행합니다.
metadata.vendor_name = "Guardicore"로그가 성공적으로 수집되면 검색 결과에 Guardicore 이벤트가 표시됩니다.
특정 피드 유형을 검색할 수도 있습니다.
metadata.vendor_name = "Guardicore" AND metadata.product_name = "Centra"
문제 해결
ULS 연결 오류
ULS가 Guardicore에 연결되지 않으면 다음을 수행합니다.
.edgerc파일에 올바른 호스트 이름과 사용자 인증 정보가 포함되어 있는지 확인합니다.다음과 같이 Guardicore 인스턴스에 대한 연결을 테스트합니다.
curl -u "username:password" https://your-instance.cloud.guardicore.com/api/v3.0/visibilityULS 서버에서 Guardicore 인스턴스에 액세스할 수 있는지 확인합니다.
ULS HTTP 출력 오류
ULS에서 Google SecOps로 로그를 전송하지 못하면 다음을 수행합니다.
- API 및 보안 비밀 키가 올바른지 확인합니다.
- Google SecOps 엔드포인트 URL이 리전에 맞게 올바른지 확인합니다.
ULS 서버에서 아웃바운드 HTTPS 연결을 확인합니다.
curl -I https://malachiteingestion-pa.googleapis.comULS 로그에서 오류 메시지를 검토합니다.
sudo journalctl -u uls-guardicore-netlog.service -f
플랫폼에 로그가 표시되지 않음
Google SecOps에 로그가 표시되지 않으면 다음을 수행합니다.
- 설정 > 데이터 관리 > 피드에서 웹훅 피드가 활성 상태인지 확인합니다.
- 피드의 상태 탭에서 처리 오류를 확인합니다.
- 피드 구성에서 분할 구분 기호가
\n로 설정되어 있는지 확인합니다. - 로그 유형이 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 전문가에게 문의하여 답변을 받으세요.