JumpCloud Directory Insights 로그 수집
이 문서에서는 Cloud Storage V2를 사용하여 JumpCloud Directory Insights 로그를 Google Security Operations로 수집하는 방법을 설명합니다.
JumpCloud는 ID 관리, SSO, 기기 관리를 제공하는 클라우드 디렉터리 플랫폼입니다. Directory Insights는 사용자 인증, 관리자 작업, 시스템 이벤트를 다루는 감사 및 활동 로그를 제공합니다. 파서는 로그 필드를 통합 데이터 모델(UDM)에 매핑하여 사용자 로그인, 리소스 변경, 보안 작업과 같은 이벤트 유형을 처리합니다.
시작하기 전에
다음 기본 요건이 충족되었는지 확인합니다.
- Google SecOps 인스턴스
- Cloud Storage API가 사용 설정된 Google Cloud 프로젝트
- Cloud Storage 버킷 및 Identity and Access Management(IAM) 정책을 만들고 관리할 수 있는 권한
- 관리자 또는 매니저 역할과 유효한 API 키가 있는 JumpCloud 계정
Cloud Storage 버킷 만들기
- Google Cloud 콘솔로 이동합니다.
- 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
- 탐색 메뉴에서 Cloud Storage > 버킷으로 이동합니다.
- 버킷 만들기를 클릭합니다.
다음 구성 세부정보를 제공합니다.
설정 값 버킷 이름 지정 전역적으로 고유한 이름(예: jumpcloud-directory-insights-logs)을 입력합니다.위치 유형 필요에 따라 선택(리전, 이중 리전, 멀티 리전) 위치 위치를 선택합니다(예: us-central1).스토리지 클래스 표준(자주 액세스하는 로그에 권장) 액세스 제어 균일(권장) 보호 도구 선택사항: 객체 버전 관리 또는 보관 정책 사용 설정 만들기를 클릭합니다.
Cloud Storage로 JumpCloud Directory Insights 로그 내보내기
JumpCloud Directory Insights는 Directory Insights API를 통해 이벤트를 노출합니다. 예약된 스크립트 또는 Cloud Run 함수를 사용하여 이벤트를 가져와 Cloud Storage에 기록합니다.
JumpCloud API 키를 생성합니다.
- JumpCloud 관리 포털에 로그인합니다.
- 프로필 아이콘으로 이동하여 내 API 키를 선택합니다.
- API 키를 복사합니다.
JumpCloud Directory Insights API를 쿼리하고 이벤트를 검색하여 Cloud Storage에 쓰는 Cloud Run 함수를 만듭니다.
Cloud Scheduler 및 Pub/Sub를 사용하여 일정에 따라 함수를 트리거합니다.
- 내보낸 파일이 원래 JSON 형식을 유지하는지 확인합니다.
- 각 파일에는 하나 이상의 이벤트 레코드가 포함되어야 합니다.
Google SecOps 서비스 계정 검색
- Google SecOps 콘솔에 로그인합니다.
- 설정 > 데이터 관리 > 피드로 이동합니다. SIEM 전용 플랫폼을 사용하는 경우 설정 > 피드로 이동합니다.
- 새 피드 추가를 클릭합니다.
- 단일 피드 구성을 클릭합니다.
- 소스 유형으로 Google Cloud Storage V2를 선택합니다.
- 로그 유형으로 JumpCloud Directory Insights를 선택합니다.
서비스 계정 가져오기를 클릭합니다. 고유한 서비스 계정 이메일이 표시됩니다. 예를 들면 다음과 같습니다.
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com이 이메일 주소를 복사합니다. 다음 단계에서 사용합니다.
Google SecOps 서비스 계정에 IAM 권한 부여
- Cloud Storage > 버킷으로 이동합니다.
- 버킷 이름을 클릭합니다.
- 권한 탭으로 이동합니다.
- 액세스 권한 부여를 클릭합니다.
- 다음 구성 세부정보를 제공합니다.
- 주 구성원 추가: Google SecOps 서비스 계정 이메일을 붙여넣습니다.
- 역할 할당: 스토리지 객체 뷰어를 선택합니다.
- 저장을 클릭합니다.
JumpCloud Directory Insights 로그를 수집하도록 Google SecOps에서 피드 구성
- 설정 > 데이터 관리 > 피드로 이동합니다. SIEM 전용 플랫폼을 사용하는 경우 설정 > 피드로 이동합니다.
- 새 피드 추가를 클릭합니다.
- 단일 피드 구성을 클릭합니다.
- 피드 이름 필드에 피드 이름을 입력합니다(예:
JumpCloud Directory Insights Logs). - 소스 유형으로 Google Cloud Storage V2를 선택합니다.
- 로그 유형으로 JumpCloud Directory Insights를 선택합니다.
- 다음을 클릭합니다.
다음 입력 파라미터의 값을 지정합니다.
필드 값 스토리지 버킷 URI gs://jumpcloud-directory-insights-logs/jumpcloud/소스 삭제 옵션 원하는 삭제 옵션을 선택합니다. 최대 파일 보관 기간(일) 기본값은 180일입니다. 애셋 네임스페이스 <p>애셋 네임스페이스 수집 라벨 이 피드의 이벤트에 적용할 라벨입니다. jumpcloud-directory-insights-logs을 실제 Cloud Storage 버킷 이름으로 바꿉니다.- URI 끝에 항상 후행 슬래시(
/)를 포함합니다.
다음을 클릭합니다.
확정 화면에서 새 피드 구성을 검토한 다음 제출을 클릭합니다.
UDM 매핑 테이블
| 로그 필드 | UDM 매핑 | 로직 |
|---|---|---|
| data.profile_list.payload_content.payload_type, data.profile_list.payload_content.payload_identifier, data.profile_list.payload_content.payload_uuid, data.profile_list.payload_content.payload_organization, data.profile_list.payload_content.payload_display_name, data.profile_list.payload_content.payload_description | 정보 | payloadContent의 속성 라벨과 병합됨 |
| data.association.op, data.association.action_source, data.geoip.region_code, data.service, data.event_type, data.@version, data.application.version, data.application.publisher, data.application.uninstall_string, data.changes.0.field, data.changes.0.from, data.changes.0.to, data.available_os_updates.allows_install_later | additional.fields | 해당 라벨과 병합됨 |
| extensions.auth.type | event_type이 USER_LOGIN인 경우 'MACHINE'으로 설정됨 | |
| data.timestamp | metadata.event_timestamp | 날짜 일치 ISO8601, RFC 3339, yyyy-MM-ddTHH:mm:ss.SSSSSSZ를 사용하여 변환됨 |
| data.message, data.client_ip, data.initiated_by.username, data.system.hostname | metadata.event_type | 메시지가 'logged in'과 일치하고 대상이 비어 있지 않으면 USER_LOGIN으로 설정되고, 그렇지 않고 IP와 사용자 ID가 있으면 USER_UNCATEGORIZED로 설정되고, 그렇지 않고 호스트 이름 또는 IP가 있으면 STATUS_UPDATE로 설정되고, 그렇지 않고 사용자 ID가 있으면 USER_UNCATEGORIZED로 설정되고, 그렇지 않으면 GENERIC_EVENT로 설정됩니다. |
| data.id | metadata.product_log_id | 값이 직접 복사됨 |
| data.@version, data.application.version | metadata.product_version | data.@version으로 설정한 후 data.application.version으로 대체됨 |
| data.application.name | principal.application | 값이 직접 복사됨 |
| data.mdm_type | principal.asset.hardware | 제조업체가 data.mdm_type으로 설정된 상태로 병합됨 |
| data.command_uuid | principal.asset_id | 'commandUuid:' + data.command_uuid로 연결됨 |
| data.system.hostname | principal.hostname | 값이 직접 복사됨 |
| data.client_ip | principal.ip | data.client_ip에서 병합됨 |
| data.geoip.country_code | principal.location.country_or_region | 값이 직접 복사됨 |
| data.geoip.region_code | principal.location.name | 값이 직접 복사됨 |
| data.geoip.latitude | principal.location.region_latitude | 문자열로 변환된 후 부동 소수점 수로 변환됨 |
| data.geoip.longitude | principal.location.region_longitude | 문자열로 변환된 후 부동 소수점 수로 변환됨 |
| data.geoip.region_name | principal.location.state | 값이 직접 복사됨 |
| data.application.path, data.process_name | principal.process.file.full_path | data.application.path로 설정한 후 data.process_name으로 대체 |
| data.association.connection.from.name, data.mdm_device_manager_id, data.request_type | principal.resource.attribute.labels | connection_from_name, mdm_device_manager_id, request_type의 라벨과 병합됨 |
| data.system.id, data.resource.id, data.mdm_device_id | principal.resource.id | data.system.id로 설정한 후 data.resource.id로 대체하고 data.mdm_device_id로 대체합니다. |
| data.resource.username | principal.resource.name | 값이 직접 복사됨 |
| data.association.connection.from.object_id | principal.resource.product_object_id | 값이 직접 복사됨 |
| data.association.connection.from.type | principal.resource.type | 값이 직접 복사됨 |
| data.initiated_by.email | principal.user.email_addresses | 이메일이 ^.+@.+$와 일치하는 경우 병합됨 |
| data.system.displayName | principal.user.user_display_name | 값이 직접 복사됨 |
| data.initiated_by.username, data.admin_info.name | principal.user.userid | data.initiated_by.username으로 설정된 후 data.admin_info.name으로 대체되었다가 data.initiated_by.username으로 대체됨 |
| data.success, data.status | sec_result.action | 성공이 true이거나 상태가 승인됨인 경우 ALLOW로 설정하고 성공이 false인 경우 BLOCK으로 설정합니다. |
| data.status, data.success | sec_result.action_details | 비어 있지 않으면 상태로 설정하고, 비어 있으면 성공으로 설정합니다. |
| data.success, data.status, data.security_info.management_status.is_activation_lock_manageable, data.security_info.management_status.is_user_enrollment, data.security_info.management_status.enrolled_via_dep, data.organization, data.windows_meta.logon_type, data.security_info.management_status.user_approved_enrollment | sec_result.detection_fields | is_activation_lock_manageable, is_user_enrollment, enrolled_via_dep, organization, logon_type, user_approved_enrollment의 라벨과 병합됨 |
| data.query_responses.device_name | target.hostname | 값이 직접 복사됨 |
| data.query_responses.wifi_mac | target.mac | data.query_responses.wifi_mac에서 병합됨 |
| data.query_responses.model_name | target.platform | (?i)mac과 일치하는 경우 'MAC'으로 설정 |
| data.query_responses.os_version | target.platform_version | 값이 직접 복사됨 |
| data.query_responses.available_device_capacity, data.query_responses.device_capacity | target.resource.attribute.labels | available_device_capacity, device_capacity의 라벨과 병합됨 |
| data.association.connection.to.name | target.resource.name | 값이 직접 복사됨 |
| data.association.connection.to.object_id | target.resource.product_object_id | 값이 직접 복사됨 |
| data.association.connection.to.type | target.resource.type | 값이 직접 복사됨 |
| data.profile_list.payload_organization | target.user.department | profile_payload_organization에서 병합됨 |
| metadata.vendor_name | 'JUMPCLOUD_DIRECTORY_INSIGHTS'로 설정합니다. | |
| metadata.product_name | 'JUMPCLOUD_DIRECTORY_INSIGHTS'로 설정합니다. | |
data.alert_id |
event.idm.read_only_udm.metadata.product_log_id |
변경 로그에서 매핑됨 |
data.alert_title |
event.idm.read_only_udm.security_result.summary |
변경 로그에서 매핑됨 |
data.category |
event.idm.read_only_udm.security_result.category_details |
변경 로그에서 매핑됨 |
data.description |
event.idm.read_only_udm.security_result.description |
변경 로그에서 매핑됨 |
data.priority |
event.idm.read_only_udm.security_result.priority |
변경 로그에서 매핑됨 |
data.rule_id |
event.idm.read_only_udm.security_result.rule_id |
변경 로그에서 매핑됨 |
data.event_description |
event.idm.read_only_udm.metadata.description |
변경 로그에서 매핑됨 |
data.di_event.event_type |
event.idm.read_only_udm.metadata.product_event_type |
변경 로그에서 매핑됨 |
data.di_event.initiated_by.email |
event.idm.read_only_udm.principal.user.email_addresses |
변경 로그에서 매핑됨 |
data.di_event.initiated_by.id |
event.idm.read_only_udm.principal.user.product_object_id |
변경 로그에서 매핑됨 |
data.di_event.client_ip |
event.idm.read_only_udm.principal.ip |
변경 로그에서 매핑됨 |
data.di_event.association.connection.from.name |
event.idm.read_only_udm.target.group.group_display_name |
변경 로그에서 매핑됨 |
data.di_event.association.connection.to.name |
event.idm.read_only_udm.about.user.userid |
변경 로그에서 매핑됨 |
data.di_event.association.connection.to.object_id |
event.idm.read_only_udm.about.user.product_object_id |
변경 로그에서 매핑됨 |
data.di_event.success |
event.idm.read_only_udm.security_result.action |
변경 로그에서 매핑됨 |
data.di_event.service |
event.idm.read_only_udm.target.application |
변경 로그에서 매핑됨 |
data.di_event.geoip.country_code |
event.idm.read_only_udm.principal.location.country_or_region |
변경 로그에서 매핑됨 |
data.organization_name |
event.idm.read_only_udm.principal.user.company_name |
변경 로그에서 매핑됨 |
data.di_event.@version |
event.idm.read_only_udm.metadata.product_version |
변경 로그에서 매핑됨 |
data.source_url |
event.idm.read_only_udm.principal.url |
변경 로그에서 매핑됨 |
data.di_event.initiated_by.source |
event.idm.read_only_udm.principal.hostname |
변경 로그에서 매핑됨 |
data.source_name |
event.idm.read_only_udm.principal.user.userid |
변경 로그에서 매핑됨 |
data.di_event.geoip.latitude |
event.idm.read_only_udm.principal.location.region_latitude |
변경 로그에서 매핑됨 |
data.di_event.geoip.longitude |
event.idm.read_only_udm.principal.location.region_longitude |
변경 로그에서 매핑됨 |
data.di_event.geoip.region_name |
event.idm.read_only_udm.principal.location.state |
변경 로그에서 매핑됨 |
data.di_event.organization |
event.idm.read_only_udm.security_result.detection_fields |
변경 로그에서 매핑됨 |
association_op", "action_source", and "sso_token_success |
additional.fields |
변경 로그에서 매핑됨 |
connection_from_type |
principal.resource.resource_type |
변경 로그에서 매핑됨 |
connection_from_object_id |
principal.resource.product_object_id |
변경 로그에서 매핑됨 |
connection_to_name |
target.resource.name |
변경 로그에서 매핑됨 |
connection_to_type |
target.resource.resource_type |
변경 로그에서 매핑됨 |
connection_to_object_id |
target.resource.product_object_id |
변경 로그에서 매핑됨 |
변경 로그
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.