com.aspose.words

Constructor Detail

• PdfDigitalSignatureDetails

  public PdfDigitalSignatureDetails()

  Initializes an instance of this class.

  Example:

  Shows how to sign a generated PDF document.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Contents of signed PDF.");
  
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Configure the "DigitalSignatureDetails" object of the "SaveOptions" object to
  // digitally sign the document as we render it with the "Save" method.
  Date signingTime = new Date();
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", signingTime));
  options.getDigitalSignatureDetails().setHashAlgorithm(PdfDigitalSignatureHashAlgorithm.SHA_256);
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getReason(), "Test Signing");
  Assert.assertEquals(options.getDigitalSignatureDetails().getLocation(), "Aspose Office");
  Assert.assertEquals(options.getDigitalSignatureDetails().getSignatureDate(), signingTime);
  
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignature.pdf", options);

• PdfDigitalSignatureDetails

  public PdfDigitalSignatureDetails(CertificateHolder certificateHolder, java.lang.String reason, java.lang.String location, java.util.Date signatureDate)

  Initializes an instance of this class.

  Parameters:

  certificateHolder - A certificate holder which contains the certificate itself.

  reason - The reason for signing.

  location - The location of signing.

  signatureDate - The date and time of signing.

  Example:

  Shows how to sign a generated PDF document.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Contents of signed PDF.");
  
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Configure the "DigitalSignatureDetails" object of the "SaveOptions" object to
  // digitally sign the document as we render it with the "Save" method.
  Date signingTime = new Date();
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", signingTime));
  options.getDigitalSignatureDetails().setHashAlgorithm(PdfDigitalSignatureHashAlgorithm.SHA_256);
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getReason(), "Test Signing");
  Assert.assertEquals(options.getDigitalSignatureDetails().getLocation(), "Aspose Office");
  Assert.assertEquals(options.getDigitalSignatureDetails().getSignatureDate(), signingTime);
  
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignature.pdf", options);

Property Getters/Setters Detail

• getCertificateHolder/setCertificateHolder

  public CertificateHolder getCertificateHolder() / public void setCertificateHolder(CertificateHolder value)
  

  Returns the certificate holder object that contains the certificate was used to sign the document.

• getHashAlgorithm/setHashAlgorithm

  public int getHashAlgorithm() / public void setHashAlgorithm(int value)
  

  Gets or sets the hash algorithm. The value of the property is PdfDigitalSignatureHashAlgorithm integer constant.

  The default value is the SHA-512 algorithm.

  Example:

  Shows how to sign a generated PDF document.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Contents of signed PDF.");
  
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Configure the "DigitalSignatureDetails" object of the "SaveOptions" object to
  // digitally sign the document as we render it with the "Save" method.
  Date signingTime = new Date();
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", signingTime));
  options.getDigitalSignatureDetails().setHashAlgorithm(PdfDigitalSignatureHashAlgorithm.SHA_256);
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getReason(), "Test Signing");
  Assert.assertEquals(options.getDigitalSignatureDetails().getLocation(), "Aspose Office");
  Assert.assertEquals(options.getDigitalSignatureDetails().getSignatureDate(), signingTime);
  
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignature.pdf", options);

• getLocation/setLocation

  public java.lang.String getLocation() / public void setLocation(java.lang.String value)
  

  Gets or sets the location of the signing.

  The default value is null.

  Example:

  Shows how to sign a generated PDF document.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Contents of signed PDF.");
  
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Configure the "DigitalSignatureDetails" object of the "SaveOptions" object to
  // digitally sign the document as we render it with the "Save" method.
  Date signingTime = new Date();
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", signingTime));
  options.getDigitalSignatureDetails().setHashAlgorithm(PdfDigitalSignatureHashAlgorithm.SHA_256);
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getReason(), "Test Signing");
  Assert.assertEquals(options.getDigitalSignatureDetails().getLocation(), "Aspose Office");
  Assert.assertEquals(options.getDigitalSignatureDetails().getSignatureDate(), signingTime);
  
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignature.pdf", options);

