Docusign 로그(베타)

Panther는 Docusign Connect webhook 이벤트 수집을 지원합니다

개요

Docusign 로그 통합은 Panther 버전 1.115부터 오픈 베타로 제공되며 모든 고객이 사용할 수 있습니다. 버그 보고서와 기능 요청은 Panther 지원팀에 공유하세요.

Panther는 다음을 수집하는 것을 지원합니다 Docusign HTTP를 통해 웹훅 이벤트를 연결합니다. Docusign Connect 특정 전자서명 워크플로우에서 이벤트가 발생할 때 Panther와 같은 외부 애플리케이션에 알림을 보내는 웹훅을 구성할 수 있습니다.

Docusign Connect 웹훅은 봉투(전송, 배달, 완료 또는 무효화), 수신자, 템플릿, 신원 확인 등 다양한 엔터티에 대한 실시간 알림을 제공할 수 있습니다. 전체 사용 가능한 이벤트 트리거 목록은 여기를 참조하세요.

Panther에서 Docusign 로그 통합을 사용하면 다음을 할 수 있습니다:

• 무단 액세스 및 사기 탐지: 인증 실패 시도, 의심스러운 수신자 행동, 비정상적인 서명 패턴 및 예기치 않은 봉투 수정 사항을 추적합니다

• 템플릿 보안 모니터링: 문서 템플릿의 생성, 수정 또는 삭제를 모니터링합니다

• 계정 활동 모니터링: 관리 작업 및 구성 변경을 추적합니다

보안 모니터링에 일반적으로 사용되는 Docusign 이벤트 트리거

다음 이벤트 트리거 는 보안 모니터링에 일반적으로 사용됩니다:

• recipient-authentication-failure: 인증 실패

• envelope-voided: 봉투 취소(잠재적 사기)

• envelope-corrected: 문서 수정(잠재적 변조)

• template-created, template-modified, template-deleted: 템플릿 변경

• recipient-declined: 문서 거부

Docusign 로그를 Panther에 온보딩하는 방법

전제 조건

• Docusign Connect 웹훅을 구성하려면 Docusign 계정에서 관리자 권한이 필요합니다. 자세한 내용은 Docusign Connect 문서 을 참조하세요.

1단계: Panther에서 새 Docusign 소스 생성

1. Panther 콘솔의 왼쪽 탐색 창에서 구성 > 로그 소스.

2. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 새로 만들기.

3. "Docusign"을 검색한 다음 타일을 클릭하세요.

4. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 설정 시작.

   
5. Panther의 HTTP 소스 구성에 대한 지침을 따르세요5단계부터 시작하여.

   • 설정 중에, 인증 방법항목에 대해 다음 중 하나를 사용해야 합니다 기본 인증 이전에 생성한 Snowflake 사용자 이름, 예를 들면 HMAC.

     • 을(를) 선택하면 HMAC에 대해 헤더 이름입력하세요 X-Docusign-Signature-1. Connect 웹훅에 HMAC 사용에 대해 자세히 알아보려면 여기를 참조하세요.

   • 구성한 인증 정보를 저장하세요. 다음 단계에서 Docusign에 웹훅을 설정할 때 필요합니다.

   • 이 소스로 전송된 페이로드는 다음의 적용을 받습니다 모든 HTTP 소스에 대한 페이로드 요구사항.

   • HTTP 엔드포인트 생성이 완료될 때까지 다음 단계로 진행하지 마세요.

2단계: Docusign Connect 웹훅 구성

아래 단계를 따라 Docusign Connect 웹훅을 구성하세요. 이 과정에서 추가 지원이 필요하면 Docusign의 Connect 구성 생성 문서.

1. 관리자로 Docusign 계정에 로그인하세요.

2. 탐색 표시줄에서 통합 > 연결.

3. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 구성 추가 > 사용자 지정.

4. 다음 웹훅 Connect 필드를 구성하세요:

   • 이름: 설명적인 이름을 입력하세요. 예: Panther 보안 통합.

   • 게시할 URL: Panther에서 이전 단계에서 생성한 HTTP 소스 URL 1단계에서 Panther에서 생성한 값입니다.

   • 트리거 이벤트: 다음 이벤트 트리거 모니터링하려는 항목입니다.

     • 데이터 포함: 각 범주에 대해 Panther로 전송되는 이벤트에 포함되기를 원하는 필드를 선택하세요. 이러한 필드에 대해서는 이 Docusign 문서.

다음을 위해 봉투 와 수신자 이벤트의 경우, 다음을 그대로 두는 것이 권장됩니다 문서 와 첨부파일 선택 해제합니다. 이는 페이로드 크기를 줄여 이벤트 전송 지연 가능성을 방지하는 데 도움이 됩니다. 자세한 내용은 여기에서 eSignature API를 통해 문서를 검색하는 방법을 참조하세요.

