Manual del desarrollador Servicio de Sello Electrónico y Compulsa Electrónica

Transcripción

1 Interoperabilidad de los servicios telemáticos de la Administración Pública de la CAC Página 1 de 25 Manual del desarrollador Servicio de Sello Electrónico y Compulsa Electrónica Rev. Fecha 0 09/06/10 Descripción 1 29/09/10 Se actualiza a la versión del servicio 2 11/11/10 Actualización de documentación para incorporar algoritmo para el código de seguridad de aplicación de compulsa y modificación de la respuesta del método de compulsa de documento (CU-SSECE-01) 3 21/11/13 Se actualiza a la versión del servicio 4 19/12/13 Se actualiza a la versión del servicio, con los métodos añadidos al servicio, orientados al trabajo con NDEs. Con los cambios realizados a la consola de compulsa se deshabilita la compulsa por parámetros mediante invocación a la misma. 5 20/03/14 Control de excepciones y cambios menores 6 26/08/14 Se añade soporte a la compulsa, sellado y verificación de sellado de firmas binarias, como CADES. 7 28/10/14 Se cambia el versionado a tipo OSGI. Documento : Ubicación en eroom: PLA-DOC-FIN SSECE-Manual del programador.odt Preparado por Revisado por Aprobado por OTP OTP

2 Servicio de Sello Electrónico y Compulsa Electrónica Página 2 de 25 Fecha: 28/10/2014 Fecha: 28/10/2014 Fecha:

3 Servicio de Sello Electrónico y Compulsa Electrónica Página 3 de 25 ÍNDICE 1 INTRODUCCIÓN VERSIÓN DEL SERVICIO CASOS DE USO CU-SSECE-01: COMPULSAR DOCUMENTO Compulsar documento Compulsar documento por NDE CU-SSECE-02: COMPULSAR DOCUMENTO DE FORMA AUTOMATIZADA Sellar documento Sellar documento por NDE CU-SSECE-03: VERIFICAR SELLO Verificar sello Verificar sello por NDE CU-SSECE-04: SELLAR DOCUMENTO Sellar documento Sellar documento por NDE INFORMACIÓN ADICIONAL CONTROL DE EXCEPCIONES SSECEEXCEPTION...24

4 Servicio de Sello Electrónico y Compulsa Electrónica Página 4 de 25 1 INTRODUCCIÓN El servicio de sello electrónico y compulsa electrónica tiene como objetivo posibilitar la tramitación electrónica integral de expedientes administrativos, incorporando a los sistemas informáticos de tramitación, imágenes electrónicas de los documentos en soporte papel, con plenas garantías jurídicas. Además, se pretende facilitar la generación de copias electrónicas a partir de documentos originales en formato papel, tal y como define el artículo 30 de la Ley 11/2007. El sello electrónico de órgano, basado en certificado electrónico, es un sistema de firma electrónica para la identificación y la autenticación de documentos en las actuaciones administrativas automatizadas. Además, mediante la firma electrónica del personal al servicio de la Administración Pública actuante, podrá realizarse la identificación y autenticación de documentos para la tramitación electrónica integral de expedientes administrativos. 2 VERSIÓN DEL SERVICIO Este documento corresponde a la versión de servicio. 3 CASOS DE USO A continuación de muestra el diagrama de casos de uso del Servicio de Sello Electrónico y Compulsa Electrónica:

5 Servicio de Sello Electrónico y Compulsa Electrónica Página 5 de CU-SSECE-01: COMPULSAR DOCUMENTO Compulsar documento Método para compulsar un documento. Se debe especificar el documento y la firma del sellado, así como la URI del usuario firmante. Añadir que desde la versión , la copia del documento compulsado a la Carpeta de Documentos Administrativos del Ciudadano se ha deshabilitado, aunque se mantienen los parámetros en la llamada por compatibilidad retroactiva con los clientes de versiones anteriores del servicio.

