> 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/enrichment/custom/lookup-table-specification-reference.md).

# 사용자 지정 보강 사양 참조

## 개요

다음 필드는 사용자 지정 보강 YAML 구성 파일에서 사용할 수 있습니다.

## 보강 필드 참조

다음은 사용자 지정 보강 사양 필드의 전체 목록입니다. 굵게 표시된 필드 이름은 필수입니다. 별표 (`*`)는 두 필드가 상호 배타적임을 나타냅니다.

<table><thead><tr><th>필드 이름</th><th width="298">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>분석 유형</code></strong></td><td>이것이 보강(조회 테이블이라고도 함)임을 나타냅니다.</td><td><code>lookup_table</code></td></tr><tr><td><strong><code>사용</code></strong></td><td>이 테이블이 활성화되어 있는지 여부</td><td>불리언</td></tr><tr><td><strong><code>LookupName</code></strong></td><td>테이블의 고유 식별자</td><td>문자열</td></tr><tr><td><strong><code>스키마</code></strong></td><td>입력 데이터를 파싱하는 데 사용할 스키마의 ID</td><td>문자열</td></tr><tr><td><strong><code>LogTypeMap</code></strong></td><td>이 테이블과 대조할 로그 스키마 필드의 매핑</td><td>객체, 다음을 참조 <a href="#logtypemap-specification"><code>LogTypeMap</code> 사양</a> 아래</td></tr><tr><td><strong><code>Filename*</code></strong></td><td>데이터 파일의 상대 경로입니다. <strong>다음과 함께 사용할 수 없음 <code>새로 고침</code></strong></td><td>문자열</td></tr><tr><td><strong><code>Refresh*</code></strong></td><td>S3 버킷 또는 Google Cloud Storage(GCS) 버킷 동기화 기능의 구성. <strong>다음과 함께 사용할 수 없음 <code>Filename</code></strong></td><td>객체, 다음을 참조 <a href="#refresh-specification"><code>새로 고침</code> 사양</a> 아래</td></tr><tr><td><strong><code>Query</code></strong></td><td>데이터 레이크에서 보강 데이터를 가져오기 위한 SQL 쿼리입니다. <strong>다음과 함께 사용할 수 없음 <code>Filename</code></strong></td><td>문자열</td></tr><tr><td><strong><code>지표</code></strong></td><td>스키마에 대한 지표 필드 매핑 목록(다음과 함께 사용됨 <code>Query</code>)</td><td>배열, 다음을 참조 <a href="https://github.com/panther-labs/panther-docs/blob/docs/gitbook/enrichment/custom/lookup-table-specification-reference.md#indicators-specification"><code>지표</code> 사양</a> 아래</td></tr><tr><td><strong><code>유효성 검사</code></strong></td><td>스키마에 대한 유효성 검사 규칙 목록(다음과 함께 사용됨 <code>Query</code>)</td><td>배열, 다음을 참조 <a href="https://github.com/panther-labs/panther-docs/blob/docs/gitbook/enrichment/custom/lookup-table-specification-reference.md#validations-specification"><code>유효성 검사</code> 사양</a> 아래</td></tr><tr><td><code>설명</code></td><td>테이블에 대한 간단한 설명</td><td>문자열</td></tr><tr><td><code>참조</code></td><td>선택적 참조 링크</td><td>문자열</td></tr></tbody></table>

### `LogTypeMap` 사양

`LogTypeMap` 다음 필드를 가진 객체여야 합니다:

<table><thead><tr><th>필드 이름</th><th width="271">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>PrimaryKey</code></strong></td><td>이벤트와 매칭하는 데 사용할 테이블의 어떤 열인지 정의합니다</td><td>문자열, 숫자 또는 배열(문자열 또는 숫자들의)<br>다음을 참조 <a href="/pages/6df320c900bbcb864e33b76e7db67c837dfdd429#primary-key-data-types">기본 키 데이터 형식</a></td></tr><tr><td><strong><code>AssociatedLogTypes</code></strong></td><td>선택자로 사용할 각 로그 유형과 해당 필드의 목록입니다.</td><td>목록, 아래를 참조하세요. 다음을 사용 중이라면 <a href="/pages/6df320c900bbcb864e33b76e7db67c837dfdd429#option-2-let-log-types-and-selectors-be-automatically-mapped-by-indicator-fields">자동 로그 유형/선택자 지정</a>, 이는 빈 목록일 수 있습니다.</td></tr></tbody></table>

