메인 콘텐츠로 건너뛰기
전자 서명을 사용하면 사용자가 동일한 흐름 내에서 문서에 서명할 수 있습니다. 사용자는 각 문서를 확인하고, 서명, 이니셜 및 요청된 데이터를 입력하며, 고급(AES) 수준에서는 이전에 인증한 이메일 또는 전화번호로 전송된 일회용 코드로 확인합니다. Didit은 서명된 각 문서와 함께 누가 어떻게 서명했는지 기록된 증거 PDF를 반환합니다. 전자 서명에는 세 가지 수준이 있습니다. 단순은 기본값이며 신분증 인증, 이메일 또는 전화번호가 필요하지 않습니다. 고급(AES)은 승인된 신분증 인증과 인증된 이메일 또는 전화번호가 필요하며, 서명을 인증된 신원과 연결합니다. 적격(QES)은 아직 제공되지 않는 추가 기능입니다. 서명 수준을 참조하십시오. 이는 인증된 사람이 서명하는 사용자 인증(KYC)과 회사의 법적 대리인 또는 주요 인물이 회사를 대신하여 서명하는 기업 확인(KYB) 모두에서 작동합니다.

서명 수준

고급(AES)은 PAdES로만 서명합니다. AES에서는 signature_format 값인 xades 및 cades가 signature_format_not_supported와 함께 거부됩니다. AES 단계를 저장하기 전에 워크플로에서 signature_availability를 확인하십시오. aes가 false인 동안 새 단계를 저장하면 aes_not_available과 함께 400이 반환됩니다.

작동 방식

1

고급(AES)의 경우 워크플로에서 서명자를 먼저 확인합니다

고급(AES) 수준에서 서명 단계는 서명자가 누구인지 확인하는 단계인 신분증 인증과 코드가 전송될 연락처에 대한 이메일 또는 전화번호 인증 이후에 실행됩니다. 시작하기 전에를 참조하십시오. 단순 수준에는 선행 단계가 필요하지 않습니다.
2

Didit이 문서를 준비합니다

서명자가 해당 단계에 도달하면 Didit은 문서와 해당 필드를 세션으로 복사하고 각 문서의 SHA-256을 기록합니다. 이후 워크플로가 변경되어도 이 서명자에게 표시되는 내용은 변경되지 않습니다.
3

서명자가 각 문서를 확인합니다

필드가 있는 문서의 경우 서명자는 필드별로 안내를 받습니다. 서명자는 서명을 한 번 등록하고, 해당 서명이 모든 서명 및 이니셜 필드에 적용되며, 텍스트 및 체크박스 필드를 작성합니다. Didit이 인증된 신원, 세션 또는 고객 시스템에서 가져온 값은 이미 페이지에 입력되어 있습니다. 필드가 없는 문서의 경우 내용을 읽고 동의합니다.
4

고급(AES)의 경우 서명자가 코드로 확인합니다

문서에 필드가 있는 경우 서명자는 먼저 문서에 전자 서명하는 데 동의합니다. 고급(AES) 수준에서 Didit은 세션 앞부분에서 인증한 이메일 또는 전화번호로 6자리 코드를 전송하며, 이를 입력하면 해당 단계의 모든 문서에 대한 서명이 승인됩니다. 단순 수준에는 코드가 없으며, 동의하는 것으로 서명이 승인됩니다.
5

Didit이 서명하고 날인합니다

Didit은 서명 날짜를 입력하고, 모든 필드 값을 각 PDF에 삽입하고 증거 페이지를 추가합니다. 고급(AES) 수준에서는 PAdES 서명과 타임스탬프를 적용하여 서명이 페이지의 모든 내용을 포함하도록 합니다. 단순 수준에서는 파일이 증거 페이지가 포함된 PDF이며 디지털 서명, 전자 봉인 또는 타임스탬프가 없습니다.
6

결과를 수신합니다

결정 및 세션 webhook은 서명자, 확인 정보, 인증서, 타임스탬프, 각 문서의 해시 및 모든 필드 값이 포함된 signatures[]를 전달합니다. 서명된 PDF와 증거 PDF를 다운로드하며, Didit이 서명자에게 사본을 이메일로 전송할 수도 있습니다.

