Vercel WAF 로그 수집

다음에서 지원:

이 문서에서는 Google Cloud Storage V2를 사용하여 Vercel WAF 로그를 Google Security Operations로 수집하는 방법을 설명합니다.

Vercel WAF는 서버리스 애플리케이션을 보호하기 위해 Vercel 에지 네트워크에 통합된 웹 애플리케이션 방화벽입니다. 에지에서 수신 HTTP 요청을 검사하고 보안 규칙을 적용하여 악성 트래픽이 애플리케이션에 도달하기 전에 차단합니다. Vercel WAF 로그는 Vercel 플랫폼에서 내보내야 하므로 해당 로그를 Google Cloud Storage(GCS) 버킷에 업로드한 다음 Google SecOps 피드를 구성하여 수집해야 합니다.

시작하기 전에

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

  • Google SecOps 인스턴스
  • 결제가 사용 설정된 Google Cloud 프로젝트
  • WAF 로그에 액세스할 수 있는 Vercel 계정(Pro 또는 Enterprise 요금제)
  • WAF 로그를 내보내도록 구성된 Vercel API 토큰 또는 로그 드레인

Google Cloud Storage 버킷 만들기

  1. Google Cloud 콘솔로 이동하세요.
  2. 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
  3. 탐색 메뉴에서 Cloud Storage > 버킷으로 이동합니다.
  4. 버킷 만들기를 클릭합니다.
  5. 다음 구성 세부정보를 제공합니다.

    설정 값
    버킷 이름 지정 전역적으로 고유한 이름(예: vercel-waf-logs)을 입력합니다.
    위치 유형 필요에 따라 선택(리전, 이중 리전, 멀티 리전)
    위치 Google SecOps 인스턴스에 가장 가까운 위치를 선택합니다(예: us-central1).
    스토리지 클래스 표준(자주 액세스하는 로그에 권장)
    액세스 제어 균일(권장)
    보호 도구 선택사항: 객체 버전 관리 또는 보관 정책 사용 설정
  6. 만들기를 클릭합니다.

GCS로 Vercel WAF 로그 내보내기

Vercel은 로그 드레인 및 Vercel REST API를 통해 WAF 로그를 제공합니다. 로그 내보내기를 구성한 다음 GCS에 업로드합니다.

Vercel 로그 드레인은 로그를 외부 엔드포인트로 실시간 스트리밍합니다.

  1. Vercel 대시보드에 로그인합니다.
  2. 팀 설정(설정 > 로그 드레이닝)으로 이동합니다.
  3. 로그 드레인 추가를 클릭합니다.
  4. 로그 드레이닝을 구성합니다.
    • 전송 형식: JSON을 선택합니다.
    • 소스: WAF 이벤트를 포함하려면 방화벽을 선택합니다.
    • 환경: 모니터링할 환경(프로덕션, 프리뷰, 개발)을 선택합니다.
    • 엔드포인트: 중간 수신자의 URL을 입력합니다(예: GCS에 쓰는 Cloud Run Functions 엔드포인트).
  5. 로그 드레인 추가를 클릭합니다.
  6. 로그가 엔드포인트로 전송되는지 확인합니다.

옵션 B: Vercel REST API를 통해 내보내기

  1. 설정 > 토큰에서 Vercel API 토큰을 생성합니다.
  2. Vercel REST API를 사용하여 방화벽 이벤트를 검색합니다.

    curl -H "Authorization: Bearer YOUR_VERCEL_TOKEN" \
      "https://api.vercel.com/v1/security/firewall/events?teamId=YOUR_TEAM_ID&projectId=YOUR_PROJECT_ID&limit=100" \
      -o vercel-waf-events.json
    

Google SecOps 서비스 계정 가져오기

  1. 설정 > 데이터 관리 > 피드로 이동합니다. SIEM 전용 플랫폼을 사용하는 경우 설정 > 피드로 이동합니다.
  2. 새 피드 추가를 클릭합니다.
  3. 단일 피드 구성을 클릭합니다.
  4. 피드 이름 필드에 피드 이름을 입력합니다(예: Vercel WAF Logs).
  5. 소스 유형으로 Google Cloud Storage V2를 선택합니다.
  6. 로그 유형으로 Vercel WAF를 선택합니다.
  7. 서비스 계정 가져오기를 클릭합니다. 고유한 서비스 계정 이메일이 표시됩니다. 예를 들면 다음과 같습니다.

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. 다음 단계에서 사용할 수 있도록 이 이메일 주소를 복사합니다.