의 각 항목은 `AssociatedLogTypes` 다음 필드를 가진 객체여야 합니다:

<table><thead><tr><th width="201">필드 이름</th><th width="317">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>LogType</code></strong></td><td>로그 스키마의 ID</td><td>문자열</td></tr><tr><td><strong><code>Selectors</code></strong></td><td>로그 유형에서 기본 키와 대조할 필드 목록</td><td>문자열 목록</td></tr></tbody></table>

### `새로 고침` 사양 <a href="#refresh-specification" id="refresh-specification"></a>

`새로 고침` 다음에서 데이터를 가져올 때의 구성을 정의합니다 [S3 버킷](/ko/enrichment/custom.md#option-2-sync-lookup-table-data-from-an-s3-bucket) 또는 [GCS 버킷](/ko/enrichment/custom.md#option-3-sync-lookup-table-data-from-a-google-cloud-storage-gcs-bucket). 다음 필드를 가진 객체여야 합니다:

<table><thead><tr><th width="214">필드 이름</th><th width="303">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>ObjectPath</code></strong></td><td>S3 또는 GCS 버킷 내 파일을 가리키는 URI입니다.</td><td>문자열</td></tr><tr><td><strong><code>PeriodMinutes</code></strong></td><td>S3 객체와 동기화하는 사이에 대기할 분 수</td><td><code>15</code>,<code>30</code>,<code>60</code>,<code>180</code> (3시간),<code>720</code> (12시간), 또는 <code>1440</code> (24시간)</td></tr><tr><td><strong><code>RoleARN</code></strong></td><td>(다음에 대해서만 필요함 <a href="/pages/6df320c900bbcb864e33b76e7db67c837dfdd429#option-2-sync-lookup-table-data-from-an-s3-bucket">S3 버킷 동기화</a>) Panther가 S3 객체에 액세스하기 위해 가정할 수 있는 역할에 해당하는 AWS ARN입니다.</td><td>문자열</td></tr><tr><td><strong><code>GCSCredentials</code></strong></td><td>(다음에 대해서만 필요함 <a href="/pages/6df320c900bbcb864e33b76e7db67c837dfdd429#option-3-sync-lookup-table-data-from-a-google-cloud-storage-gcs-bucket">GCS 버킷 동기화</a>) Workload Identity Federation JSON 자격 증명 구성 파일입니다.</td><td>문자열(JSON 객체 포함)</td></tr><tr><td><code>StorageProvider</code></td><td>다음 클라우드 서비스에 위치한 <code>ObjectPath</code> 에 위치합니다.</td><td><code>S3</code> 또는 <code>GCS</code> (기본값은 <code>S3</code> 정의되지 않은 경우)</td></tr></tbody></table>

### `지표` 사양 <a href="#user-content-indicators-specification" id="user-content-indicators-specification"></a>

`지표` 다음을 사용할 때 필드 지표 매핑을 정의합니다 `Query`. 배열의 각 항목은 다음 필드를 가진 객체여야 합니다:

<table><thead><tr><th width="214">필드 이름</th><th width="303">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>필드</code></strong></td><td>쿼리 결과의 필드 이름</td><td>문자열</td></tr><tr><td><strong><code>지표</code></strong></td><td>이 필드의 지표 유형 목록</td><td>문자열 배열(예: <code>["username", "email"]</code>)</td></tr></tbody></table>

### `유효성 검사` 사양 <a href="#user-content-validations-specification" id="user-content-validations-specification"></a>

`유효성 검사` 다음을 사용할 때 필드 유효성 검사 규칙을 정의합니다 `Query`. 배열의 각 항목은 다음 필드를 가진 객체여야 합니다:

<table><thead><tr><th width="214">필드 이름</th><th width="303">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>필드</code></strong></td><td>쿼리 결과의 필드 이름</td><td>문자열</td></tr><tr><td><code>유효성 검사</code></td><td>이 필드의 유효성 검사 규칙 목록</td><td>유효성 검사 객체 배열</td></tr></tbody></table>


---

# 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/enrichment/custom/lookup-table-specification-reference.md?ask=<question>&goal=<endgoal>
```

`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.