6 Servicio de Sello Electrónico y Compulsa Electrónica Página 6 de 25 Interfaz: Entrada del servicio: uridocumento URI que identifica al documento a compulsar en el repositorio de PLATINO. uriusuario URI que identifica al funcionario firmante. firma copiardocumentos uriciudadano Contenido de los datos firmados en formato XMLSignature o binario (para aquellos formatos como CADES). Indica si los documentos compulsados van a ser copiados a la Carpeta de Documentos Administrativos del Ciudadano. FUNCIONALIDAD DESHABILITADA URI que identifica al ciudadano propietario del documento de la compulsa. Se debe especificar en caso de que el parámetro copiardocumentos sea true. FUNCIONALIDAD DESHABILITADA bytes boolean

7 Servicio de Sello Electrónico y Compulsa Electrónica Página 7 de 25 EJEMPLO DE ENTRADA <ssec:compulsardocumento> <uridocumento>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumento> <uriusuario>platino://gobcan.es/servicios/organizacion/funcionario/ _dadee_ </uriusuario> <firma><![cdata[<?xml version="1.0" encoding="utf-8"?> <ds:signature xmlns:ds=" <ds:signedinfo> <ds:canonicalizationmethod Algorithm=" <ds:signaturemethod Algorithm=" <ds:reference URI=" <ds:digestmethod Algorithm=" <ds:digestvalue>ulcxydidetaaidrgus71d1spwus=</ds:digestvalue> </ds:reference> </ds:signedinfo> <ds:signaturevalue> OfQp7xUGb1Y5Ns+kj2ak+ConxqBvLriqXTsTHuV9V1PWcrtxF3JQSx1ZYkv6eg2X8Xf5SEC+RrWS N+G7bFwfJ8ucCCSNB0je8OxhL4QVrbtEKufQAOEwzIRYBCIIirzJgvuTTy9TCHk+z0w2CV9X5ckA 1IVDKli5ImxuO3wY3Ws= </ds:signaturevalue> <ds:keyinfo> <ds:x509data> <ds:x509issuerserial> <ds:x509issuername>cn=cibercentro,ou=dgti,o=gobierno de Canarias,ST=Canarias,C=ES, ADDRESS=cibercentro@gobiernodecanarias.org</ds:X509IssuerName> <ds:x509serialnumber> </ds:x509serialnumber> </ds:x509issuerserial> <ds:x509certificate> MIIEOTCCA+OgAwIBAgIKPkIRiAACAAALiDANBgkqhkiG9w0BAQUFADCBlzExMC8GCSqGSIb3DQEJ ARYiY2liZXJjZW50cm9AZ29iaWVybm9kZWNhbmFyaWFzLm9yZzELMAkGA1UEBhMCRVMxETAPBgNV BAgTCENhbmFyaWFzMR0wGwYDVQQKExRHb2JpZXJubyBkZSBDYW5hcmlhczENMAsGA1UECxMEREdU STEUMBIGA1UEAxMLY2liZXJjZW50cm8wHhcNMDcwNjEzMTExMzEyWhcNMDgwNjEzMTEyMzEyWjCB jtenmcugcsqgsib3dqejaryyanbhzhjvbkbvcgvuy2fuyxjpyxmuy29tmqswcqydvqqgewjfuzer MA8GA1UECBMIQ2FuYXJpYXMxHTAbBgNVBAoTFEdvYmllcm5vIGRlIENhbmFyaWFzMQ0wCwYDVQQL EwRER1RJMRQwEgYDVQQDEwtleHQtanBhZGxvcjCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA rg5o7i0pqnbkgdhlnpmkp9ptrjwjigwuh8likx7hlndaiectctpyskesvpm9kywnpeozud1yolor wv9cmx9nnrqgz8887w7nmz6iucebva+qea2mfy4p4kc5kdoohw/uaspjqxy7xumskqtcenddewyg +us07hd7qbpr+t273i8caweaaaocadmwgghpma4ga1uddweb/wqeawie8datbgnvhsueddakbggr BgEFBQcDAjAdBgNVHQ4EFgQU3N3sRosdglUOUrONw4IDQEOQzsEwgdMGA1UdIwSByzCByIAUcO0k rlnbkrzd4aibefxwoix1nxkhgz2kgzowgzcxmtavbgkqhkig9w0bcqewimnpymvyy2vudhjvqgdv Ymllcm5vZGVjYW5hcmlhcy5vcmcxCzAJBgNVBAYTAkVTMREwDwYDVQQIEwhDYW5hcmlhczEdMBsG

