개요

Document Cloud eSign 서비스 문서 API는 별도의 eSign 서비스 관리 등록 프로세스를 거치지 않아도 기존의 응용 프로그램에 원활하게 통합되도록 설계되어 있습니다. 따라서 상위 응용 프로그램은 전송자가 등록된 eSign 서비스 사용자임을 확인할 책임이 있습니다. 그렇지 않을 경우 API를 통해 전송자를 프로그래밍 방식으로 등록합니다. 수신자는 등록하도록 요구받지 않으며, eSign 서비스는 항상 수신자 측에서 필요한 상호 작용만 관리합니다.

문서 전송자 지정

sendDocument 메서드로 새 트랜잭션을 시작할 때 전송자를 지정하는 몇 가지 방법이 있습니다. 그 동작은 선택적 SenderInfo 매개 변수를 통해 전달되는 값에 따라 달라집니다.

  • Null SenderInfo: 이 경우 문서의 전송자는 사용되는 API 키와 연결된 특정 고유 사용자입니다. 이 메서드는 테스트 및 제한된 범위의 특정 구현에 적합하지만, 일반적으로 기존 사용자 집합과의 대규모 통합에는 유용하지 않습니다.
  • 전자 메일암호를 사용하는 SenderInfo: 이 경우 문서의 전송자는 전자 메일 매개 변수에서 지정하는 사용자입니다. 제공된 암호는 사용자의 EchoSign 암호와 일치해야 합니다. 통합을 목적으로 할 경우, 전자 메일과 암호는 문서가 전송되려고 할 때 상위 응용 프로그램의 컨텍스트 내에서 사용자로부터 구할 수 있습니다. 또는 상위 응용 프로그램이 사용자를 생성했거나, 사용자가 이전에 전자 메일 주소와 암호를 제공해서 캐시되어 있기 때문에 상위 응용 프로그램이 해당 정보를 기억하고 있을 수 있습니다.
  • 전자 메일만 사용하고 암호는 사용하지 않는 SenderInfo: 이 경우 문서의 전송자는 전자 메일 매개 변수에서 지정하는 사용자입니다. 암호 값은 null이어야 합니다. EchoSign에서는 API 호출자와 의도했던 전송자가 동일한 계정에 속하는지는 확인하지만 암호를 요구하거나 확인하지는 않습니다. 이 방법은 특정 조직 내에서 API 통합에 적합한 경우도 있지만 개별 보안성은 줄어듭니다. 이 인증 모델은 EchoSign API를 통해 사용할 수 있도록 마스터 계정 보유자에 의해 명시적으로 요청받아야 합니다.

eSign 서비스 계정 관리

위에서 간략하게 설명했듯이, 대부분의 경우 자신이 대신해서 문서를 보내는 사용자의 전자 메일과 암호를 제공해야 합니다. 다음 섹션에서는 이러한 정보를 얻을 수 있는 다양한 방법에 대해 설명합니다.

사용자에게 확인

사용자에게 전송 프로세스의 일부로서 eSign 서비스 전자 메일과 암호를 묻는 메시지를 표시합니다. verifyUser 메서드를 사용하여 사용자가 eSign 서비스에 등록되어 있는지 여부와 암호가 올바른지 여부를 확인할 수 있습니다. 사용자가 등록되어 있지 않다면, 사용자에게 eSign 서비스 계정을 만들라고 요구하거나 사용자 계정을 만들 수 있습니다(아래 참조).

계정 만들기

verifyUser를 호출하여 해당 전자 메일 주소로 존재하는 사용자가 없는 것으로 나타나면 createUser를 호출하여 프로그래밍 방식으로 eSign 서비스 사용자를 생성할 수 있습니다. 사용자를 성공적으로 생성했다고 가정하면 이제 입력한 전자 메일과 암호를 문서에 대한 SenderInfo로 사용할 수 있습니다.

계정 기억

위의 시나리오 중 하나를 수행한 후 사용자의 전자 메일과 암호를 기억했다가 해당 사용자를 대신하여 후속 문서를 보내는 데 SenderInfo로 사용할 수 있습니다. 실제로 사용자가 eSign 서비스 계정에 로그인하고 언제든지 암호를 변경할 수 있으므로 응용 프로그램에서는 이전에 저장한 암호가 올바르지 않은 경우를 처리할 수 있어야 합니다.

결론

eSign 서비스 문서 API를 사용할 때 전송자 ID를 확인하는 방법은 많습니다. 위의 정보를 주의 깊게 읽고 응용 프로그램에 적합한 방법을 결정하십시오. 질문이 있으면, 주저하지 말고 Adobe에 문의하십시오.

이 작업에는 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License의 라이센스가 부여되었습니다.  Twitter™ 및 Facebook 게시물은 Creative Commons 약관을 적용받지 않습니다.

법적 고지 사항   |   온라인 개인 정보 보호 정책