• getReason/setReason

  public java.lang.String getReason() / public void setReason(java.lang.String value)
  

  Gets or sets the reason for the signing.

  The default value is null.

  Example:

  Shows how to sign a generated PDF document.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Contents of signed PDF.");
  
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Configure the "DigitalSignatureDetails" object of the "SaveOptions" object to
  // digitally sign the document as we render it with the "Save" method.
  Date signingTime = new Date();
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", signingTime));
  options.getDigitalSignatureDetails().setHashAlgorithm(PdfDigitalSignatureHashAlgorithm.SHA_256);
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getReason(), "Test Signing");
  Assert.assertEquals(options.getDigitalSignatureDetails().getLocation(), "Aspose Office");
  Assert.assertEquals(options.getDigitalSignatureDetails().getSignatureDate(), signingTime);
  
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignature.pdf", options);

• getSignatureDate/setSignatureDate

  public java.util.Date getSignatureDate() / public void setSignatureDate(java.util.Date value)
  

  Gets or sets the date of the signing.

  The default value is the current time.

  This value will appear in the digital signature as an unverified computer time.

  Example:

  Shows how to sign a generated PDF document.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Contents of signed PDF.");
  
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Configure the "DigitalSignatureDetails" object of the "SaveOptions" object to
  // digitally sign the document as we render it with the "Save" method.
  Date signingTime = new Date();
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", signingTime));
  options.getDigitalSignatureDetails().setHashAlgorithm(PdfDigitalSignatureHashAlgorithm.SHA_256);
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getReason(), "Test Signing");
  Assert.assertEquals(options.getDigitalSignatureDetails().getLocation(), "Aspose Office");
  Assert.assertEquals(options.getDigitalSignatureDetails().getSignatureDate(), signingTime);
  
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignature.pdf", options);

• getTimestampSettings/setTimestampSettings

  public PdfDigitalSignatureTimestampSettings getTimestampSettings() / public void setTimestampSettings(PdfDigitalSignatureTimestampSettings value)
  

  Gets or sets the digital signature timestamp settings.

  The default value is null and the digital signature will not be time-stamped. When this property is set to a valid PdfDigitalSignatureTimestampSettings object, then the digital signature in the PDF document will be time-stamped.

  Example:

  Shows how to sign a saved PDF document digitally and timestamp it.

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  builder.writeln("Signed PDF contents.");
  
  // Create a "PdfSaveOptions" object that we can pass to the document's "Save" method
  // to modify how that method converts the document to .PDF.
  PdfSaveOptions options = new PdfSaveOptions();
  
  // Create a digital signature, and assign it to our SaveOptions object to sign the document when we save it to PDF. 
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir() + "morzal.pfx", "aw");
  options.setDigitalSignatureDetails(new PdfDigitalSignatureDetails(certificateHolder, "Test Signing", "Aspose Office", new Date()));
  
  // Create a timestamp authority-verified timestamp.
  options.getDigitalSignatureDetails().setTimestampSettings(new PdfDigitalSignatureTimestampSettings("https://freetsa.org/tsr", "JohnDoe", "MyPassword"));
  
  // The default lifespan of the timestamp is 100 seconds.
  Assert.assertEquals(options.getDigitalSignatureDetails().getTimestampSettings().getTimeout(), 100000);
  
  // We can set our own timeout period via the constructor.
  options.getDigitalSignatureDetails().setTimestampSettings(new PdfDigitalSignatureTimestampSettings("https://freetsa.org/tsr", "JohnDoe", "MyPassword", (long) 30.0));
  
  Assert.assertEquals(options.getDigitalSignatureDetails().getTimestampSettings().getTimeout(), 30);
  Assert.assertEquals(options.getDigitalSignatureDetails().getTimestampSettings().getServerUrl(), "https://freetsa.org/tsr");
  Assert.assertEquals(options.getDigitalSignatureDetails().getTimestampSettings().getUserName(), "JohnDoe");
  Assert.assertEquals(options.getDigitalSignatureDetails().getTimestampSettings().getPassword(), "MyPassword");
  
  // The "Save" method will apply our signature to the output document at this time.
  doc.save(getArtifactsDir() + "PdfSaveOptions.PdfDigitalSignatureTimestamp.pdf", options);