8 Servicio de Sello Electrónico y Compulsa Electrónica Página 8 de 25 A1UEChMUR29iaWVybm8gZGUgQ2FuYXJpYXMxDTALBgNVBAsTBERHVEkxFDASBgNVBAMTC2NpYmVy Y2VudHJvghAZZsd2bMJlrkCEiAcS60oDMFMGA1UdHwRMMEowSKBGoESGQmh0dHA6Ly9jb2dzd29y dgguz29iawvybm9kzwnhbmfyawfzlm9yzy9jzxj0zw5yb2xsl2npymvyy2vudhjvlmnybdbebggr BgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly9jb2dzd29ydGguZ29iaWVybm9kZWNhbmFy awfzlm9yzy9jzxj0zw5yb2xsl2npymvyy2vudhjvlmnyddanbgkqhkig9w0baqufaanbagk7mheb VTA/ygxmLwOyL551yzSjPIaujl3bc18d3Dy76+GCCKxw9OsjNs9Dr35uNggaovLzQaaZyulGVfPZ ++k= </ds:x509certificate> </ds:x509data> <ds:keyvalue> <ds:rsakeyvalue> <ds:modulus> rg5o7i0pqnbkgdhlnpmkp9ptrjwjigwuh8likx7hlndaiectctpyskesvpm9kywnpeozud1yolor wv9cmx9nnrqgz8887w7nmz6iucebva+qea2mfy4p4kc5kdoohw/uaspjqxy7xumskqtcenddewyg +us07hd7qbpr+t273i8= </ds:modulus> <ds:exponent>aqab</ds:exponent> </ds:rsakeyvalue> </ds:keyvalue> </ds:keyinfo> </ds:signature>]]></firma> <copiardocumentos>true</copiardocumentos> <uriciudadano>platino://gobcan.es/servicios/terceros/tercero/80965f0a-d de-4fa9b0ded07f2</uriciudadano> </ssec:compulsardocumento> Salida del servicio: No hay parámetros

9 Servicio de Sello Electrónico y Compulsa Electrónica Página 9 de 25 EJEMPLO DE SALIDA <ssec:compulsardocumentoresponse/> Compulsar documento por NDE Método para compulsar un documento. Se debe especificar el documento, mediante su NDE, y la firma del sellado, así como la URI del usuario firmante. Añadir que desde la versión , la copia del documento compulsado a la Carpeta de Documentos Administrativos del Ciudadano se ha deshabilitado, aunque se mantienen los parámetros en la llamada por compatibilidad retroactiva con los clientes de versiones anteriores del servicio. Interfaz: Entrada del servicio:

10 Servicio de Sello Electrónico y Compulsa Electrónica Página 10 de 25 NDE NDE que identifica al documento a compulsar en el repositorio de PLATINO. uriusuario URI que identifica al funcionario firmante. firma copiardocumentos Contenido de los datos firmados en formato XMLSignature o binaro (para aquellos formatos como CADES). Indica si los documentos compulsados van a ser copiados a la Carpeta de Documentos Administrativos del Ciudadano. bytes boolean uriciudadano URI que identifica al ciudadano propietario del documento de la compulsa. Se debe especificar en caso de que el parámetro copiardocumentos sea true. EJEMPLO DE ENTRADA