• HMAC 서명 포함: 1단계에서 Panther에 HMAC 인증을 사용한 경우 이 옵션을 선택하세요.

  • 일반 구성 1. 필드에 HMAC 헤더 이름 1단계에서 Panther에 입력한 값을 입력하세요. Docusign은 이 값을 X-Docusign-Signature-1 헤더와 연관되어 전송합니다.

  • 자세한 내용은 Docusign Connect에서 HMAC 보안 사용 문서를 참조하세요.

  

  • 기본 인증 헤더 포함: 1단계에서 Panther에 기본 인증을 사용한 경우 이 옵션을 선택하세요.

• 사용자 이름: Panther에서 이전 단계에서 생성한 사용자 이름 1단계에서 Panther에 입력한 값입니다.

• 비밀번호: Panther에서 이전 단계에서 생성한 비밀번호 1단계에서 Panther에 입력한 값입니다.

1. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 구성 추가.

지원되는 로그 유형

Docusign.Connect

봉투 상태 변경, 수신자 작업, 문서 워크플로우 업데이트 등에 대해 알리는 Docusign Connect 웹훅 이벤트입니다.

참고: Docusign Connect JSON SIM 이벤트 모델

스키마: Docusign.Connect
설명: 봉투 상태 변경, 수신자 작업 및 문서 워크플로우 업데이트에 대해 알리는 Docusign Connect 웹훅 이벤트
참고 URL: https://developers.docusign.com/platform/webhooks/connect/json-sim-event-model
필드:
  - name: event
    required: true
    설명: 웹훅을 트리거한 이벤트 유형(예: recipient-sent, envelope-completed).
    type: string
  - name: uri
    설명: 봉투 리소스에 대한 REST API URI입니다.
    type: string
  - name: retryCount
    설명: 이 웹훅 전송에 대한 재시도 횟수입니다.
    type: string
  - name: configurationId
    설명: 이 웹훅을 생성한 Connect 구성 ID입니다.
    type: string
  - name: apiVersion
    설명: 이 이벤트에 사용된 Docusign API 버전입니다.
    type: string
  - name: generatedDateTime
    required: true
    설명: Docusign에서 이벤트가 생성된 시점입니다.
    type: timestamp
    timeFormats:
      - rfc3339
    isEventTime: true
  - name: data
    required: true
    설명: 이벤트 정보를 포함하는 주요 이벤트 데이터입니다.
    type: object
    필드:
      - 이름: accountId
        설명: 발신자의 계정을 식별하거나 Recipient Connect의 경우 수신자의 계정을 식별합니다.
        type: string
        지표:
          - trace_id
      - name: userId
        설명: 이벤트와 관련된 사용자 ID입니다
        type: string
        지표:
          - trace_id
      - name: recipientId
        설명: 이 이벤트와 관련된 수신자 ID입니다
        type: string
        지표:
          - trace_id
      - name: envelopeId
        설명: 이벤트에 관련된 봉투를 식별합니다.
        type: string
        지표:
          - trace_id
      - 이름: name
        설명: 관련 템플릿 이벤트의 이름 또는 봉투가 재할당된 사람의 이름입니다.
        type: string
      - 이름: email
        설명: 봉투가 재할당된 사람의 이메일 주소입니다.
        type: string
        지표:
          - 이메일
      - name: routingOrder
        설명: 봉투가 재할당된 사람의 라우팅 순서입니다.
        type: string
      - 이름: created
        설명: 템플릿이 생성/편집/삭제된 UTC 날짜 및 시간입니다.
        type: timestamp
        timeFormats:
          - rfc3339
      - name: templateId
        설명: 생성/편집/삭제된 템플릿 ID입니다.
        type: string
        지표:
          - trace_id
      - name: clickwrapId
        설명: 동의되거나 거부된 탄력적(elastic) 템플릿을 식별합니다.
        type: string
        지표:
          - trace_id
      - name: agreementId
        설명: 탄력적 템플릿 내의 합의를 식별합니다.
        type: string
        지표:
          - trace_id

사용자 정의 디텍션 패턴

Docusign용 사용자 정의 디텍션을 작성할 때 다음의 일반 패턴을 사용할 수 있습니다:

# 특정 이벤트 유형 확인
event_type = event.get('event')

# 인증 실패 모니터링
if event_type == 'recipient-authentication-failure':
    return True
    
# 봉투 무효화 모니터링(잠재적 사기 지표)  
if event_type == 'envelope-voided':
    return True

# 봉투 및 발신자/수신자 데이터 접근
envelope_id = deep_get(event, 'data', 'envelopeId')
account_id = deep_get(event, 'data', 'accountId')

Docusign 로그 쿼리

에서 Docusign 로그를 쿼리하려면 panther_monitor:

-- 최근 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;