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

## 개요

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

## 강화 필드 참조

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

<table><thead><tr><th>필드 이름</th><th width="298">설명</th><th>예상 값</th></tr></thead><tbody><tr><td><strong><code>AnalysisType</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>Refresh</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>Refresh</code> 사양</a> 아래</td></tr><tr><td><strong><code>쿼리</code></strong></td><td>데이터 레이크에서 강화 데이터를 가져오기 위한 SQL 쿼리입니다. <strong>과 함께 사용할 수 없습니다 <code>Filename</code></strong></td><td>문자열</td></tr><tr><td><strong><code>Indicators</code></strong></td><td>스키마에 대한 지표 필드 매핑 목록입니다(함께 사용됨 <code>쿼리</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>Indicators</code> 사양</a> 아래</td></tr><tr><td><strong><code>Validations</code></strong></td><td>스키마의 유효성 검사 규칙 목록입니다(함께 사용됨 <code>쿼리</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>Validations</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>

### `Refresh` 사양 <a href="#refresh-specification" id="refresh-specification"></a>

`Refresh` 다음에서 데이터를 가져올 때의 구성을 정의합니다 [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>

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

`Indicators` 사용 시 필드 지표 매핑을 정의합니다 `쿼리`. 배열의 각 항목은 다음 필드를 포함하는 객체여야 합니다:

<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>Indicators</code></strong></td><td>이 필드에 대한 지표 유형 목록</td><td>문자열 배열(예: <code>["username", "email"]</code>)</td></tr></tbody></table>

### `Validations` 사양 <a href="#user-content-validations-specification" id="user-content-validations-specification"></a>

`Validations` 사용 시 필드 유효성 검사 규칙을 정의합니다 `쿼리`. 배열의 각 항목은 다음 필드를 포함하는 객체여야 합니다:

<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>Validations</code></td><td>이 필드에 대한 유효성 검사 규칙 목록</td><td>유효성 검사 객체 배열</td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.panther.com/ko/enrichment/custom/lookup-table-specification-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.