11 Servicio de Sello Electrónico y Compulsa Electrónica Página 11 de 25 <ssec:compulsardocumentonde> <NDE>0+q5NA/rWaV35BTr7vcDTO7kiWuBzQtC8</NDE> <uriusuario>platino://gobcan.es/servicios/organizacion/funcionario/ _dadee_ </uriusuario> <firma><![cdata[<?xml version="1.0" encoding="utf-8"?> <ds:signature xmlns:ds=" <ds:signedinfo> <ds:canonicalizationmethod Algorithm=" <ds:signaturemethod Algorithm=" <ds:reference URI=" <ds:digestmethod Algorithm=" <ds:digestvalue>ulcxydidetaaidrgus71d1spwus=</ds:digestvalue> </ds:reference> </ds:signedinfo> <ds:signaturevalue> OfQp7xUGb1Y5Ns+kj2ak+ConxqBvLriqXTsTHuV9V1PWcrtxF3JQSx1ZYkv6eg2X8Xf5SEC+RrWS N+G7bFwfJ8ucCCSNB0je8OxhL4QVrbtEKufQAOEwzIRYBCIIirzJgvuTTy9TCHk+z0w2CV9X5ckA 1IVDKli5ImxuO3wY3Ws= </ds:signaturevalue> <ds:keyinfo> <ds:x509data> <ds:x509issuerserial> <ds:x509issuername>cn=cibercentro,ou=dgti,o=gobierno de Canarias,ST=Canarias,C=ES, ADDRESS=cibercentro@gobiernodecanarias.org</ds:X509IssuerName> <ds:x509serialnumber> </ds:x509serialnumber> </ds:x509issuerserial> <ds:x509certificate> MIIEOTCCA+OgAwIBAgIKPkIRiAACAAALiDANBgkqhkiG9w0BAQUFADCBlzExMC8GCSqGSIb3DQEJ ARYiY2liZXJjZW50cm9AZ29iaWVybm9kZWNhbmFyaWFzLm9yZzELMAkGA1UEBhMCRVMxETAPBgNV BAgTCENhbmFyaWFzMR0wGwYDVQQKExRHb2JpZXJubyBkZSBDYW5hcmlhczENMAsGA1UECxMEREdU STEUMBIGA1UEAxMLY2liZXJjZW50cm8wHhcNMDcwNjEzMTExMzEyWhcNMDgwNjEzMTEyMzEyWjCB jtenmcugcsqgsib3dqejaryyanbhzhjvbkbvcgvuy2fuyxjpyxmuy29tmqswcqydvqqgewjfuzer MA8GA1UECBMIQ2FuYXJpYXMxHTAbBgNVBAoTFEdvYmllcm5vIGRlIENhbmFyaWFzMQ0wCwYDVQQL EwRER1RJMRQwEgYDVQQDEwtleHQtanBhZGxvcjCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA rg5o7i0pqnbkgdhlnpmkp9ptrjwjigwuh8likx7hlndaiectctpyskesvpm9kywnpeozud1yolor wv9cmx9nnrqgz8887w7nmz6iucebva+qea2mfy4p4kc5kdoohw/uaspjqxy7xumskqtcenddewyg +us07hd7qbpr+t273i8caweaaaocadmwgghpma4ga1uddweb/wqeawie8datbgnvhsueddakbggr BgEFBQcDAjAdBgNVHQ4EFgQU3N3sRosdglUOUrONw4IDQEOQzsEwgdMGA1UdIwSByzCByIAUcO0k rlnbkrzd4aibefxwoix1nxkhgz2kgzowgzcxmtavbgkqhkig9w0bcqewimnpymvyy2vudhjvqgdv Ymllcm5vZGVjYW5hcmlhcy5vcmcxCzAJBgNVBAYTAkVTMREwDwYDVQQIEwhDYW5hcmlhczEdMBsG A1UEChMUR29iaWVybm8gZGUgQ2FuYXJpYXMxDTALBgNVBAsTBERHVEkxFDASBgNVBAMTC2NpYmVy Y2VudHJvghAZZsd2bMJlrkCEiAcS60oDMFMGA1UdHwRMMEowSKBGoESGQmh0dHA6Ly9jb2dzd29y dgguz29iawvybm9kzwnhbmfyawfzlm9yzy9jzxj0zw5yb2xsl2npymvyy2vudhjvlmnybdbebggr

