A Gateway de assinatura de documentos eSigner A API é distribuída como uma imagem docker e instalada nas instalações do cliente. Ele executa as seguintes ações:
- O aplicativo envia o documento PDF não assinado para a API do gateway de assinatura de documentos
- O aplicativo gateway de assinatura de documentos calcula o hash do PDF e envia para a API eSigner CSC para assinatura de hash
- O hash assinado é então incorporado ao documento PDF como parte da operação de assinatura do documento PDF
- O documento PDF assinado tem carimbo de data/hora usando SSL.com TSA
- A revogação da cadeia de certificados baseada em CRL é buscada e incorporada dentro do documento PDF para torná-lo habilitado para LTV
Requisitos
Solicitar:-
URL:- /v1/pdf/seal
Um token de acesso válido é necessário para acessar a API. Um guia sobre como recuperar o token de acesso pode ser encontrado neste artigo: Assinatura remota de documentos com 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, "largura":250, "altura": 150 }, "hand_signature": " ", "pdf": "" }
Legenda:
- credencial_id – ID da credencial obrigatória do certificado eSeal. Para saber como identificar o ID da credencial do seu certificado, consulte este guia: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- número de página – Necessário apenas para assinaturas visíveis. Começa com 0
- motivo_assinatura – Motivo de assinatura opcional
- local_de_assinatura – Local de assinatura opcional
- contato_info – Informações de contato opcionais
- sig_field_position – x, y, largura e altura da posição do campo de assinatura. Só é necessário para assinaturas visíveis
- assinatura_de_mão – Imagem de assinatura manual PNG codificada em Base64. É necessário apenas para assinaturas visíveis e para adicionar assinatura manual como parte da aparência da assinatura
- pdf – Documento PDF codificado em Base64 para assinar
Resposta:-
{ "signed_pdf": "" }
- assinado_pdf – Documento PDF habilitado para LTV, codificado em Base64
Instruções de instalação
- Descompacte a versão do gateway de assinatura de documentos
- Abra os arquivos application.properties e altere de acordo
# Para testes de sandbox, defina o CSR URL para https://cs-try.ssl.com e para produção defina-o como https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL do SSL.com TSA tsa.url=http://ts.ssl.com # Porta no contêiner docker server.port=8081 # TLS configurações de certificado do servidor. Pode-se usar certificado autoassinado ou privado PKI ou público PKI certificado server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: secreto server.ssl.key-store-password: secret
-
Abra o Dockerfile
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Porta na qual o gateway de assinatura de documentos será executado. Deve ser o mesmo que no arquivo 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=arquivo:/app/application.properties", "-jar", "document_signing_gateway-1.0.0.jar"]
- Instale o Docker Engine em sua máquina. Depois, crie a imagem docker usando o seguinte comando:
docker build -t document_signing_gateway:1.0.0.
- Execute o contêiner usando o seguinte comando. Também cria volume para arquivo de log da API do gateway de assinatura do docker e mapeamento de portas também.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Acesse a API do gateway de assinatura de documentos usando um aplicativo ou ferramenta POSTMAN.
