> 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/zendesk.md).
# Zendesk 로그
## 개요
Panther는 Zendesk에서 로그를 직접 가져오는 것을 지원합니다. Panther는 가져올 수 있습니다 [Zendesk 감사 로그 ](https://developer.zendesk.com/api-reference/ticketing/account-configuration/audit_logs/)를 쿼리하여 [Zendesk Support API](https://developer.zendesk.com/api-reference/ticketing/introduction/).
Panther에서 로그 소스로 Zendesk를 설정하려면 Zendesk에서 Panther에 권한을 부여한 다음 Panther에서 Zendesk를 로그 소스로 설정해야 합니다.
다음 제한 사항에 유의하세요:
* Zendesk API 속도 제한은 Zendesk Suite 요금제에 따라 달라집니다.
* 참고 [Zendesk의 속도 제한 문서](https://developer.zendesk.com/api-reference/introduction/rate-limits/) 에서 자세한 내용을 확인하세요.
* 이 통합은 Zendesk의 Enterprise 및 Enterprise Plus Suite 요금제에서만 사용할 수 있습니다.
* 다음을 참조하세요 [Zendesk 감사 로그 문서](https://support.zendesk.com/hc/en-us/articles/4408828001434-Viewing-the-audit-log-for-changes) 감사 로그 및 요금제 이용 가능 여부에 대한 정보를 확인하세요.
## Zendesk 로그를 Panther에 온보딩하는 방법
### 1단계: Panther용 Zendesk 구성
Zendesk를 Panther와 통합하도록 구성하는 데는 세 가지 옵션이 있습니다:
* [옵션 1: 새 OAuth2 앱 만들기](#option-1-create-a-new-oauth2-app)
* [옵션 2: Zendesk 이메일 및 비밀번호 제공](#option-2-provide-zendesk-email-and-password)
* [옵션 3: API 토큰 생성](#option-3-generate-an-api-token)
#### 옵션 1: 새 OAuth2 앱 만들기
{% hint style="info" %}
OAuth2 앱을 등록하려면 Zendesk Support 관리자여야 합니다.
Panther의 Zendesk 통합이 계속 정상 작동하려면 OAuth2App을 만드는 사용자가 Zendesk에서 제거되지 않아야 하며 계속 관리자 권한을 보유해야 합니다.
자세한 내용은 다음을 참조하세요: [Zendesk의 OAuth 문서](https://developer.zendesk.com/documentation/ticketing/working-with-oauth/using-oauth-to-authenticate-zendesk-api-requests-in-a-web-app/).
{% endhint %}
1. Zendesk Admin Center에 로그인하세요.
2. 왼쪽 사이드바의 톱니바퀴 아이콘을 클릭한 다음 **채널 > 앱 및 통합 > API > Zendesk API**.
3. 다음 타일을 클릭하세요: **OAuth 클라이언트** 채널/API 페이지의 탭을 연 다음 **OAuth 클라이언트 추가** 를 클라이언트 목록 오른쪽에서 클릭하세요.
* 애플리케이션 등록 페이지가 표시됩니다. **보안 비밀** 필드가 미리 채워져 있습니다.
4. 다음 필수 필드를 작성하세요:
* **클라이언트 이름**: Zendesk Support 인스턴스에 액세스할 수 있는 앱 목록에서 표시되는 이름입니다.
* **고유 식별자**: 필드를 클릭하면 앱에 입력한 이름으로 자동 채워집니다. 원하면 변경할 수 있습니다.
* **클라이언트 종류**: 다음으로 설정 **기밀**.
* **리디렉션 URL**: Panther UI의 Zendesk 로그 소스 온보딩 흐름에서 이 값을 찾을 수 있습니다(스크린샷 참조 [아래](#step-2-create-a-new-zendesk-source-in-panther)). 이 URL은 Zendesk Support가 사용자의 애플리케이션 액세스 허용 결정을 전송하는 데 사용합니다.
5. 클릭합니다 **저장**.
6. 메시지가 표시되면 다음을 복사하세요 **보안 비밀** 값을 안전한 곳에 저장하세요. 다음 단계에서 필요합니다.
* 문자들이 텍스트 상자의 너비를 넘어갈 수 있으므로 복사하기 전에 모두 선택했는지 확인하세요.
7. 클릭합니다 **저장**.
#### 옵션 2: Zendesk 이메일 및 비밀번호 제공
{% hint style="info" %}
Panther의 Zendesk 통합이 계속 정상 작동하려면 이메일과 비밀번호가 사용되는 Zendesk Support 관리자 사용자가 Zendesk에서 제거되지 않아야 하며 계속 관리자 권한을 보유해야 합니다.
{% endhint %}
Panther에 Zendesk Support 관리자 이메일과 비밀번호를 제공하여 Zendesk를 로그 소스로 설정할 수도 있습니다. 이 방법을 선택하면 이 문서의 마지막 섹션으로 이동하여 Panther Console에서 Zendesk를 로그 소스로 온보딩할 때 관리자 이메일과 비밀번호를 준비해 두세요.
#### 옵션 3: API 토큰 생성
{% hint style="info" %}
API 토큰을 만들려면 Zendesk Support 관리자여야 합니다.
Panther의 Zendesk 통합이 계속 정상 작동하려면 API 토큰을 만드는 사용자가 Zendesk에서 제거되지 않아야 하며 계속 관리자 권한을 보유해야 합니다.
Zendesk API 토큰 생성에 대해 자세히 알아보기 [여기](https://support.zendesk.com/hc/en-us/articles/226022787-Generating-a-new-API-token-).
{% endhint %}
1. Zendesk Support 계정에 로그인하세요.
2. 왼쪽 사이드바의 톱니바퀴 아이콘을 클릭한 다음 선택하세요 **채널 > 앱 및 통합 > API > Zendesk API**.
3. 다음 타일을 클릭하세요: **설정** 탭을 선택한 다음 Token Access가 활성화되어 있는지 확인하세요.
4. 다음 타일을 클릭하세요: **+** 오른쪽의 버튼 **활성 API 토큰**.
5. 토큰 이름을 입력한 다음 **생성**. 토큰이 생성되어 팝업 창에 표시됩니다.
6. 토큰(빨간색)을 복사하여 안전한 위치에 보관하세요. 다음 단계에서 필요합니다.
* **참고**: 이 창을 닫으면 전체 토큰은 다시 표시되지 않습니다.
### 2단계: Panther에서 새 Zendesk 소스 만들기
1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**.
2. 클릭합니다 **새로 만들기.**
3. 선택 **Zendesk** 사용 가능한 로그 소스 목록에서.
4. 오른쪽 상단 모서리에서 다음을 클릭합니다 **설정 시작.**
5. 다음 화면에서 설명적인 **이름** 소스 이름을 입력하세요. 예: `내 Zendesk 감사 로그` 그리고 조직의 **Zendesk 하위 도메인**.
6. 클릭합니다 **설정.**
7. Panther가 Zendesk에서 로그를 수신하도록 승인하세요. 이전에 선택한 [이 문서의 옵션에 따라](#step-1-configure-zendesk-for-panther) Zendesk 구성 방법에 맞는 아래 단계를 따르세요:
* **옵션 1: OAuth2 승인 흐름 사용**
1. 관리자 계정으로 Zendesk에 로그인하세요.
2. 아래 필드를 작성하세요. 애플리케이션을 등록하면 Zendesk 계정의 OAuth 앱 상세 페이지에서 이 정보를 찾을 수 있습니다.
* **Client ID**: Zendesk의 고유 식별자를 입력하세요.
* **클라이언트 시크릿:** 이 문서의 이전 단계에서 얻은 Zendesk의 비밀 키를 입력하세요.\
3. 클릭합니다 **설정**.
4. 다음 페이지에서 **설정 확인** 페이지에서 다음 **액세스 허용**.\
5. Zendesk로 이동하여 Panther에 Zendesk 로그 접근 권한을 부여하라는 메시지가 표시됩니다. 다음을 클릭하세요 **허용**.\
* **옵션 2: 이메일 및 비밀번호 사용**
1. 다음 필드를 입력합니다:
1. **이메일**: Zendesk Support 관리자 **이메일.**
2. **비밀번호**: Zendesk Support 관리자 **비밀번호.**
2. 클릭합니다 **설정**.
* **옵션 3: API 인증 사용**
1. 다음 필드를 입력합니다:
* **이메일:** Zendesk Support 관리자의 **이메일**.
* **API 토큰:** 이 문서의 이전 단계에서 Zendesk에서 생성한 API 토큰을 입력하세요.
2. 클릭합니다 **설정**.
8. 성공 화면으로 이동합니다:\\
* 선택적으로 하나 이상의 [디택션 팩](https://docs.panther.com/detections/panther-managed/packs).
* 다음 **이벤트가 처리되지 않으면 알러트를 발생시키기** 설정의 기본값은 **예**. 일정 시간이 지난 후 로그 소스에서 데이터 흐름이 멈추면 알러트를 받게 되므로 이 설정을 활성화한 상태로 두는 것을 권장합니다. 이 시간 범위는 구성 가능하며 기본값은 24시간입니다.\\
## Panther가 관리하는 디택션
참고 [Panther가 관리하는](https://docs.panther.com/detections/panther-managed) Zendesk에 대한 규칙을 [panther-analysis GitHub 저장소](https://github.com/panther-labs/panther-analysis/tree/master/rules/zendesk_rules).
## 지원되는 로그 유형
### Zendesk.Audit
감사 로그에는 계정이 생성된 이후 Zendesk에서 발생한 다양한 변경 사항이 표시됩니다. 이 변경 사항 기록은 무기한 저장되며 전체 변경 내역을 볼 수 있습니다.
참조: [감사 로그에 대한 Zendesk 문서.](https://developer.zendesk.com/api-reference/ticketing/account-configuration/audit_logs/)
```yaml
스키마: Zendesk.Audit
파서:
네이티브:
이름: Zendesk.Audit
설명: 감사 로그에는 계정이 생성된 이후 Zendesk에서 발생한 다양한 변경 사항이 표시됩니다. 이 변경 사항 기록은 무기한 저장되며 전체 변경 내역을 볼 수 있습니다.
referenceURL: https://developer.zendesk.com/rest_api/docs/support/audit_logs
필드:
- 이름: action
설명: 값은 'login', 'create', 'update' 또는 'destroy'일 수 있습니다
유형: string
- 이름: action_label
설명: action 필드의 현지화된 문자열
유형: string
- 이름: actor_id
설명: 티켓을 생성하는 사용자의 ID
유형: bigint
- 이름: change_description
설명: 발생한 변경 사항의 설명
유형: string
- 이름: created_at
필수: true
설명: 감사가 생성된 시간
유형: timestamp
시간 형식: rfc3339
이벤트 시간 여부: true
- 이름: id
필수: true
설명: 생성 시 자동으로 할당된 ID
유형: bigint
- 이름: ip_address
설명: 감사를 수행하는 사용자의 IP 주소
유형: string
지표:
- ip
- 이름: source_id
설명: 감사 대상 항목의 ID
유형: bigint
- 이름: source_label
설명: 감사 대상 항목의 이름
유형: string
- 이름: source_type
설명: 감사 대상 항목의 유형
유형: string
- 이름: url
설명: 감사 로그에 액세스하는 URL
유형: string
```
---
# 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/zendesk.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.