amap-custodia

Última modificación por Administrator el 2019/11/04 12:19

amap-custodia 1.3.0 2019/04/07

  • Funcionalidad interna

amap-custodia 1.2.0 2019/02/12

  • Implementacion del mock

amap-custodia 1.1.0 2018/04/16

  • Adaptación a siaval 7.0.0

amap-custodia 1.0.1 2018/04/16

  • Mejoras internas

amap-custodia 1.0.0 2014/02/21

  • versión inicial del componente
<dependency>
<groupId>es.gobcantabria.amap.integracion</groupId>
<artifactId>amap-custodia</artifactId>
<version>1.3.0</version>
</dependency>

Es necesario de disponer de los datos:

  • URL de acceso al módulo de Custodia.
  • Usuario y password del módulo de Custodia.
  • Identificador de aplicación del módulo de Custodia: Solo para operaciones de custodiado, para las de recuperación de ficheros no es necesario.

Sin recursos disponibles.

Configuración

Configuración de la factoría de servicios

Para la utilización del componente AMAPCustodia basta con añadir el jar y sus correspondientes dependencias al classpath de la aplicación y crear un servicio del siguiente modo:

CustodiaService miservicio = CustodiaService.getServicio(implementation, url, user, password, verifySignatures);

El servicio concreto a usar se definirá a partir del fichero de properties junto con el resto de los parámetros:

KeyDescripciónEjemplo
sistemas.app.amap.custodia.implementacionImplementación de custodia a usar. Si no se indicara ninguna implementación en el fichero de propiedades, se usará la de sia.sia
sistemas.global.amap.custodia.urlEndpoint del servicio web de custodia.http://*****/tspCustody/Custody?WSDL
sistemas.app.amap.custodia.usuarioUsuario necesario para autenticarse en custodiaXXXXXXXX
sistemas.app.amap.custodia.passwordPassword necesaria para autenticarse en custodia*

Los valores de las propieades aquí mostrados son meramente ilustrativos. En los entornos de desarrollo / preproducción y producción los valores de las variables han de ser externalizados tal y como se especifica en el documento Definición de acceso a propiedades de sistema

Ejemplo de contenido del fichero de propiedades:

sistemas.app.amap.custodia.implementacion=sia
sistemas.global.amap.custodia.url=http://*****/tspCustody/Custody?WSDL
sistemas.app.amap.custodia.usuario=XXXXXXXX
sistemas.app.amap.custodia.password=*****

Implementación mock

Otra manera de invocar al servicio sería la implementación mock, la cual simula el servicio de custodia. Para crear el servicio se hace del siguiente modo:

CustodiaService miservicio = CustodiaService.getServicio(implementation, rutaTemporales, timesleepMin, timesleepMax, tasaError);
KeyDescripciónEjemplo
sistemas.app.amap.custodia.implementacionImplementación de custodia a usar. Si no se indicara ninguna implementación en el fichero de propiedades, se usará la del mock.mock
rutaTemporalesLugar en el que se almacenaran los archivos temporales.tmp/appName
timesleepMinTiempo mínimo de espera simulada en milisegundos10000
timesleepMaxTiempo máximo de espera simulada en milisegundos30000
tasaErrorTasa de probabilidad de error, valor entre 0 y 10050

Documento

Información binaria que se quiere custodiar mediante el módulo de custodia. Esta información será resellada periódicamente con un certificado válido para mantener su validez jurídica.

Firma

Información de autenticidad de un documento.

Tipo de firma


Mecanísmo de firmado utilizado para firmar un determinado documento.

Modo de firma (attached vs. detached)


Indica si se incluye dentro de la firma el documento original a firmar (attached) o solamente la firma (detached).

Nombreamap-custodia
Identificadoramap-custodia
Grupoes.gobcantabria.amap.integracion
Versión1.3.0
Licencia
DesarrolladorGobierno de Cantabria
Descripción

Componente de integración con el módulo de custodia de documentos corporativo.

Documentaciónamap-custodia (JavaDoc)
Binarioamap-custodia (Jar)

Sin particularidades. Seguir las recomendaciones del fabricante.

Ejemplos de uso

Custodiar

Obtener servicio

Antes de realizar cualquier operación de custodia se deberá obtener el servicio, tal y como se indica en la pestaña de configuración:


String url = "http://******/tspCustody/Custody?WSDL";
String user = "{}noRepudioDesarrollo";
String password = "******";

CustodiaService miservicio = CustodiaService.getServicio(Constantes.IMPLEMENTATION_SIA, url, user, password, true, true);

Custodiar documento "attached"

El método addDocumentoAttached del servicio permite la custodia de documentos firmados en modo "attached" (con el fichero original incluido) en la plataforma , para lo cual se necesita el contenido de la firma y el identificador de la aplicación dado de alta en la plataforma de custodia.


Documento documento = miservicio.addDocumentoAttached(filecontent, aplication);

Custodiar documento "detached"

El método addDocumentoDetached del servicio permite la custodia de documentos firmados en modo "detached" (con el fichero original NO incluido) en la plataforma , para lo cual se necesita el contenido del fichero original, contenido de la firma y el identificador de la aplicación dado de alta en la plataforma de custodia.


Documento documento = miservicio.addDocumentoDetached(filecontent, firma, aplication);

Custodiar documento en modo PDF

 

El método setDocumentoAttached del servicio permite la custodia de documentos firmados en modo "PDF" ( fichero PDF original incluido) en la plataforma , para lo cual se necesita el contenido de la firma y el identificador de la aplicación dado de alta en la plataforma de custodia.


Documento documento = miservicio.addDocumentoPDF(filecontent, aplication);

Información de la Custodia

Obtener documento custodiado

El método addDocumentoCustodiado del servicio permite la obtención de documentos custodiados en la plataforma, para lo cual se necesita su identificador de documento, el tipo de firma realizado (principalmente PDF, PKCS7 y PKCS7_DETACHED)


Documento documento = miservicio.getDocumentoCustodiado(idDocumento, Constantes.SIGNATURE_PKCS7_DETACHED, false);

© 2014 GOBIERNO DE CANTABRIA - AVISO LEGAL Y PROTECCIÓN DE DATOS