com.logicaldoc.gui.frontend.client.services

Interface SignService

All Superinterfaces:

com.google.gwt.user.client.rpc.RemoteService

@RemoteServiceRelativePath(value="sign")
public interface SignService
extends com.google.gwt.user.client.rpc.RemoteService

The client side stub for the Sign Service. This service gives all needed methods to handle documents signature.

Since:

6.1

Author:

Matteo Caruso - Logical Objects

Method Summary

Methods

Modifier and Type	Method and Description
String[]	extractSubjectSignatures(String sid, long userId, Long docId, String fileVersion) Extracts the certificate subjects names from an uploaded .p7m file.
boolean	resetSignature(String sid, long userId) Reset from the user folder the signature file associated to the given user.
String	signDocument(String sid, long userId, long docId, String version) Verifies the user signature file, checks if the uploaded file's digest and the document's file digest are equals, then signs the document.
String	storeSignature(String sid, long userId, String signerName) Stores on the user folder the certificate file associated to the given signer name.

Method Detail

extractSubjectSignatures

String[] extractSubjectSignatures(String sid,
                                long userId,
                                Long docId,
                                String fileVersion)
                                  throws InvalidSessionException

Extracts the certificate subjects names from an uploaded .p7m file.

Parameters:

sid - The session identifier

userid - Identifier of the user that is saving the signature or that wants to retrieve the signers of a signed document to verify it.

docId - Id of signed document to verify (optional)

fileVersion - The file version of the document to verify (optional)

Returns:

Subjects names array.

Throws:

InvalidSessionException

storeSignature

String storeSignature(String sid,
                    long userId,
                    String signerName)
                      throws InvalidSessionException

Stores on the user folder the certificate file associated to the given signer name.

Parameters:

sid - The session identifier

userid - Identifier of the user that is saving the signature

signerName - The name of the certificate signer

Returns:

'ok' if no errors occurred, otherwise returns the error message.

Throws:

InvalidSessionException

signDocument

String signDocument(String sid,
                  long userId,
                  long docId,
                  String version)
                    throws InvalidSessionException

Verifies the user signature file, checks if the uploaded file's digest and the document's file digest are equals, then signs the document.

Parameters:

sid - The session identifier

userid - Identifier of the user that is performing the signature

docId - Identifier of the document to sign

version - The version of the given document that must be sugned (optional)

Returns:

'ok' if no errors occurred, otherwise returns the error message.

Throws:

InvalidSessionException

resetSignature

boolean resetSignature(String sid,
                     long userId)
                       throws InvalidSessionException

Reset from the user folder the signature file associated to the given user.

Parameters:

sid - The session identifier

userid - Identifier of the user for which will be reset the signature

Throws:

InvalidSessionException