시작하기 전에

Advanced (AES) 수준에서는 서명자가 서명하기 전에 인증을 완료해야 합니다. Didit은 귀하나 서명자가 입력한 정보가 아닌, 세션 자체의 검증된 기록에서 서명자의 성명과 연락처를 가져옵니다. Simple 수준은 이러한 과정이 전혀 필요하지 않습니다. 즉 신분증 인증, 이메일, 전화번호 또는 코드가 없으며, KYB 서명자에게는 사용할 수 없습니다. 사용자 인증(KYC)의 경우, 워크플로에서 전자 서명 앞에 다음 단계를 배치하세요:
  • 신분증 인증, 승인된 상태이며 성명을 판독할 수 있어야 합니다. 이것이 없으면 해당 단계는 SIGNATURE_IDENTITY_NOT_VERIFIED를 기록합니다.
  • 코드를 이메일로 전송하는 경우(기본값) 이메일 인증, SMS로 전송하는 경우 전화번호 인증. 코드는 동일한 세션에서 인증된 연락처로만 전송됩니다.
  • 워크플로에 라이브니스 감지도 포함되어 있는 경우, 반드시 승인되어야 합니다.
서명자에게 서명된 문서의 사본을 이메일로 전송하려면 코드가 SMS로 전송되는 경우에도 세션에 인증된 이메일이 있어야 합니다. 기업 확인(KYB)의 경우 서명자는 회사의 주요 인물이며, 각자 승인된 자체 KYC가 있어야 합니다: KYB 단계에는 1명에서 20명 사이의 서명자가 참여하며, 각 서명자는 서명 시점까지 승인된 KYC를 보유해야 합니다. 각 서명자는 자신의 문서 사본에 서명하고 자체 KYC 세션에서 인증된 연락처로 전송된 코드로 확인합니다. 주요 인물에 대해 기재된 성명은 대소문자와 공백을 무시하고 인증된 성명과 일치해야 하며, 그렇지 않으면 해당 단계는 SIGNATURE_NAME_MISMATCH를 기록합니다. 모든 서명자가 서명하거나 거부하면 해당 단계가 완료됩니다.

문서

문서의 출처

signature_documents_source는 단계에서 문서를 가져올 출처를 설정합니다. 세션별 문서는 서명자의 이름, 금액 또는 조건이 시스템에 의해 이미 입력된 계약서에 서명하도록 하는 방법입니다.

지원되는 파일

Word 문서를 업로드하면 Didit은 업로드가 진행되는 동안 최대 60초 이내에 이를 PDF로 변환합니다. 변환된 페이지는 서명자가 보고 서명하는 내용이므로 필드를 배치하기 전에 확인하십시오. 줄 바꿈이 Word와 약간 다를 수 있습니다. Word 파일과 해당 PDF는 동일한 문서에 속하며 함께 삭제됩니다. 증적 PDF에는 변환 내역과 두 파일의 SHA-256이 기록됩니다. 서명될 내용이 모호한 경우, Didit은 signature_document_not_supported 및 reason과 함께 Word 파일을 거부합니다. 즉, 매크로(macros), 수락되지 않은 변경 내용 추적(tracked_changes), 외부 콘텐츠로의 링크(external_links) 또는 포함된 개체(embedded_objects)가 있는 경우입니다. PDF에 합의된 텍스트가 표시되도록 업로드하기 전에 변경 내용 추적을 수락하거나 거부하십시오. 변환할 수 없는 파일은 signature_document_conversion_failed 및 다음 사유 중 하나와 함께 거부됩니다.

문서의 필드