Google SecOps 서비스 계정에 IAM 권한 부여

Google SecOps 서비스 계정에는 GCS 버킷에 대한 스토리지 객체 뷰어 역할이 필요합니다.

  1. Cloud Storage > 버킷으로 이동합니다.
  2. 버킷 이름(예: vercel-waf-logs)을 클릭합니다.
  3. 권한 탭으로 이동합니다.
  4. 액세스 권한 부여를 클릭합니다.
  5. 다음 구성 세부정보를 제공합니다.
    • 주 구성원 추가: Google SecOps 서비스 계정 이메일(예: chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com)을 붙여넣습니다.
    • 역할 할당: 스토리지 객체 뷰어를 선택합니다.
  6. 저장을 클릭합니다.

Google SecOps 피드 구성

  1. 설정 > 데이터 관리 > 피드로 이동합니다. SIEM 전용 플랫폼을 사용하는 경우 설정 > 피드로 이동합니다.
  2. 새 피드 추가를 클릭합니다.
  3. 단일 피드 구성을 클릭합니다.
  4. 피드 이름 필드에 피드 이름을 입력합니다(예: Vercel WAF Logs).
  5. 소스 유형으로 Google Cloud Storage V2를 선택합니다.
  6. 로그 유형으로 Vercel WAF를 선택합니다.
  7. 다음을 클릭합니다.
  8. 다음 입력 파라미터의 값을 지정합니다.

    • 스토리지 버킷 URL: GCS 버킷 URI를 입력합니다.

      gs://vercel-waf-logs/vercel-waf/
      
      • vercel-waf-logs을 GCS 버킷 이름으로 바꿉니다.
      • vercel-waf를 구성된 프리픽스 경로로 바꿉니다.
    • 소스 삭제 옵션: 환경설정에 따라 삭제 옵션을 선택합니다.

      • 삭제 안함: 전송 후 파일을 삭제하지 않습니다(테스트에 권장).
      • 전송된 파일 및 빈 디렉터리 삭제: 전송이 완료된 후 파일과 빈 디렉터리를 삭제합니다.

    • 최대 파일 기간: 지난 며칠 동안 수정된 파일을 포함합니다 (기본값은 180일).

    • 애셋 네임스페이스: 애셋 네임스페이스입니다.

    • 수집 라벨: 이 피드의 이벤트에 적용할 라벨입니다.

  9. 다음을 클릭합니다.

  10. 확정 화면에서 새 피드 구성을 검토한 다음 제출을 클릭합니다.

UDM 매핑 테이블

로그 필드 UDM 매핑 로직
record.requestId, record.proxy.timestamp, record.proxy.region, record.proxy.errorCode, record.proxy.vercelCache, record.proxy.pathType, record.proxy.referer, record.proxy.cacheId, record.proxy.wafAction, record.proxy.scheme, record.proxy.userAgent, record.environment additional.fields 추가 이벤트 메타데이터
metadata.event_type 이벤트 유형
record.deploymentId metadata.product_deployment_id 제품별 배포 ID
record.id metadata.product_log_id 제품별 로그 ID
record.proxy.method network.http.method HTTP 메서드
record.statusCode network.http.response_code HTTP 응답 코드
record.source principal.asset.hostname 주 구성원과 연결된 애셋의 호스트 이름
record.host principal.hostname 주 구성원의 호스트 이름
record.message security_result.description 보안 결과에 대한 설명
record.proxy.wafRule security_result.rule_name 보안 결과를 트리거한 규칙의 이름
record.level security_result.severity 보안 결과의 심각도
record.proxy.wafRule security_result.threat_name 위협 이름
record.proxy.clientIp target.asset.ip 애셋의 IP 주소
record.projectId target.cloud.project.id 클라우드 프로젝트 ID
record.projectName target.cloud.project.name 클라우드 프로젝트 이름
record.proxy.path target.file.full_path 파일의 전체 경로
record.proxy.clientIp target.ip 타겟의 IP 주소
record.executionRegion target.location.name 위치 이름
record.proxy.vercelId target.user.userid 대상 사용자의 사용자 ID
metadata.product_name 제품 이름
metadata.vendor_name 공급업체 이름

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