eSigner 문서 서명 게이트웨이 가이드

  eSigner 문서 서명 게이트웨이 API는 도커 이미지로 배포되어 고객 구내에 설치됩니다. 다음 작업을 수행합니다.

  • 애플리케이션은 서명되지 않은 PDF 문서를 문서 서명 게이트웨이 API로 보냅니다.
  • 문서 서명 게이트웨이 애플리케이션은 PDF 해시를 계산하고 해시 서명을 위해 eSigner CSC API로 보냅니다.
  • 그런 다음 서명된 해시는 PDF 문서 서명 작업의 일부로 PDF 문서 내에 포함됩니다.
  • 서명된 PDF 문서에는 다음을 사용하여 타임스탬프가 지정됩니다. SSL.com TSA
  • 인증서 체인의 CRL 기반 취소를 가져와서 PDF 문서에 삽입하여 LTV를 활성화합니다.

요구조건 니즈

요구:-

URL:- /v1/pdf/eseal API에 액세스하려면 유효한 액세스 토큰이 필요합니다. 액세스 토큰을 검색하는 방법에 대한 가이드는 다음 문서에서 찾을 수 있습니다. eSigner CSC API를 사용한 원격 문서 서명
{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "page_number": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field_position":{ " x": 160, "y":245, "너비":250, "높이": 150 }, "hand_signature": " ", "pdf": "" }

범례 :

  • 자격 증명_ID – eSeal 인증서의 필수 자격 증명 ID입니다. 인증서의 자격 증명 ID를 식별하는 방법을 알아보려면 다음 가이드를 참조하세요. https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
  • 페이지 번호 – 보이는 서명에만 필요합니다. 0부터 시작해요
  • 서명 이유 – 선택적 서명 이유
  • 서명_위치 – 선택적 서명 위치
  • 연락처 정보 – 선택적 연락처 정보
  • sig_field_position – 서명 필드 위치의 x, y, 너비 및 높이. 눈에 보이는 서명에만 필요합니다.
  • 손_서명 – Base64로 인코딩된 PNG 손 서명 이미지. 눈에 보이는 서명에만 필요하며 서명 표시의 일부로 손 서명을 추가해야 합니다.
  • PDF – 서명할 Base64로 인코딩된 PDF 문서

응답:-

{ "signed_pdf": "" }
  • signed_pdf – Base64로 인코딩된 서명된 LTV 지원 PDF 문서

설치 지침

  1. 문서 서명 게이트웨이 릴리스의 압축을 풉니다.
  2. application.properties 파일을 열고 그에 따라 변경하십시오.
    # 샌드박스 테스트의 경우 CSR URL은 https://cs-try.ssl.com이고 프로덕션에서는 https://cs.ssl.com으로 설정합니다. csc.url=https://cs-try.ssl.com # SSL.com의 URL TSA tsa.url=http://ts.ssl.com # docker 컨테이너의 포트 server.port=8081 # TLS 서버 인증서 설정. 자체 서명된 인증서 또는 개인용 인증서를 사용할 수 있습니다. PKI 또는 공개 PKI 인증서 server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: 비밀 server.ssl.key-store-password: 비밀
  3. 도커파일 열기
    FROM eclipse-temurin:17.0.9_9-jdk-jammy # 문서 서명 게이트웨이가 실행될 포트입니다. 이는 application.properties 파일과 동일해야 합니다. EXPOSE 8081 WORKDIR /app COPY document_signing_gateway-1.0.0.jar /app/ COPY application.properties /app/ COPY server.jks /app/ COPY GoNotoKurrent.ttf /app/ ENTRYPOINT [" java", "-Dspring.config.location=file:/app/application.properties", "-jar", "document_signing_gateway-1.0.0.jar"]
  4. 도커 엔진 설치 당신의 컴퓨터에. 그런 다음 다음 명령을 사용하여 Docker 이미지를 빌드합니다.
    docker build -t document_signing_gateway:1.0.0 .
  5. 다음 명령을 사용하여 컨테이너를 실행합니다. 또한 볼륨을 생성합니다. docker 서명 게이트웨이 API 로그 파일 및 포트 매핑도 제공됩니다.
    docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
  6. 애플리케이션이나 POSTMAN 도구를 사용하여 문서 서명 게이트웨이 API에 액세스하세요.

SSL.com의 뉴스 레터 구독

SSL.com의 새로운 기사 및 업데이트를 놓치지 마십시오

최신 정보를 얻고 보안을 유지하세요

SSL.com 사이버 보안 분야의 글로벌 리더입니다. PKI 그리고 디지털 인증서. 최신 업계 뉴스, 팁, 제품 공지 사항을 받아보려면 등록하세요. SSL.com.

우리는 귀하의 피드백을 환영합니다

설문조사에 참여하여 최근 구매에 대한 의견을 알려주세요.