Dropbox Sign에서 마스킹된 데이터를 가져와 조회하는 방법

업데이트된 날짜 Aug 18, 2026

In this article

person icon

이 문서의 정보는 Dropbox Sign Premium 요금제를 사용 중인 관리자에게 적용됩니다.

입력란 마스킹 기능을 사용해 민감한 서명자 정보를 숨길 수 있습니다. API 대시보드에서 표시되는 콜백 이벤트에서 마스킹된 모든 입력란 정보는 숨겨지고 별표(예: *****)로 대체되어 표시됩니다. 이 문서에서는 이러한 마스킹된 데이터를 가져와 조회하는 방법을 설명합니다.

마스킹된 데이터를 조회하는 방법

마스킹된 데이터를 조회하는 방법에는 세 가지가 있습니다.

문서 데이터를 CSV로 다운로드 
문서 데이터를 CSV로 다운로드하면, 마스킹된 필드를 포함한 모든 필드의 값과 함께 서명 요청에 대한 정보가 포함된 Excel 시트가 전송됩니다. 문서를 CSV로 다운로드하는 방법을 알아보세요.
highlighter icon

참고: 기본적으로 관리자만 문서 데이터를 CSV로 다운로드할 수 있습니다. 하지만 관리자는 발신자가 문서 데이터를 CSV로 다운로드할 수 있도록 허용할 수 있습니다.

서명 가져오기(Get Signature) 엔드포인트로 요청 실행

서명 가져오기 요청(Get Signature Request) 엔드포인트에 대한 요청을 실행하면 마스킹되지 않은 값이 포함된 응답 객체가 반환됩니다. 이용 방법:

  1. app.sign.dropbox.com에 로그인합니다.
  2. 서명 가져오기 요청 엔드포인트 페이지로 이동합니다.
  3. 페이지 상단에서 사용해 보기를 클릭합니다.
  4. 보안에서 API 키를 입력합니다.
  5. 매개변수를 클릭합니다.
  6. 마스킹된 필드가 있는 서명 요청의 signature_request_id 를 입력합니다.
  7. 보내기를 클릭합니다.
highlighter icon

참고: 마스킹된 데이터가 있는 필드에는 해당 원래 값이 문서에서 마스킹되었음을 나타내는 "masked":true가 포함됩니다.

콜백 응답 객체 보기

계정에 설정된 콜백 URL에 보고하는 콜백 이벤트 응답 객체에서 마스킹된 필드의 마스킹되지 않은 값을 볼 수 있습니다. 이 옵션을 사용하면 워크플로 내에서 정보를 처리할 수 있습니다.

highlighter icon

참고:

  • 콜백 응답 객체에서 마스킹된 값을 받도록 기본 설정하려면 이 지침에 따라 Dropbox 지원팀에 요청을 제출하세요. 
  • 콜백 이벤트에 대한 자세한 내용은 이벤트 및 콜백 가이드를 참조하세요.

API 대시보드에서 마스킹된 데이터 조회하기(예시)

다음은 API 대시보드에 게시된 콜백 이벤트의 응답 본문으로, 데이터가 별표로 마스킹되어 있습니다.

- "": "*********"