12 Servicio de Sello Electrónico y Compulsa Electrónica Página 12 de 25 BgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly9jb2dzd29ydGguZ29iaWVybm9kZWNhbmFy awfzlm9yzy9jzxj0zw5yb2xsl2npymvyy2vudhjvlmnyddanbgkqhkig9w0baqufaanbagk7mheb VTA/ygxmLwOyL551yzSjPIaujl3bc18d3Dy76+GCCKxw9OsjNs9Dr35uNggaovLzQaaZyulGVfPZ ++k= </ds:x509certificate> </ds:x509data> <ds:keyvalue> <ds:rsakeyvalue> <ds:modulus> rg5o7i0pqnbkgdhlnpmkp9ptrjwjigwuh8likx7hlndaiectctpyskesvpm9kywnpeozud1yolor wv9cmx9nnrqgz8887w7nmz6iucebva+qea2mfy4p4kc5kdoohw/uaspjqxy7xumskqtcenddewyg +us07hd7qbpr+t273i8= </ds:modulus> <ds:exponent>aqab</ds:exponent> </ds:rsakeyvalue> </ds:keyvalue> </ds:keyinfo> </ds:signature>]]></firma> <copiardocumentos>true</copiardocumentos> <uriciudadano>platino://gobcan.es/servicios/terceros/tercero/80965f0a-d de-4fa9b0ded07f2</uriciudadano> </ssec:compulsardocumentonde> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA

13 Servicio de Sello Electrónico y Compulsa Electrónica Página 13 de 25 <ssec:compulsardocumentonderesponse/> 3.2 CU-SSECE-02: COMPULSAR DOCUMENTO DE FORMA AUTOMATIZADA Sellar documento Método para aplicar un sello electrónico a un documento del repositorio. Se debe especificar la URI documento, el tipo de sello a aplicar (Compulsa) y el alias del certificado que se utilizará para firmar. El certificado debe estar almacenado en el servidor. Interfaz: Entrada del servicio: uridocumento URI que identifica al documento en el repositorio de PLATINO

14 Servicio de Sello Electrónico y Compulsa Electrónica Página 14 de 25 tiposellado Tipo de sellado a realizar (Compulsa). alias Alias del certificado, almacenado en el servidor, con el que se va firmar el documento. EJEMPLO DE ENTRADA <ssec:sellardocumento> <uridocumento>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumento> <tiposellado>compulsa</tiposellado> <alias>camerfirma</alias> </ssec:sellardocumento> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA <ssec:sellardocumentoresponse/>

15 Servicio de Sello Electrónico y Compulsa Electrónica Página 15 de Sellar documento por NDE Método para aplicar un sello electrónico a un documento del repositorio. Se debe especificar el NDE del documento, el tipo de sello a aplicar (Compulsa) y el alias del certificado que se utilizará para firmar. El certificado debe estar almacenado en el servidor. Interfaz: Entrada del servicio: NDE NDE que identifica al documento en el repositorio de PLATINO tiposellado Tipo de sellado a realizar (Compulsa). alias Alias del certificado, almacenado en el servidor, con el que se va firmar el documento. EJEMPLO DE ENTRADA

16 Servicio de Sello Electrónico y Compulsa Electrónica Página 16 de 25 <ssec:sellardocumentonde> <NDE>0+q5NA/rWaV35BTr7vcDTO7kiWuBzQtC8</NDE> <tiposellado>compulsa</tiposellado> <alias>camerfirma</alias> </ssec:sellardocumentonde> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA <ssec:sellardocumentonderesponse/>