데스크톱 서명 도구에서 전자 봉투를 준비하는 것처럼, 필드는 문서를 서명자가 작성하는 템플릿으로 변환합니다. 필드가 없는 문서는 더 간단한 절차를 유지합니다. 서명자가 문서를 읽고 동의합니다. 현재 버전에는 날짜 선택기가 없습니다. 서명자가 입력하는 날짜에는 text 필드를 사용하십시오. 필드에는 다음 속성이 있습니다.
문서 하나당 최대 200개의 필드를 포함할 수 있으며, 서명자 한 명당 문서 전체에서 최대 500개까지 포함할 수 있습니다. 단계는 해당 서명자의 필드만 입력하고 날인합니다. 워크플로의 여러 서명(Signature) 단계에서 사용하는 경우에만 문서에 여러 역할에 대한 필드를 포함할 수 있습니다. 각 단계는 자체 역할의 필드를 작성하고 사본의 다른 필드는 비워 둡니다. 워크플로의 어떤 서명 단계에서도 사용하지 않는 역할의 필드는 role_not_used로 거부됩니다. 문서에 필드가 있는 모든 역할에는 signature 또는 initials 필드가 하나 이상 있어야 하며, 그렇지 않으면 워크플로 버전을 게시할 수 없습니다(signature_field_missing).

유효성 검사

validation은 text 필드에 적용됩니다:
  • kind: any, letters(모든 문자 체계의 문자, 공백, 하이픈, 아포스트로피), number(선택적 소수점 구분 기호가 포함된 숫자), email, 또는 pattern.
  • min_length: 0부터 max_length까지입니다.
  • max_length: 1부터 500까지입니다. 기본값은 120입니다.
  • pattern: kind: "pattern"인 경우 필수입니다. 전체 값이 일치해야 하는 최대 200자의 정규 표현식입니다. 전후방 탐색과 역참조는 지원되지 않습니다.
  • message: 기본 오류 대신 표시되는 최대 120자의 메시지입니다.
콘솔 미리보기, 서명 절차 및 API에 동일한 규칙이 적용됩니다.

사전 입력 값

prefill은 필드 값의 출처를 지정합니다: data 필드에는 반드시 prefill이 있어야 합니다. full_name 필드는 항상 identity.full_name을 사용하고 email 필드는 contact.email을 사용하며, text 필드에도 지정할 수 있습니다. data, full_name 및 인증된 email 필드의 값은 서명자가 서명을 시작할 때 고정되며, 이후 세션이 변경되어도 바뀌지 않습니다. 사전 입력된 text 또는 email 필드는 editable_when_prefilled를 설정하지 않는 한 읽기 전용입니다. 주소가 없는 세션과 같이 해당 시점에 필수 필드의 출처에 값이 없는 경우, 필드는 비어 있는 상태로 유지되며 서명자는 계속 서명할 수 있습니다. 경고는 발생하지 않으며, 보고서의 value_unavailable_reason에 이유가 표시됩니다.

콘솔에서 설정하기

  1. 워크플로우로 이동하여 워크플로를 열고, 서명자를 확인하는 단계 뒤에 전자 서명 단계를 추가합니다.
  2. 문서에서 업로드를 선택하여 PDF 또는 Word 파일을 추가하고, 서명자에게 표시되는 순서대로 드래그합니다. Word 파일은 PDF로 변환됩니다. 필드를 배치하기 전에 변환된 페이지를 확인하세요. 교체는 문서 파일을 교체하면서 필드를 유지하지만, 새 파일에 더 이상 없는 페이지의 필드는 제외됩니다.
  3. 문서에 필드 배치 아래에서 편집기 열기를 선택합니다. 팔레트에서 페이지로 필드를 드래그하거나 필드를 선택한 후 배치할 위치를 클릭한 다음, 이동하고 크기를 조정합니다. 각 필드에 대해 입력하는 사람, 레이블, 필수 여부, 허용되는 값, 값의 출처 및 API 키(해당 필드의 key)를 설정합니다. 서명자로 미리보기를 통해 모바일 기기나 데스크톱에서 서명자에게 표시되는 문서를 확인할 수 있습니다. 편집기는 작업 중 내용을 자동으로 저장하며(초안에 저장됨), 완료를 선택하기 전에 수정해야 할 사항을 목록으로 표시합니다.
  4. 계속해서 문서에서 문서의 출처를 선택합니다: 이 워크플로우, 각 세션 또는 둘 다. 필드가 없는 문서의 경우 서명자가 서명 전에 끝까지 읽기를 해야 하는지, 그리고 문서별 동의를 제공해야 하는지 선택합니다.
  5. 서명에서 서명자, 수준(기본값인 단순, 또는 고급(AES); 적격(QES)은 출시 예정으로 표시됨), 형식, 코드가 전송되는 위치(일회용 코드 수신 방법)를 선택합니다.
  6. 규칙에서 각 경고가 판정에 미치는 영향을 설정합니다.
  7. 고급에서 서명된 사본을 이메일로 보내기 및 증거 페이지 추가 여부와 서명 링크의 유효 기간(일수)을 선택합니다. 커스텀 상태 규칙을 추가할 수도 있습니다.
  8. 워크플로를 저장합니다.