{
"event": {
"event_type":"signature_request_signed",
"event_time":"1609432599",
"event_hash":"5118da82b71d394887382d21e2488ae7a029d7ab",
"event_metadata": {
"related_signature_id":"d91adbb59792d036264057",
"reported_for_account_id":"f0899a9b5354b22b6cc6b301",
"reported_for_app_id":"d8754524aaa29c3025bd3"
      }
  },
"account_guid":"f0899a9b5354b24263252b6cc6b301",
"client_id":"d8754524aaa6129c3025bd3",
"signature_request": {
"signature_request_id":"aaf05626ad486775234c3e4043",
"test_mode": true,
"title":"test masked SSN",
"original_title":"masked SSN",
"subject":"masked SSN",
"message": null,
"metadata": {
"signed_on_domain":"localhost"
  },
"created_at": 1609432502,
"is_complete": false,
"is_declined": false,
"has_error": false,
"custom_fields":[],
"response_data":[{
"name":"Signature1",
"type":"signature",
"required": true,
"api_id":"97f86e0633f7",
"value": null,
"signature_id":"d91adbb597920fcd036264057"
          },
          {
"name":"Masked SSN Field",
"type":"text",
"required": true,
"api_id":"acf4bb6fd352",
"value":"*********",
"signature_id":"d91adbb59792fcd036264057"
          }
      ],
"signing_url": null,
"signing_redirect_url": null,
"final_copy_uri":"/v3/signature_request/final_copy/aaf05626a1fafa35234c3e4043",
"files_url":"https://api.hellosign.com/v3/signature_request/files/aaf05626ad486775234c3e4043",
"details_url":"https://app.hellosign.com/home/manage?guid=aaf05626ad486775234c3e4043",
"requester_email_address":"jack@example.com",
"signatures":[{
"signature_id":"d91adbb5979d036264057",
"has_pin": false,
"has_sms_auth": false,
"signer_email_address":"jill@example.com",
"signer_name":"Jill",
"signer_role": 1,
"order": null,
"status_code":"signed",
"signed_at": 1609432599,
"last_viewed_at": 1609432578,
"last_reminded_at": null,
"error": null
   }],
"cc_email_addresses":[],
"template_ids": [
"7b3d2693ad423a39a2dd104"
      ],
"client_id":"d8754524aaa6129c3025bd3"
  }
} 

다음은 관련 signature_request_id를 사용하여 서명 가져오기 요청 엔드포인트를 실행한 후의 응답 본문입니다. 이렇게 하면 마스킹된 데이터가 노출됩니다.

- "": "123-45-6789"

{
"signature_request": {
"signature_request_id": "aaf05626ad486775234c3e4043",
"test_mode": true,
"title": "test masked SSN",
"original_title": "masked SSN",
"subject": "masked SSN",
"message": null,
"metadata": {
"signed_on_domain": "localhost"
},
"created_at": 1609432502,
"is_complete": true,
"is_declined": false,
"has_error": false,
"custom_fields": [ ],
"response_data": [{
"name": "Signature1",
"type": "signature",
"required": true,
"api_id": "97f86e0633f7",
"value": null,
"signature_id": "d91adbb597920fcd036264057"
},
{
"name": "Masked SSN Field",
"type": "text",
"required": true,
"api_id": "e2b418c6-2498-44af-b73f-acf4bb6fd352",
"value": "123-45-6789",
"signature_id": "d91adbb59792fcd036264057"
"masked": true
}
],
"signing_url": null,
"signing_redirect_url": null,
"final_copy_uri": "/v3/signature_request/final_copy/aaf05626a1fafa35234c3e4043",
"files_url": "https://api.hellosign.com/v3/signature_request/files/aaf05626a1fafa35234c3e4043",
"details_url": "https://app.hellosign.com/home/manage?guid=aaf05626a1fafa35234c3e4043",
"requester_email_address": "hazem.hamed@hellosign.com",
"signatures": [{
"signature_id": "d91adbb5979d036264057",
"has_pin": false,
"has_sms_auth": false,
"signer_email_address": "jhondoe1@test.com",
"signer_name": "John Doe",
"signer_role": 1,
"order": null,
"status_code": "signed",
"signed_at": 1609432599,
"last_viewed_at": 1609432578,
"last_reminded_at": null,
"error": null
}],
"cc_email_addresses": [],
"template_ids": [
"7b3d2693ad423a39a2dd104"
],
"client_id": "d8754524aaa6129c3025bd3"
}
}
이 글이 도움이 되셨나요?

문제가 해결되지 않은 이유를 알려주세요.

Dropbox에 알려주셔서 감사합니다!

의견을 보내 주셔서 감사합니다!

도움을 받을 수 있는 기타 방법