com.telventi.multifirmamasiva
Interface MultiFirmaWebMasiva

All Superinterfaces:
javax.ejb.EJBObject, java.rmi.Remote

public interface MultiFirmaWebMasiva
extends javax.ejb.EJBObject

La interfaz MultiFirmaWebMasiva permite realizar un procedimiento de multifirma masiva por usuario. Adicionalmente proporciona unos métodos frecuentes de consulta de información sobre transacciones de firma realizadas del tipo mencionado.

En el proceso de multifirma masiva por usuario intervienen tres agentes:
- Usuario (cliente)
- Aplicación que utiliza la interfaz
- Plataforma de Firma (interfaz de multifirma).

Este proceso se puede describir como un procedimiento en 3 pasos:
1) Se registra la página que se va ha multifirmar en la Herramienta de Administración y se obtiene el identificador de transacción.
2) La aplicación solicita a la plataforma de Firma la generación de la pagina que se va ha multifirmar la cual incluye los datos a firmar, que serán enviados a la máquina del usuario para ser firmados. (método iniciarMultiFirmaMasiva).
3) El usuario firma los datos y la aplicación envía el resultado a la plataforma de Firma para terminar el proceso. (método finalizarMultiFirmaMasiva)


Method Summary
 boolean checkSign(java.lang.String transactionID)
          Método que comprueba si la firma de la transacción indicada es correcta.
 java.util.Vector checkSigns(java.util.Vector transactions)
          Método que comprueba todas las firmas indicadas en el Vector de entrada.
 void finalizarMultiFirmaMasiva(java.lang.String idTransaccionMultifirma, java.lang.String datosFirmados)
          Método que finalizar el proceso de multifirma masiva.
 java.lang.String getAppName(java.lang.String transactionID)
          Método que devuelve el nombre de la Aplicación.
 byte[] getASN1AR(java.lang.String transactionID)
          Deprecated.  
 byte[] getASN1EFE(java.lang.String transactionID)
          Deprecated.  
 java.lang.String getPageMode(java.lang.String transactionID)
          Método que devuelve el Modo de Página.
 byte[] getPKCS7(java.lang.String transactionID)
          Método que devuelve la firma de la transacción indicada.
 java.lang.String getSecName(java.lang.String transactionID)
          Método que devuelve el nombre de la Sección donde se guarda la configuración de la Aplicacion en la herramienta de Administración.
 DTOFirmante getSigner(java.lang.String transactionID)
          Método que devuelve un objeto DTOFirmate que contiene la información sobre la persona firmante de la transacción indicada.
 java.util.Vector getSigners(java.util.Vector transactions)
          Método que devuelve un Vector de objetos DTOFirmante que contienen información sobre los firmantes de las transacciones indicadas.
 java.util.Vector getTransactionIDs(java.lang.String transactionIDOriginal)
          Método que devuelve un Vector con todos los identificadores de transacciones de multifirma realizadas sobre la firma indicada.
 byte[] iniciarMultiFirmaMasiva(java.lang.String transactionIDOriginal)
          Método que inicializa el proceso de multifirma masiva, esta función requiere que ya exista una firma previa finalizada para que se pueda realizar la multifirma.
 
Methods inherited from interface javax.ejb.EJBObject
getEJBHome, getHandle, getPrimaryKey, isIdentical, remove
 

Method Detail

getPKCS7

public byte[] getPKCS7(java.lang.String transactionID)
                throws FirmaException,
                       java.rmi.RemoteException
Método que devuelve la firma de la transacción indicada.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
byte[] que contiene la firma en formato PKCS#7.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.

getASN1EFE

public byte[] getASN1EFE(java.lang.String transactionID)
                  throws FirmaException,
                         java.rmi.RemoteException
Deprecated.  

Método que devuelve un ASN1 con la Estructura de Firma Electronica.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
byte[] que contiene el ASN1 con la Estructura de Firma Electronica. o null si la transacción de firma no posee dicha estructura.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.

getASN1AR

public byte[] getASN1AR(java.lang.String transactionID)
                 throws FirmaException,
                        java.rmi.RemoteException
Deprecated.  

Método que devuelve un ASN1 con el Acuse de Recibo.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
byte[] que contiene el ASN1 con el Acuse de Recibo o null. si la transacción de firma no posee dicha estructura.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.

getPageMode

public java.lang.String getPageMode(java.lang.String transactionID)
                             throws FirmaException,
                                    java.rmi.RemoteException
Método que devuelve el Modo de Página.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
String Modo de Página, puede tomar los siguientes valores:

- 0: Servidor sin política de sellado de tiempo.
- 1: Servidor con política de sellado de tiempo.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota

getAppName

