> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/data-onboarding/supported-logs/hex.md). # Hex 로그 ## 개요 Panther는 다음에서 실시간 감사 로그 이벤트를 수신할 수 있습니다. [Hex](https://hex.tech/) 웹훅을 통해. 이 통합은 프로젝트 액세스, 데이터 내보내기, 관리 작업을 포함하여 Hex 워크스페이스 전반의 사용자 활동을 확인할 수 있게 해 주며, 보안 모니터링과 규정 준수 감사가 가능해집니다. ## Hex 감사 로그를 Panther에 온보딩하는 방법 ### 사전 요구 사항 * 이 통합을 설정하려면 다음에 대한 액세스 권한이 있는 Hex 워크스페이스 관리자여야 합니다. **설정** > **Audit Logs**. ### 1단계: Panther에 새 Hex 로그 소스 생성 1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**. 2. 클릭합니다 **새로 만들기.** 3. "Hex"를 검색한 다음 해당 타일을 클릭합니다. 4. 클릭합니다 **설정 시작**. 5. Panther의 [HTTP 소스 구성 지침을 따르세요](https://github.com/panther-labs/panther-docs/tree/main/docs/gitbook/data-transports/http.md#how-to-set-up-an-http-log-source-in-panther), 5단계부터 시작합니다. * 다음을 사용해야 합니다 [공유 비밀 인증](https://github.com/panther-labs/panther-docs/tree/main/docs/gitbook/data-transports/http.md#shared-secret). * 이 소스로 전송되는 페이로드는 [모든 HTTP 소스의 페이로드 요구사항](https://github.com/panther-labs/panther-docs/tree/main/docs/gitbook/data-transports/http.md#payload-requirements). * HTTP 엔드포인트 생성이 완료될 때까지 다음 단계로 진행하지 마세요. 다음을 복사하세요. **HTTP 소스 URL**, **헤더 이름**, 및 **비밀 키 값** — 2단계에서 필요합니다. ### 2단계: Hex에서 감사 로그 스트림 구성 1. Hex 워크스페이스에서 다음으로 이동합니다. **설정** > **Audit Logs**. 2. 선택 **로그 스트림 구성**. 3. 선택 **일반 HTTPS** 을 대상 유형으로 선택합니다. 4. 다음 필드를 입력합니다: * **URL**: 다음을 입력합니다 **HTTP 소스 URL** Panther에서 생성한 값입니다. * **인증 헤더 이름**: 다음을 입력합니다 **헤더 이름** Panther에서 구성한 값입니다. * **인증 헤더 값**: 다음을 입력합니다 **비밀 키 값** Panther에서 구성한 값입니다. 5. 다음 중 하나를 선택합니다. **JSON** 또는 **NDJSON** 에 대해 **요청 본문 형식.** 6. 구성을 저장합니다. Hex는 즉시 Panther로 새 감사 이벤트 스트리밍을 시작합니다. ## 지원되는 로그 유형 ### Hex.Audit Hex 분석 플랫폼에서 발생한 감사 로그 이벤트로, 셀 실행, 프로젝트 생성, 액세스 관리, 데이터 다운로드와 같은 워크스페이스 내 사용자 및 시스템 작업을 캡처합니다. ```yaml 스키마: Hex.Audit 설명: Hex 분석 플랫폼 웹훅의 감사 로그 이벤트 referenceURL: https://learn.hex.tech/docs/administration/workspace_settings/audit-logs/audit-logs-reference 필드: - name: source 유형: string 설명: 웹훅 봉투 소스 식별자(항상 "Hex") - 이름: keySuffix 유형: string 설명: 웹훅 전달 중복 제거 키(Hex가 각 전달마다 할당하는 ULID) - 이름: timestamp 유형: timestamp 시간 형식: - rfc3339 설명: 웹훅 전달 시간(Hex가 이벤트를 전송한 시점이며, event.occurred_at과는 다름) - 이름: event 유형: object 필수: true 설명: 감사 이벤트 페이로드 필드: - name: actor 유형: object 필수: true 설명: 작업을 수행한 주체 필드: - 이름: id 유형: string 설명: 주체의 고유 식별자 지표: - actor_id - 이름: type 유형: string 설명: 주체 유형(예: USER) - 이름: metadata 유형: object 설명: 주체에 대한 추가 메타데이터 필드: - 이름: email 유형: string 설명: 주체의 이메일 주소 지표: - email - 이름: workspace 유형: string 설명: 작업 공간 이름 - 이름: workspaceId 유형: string 설명: 워크스페이스의 고유 식별자 - 이름: actorOrgRole 유형: string 설명: 주체의 조직 내 역할(예: ADMIN, MEMBER) - 이름: action 필수: true 유형: string 설명: 수행된 작업(예: RUN_CELL, CREATE_PROJECT) - 이름: context 유형: object 설명: 작업이 수행된 위치의 컨텍스트 필드: - 이름: location 유형: string 설명: 요청의 IP 주소 지표: - ip - 이름: user_agent 유형: string 설명: 요청의 사용자 에이전트 문자열 - 이름: targets 유형: array 설명: 작업의 영향을 받은 객체 요소: 유형: object 필드: - 이름: id 유형: string 설명: 대상의 고유 식별자 - 이름: type 유형: string 설명: 대상 유형(예: project, project_version, cell) - 이름: metadata 유형: object 설명: 대상에 대한 추가 메타데이터 필드: - 이름: created 유형: boolean 설명: 대상이 이 작업으로 생성되었는지 여부 - 이름: principal_type 유형: string 설명: 액세스 이벤트의 주체 유형(예: user, group) - 이름: representation 유형: string 설명: JSON으로 인코딩된 대상 객체 표현 - 이름: version 유형: string 설명: 이벤트의 스키마 버전 - 이름: metadata 유형: object 설명: 작업에 대한 추가 메타데이터 필드: - 이름: result 유형: string 설명: 작업 결과(예: SUCCESS, FAILURE) - 이름: requestArgs 유형: string 설명: JSON으로 인코딩된 요청 인수 - 이름: failureReason 유형: string 설명: 작업이 실패한 경우의 실패 사유 - 이름: hexTraceId 유형: string 설명: 서비스 간 이벤트 상관관계를 위한 Hex 추적 ID 지표: - trace_id - name: source 유형: string 설명: 이벤트를 생성한 소스 시스템 - 이름: isRefreshingKey 유형: boolean 설명: 키 새로고침 작업으로 이벤트가 트리거되었는지 여부 - 이름: projectCreationMethod 유형: string 설명: 프로젝트 생성에 사용된 방법(예: BLANK, TEMPLATE) - 이름: occurred_at 필수: true 유형: timestamp 시간 형식: - rfc3339 이벤트 시간 여부: true 설명: 이벤트가 발생한 시각의 타임스탬프 ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.panther.com/ko/data-onboarding/supported-logs/hex.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.