com.lacunasoftware.restpki

Class SignatureExplorer2

java.lang.Object

com.lacunasoftware.restpki.SignatureExplorer2

Direct Known Subclasses:

CadesSignatureExplorer2, PadesSignatureExplorer2, XmlSignatureExplorer

public abstract class SignatureExplorer2
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected SignaturePolicyCatalog	acceptableExplicitPolicies
protected RestPkiClient	client
protected java.lang.String	defaultSignaturePolicyId
protected boolean	ignoreRevocationStatusUnknown
protected java.lang.String	securityContextId
protected boolean	trustUncertifiedSigningTime
protected boolean	validate

Constructor Summary

Constructors

Constructor and Description
SignatureExplorer2(RestPkiClient client) Create a new instance using the given RestPkiClient.

Method Summary

Modifier and Type	Method and Description
protected com.lacunasoftware.restpki.OpenSignatureRequestModel	fillRequest(com.lacunasoftware.restpki.OpenSignatureRequestModel request)
SignaturePolicyCatalog	getAcceptableExplicitPolicies()
RestPkiClient	getClient()
java.lang.String	getDefaultSignaturePolicyId()
java.lang.String	getSecurityContextId()
com.lacunasoftware.restpki.FileRef	getSignatureFile()
boolean	isTrustUncertifiedSigningTime()
boolean	isValidate()
void	setAcceptableExplicitPolicies(SignaturePolicyCatalog policyCatalog) Sets the "catalog" of explicit policies that should be accepted when validating signatures with an explicit validation policy attribute.
void	setClient(RestPkiClient client)
void	setDefaultSignaturePolicy(SignaturePolicy signaturePolicy) Sets the default signature policy to be used to validate signatures.
void	setIgnoreRevocationStatusUnknown(boolean ignoreRevocationStatusUnknown) Sets the option of "IgnoreRevocationStatusUnknown".
void	setSecurityContext(SecurityContext securityContext) Sets the security context to be used to validate the signatures.
void	setSignatureFile(BlobReference fileBlob) Sets the signature to be signed from its blob reference
void	setSignatureFile(byte[] content) Sets the signature file to be opened.
void	setSignatureFile(FileResult fileResult) Sets the signature to be signed from a file result from a previous call to Rest PKI.
void	setSignatureFile(java.io.InputStream stream) Sets the PDF to be signed via a stream object
void	setSignatureFile(java.nio.file.Path path) Sets the file path of the signature file to be opened.
void	setSignatureFile(java.lang.String path) Sets the file path of the signature file to be opened.
void	setTrustUncertifiedSigningTime(boolean trustUncertifiedSigningTime)
void	setValidate(boolean validate) Sets whether the signature file should be validated or just opened.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

client

protected RestPkiClient client

validate

protected boolean validate

securityContextId

protected java.lang.String securityContextId

defaultSignaturePolicyId

protected java.lang.String defaultSignaturePolicyId

acceptableExplicitPolicies

protected SignaturePolicyCatalog acceptableExplicitPolicies

ignoreRevocationStatusUnknown

protected boolean ignoreRevocationStatusUnknown

trustUncertifiedSigningTime

protected boolean trustUncertifiedSigningTime

Constructor Detail

SignatureExplorer2

public SignatureExplorer2(RestPkiClient client)

Create a new instance using the given RestPkiClient.

Parameters:

client - the RestPkiClient which shall be used.

Method Detail

getSignatureFile

public com.lacunasoftware.restpki.FileRef getSignatureFile()

setSignatureFile

public void setSignatureFile(java.lang.String path)

Sets the file path of the signature file to be opened.

Parameters:

path - File path of the signature file to be signed.

setSignatureFile

public void setSignatureFile(java.nio.file.Path path)

Sets the file path of the signature file to be opened.

Parameters:

path - File path of the signature file to be opened.

setSignatureFile

public void setSignatureFile(java.io.InputStream stream)

Sets the PDF to be signed via a stream object

Parameters:

stream - a pre-opened InputStream linked to the PDF that will be signed. The stream is NOT closed by this method.

setSignatureFile

public void setSignatureFile(byte[] content)

Sets the signature file to be opened.

Parameters:

content - Binary content of the signature file.

setSignatureFile

public void setSignatureFile(BlobReference fileBlob)

Sets the signature to be signed from its blob reference

Parameters:

fileBlob - blob reference

setSignatureFile

public void setSignatureFile(FileResult fileResult)

Sets the signature to be signed from a file result from a previous call to Rest PKI.

Parameters:

fileResult - FileResult from previous call to Rest PKI.

isValidate

public boolean isValidate()

setValidate

public void setValidate(boolean validate)

Sets whether the signature file should be validated or just opened.

Parameters:

validate - Whether to validate the signature file or not.

getDefaultSignaturePolicyId

public java.lang.String getDefaultSignaturePolicyId()

setDefaultSignaturePolicy

public void setDefaultSignaturePolicy(SignaturePolicy signaturePolicy)

Sets the default signature policy to be used to validate signatures. This value is used to validate signatures without an explicit validation policy attribute and also signatures with an explicit validation policy attribute that is not among the policies specified in AcceptableExplicitPolicies. In order to accept only a certain list of explicit policies, this value should be omitted.

Parameters:

signaturePolicy - The default signature policy for validation. Depending on the policy, it might also be necessary to set a security context.

getAcceptableExplicitPolicies

public SignaturePolicyCatalog getAcceptableExplicitPolicies()

setAcceptableExplicitPolicies

public void setAcceptableExplicitPolicies(SignaturePolicyCatalog policyCatalog)

Sets the "catalog" of explicit policies that should be accepted when validating signatures with an explicit validation policy attribute. If a signature being validated has an explicit validation policy attribute which is not among the values passed, then the default signature policy is used (specified with the setDefaultSignaturePolicy method). In order to accept only the given catalog of explicit policies, don't set a default policy.

Parameters:

policyCatalog - The signature policy catalog (for instance, SignaturePolicyCatalog.getPkiBrazilCades() or SignaturePolicyCatalog.getPkiBrazilPades())

getSecurityContextId

public java.lang.String getSecurityContextId()

setSecurityContext

public void setSecurityContext(SecurityContext securityContext)

Sets the security context to be used to validate the signatures. Depending on the signature policies passed on the methods setAcceptableExplicitPolicies and setDefaultSignaturePolicy, this may be mandatory. If a signature policy does not require a security context to be set but one is nevertheless passed, the given security context overrides the one that would otherwise be inferred from the policy.

Parameters:

securityContext - The security context to be used to validate the signatures on the signature file.

getClient

public RestPkiClient getClient()

setClient

public void setClient(RestPkiClient client)

setIgnoreRevocationStatusUnknown

public void setIgnoreRevocationStatusUnknown(boolean ignoreRevocationStatusUnknown)

Sets the option of "IgnoreRevocationStatusUnknown".

Parameters:

ignoreRevocationStatusUnknown - The option of "IgnoreRevocationStatusUnknown".

isTrustUncertifiedSigningTime

public boolean isTrustUncertifiedSigningTime()

setTrustUncertifiedSigningTime

public void setTrustUncertifiedSigningTime(boolean trustUncertifiedSigningTime)

fillRequest

protected com.lacunasoftware.restpki.OpenSignatureRequestModel fillRequest(com.lacunasoftware.restpki.OpenSignatureRequestModel request)
                                                                    throws RestException,
                                                                           java.io.IOException

Throws:

RestException

java.io.IOException