public java.lang.String getAppName(java.lang.String transactionID)
                            throws FirmaException,
                                   java.rmi.RemoteException
Método que devuelve el nombre de la Aplicación.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
String Nombre de la Aplicación.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.

getSecName

public java.lang.String getSecName(java.lang.String transactionID)
                            throws FirmaException,
                                   java.rmi.RemoteException
Método que devuelve el nombre de la Sección donde se guarda la configuración de la Aplicacion en la herramienta de Administración.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
String Nombre de la Sección.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.

getSigners

public java.util.Vector getSigners(java.util.Vector transactions)
                            throws FirmaException,
                                   java.rmi.RemoteException
Método que devuelve un Vector de objetos DTOFirmante que contienen información sobre los firmantes de las transacciones indicadas.

Parameters:
transactions - Vector con identificadores de transacciones de las que se quiere obtener la información de los firmantes. Como máximo puede tener 20 elementos.
Returns:
Vector de objetos DTOFirmante, uno para cada identificador de transacción.
Throws:
FirmaException - Indica un error en el proceso de recuperación. o que se han pasado más de 20 indentificadores.
java.rmi.RemoteException - fallo en la comunicación remota.
See Also:
DTOFirmante

getSigner

public DTOFirmante getSigner(java.lang.String transactionID)
                      throws FirmaException,
                             java.rmi.RemoteException
Método que devuelve un objeto DTOFirmate que contiene la información sobre la persona firmante de la transacción indicada.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
DTOFirmante con información sobre la persona firmante.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.
See Also:
DTOFirmante

checkSign

public boolean checkSign(java.lang.String transactionID)
                  throws FirmaException,
                         java.rmi.RemoteException
Método que comprueba si la firma de la transacción indicada es correcta. Nota: este método es muy costoso en tiempo y recursos.

Parameters:
transactionID - identificador de la transación de firma.
Returns:
boolean Devuelve true si la firma es correcta o false en caso contrario.
Throws:
FirmaException - Indica un error en el proceso de verificación.
java.rmi.RemoteException - fallo en la comunicación remota.

checkSigns

public java.util.Vector checkSigns(java.util.Vector transactions)
                            throws FirmaException,
                                   java.rmi.RemoteException
Método que comprueba todas las firmas indicadas en el Vector de entrada. Nota: este método es muy costoso en tiempo y recursos.

Parameters:
transactions - Vector con identificadores de transacciones de las que se quiere comprobar la firma. Como máximo puede tener 20 elementos.
Returns:
Vector con los identificadores de las transacciones cuya comprobación. ha fallado. Vacio en el caso que de todas las firmas sean correctas.
Throws:
FirmaException - Indica un error en el proceso de verificación. o que se han pasado más de 20 indentificadores.
java.rmi.RemoteException - fallo en la comunicación remota.

iniciarMultiFirmaMasiva

public byte[] iniciarMultiFirmaMasiva(java.lang.String transactionIDOriginal)
                               throws FirmaException,
                                      java.rmi.RemoteException
Método que inicializa el proceso de multifirma masiva, esta función requiere que ya exista una firma previa finalizada para que se pueda realizar la multifirma.

Parameters:
transactionIDOriginal - Transacción de firma sobre la cual realizar la multifirma.
Returns:
byte[] que contiene la pagina que se va ha Multifirmar con la informacion necesaria.
Throws:
FirmaException - Indica un error en el proceso de Firma.
java.rmi.RemoteException - Error de comunicación.

finalizarMultiFirmaMasiva

public void finalizarMultiFirmaMasiva(java.lang.String idTransaccionMultifirma,
                                      java.lang.String datosFirmados)
                               throws FirmaException,
                                      java.rmi.RemoteException
Método que finalizar el proceso de multifirma masiva.

Parameters:
idTransaccionMultifirma - Identificador de la sesión de firma. Este parámetro se obtiene del dto devuelto del método iniciarMultiFirmaMasiva.
datosFirmados - Datos devueltos por el activex/applet.
Throws:
FirmaException - Indica un error en el proceso de Firma.
java.rmi.RemoteException - Error de comunicación.

getTransactionIDs

public java.util.Vector getTransactionIDs(java.lang.String transactionIDOriginal)
                                   throws FirmaException,
                                          java.rmi.RemoteException
Método que devuelve un Vector con todos los identificadores de transacciones de multifirma realizadas sobre la firma indicada.

Parameters:
transactionIDOriginal - identificador de la transacción original de una multifirma masiva.
Returns:
Vector de identificadores de transacciones.
Throws:
FirmaException - Indica un error en el proceso de recuperación.
java.rmi.RemoteException - fallo en la comunicación remota.