API를 통해 동일한 단계를 구성하려면 Workflow feature configs를 참조하세요. 워크플로 문서 및 해당 필드는 콘솔에서 관리되며, API를 통해서는 세션당 문서와 필드를 전송합니다.

서명 환경

서명 단계는 호스팅 인증 페이지, Web SDK, 네이티브 SDK에서 데스크톱과 휴대폰에서 실행됩니다. 별도의 서명 UI를 구축할 필요가 없습니다.
  1. 소개. 서명자는 서명할 문서를 확인합니다.
  2. 각 문서별 순차 진행. 필드가 있는 문서의 경우 서명자는 position 순서에 따라 필드를 안내받습니다. 첫 번째 서명 또는 이니셜 필드에 도달하면 서명을 채택할 수 있는 시트가 열립니다. 선택 사항인 필드는 선택 사항으로 표시됩니다. Didit이 미리 채운 값은 페이지에 자물쇠 아이콘과 함께 표시되며 개별 입력 단계로 처리되지 않습니다. 페이지에서 필드를 탭하면 해당 필드로 바로 이동합니다. 휴대폰에서는 키보드 상단에 고정된 패널에 한 번에 하나의 필드가 표시됩니다. 너비가 1200px 이상인 화면에서는 페이지와 필드 목록이 나란히 표시됩니다. 필수 필드가 비어 있는 상태에서 문서 서명을 완료하려고 하면 남은 필드 수가 표시되고 첫 번째 미입력 필드로 이동합니다. 필드가 없는 문서는 구성한 설정에 따라 내용을 읽고 동의하게 됩니다.
  3. 검토. 서명자는 문서를 다시 검토하고, 문서에 필드가 포함되어 있는 경우 전자 서명하는 데 동의합니다.
  4. 코드(고급(AES) 전용). 서명자가 코드를 요청합니다. 코드는 5분 동안 유효하며, 60초 후에 새 코드를 전송할 수 있고, 서명자에게는 최대 5개의 코드와 3회의 잘못된 시도가 허용됩니다. 코드를 모두 사용하거나 잘못된 시도를 모두 소진하면 SIGNATURE_OTP_FAILED가 기록됩니다. 단순(Simple) 등급에서는 코드가 없으며, 서명자는 검토 단계에서 바로 서명으로 넘어갑니다.
  5. 서명 완료. 서명 후 서명자는 서명된 문서를 다운로드할 수 있습니다. 활성화한 경우 Didit에서 서명자에게 사본을 이메일로도 전송합니다.
  6. 거부. 서명자는 서명 대신 거부를 선택할 수 있습니다. 이 경우 SIGNATURE_DECLINED가 기록됩니다. 서명 링크가 유효한 동안에는 거부 상태를 다시 열 수 있으므로 마음이 바뀌면 여전히 서명할 수 있습니다.
플로우는 코드가 만료되었거나, 문서가 변경되었거나, 서명에 실패했거나, 서명 링크가 만료되었을 때 서명자에게 이를 알려줍니다. 서명 링크는 세션이 생성된 시점부터 계산하여 signature_link_validity_days(1~30, 기본값 7) 동안 유효하게 유지됩니다. 세션은 최소한 해당 기간 동안 열려 있습니다.
네이티브 SDK는 해당 단계가 추가된 릴리스부터 서명 단계를 표시하며, 배포 시 네이티브 SDK 개요에 기재됩니다. 필드가 있는 문서는 필드를 지원하는 릴리스가 필요합니다. 이전 릴리스에서는 필드를 표시할 수 없으며 해당 단계에서 오류가 표시됩니다. 필드가 없는 문서는 서명 단계가 포함된 모든 릴리스에서 작동합니다. 워크플로에서 사용하는 기능을 지원하는 릴리스를 앱에 적용하기 전까지는 사용자를 호스팅 페이지나 Web SDK로 안내하십시오.

