> 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/docusign.md).
# Docusign 로그
## 개요
Panther는 수집을 지원합니다 [Docusign](https://www.docusign.com/) HTTP를 통해 Connect 웹훅 이벤트를 연결합니다. [Docusign Connect](https://developers.docusign.com/platform/webhooks/connect/) Docusign Connect를 사용하면 eSignature 워크플로에서 특정 이벤트가 발생할 때 Panther와 같은 외부 애플리케이션에 알리는 웹훅을 구성할 수 있습니다.
Docusign Connect 웹훅은 봉투(전송됨, 전달됨, 완료됨 또는 무효화됨), 수신자, 템플릿, 신원 확인 등 다양한 엔터티에 대한 실시간 알림을 제공할 수 있습니다. 여기에서 [사용 가능한 이벤트 트리거의 전체 목록을 확인하세요](https://developers.docusign.com/platform/webhooks/connect/event-triggers/).
Panther에서 Docusign 로그 통합을 다음 용도로 사용할 수 있습니다:
* **무단 액세스 및 사기 탐지**: 인증 실패 시도, 의심스러운 수신자 행동, 비정상적인 서명 패턴, 예상치 못한 봉투 수정 추적
* **템플릿 보안 모니터링**: 문서 템플릿의 생성, 수정 또는 삭제 모니터링
* **계정 활동 모니터링**: 관리 작업 및 구성 변경 추적
### 보안 모니터링에 일반적으로 사용되는 Docusign 이벤트 트리거
다음 [이벤트 트리거](https://developers.docusign.com/platform/webhooks/connect/event-triggers/) 는 보안 모니터링에 일반적으로 사용됩니다:
* `recipient-authentication-failure`: 인증 실패
* `envelope-voided`: 봉투 취소(잠재적 사기)
* `envelope-corrected`: 문서 수정(잠재적 변조)
* `template-created`, `template-modified`, `template-deleted`: 템플릿 변경
* `recipient-declined`: 문서 거부
## Panther에 Docusign 로그를 온보딩하는 방법
### 사전 요구 사항
* Docusign Connect 웹훅을 구성하려면 Docusign 계정에서 관리자 권한이 있어야 합니다. 다음을 참조하세요. [Docusign Connect 문서](https://developers.docusign.com/platform/webhooks/connect/) 자세한 내용은
### 1단계: Panther에서 새 Docusign 소스 만들기
1. Panther 콘솔의 왼쪽 탐색 표시줄에서 다음을 클릭합니다: **구성** > **로그 소스**.
2. 다음을 클릭합니다: **새로 만들기**.
3. "Docusign"을 검색한 다음 해당 타일을 클릭하세요.
4. 다음을 클릭합니다: **설정 시작**.
5. Panther의 [HTTP 소스 구성 지침을 따르세요](/ko/data-onboarding/data-transports/http.md#how-to-set-up-an-http-log-source-in-panther)5단계부터 시작합니다.
* 설정 중, 다음 항목에 대해 **인증 방법**, 다음 중 하나를 사용해야 합니다 **기본 인증** 또는 **HMAC**.
* 선택하는 경우 **HMAC**, 다음에 대해 **헤더 이름**, 입력 `X-Docusign-Signature-1`. [Connect 웹훅에서 HMAC을 사용하는 방법에 대해 여기에서 자세히 알아보세요](https://developers.docusign.com/platform/webhooks/connect/hmac/).
* 구성한 인증 정보를 저장해 두세요. 다음 단계에서 Docusign에서 웹훅을 설정할 때 필요합니다.
* 이 소스로 전송되는 페이로드는 [모든 HTTP 소스에 대한 페이로드 요구 사항](/ko/data-onboarding/data-transports/http.md#payload-requirements).
* HTTP 엔드포인트 생성이 완료될 때까지 다음 단계로 진행하지 마세요.
### 2단계: Docusign Connect 웹훅 구성
아래 단계를 따라 Docusign Connect 웹훅을 구성하세요. 이 과정에서 추가 지원이 필요하면 다음을 참조하세요 [Docusign Create a Connect Configuration 문서](https://support.docusign.com/s/document-item?language=en_US&_gl=1*jyc3me*_gcl_au*MTM1MDY1NDYyMS4xNzUzODgzNTcx\&bundleId=vob1727899215236\&topicId=xwi1583277389681.html&_LANG=enus).
1. 관리자로 Docusign 계정에 로그인하세요.
2. 탐색 모음에서 **통합** > **연결**.
3. 다음을 클릭합니다: **구성 추가** > **사용자 지정**.
4. 다음을 구성하세요 [웹훅 Connect 필드](https://support.docusign.com/s/document-item?language=en_US\&bundleId=vob1727899215236\&topicId=zjq1665170940873.html&_LANG=enus):
* **이름**: 설명적인 이름을 입력하세요. 예: `Panther 보안 통합`.
* **게시할 URL**: 다음을 입력하세요. **HTTP 소스 URL** 1단계에서 Panther에서 생성한 URL
* **트리거 이벤트**: 다음을 선택합니다. [이벤트 트리거](https://developers.docusign.com/platform/webhooks/connect/event-triggers/) 모니터링하려는
* **데이터 포함**: 각 범주에 대해 Panther로 전송되는 이벤트에 포함할 필드를 선택하세요. 이 필드에 대해 자세히 알아보려면 이 [Docusign 문서](https://support.docusign.com/s/document-item?language=en_US\&bundleId=vob1727899215236\&topicId=zbg1608069790210.html&_LANG=enus).
{% hint style="warning" %}
대상 **봉투** 그리고 **수신자** 이벤트의 경우, 다음을 비워 두는 것이 좋습니다 **문서** 그리고 **첨부파일** 선택 해제하세요. 이렇게 하면 페이로드 크기를 줄여 잠재적인 이벤트 전달 지연을 방지할 수 있습니다. 다음에 대해 자세히 알아보세요 [대신 eSignature API를 통해 문서를 검색하는 방법을 여기에서 알아보세요](https://support.docusign.com/s/document-item?language=en_US&_gl=1*jyc3me*_gcl_au*MTM1MDY1NDYyMS4xNzUzODgzNTcx\&bundleId=vob1727899215236\&topicId=oza1583277387805.html&_LANG=enus).
{% endhint %}
* **HMAC 서명 포함**: 1단계에서 Panther에서 HMAC 인증을 사용했다면 여기를 선택하세요.
* 다음의 **1.** 필드에 HMAC **헤더 이름** 1단계에서 Panther에 입력한 값을 입력하세요. Docusign은 이 값을 다음과 연결된 값으로 전송합니다. `X-Docusign-Signature-1` 헤더.
* 다음 문서에서 자세히 알아보세요 [Docusign Connect와 함께 HMAC 보안을 사용하는 방법 문서](https://developers.docusign.com/platform/webhooks/connect/hmac/).
* **기본 인증 헤더 포함**1단계에서 Panther에서 기본 인증을 사용했다면 여기를 선택하세요.
* **사용자 이름**: 다음을 입력하세요. **사용자명** 1단계에서 Panther에 입력한
* **비밀번호**: 다음을 입력하세요. **비밀번호** 1단계에서 Panther에 입력한
5. 다음을 클릭합니다: **구성 추가**.
## 지원되는 로그 유형
### Docusign.Connect
봉투 상태 변경, 수신자 작업, 문서 워크플로 업데이트 등을 알리는 Docusign Connect 웹훅 이벤트.
참조: [Docusign Connect JSON SIM 이벤트 모델](https://developers.docusign.com/platform/webhooks/connect/json-sim-event-model/)
```yaml
schema: Docusign.Connect
description: 봉투 상태 변경, 수신자 작업, 문서 워크플로 업데이트 등을 알리는 Docusign Connect 웹훅 이벤트
referenceURL: https://developers.docusign.com/platform/webhooks/connect/json-sim-event-model
fields:
- name: event
required: true
description: 웹훅을 트리거한 이벤트 유형(예: recipient-sent, envelope-completed).
type: string
- name: uri
description: 봉투 리소스의 REST API URI.
type: string
- name: retryCount
description: 이 웹훅 전달에 대한 재시도 횟수.
type: string
- 이름: configurationId
description: 이 웹훅을 생성한 Connect 구성 ID.
type: string
- name: apiVersion
description: 이 이벤트에 사용된 Docusign API 버전.
type: string
- name: generatedDateTime
required: true
description: Docusign에서 이벤트가 생성된 시점.
type: timestamp
timeFormats:
- rfc3339
isEventTime: true
- name: data
required: true
description: 이벤트 정보를 포함하는 주요 이벤트 데이터.
type: object
fields:
- 이름: accountId
description: 보낸 사람의 계정을 식별하거나, Recipient Connect의 경우 수신자의 계정을 식별합니다.
type: string
표시자:
- trace_id
- name: userId
description: 이벤트와 관련된 사용자 ID
type: string
표시자:
- trace_id
- name: recipientId
description: 이 이벤트와 관련된 수신자 ID
type: string
표시자:
- trace_id
- name: envelopeId
description: 이벤트에 관련된 봉투를 식별합니다.
type: string
표시자:
- trace_id
- 이름: name
description: 관련 템플릿 이벤트의 이름 또는 봉투가 재할당된 사람의 이름.
type: string
- 이름: email
description: 봉투가 재할당된 사람의 이메일 주소.
type: string
표시자:
- 이메일
- name: routingOrder
description: 봉투가 재할당된 사람의 라우팅 순서.
type: string
- 이름: created
description: 템플릿이 생성/편집/삭제된 UTC 날짜 및 시간.
type: timestamp
timeFormats:
- rfc3339
- name: templateId
description: 생성/편집/삭제된 템플릿 ID.
type: string
표시자:
- trace_id
- name: clickwrapId
description: 동의되거나 거부된 elastic 템플릿을 식별합니다.
type: string
표시자:
- trace_id
- name: agreementId
description: elastic 템플릿 내의 계약을 식별합니다.
type: string
표시자:
- trace_id
```
## 사용자 지정 디택션 패턴
Docusign에 대한 사용자 지정 디택션을 작성할 때 다음과 같은 일반적인 패턴을 사용할 수 있습니다:
```python
# 특정 이벤트 유형 확인
event_type = event.get('event')
# 인증 실패 모니터링
if event_type == 'recipient-authentication-failure':
return True
# 봉투 무효화 모니터링(잠재적 사기 지표)
if event_type == 'envelope-voided':
return True
```
```python
# 봉투 및 발신자/수신자 데이터에 접근
envelope_id = deep_get(event, 'data', 'envelopeId')
account_id = deep_get(event, 'data', 'accountId')
```
## Docusign 로그 조회
Docusign 로그를 조회하려면 [Data Explorer](/ko/search/data-explorer.md):
```sql
-- 최근 Docusign 이벤트 보기
SELECT event, generatedDateTime, data:envelopeId, data:email
FROM panther_logs.docusign_connect
WHERE p_occurs_since('1 day')
ORDER BY p_event_time DESC;
-- 인증 실패 모니터링
SELECT *
FROM panther_logs.docusign_connect
WHERE event = 'recipient-authentication-failure'
AND p_occurs_since('7 days')
ORDER BY p_event_time DESC;
-- 봉투 상태 변경 추적
SELECT event, data:envelopeId, data:accountId, generatedDateTime
FROM panther_logs.docusign_connect
WHERE event LIKE 'envelope-%'
AND p_occurs_since('1 day')
ORDER BY generatedDateTime DESC;
```
---
# 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:
```
GET https://docs.panther.com/ko/data-onboarding/supported-logs/docusign.md?ask=
```
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.