17 Servicio de Sello Electrónico y Compulsa Electrónica Página 17 de CU-SSECE-03: VERIFICAR SELLO Verificar sello Método para verificar si a un documento se le ha aplicado un sello electrónico. En caso de que posea información de sellado se verifica si la firma en formato XMLSignature o binaria (para aquellos formatos como CADES), es válida. Interfaz: Entrada del servicio: uridocumento URI de PLATINO que identifica al documento al que se le quiere verificar su sellado. EJEMPLO DE ENTRADA <ssec:verificarsello> <uridocumento>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumento> </ssec:verificarsello> Salida del servicio:

18 Servicio de Sello Electrónico y Compulsa Electrónica Página 18 de 25 return Resultado de la verificación del sellado. boolean EJEMPLO DE SALIDA <ssec:verificarselloresponse> <return>true</return> </ssec:verificarselloresponse> Verificar sello por NDE Método para verificar si a un documento se le ha aplicado un sello electrónico. En caso de que posea información de sellado se verifica si la firma en formato XMLSignature o binaria (para aquellos formatos como CADES), es válida. Interfaz: Entrada del servicio:

19 Servicio de Sello Electrónico y Compulsa Electrónica Página 19 de 25 NDE NDE del documento dentro del repositorio documental que identifica al documento al que se le quiere verificar su sellado. EJEMPLO DE ENTRADA <ssec:verificarsellonde> <NDE>0+q5NA/rWaV35BTr7vcDTO7kiWuBzQtC8</NDE> </ssec:verificarsellonde> Salida del servicio: return Resultado de la verificación del sellado. boolean EJEMPLO DE SALIDA

20 Servicio de Sello Electrónico y Compulsa Electrónica Página 20 de 25 <ssec:verificarsellonderesponse> <return>true</return> </ssec:verificarsellonderesponse> 3.4 CU-SSECE-04: SELLAR DOCUMENTO Sellar documento Método para aplicar un sello electrónico a un documento del repositorio. Se debe especificar la URI documento, el tipo de sello a aplicar (Compulsa, Representación o Conformidad) y el alias del certificado que se utilizará para firmar. El certificado debe estar almacenado en el servidor. Interfaz: Entrada del servicio:

21 Servicio de Sello Electrónico y Compulsa Electrónica Página 21 de 25 uridocumento tiposellado alias URI que identifica al documento en el repositorio de PLATINO Tipo de sellado a realizar (Compulsa, Conformidad o Representación). Alias del certificado, almacenado en el servidor, con el que se va firmar el documento. EJEMPLO DE ENTRADA <ssec:sellardocumento> <uridocumento>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumento> <tiposellado>conformidad</tiposellado> <alias>camerfirma</alias> </ssec:sellardocumento> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA

22 Servicio de Sello Electrónico y Compulsa Electrónica Página 22 de 25 <ssec:sellardocumentoresponse/> Sellar documento por NDE Método para aplicar un sello electrónico a un documento del repositorio. Se debe especificar el NDE del documento, el tipo de sello a aplicar (Compulsa, Representación o Conformidad) y el alias del certificado que se utilizará para firmar. El certificado debe estar almacenado en el servidor. Interfaz: Entrada del servicio: NDE tiposellado NDE que identifica al documento en el repositorio de PLATINO Tipo de sellado a realizar (Compulsa, Conformidad o Representación).

23 Servicio de Sello Electrónico y Compulsa Electrónica Página 23 de 25 alias Alias del certificado, almacenado en el servidor, con el que se va firmar el documento. EJEMPLO DE ENTRADA <ssec:sellardocumentonde> <NDE>0+q5NA/rWaV35BTr7vcDTO7kiWuBzQtC8</NDE> <tiposellado>conformidad</tiposellado> <alias>camerfirma</alias> </ssec:sellardocumentonde> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA

24 Servicio de Sello Electrónico y Compulsa Electrónica Página 24 de 25 <ssec:sellardocumentonderesponse/> 4 INFORMACIÓN ADICIONAL 4.1 CONTROL DE EXCEPCIONES SSECEEXCEPTION

25 Servicio de Sello Electrónico y Compulsa Electrónica Página 25 de 25 message Descripción textual del error. String