서명 채택

서명자는 문서에서 서명 또는 이니셜을 처음 요구할 때 하나의 시트에서 서명과 이니셜을 한 번 채택합니다.
  • 입력: 서명자가 선택한 필기체 스타일로 표시되는 검증된 성명이며, ID에서 가져옴으로 표시됩니다. 다른 성명을 입력할 수 없습니다. 입력된 이니셜은 해당 성명의 첫 글자입니다.
  • 그리기: 서명과 이니셜 모두 손가락이나 마우스로 직접 그립니다.
이후의 모든 서명 또는 이니셜 필드는 탭 한 번으로 적용되며, 이미 적용된 서명 또는 이니셜을 탭하면 다시 제거됩니다.

결과

각 서명자의 결과는 세션 결정 및 세션 webhook의 decision 내 signatures[] 항목으로 제공됩니다. 별도의 서명 webhook은 없으며, 세션의 status.updated 이벤트를 통해 결정을 조회할 시점을 알 수 있습니다. 모든 문서의 서명된 PDF, 각 서명자별 증거 PDF, 모든 원본 및 서명된 파일의 SHA-256을 받아 나중에 아무것도 변경되지 않았음을 증명할 수 있습니다. 필드가 있는 문서의 경우 모든 필드 값, 데이터 출처, 작성 시점뿐만 아니라 채택된 서명 및 서명자가 전자 서명에 동의한 시점도 함께 제공됩니다. 모든 필드, 다운로드 및 서명 재검증 방법에 대한 자세한 내용은 전자 서명 보고서를 참고하십시오. 콘솔에서는 세션의 서명 탭에 문서가 표시된 후 각 페이지의 미리보기, 채택된 서명 및 이니셜, 모든 필드의 값, 시간, 출처가 포함된 필드 블록이 표시됩니다. PDF 보고서에는 서명 섹션이 포함되며 문서에 필드가 있는 경우 전자 서명 · 필드 페이지가 포함됩니다.

요금

전자 서명 비용은 서명된 세션당 $0.10이며, 단일 서명 건의 문서 수나 단순(Simple) 또는 고급(AES) 등급 여부와 관계없이 무료 크레딧에 포함됩니다. 거부되었거나 실패했거나 만료된 서명에는 비용이 청구되지 않습니다. 적격(QES)은 아직 제공되지 않는 애드온이며 가격이 책정되어 있지 않습니다.

서명 데이터 삭제

세션을 삭제하면 서명 데이터도 함께 삭제됩니다. 세션과 함께 전송된 문서 및 원본 Word 파일, 각 서명자용으로 준비된 사본, 서명된 PDF, 증거 PDF, 채택된 서명 및 이니셜 이미지, 모든 필드 값이 이에 해당합니다. 다운로드 링크는 작동을 멈춥니다. 데이터 보존 기간이 만료되어 세션이 삭제될 때도 동일하게 처리됩니다. 삭제는 취소할 수 없으므로 보관해야 할 항목이 있다면 먼저 다운로드하십시오.
  • 기업 확인(KYB)의 서명된 문서는 해당 기업의 세션에 속합니다. 해당 세션을 삭제하면 이 문서들도 함께 삭제됩니다.
  • 워크플로에서 문서를 제거하면 해당 문서와 필드, 원본 Word 파일이 삭제됩니다. 이미 서명을 시작한 서명자는 사용자가 해당 세션을 삭제할 때까지 세션의 일부로서 자신에게 표시된 사본을 계속 유지합니다. 서명 대기 중인 세션이 없는 워크플로에서만 문서를 제거하십시오.
  • Didit이 이미 서명자에게 이메일로 전송한 사본은 서명자의 메일함에 보관되며 영향을 받지 않습니다.

관련 문서

마지막 수정일 2026년 11월 7일