Cloud Storage 컨텍스트 로그 수집
이 문서에서는 Cloud Storage를 사용하여 Cloud Storage 컨텍스트 로그를 내보내고 Google Security Operations로 처리하는 방법을 설명합니다. 파서는 Cloud Storage 로그에서 수신되는 JSON 데이터를 정리하고 구조화합니다. 그런 다음 관련 필드를 통합 데이터 모델 (UDM)에 매핑하여 보안 생태계 내에서 일관된 표현과 분석을 위해 라벨과 메타데이터로 데이터를 보강합니다.
시작하기 전에
- Google SecOps 인스턴스가 있는지 확인합니다.
- Cloud Storage가 환경에서 설정되고 활성 상태인지 확인합니다. Google Cloud
- Google Cloud 에 대한 액세스 권한과 적절한 권한이 있는지 확인합니다.
Cloud Storage 버킷 만들기
- Google Cloud 콘솔에 로그인합니다.
Cloud Storage 버킷 페이지로 이동합니다.
만들기를 클릭합니다.
버킷 만들기 페이지에서 버킷 정보를 입력합니다. 다음 단계를 완료할 때마다 계속을 클릭하여 다음 단계로 진행합니다.
시작하기 섹션에서 다음을 수행합니다.
- 버킷 이름 요구사항을 충족하는 고유한 이름을 입력합니다(예: google-storage-context-logs).
계층적 네임스페이스를 사용 설정하려면 펼치기 화살표를 클릭하여 파일 지향 및 데이터 집약적인 워크로드에 최적화 섹션을 펼친 다음 이 버킷에서 계층적 네임스페이스 사용 설정을 선택합니다.
버킷 라벨을 추가하려면 펼치기 화살표를 클릭하여 라벨 섹션을 펼칩니다.
라벨 추가를 클릭하고 라벨의 키와 값을 지정합니다.
데이터 저장 위치 선택 섹션에서 다음을 수행합니다.
- 위치 유형을 선택합니다.
위치 유형 메뉴를 사용하여 버킷 내 객체 데이터가 영구적으로 저장될 위치를 선택합니다.
버킷 간 복제를 설정하려면 버킷 간 복제 설정 섹션을 펼칩니다.
데이터의 스토리지 클래스 선택 섹션에서 버킷의 기본 스토리지 클래스를 선택하거나, 버킷 데이터의 자동 스토리지 클래스 관리에 자동 클래스를 선택합니다.
객체 액세스를 제어하는 방식 선택 섹션에서 아니요를 선택하여 공개 액세스 방지를 적용하고 버킷의 객체에 대한 액세스 제어 모델을 선택합니다.
객체 데이터 보호 방법 선택 섹션에서 다음을 수행합니다.
- 데이터 보호에서 버킷에 설정할 옵션을 선택합니다.
- 객체 데이터를 암호화하는 방법을 선택하려면 데이터 암호화라는 펼치기 화살표를 클릭하고 데이터 암호화 방법을 선택합니다.
만들기를 클릭합니다.
Cloud Storage 컨텍스트 로그 내보내기 구성
- Google Cloud 콘솔에 로그인합니다.
- 로깅 > 로그 라우터로 이동합니다.
- 싱크 만들기를 클릭합니다.
다음 구성 매개변수를 제공합니다.
- Sink Name(싱크 이름): 의미 있는 이름을 입력합니다(예:
Storage-Context-Sink
). - 싱크 대상: Cloud Storage 저장소를 선택하고 버킷의 URI(예:
gs://google-storage-context-logs
)를 입력합니다. 로그 필터:
logName="*storage*" resource.type="gcs_bucket"
- Sink Name(싱크 이름): 의미 있는 이름을 입력합니다(예:
만들기를 클릭합니다.
Cloud Storage 권한 구성
- IAM 및 관리자 > IAM으로 이동합니다.
- Cloud Logging 서비스 계정을 찾습니다.
- 버킷에 roles/storage.admin을 부여합니다.
Cloud Storage 컨텍스트 로그를 수집하도록 Google SecOps에서 피드 구성
- SIEM 설정 > 피드로 이동합니다.
- 새로 추가를 클릭합니다.
- 피드 이름 필드에 피드 이름을 입력합니다(예: Cloud Storage 컨텍스트 로그).
- 소스 유형으로 Google Cloud Storage를 선택합니다.
- 로그 유형으로 GCP Google Cloud Storage 컨텍스트를 선택합니다.
- Chronicle 서비스 계정 필드 옆에 있는 서비스 계정 가져오기를 클릭합니다.
- 다음을 클릭합니다.
다음 입력 매개변수의 값을 지정합니다.
- 스토리지 버킷 URI: Cloud Storage 버킷 URL입니다(예:
gs://google-storage-context-logs
). - URI Is A: 하위 디렉터리가 포함된 디렉터리를 선택합니다.
소스 삭제 옵션: 원하는 삭제 옵션을 선택합니다.
애셋 네임스페이스: 애셋 네임스페이스입니다.
수집 라벨: 이 피드의 이벤트에 적용된 라벨입니다.
- 스토리지 버킷 URI: Cloud Storage 버킷 URL입니다(예:
다음을 클릭합니다.
확정 화면에서 새 피드 구성을 검토한 다음 제출을 클릭합니다.
UDM 매핑 표
로그 필드 | UDM 매핑 | 논리 |
---|---|---|
상위 항목 | event.idm.entity.entity.resource.attribute.labels.value | 조상 값은 원시 로그의 조상 배열에서 추출됩니다. |
assetType | event.idm.entity.entity.resource.type | 원시 로그의 assetType 필드에서 직접 매핑됩니다. |
insertId | event.idm.entity.metadata.product_entity_id | 원시 로그의 insertId 필드에서 직접 매핑됩니다. |
labels.compute.googleapis.com/resource_name | event.idm.entity.entity.resource.name | 원시 로그의 labels.compute.googleapis.com/resource_name 필드에서 직접 매핑됩니다. |
labels.k8s-pod/controller-revision-hash | event.idm.entity.entity.file.sha1 | 원시 로그의 labels.k8s-pod/controller-revision-hash 필드에서 직접 매핑됩니다. |
labels.k8s-pod/name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 labels.k8s-pod/name 필드에서 직접 매핑됩니다. |
labels.k8s-pod/pod-template-generation | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 labels.k8s-pod/pod-template-generation 필드에서 직접 매핑됩니다. |
logName | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 logName 필드에서 직접 매핑됩니다. |
name | event.idm.entity.entity.resource.name | 원시 로그의 이름 필드에서 직접 매핑됩니다. |
receiveTimestamp | event.idm.entity.entity.resource.attribute.creation_time | 원시 로그의 receiveTimestamp 필드에서 타임스탬프 형식으로 변환되었습니다. |
resource.data.iamConfiguration.publicAccessPrevention | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.iamConfiguration.publicAccessPrevention 필드에서 직접 매핑됩니다. |
resource.data.id | event.idm.entity.entity.resource.product_object_id | 원시 로그의 resource.data.id 필드에서 직접 매핑됩니다. |
resource.data.kind | event.idm.entity.entity.resource.type | 원시 로그의 resource.data.kind 필드에서 직접 매핑됩니다. |
resource.data.labels.app_id | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.app_id 필드에서 직접 매핑됩니다. |
resource.data.labels.app_name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.app_name 필드에서 직접 매핑됩니다. |
resource.data.labels.bucket_id | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.bucket_id 필드에서 직접 매핑됩니다. |
resource.data.labels.data_classification | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.data_classification 필드에서 직접 매핑됩니다. |
resource.data.labels.dept_name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.dept_name 필드에서 직접 매핑됩니다. |
resource.data.labels.dept_no | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.dept_no 필드에서 직접 매핑됩니다. |
resource.data.labels.environment | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.environment 필드에서 직접 매핑됩니다. |
resource.data.labels.goog-composer-environment | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.goog-composer-environment 필드에서 직접 매핑됩니다. |
resource.data.labels.goog-composer-location | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.goog-composer-location 필드에서 직접 매핑됩니다. |
resource.data.labels.goog-composer-version | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.goog-composer-version 필드에서 직접 매핑됩니다. |
resource.data.labels.technical_contact | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.technical_contact 필드에서 직접 매핑됩니다. |
resource.data.labels.type | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.data.labels.type 필드에서 직접 매핑됩니다. |
resource.data.location | event.idm.entity.entity.location.name | 원시 로그의 resource.data.location 필드에서 직접 매핑됩니다. |
resource.data.projectNumber | event.idm.entity.entity.resource.attribute.cloud.project.id | 원시 로그의 resource.data.projectNumber 필드에서 직접 매핑됩니다. |
resource.data.selfLink | event.idm.entity.entity.url | 원시 로그의 resource.data.selfLink 필드에서 직접 매핑됩니다. |
resource.data.timeCreated | event.idm.entity.entity.resource.attribute.creation_time | 원시 로그의 resource.data.timeCreated 필드에서 타임스탬프 형식으로 변환되었습니다. |
resource.data.updated | event.idm.entity.entity.resource.attribute.last_update_time | 원시 로그의 resource.data.updated 필드에서 타임스탬프 형식으로 변환되었습니다. |
resource.discoveryDocumentUri | event.idm.entity.entity.file.full_path | 원시 로그의 resource.discoveryDocumentUri 필드에서 직접 매핑됩니다. |
resource.labels.cluster_name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.labels.cluster_name 필드에서 직접 매핑됩니다. |
resource.labels.container_name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.labels.container_name 필드에서 직접 매핑됩니다. |
resource.labels.location | event.idm.entity.entity.location.name | 원시 로그의 resource.labels.location 필드에서 직접 매핑됩니다. |
resource.labels.namespace_name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.labels.namespace_name 필드에서 직접 매핑됩니다. |
resource.labels.pod_name | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.labels.pod_name 필드에서 직접 매핑됩니다. |
resource.labels.project_id | event.idm.entity.entity.resource.attribute.cloud.project.id | 원시 로그의 resource.labels.project_id 필드에서 직접 매핑됩니다. |
resource.parent | event.idm.entity.entity.resource.parent | 원시 로그의 resource.parent 필드에서 직접 매핑됩니다. |
resource.type | event.idm.entity.entity.resource.type | 원시 로그의 resource.type 필드에서 직접 매핑됩니다. |
resource.version | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 resource.version 필드에서 직접 매핑됩니다. |
textPayload | event.idm.entity.entity.resource.attribute.labels.value | 원시 로그의 textPayload 필드에서 직접 매핑됩니다. |
해당 사항 없음 | event.idm.entity.metadata.collected_timestamp | 수집된 타임스탬프는 로그 항목 타임스탬프입니다. |
해당 사항 없음 | event.idm.entity.metadata.entity_type | RESOURCE 로 하드코딩되었습니다. |
해당 사항 없음 | event.idm.entity.metadata.product_name | GCP Storage Context 로 하드코딩되었습니다. |
해당 사항 없음 | event.idm.entity.metadata.vendor_name | Google Cloud Platform 로 하드코딩되었습니다. |
해당 사항 없음 | event.idm.entity.entity.resource.attribute.cloud.environment | GOOGLE_CLOUD_PLATFORM 로 하드코딩되었습니다. |
해당 사항 없음 | event.idm.entity.entity.resource.resource_type | STORAGE_BUCKET 로 하드코딩되었습니다. |
해당 사항 없음 | event.timestamp | 이벤트 타임스탬프는 로그 항목 타임스탬프입니다. |
변경사항
2024-05-28
개선사항:
- 파싱되지 않은 JSON 로그를 처리했습니다.
2023-04-13
개선사항:
resource.data.iamConfiguration.publicAccessPrevention
및resource.version
를entity.resource.attribute.label
에 매핑했습니다.resource.discoveryDocumentUri
를entity.file.full_path
에 매핑했습니다.
2022-12-07
버그 수정:
resource.data.timeCreated
의 매핑을event.timestamp
에서entity.resource.attribute.creation_time
로 수정했습니다.
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가의 답변을 받으세요.