de.uni_koblenz.aggrimm.icp.crypto.sign.algorithm

Interface SignatureAlgorithmInterface

All Known Implementing Classes:

SignatureAlgorithmCarroll2003, SignatureAlgorithmFisteus2010, SignatureAlgorithmSayers2004, SignatureAlgorithmTummarello2005

public interface SignatureAlgorithmInterface

This Interface specifies the methods which must be implemented by all signature algorithms.

Author:

Peter Schauß

Method Summary

Modifier and Type	Method and Description
void	assemble(GraphCollection gc, String signatureGraphName) Assembles a GraphCollection (add signature(s) and a signature graph).
void	canonicalize(GraphCollection gc) Canonicalizes a GraphCollection for a unique representation (commonly blank node removal/labeling and sorting).
String	getName() Gets the name of the signature algorithm (used for identification of the algorithm when signing/verifying)
void	hash(GraphCollection gc, String digestAlgo) Calculates the hash value of a GraphCollection and safes it in its SignatureData.
void	postCanonicalize(GraphCollection gc) Executes extra steps after the actual canonicalization of a GraphCollection
void	postHash(GraphCollection gc) Executes extra steps after the actual hash calculation of a GraphCollection
void	sign(GraphCollection gc, Key privateKey, String verficiationCertificate) Signs GraphCollection (calculate signature(s) using a certificate/key and the hash value(s)).
boolean	verify(GraphCollection gc, Key publicKey) Verifies a signed graph collection using a public key Involves canonicalization and hashing of the graph collection and a cryptographic signature check

Method Detail

canonicalize

void canonicalize(GraphCollection gc)
           throws Exception

Canonicalizes a GraphCollection for a unique representation (commonly blank node removal/labeling and sorting). Must set SignatureData.canonicalizationMethod of SignatureData.

Parameters:

gc - graphCollection which is canonicalized

Throws:

Exception

postCanonicalize

void postCanonicalize(GraphCollection gc)
               throws Exception

Executes extra steps after the actual canonicalization of a GraphCollection

Parameters:

gc - graphCollection which is canonicalized

Throws:

Exception

hash

void hash(GraphCollection gc,
          String digestAlgo)
   throws Exception

Calculates the hash value of a GraphCollection and safes it in its SignatureData. Must set SignatureData.graphDigestMethod and SignatureData.serializationMethod of SignatureData.

Parameters:

gc - graphCollection which is hashed

digestAlgo - string specifying a digest algorithm

Throws:

Exception

postHash

void postHash(GraphCollection gc)
       throws Exception

Executes extra steps after the actual hash calculation of a GraphCollection

Parameters:

gc - graphCollection which is hashed

Throws:

Exception

sign

void sign(GraphCollection gc,
          Key privateKey,
          String verficiationCertificate)
   throws Exception

Signs GraphCollection (calculate signature(s) using a certificate/key and the hash value(s)). Must set SignatureData.signatureMethod of SignatureData.

Parameters:

gc - graphCollection which is signed

privateKey - key used to calculate the signature

verficiationCertificate - string specifying the certificate which should be used for verification

Throws:

Exception

assemble

void assemble(GraphCollection gc,
              String signatureGraphName)
       throws Exception

Assembles a GraphCollection (add signature(s) and a signature graph).

Parameters:

gc - graphCollection which is assembled

signatureGraphName - string name for the signature graph

Throws:

Exception

verify

boolean verify(GraphCollection gc,
               Key publicKey)
        throws Exception

Verifies a signed graph collection using a public key Involves canonicalization and hashing of the graph collection and a cryptographic signature check

Parameters:

gc - graphCollection which will be verified

publicKey - key for the cryptographic signature check

Returns:

boolean true if verification succeeded, false otherwise

Throws:

Exception

getName

String getName()

Gets the name of the signature algorithm (used for identification of the algorithm when signing/verifying)

Returns:

string name of the algorithm