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 버킷 만들기

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

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

Cloud Storage로 JumpCloud Directory Insights 로그 내보내기

JumpCloud Directory Insights는 Directory Insights API를 통해 이벤트를 노출합니다. 예약된 스크립트 또는 Cloud Run 함수를 사용하여 이벤트를 가져와 Cloud Storage에 기록합니다.

  1. JumpCloud API 키를 생성합니다.

    1. JumpCloud 관리 포털에 로그인합니다.
    2. 프로필 아이콘으로 이동하여 내 API 키를 선택합니다.
    3. API 키를 복사합니다.
  2. JumpCloud Directory Insights API를 쿼리하고 이벤트를 검색하여 Cloud Storage에 쓰는 Cloud Run 함수를 만듭니다.

  3. Cloud Scheduler 및 Pub/Sub를 사용하여 일정에 따라 함수를 트리거합니다.

  • 내보낸 파일이 원래 JSON 형식을 유지하는지 확인합니다.
  • 각 파일에는 하나 이상의 이벤트 레코드가 포함되어야 합니다.

Google SecOps 서비스 계정 검색

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

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

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

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

JumpCloud Directory Insights 로그를 수집하도록 Google SecOps에서 피드 구성

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

    필드 값
    스토리지 버킷 URI gs://jumpcloud-directory-insights-logs/jumpcloud/
    소스 삭제 옵션 원하는 삭제 옵션을 선택합니다.
    최대 파일 보관 기간(일) 기본값은 180일입니다.
    애셋 네임스페이스 <p>애셋 네임스페이스
    수집 라벨 이 피드의 이벤트에 적용할 라벨입니다.
    • jumpcloud-directory-insights-logs을 실제 Cloud Storage 버킷 이름으로 바꿉니다.
    • URI 끝에 항상 후행 슬래시(/)를 포함합니다.
  9. 다음을 클릭합니다.

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

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 전문가에게 문의하여 답변을 받으세요.