Package eu.europa.esig.dss.ws.server.signing.common

Interface RemoteSignatureTokenConnection

All Known Implementing Classes:

RemoteSignatureTokenConnectionImpl

public interface RemoteSignatureTokenConnection

The interface used for a remote signing

Method Summary

Modifier and Type	Method	Description
RemoteKeyEntry	getKey(String alias)	Retrieves a key by its alias
List<RemoteKeyEntry>	getKeys()	Retrieves all the available keys (private keys entries) from the token.
SignatureValueDTO	sign(ToBeSignedDTO toBeSigned, DigestAlgorithm digestAlgorithm, MaskGenerationFunction mgf, String alias)	Deprecated. since DSS 6.1.
SignatureValueDTO	sign(ToBeSignedDTO toBeSigned, DigestAlgorithm digestAlgorithm, String alias)	This method signs the toBeSigned data with the digest digestAlgorithm and the given alias.
SignatureValueDTO	sign(ToBeSignedDTO toBeSigned, SignatureAlgorithm signatureAlgorithm, String alias)	This method signs the toBeSigned data with the digest signatureAlgorithm and the given alias.
SignatureValueDTO	signDigest(DigestDTO digest, MaskGenerationFunction mgf, String alias)	Deprecated. since DSS 6.1.
SignatureValueDTO	signDigest(DigestDTO digest, SignatureAlgorithm signatureAlgorithm, String alias)	This method signs the digest data with a signatureAlgorithm and the given alias.
SignatureValueDTO	signDigest(DigestDTO digest, String alias)	This method signs the digest data with the given alias.

Method Details

getKeys

List<RemoteKeyEntry> getKeys()
                      throws DSSException

Retrieves all the available keys (private keys entries) from the token.

Returns:

List of encapsulated private keys

Throws:

DSSException - If there is any problem during the retrieval process

getKey

RemoteKeyEntry getKey(String alias)
               throws DSSException

Retrieves a key by its alias

Parameters:

alias - the key alias to retrieve

Returns:

the RemoteKeyEntry with the given alias

Throws:

DSSException

sign

SignatureValueDTO sign(ToBeSignedDTO toBeSigned,
 DigestAlgorithm digestAlgorithm,
 String alias)
                throws DSSException

This method signs the toBeSigned data with the digest digestAlgorithm and the given alias.

Parameters:

toBeSigned - The data that need to be signed

digestAlgorithm - The digest algorithm to be used before signing

alias - The key alias to be used

Returns:

The array of bytes representing the signature value

Throws:

DSSException - If there is any problem during the signature process

sign

@Deprecated
SignatureValueDTO sign(ToBeSignedDTO toBeSigned,
 DigestAlgorithm digestAlgorithm,
 MaskGenerationFunction mgf,
 String alias)
                throws DSSException

Deprecated.

since DSS 6.1. Please use #sign(toBeSigned, signatureAlgorithm, alias) method instead in order to specify the target algorithm with a mask generation function (i.e. RSA for none MGF, RSASSA-PSS for MGF1)

This method signs the toBeSigned data with the digest digestAlgorithm, the mask mgf and the given alias.

Parameters:

toBeSigned - The data that need to be signed

digestAlgorithm - The digest algorithm to be used before signing

mgf - the mask generation function

alias - The key alias to be used

Returns:

The array of bytes representing the signature value

Throws:

DSSException - If there is any problem during the signature process

sign

SignatureValueDTO sign(ToBeSignedDTO toBeSigned,
 SignatureAlgorithm signatureAlgorithm,
 String alias)
                throws DSSException

This method signs the toBeSigned data with the digest signatureAlgorithm and the given alias.

Parameters:

toBeSigned - The data that need to be signed

signatureAlgorithm - The signature algorithm to be used for signing

alias - The key alias to be used

Returns:

The array of bytes representing the signature value

Throws:

DSSException - If there is any problem during the signature process

signDigest

SignatureValueDTO signDigest(DigestDTO digest,
 String alias)
                      throws DSSException

This method signs the digest data with the given alias.

Parameters:

digest - The digested data that need to be signed

alias - The key alias to be used

Returns:

the signature value representation with the used algorithm and the binary value

Throws:

DSSException - If there is any problem during the signature process

signDigest

@Deprecated
SignatureValueDTO signDigest(DigestDTO digest,
 MaskGenerationFunction mgf,
 String alias)
                      throws DSSException

Deprecated.

since DSS 6.1. Please use #signDigest method instead in order to specify the target algorithm with a mask generation function (i.e. RSA for none MGF, RSASSA-PSS for MGF1)

This method signs the digest data with a mask mgf and the given alias.

Parameters:

digest - The digested data that need to be signed

mgf - the mask generation function

alias - The key alias to be used

Returns:

the signature value representation with the used algorithm and the binary value

Throws:

DSSException - If there is any problem during the signature process

signDigest

SignatureValueDTO signDigest(DigestDTO digest,
 SignatureAlgorithm signatureAlgorithm,
 String alias)
                      throws DSSException

This method signs the digest data with a signatureAlgorithm and the given alias.

Parameters:

digest - The digested data that need to be signed

signatureAlgorithm - The signature algorithm to be used for signing

alias - The key alias to be used

Returns:

the signature value representation with the used algorithm and the binary value

Throws:

DSSException - If there is any problem during the signature process