eSigner ドキュメント署名ゲートウェイガイド

SSLサポートチーム

1ヶ月前

　 eSigner ドキュメント署名ゲートウェイ APIはDockerイメージとして配布され、お客様の社内にインストールされます。次のアクションを実行します。

アプリケーションは、署名されていない PDF ドキュメントをドキュメント署名ゲートウェイ API に送信します。
ドキュメント署名ゲートウェイアプリケーションは PDF ハッシュを計算し、ハッシュ署名のために eSigner CSC API に送信します。
署名されたハッシュは、PDF ドキュメント署名操作の一部として PDF ドキュメント内に埋め込まれます。
署名された PDF ドキュメントには次の方法でタイムスタンプが付けられます。 SSL.com TSA
CRL ベースの証明書チェーンの失効が取得され、PDF ドキュメント内に埋め込まれ、LTV が有効になります。

要件

リクエスト：-

URL:-/v1/pdf/seal API にアクセスするには、有効なアクセストークンが必要です。アクセストークンを取得する方法に関するガイドは、次の記事にあります。 eSigner CSCAPIを使用したリモートドキュメント署名

{ "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": "" }

伝説：

credential_id – eSeal 証明書の必須の資格情報 ID。証明書の資格情報 ID を識別する方法については、このガイドを参照してください。 https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
ページ番号 – 目に見える署名の場合にのみ必要です。 0から始まります
signature_reason – オプションの署名理由
署名場所 – オプションの署名場所
連絡先情報 – オプションの連絡先情報
sig_field_position – 署名フィールドの位置の x、y、幅、高さ。目に見える署名の場合にのみ必要です
手書きの署名 – Base64 でエンコードされた PNG 手書き署名画像。目に見える署名の場合、および署名の外観の一部として手書きの署名を追加する場合にのみ必要です。
PDFファイル – 署名する Base64 エンコードされた PDF ドキュメント

応答：-

{ "signed_pdf": "" }

signed_pdf – Base64 でエンコードされた署名付き LTV 対応 PDF ドキュメント

インストール手順

ドキュメント署名ゲートウェイのリリースを解凍します。

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=trueserver.ssl.key-store: ./server.jksserver.ssl.key-password:secretserver.ssl.key-store-password:secret

Dockerfileを開く

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"]

Docker エンジンをインストールする あなたのマシン上で。その後、次のコマンドを使用して Docker イメージをビルドします。
```
docker build -t document_signing_gateway:1.0.0 。
```
次のコマンドを使用してコンテナを実行します。ボリュームも生まれます docker 署名ゲートウェイ API ログファイルとポートマッピングも同様です。
```
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
```
アプリケーションまたは POSTMAN ツールを使用して、ドキュメント署名ゲートウェイ API にアクセスします。

ドキュメント署名ゲートウェイのダウンロード