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

Transcripción

1 Interoperabilidad de los servicios telemáticos de la Administración Pública de la CAC Página 1 de 21 Manual del desarrollador Servicio de Sello Electrónico y Copia 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. 8 30/03/15 Se publican las nuevas interfaces del servicio 9 28/04/15 Reutilización del metadato tipo de sello a estado elaboración y adaptación del servicio 10 30/06/15 Se adapta el proceso de copia para documentos proporcionados por una administración externa /01/16 Permitir marcar un documento como original auténtico a través de un sellado y migración a sfst2

2 Servicio de Sello Electrónico y Copia Electrónica Página 2 de 21 Documento : PLA-DOC-FIN SSECE-Manual del programador.odt Ubicación en eroom: Preparado por Revisado por Aprobado por OTP OTP Fecha: 26/01/2016 Fecha: 26/01/2016 Fecha:

3 Servicio de Sello Electrónico y Copia Electrónica Página 3 de 21 ÍNDICE 1 INTRODUCCIÓN VERSIÓN DEL SERVICIO CASOS DE USO CU-SSECE-01: COPIAR DOCUMENTO Copiar documento Copiar documento por NDE CU-SSECE-03: SELLAR DOCUMENTO Sellar documento Sellar documento por NDE CU-SSECE-02: VERIFICAR SELLO Verificar sello Verificar sello por NDE INFORMACIÓN ADICIONAL CONTROL DE EXCEPCIONES SSECEEXCEPTION...21

4 Servicio de Sello Electrónico y Copia Electrónica Página 4 de 21 1 INTRODUCCIÓN El servicio de sello electrónico y copia 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. En esta nueva versión del servicio se modifica el caso de uso 3.2 CU-SSECE-03 asociado al sellado de documentos. Se eliminan dos parámetros innecesarios. Es obligatorio su regeneración si utiliza dicho método. 3 CASOS DE USO A continuación de muestra el diagrama de casos de uso del Servicio de Sello Electrónico y Copia Electrónica:

5 Servicio de Sello Electrónico y Copia Electrónica Página 5 de CU-SSECE-01: COPIAR DOCUMENTO Copiar documento Método para copiar un documento. Se debe especificar el tipo de copia, el identificador del documento padre en caso que sea obligatorio, el identificador del documento y la firma de la copia. Cuando el docucumento proviene de una administración externa, no se incluye el cálculo de la uri del tercero ni el cargo que desempeña. Se calcula la uri del firmante a través de la firma de sellado. 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 Copia Electrónica Página 6 de 21 Interfaz: Entrada del servicio: tipocopia uridocumentopadre Tipo de copia que se realiza. Los valores permitidos son: EE02, Copia electrónica auténtica con cambio de formato (Ley 11/2007 art. 30.1) EE03, Copia electrónica auténtica de documento papel (Ley 11/2007 art y 30.3) EE04, Copia electrónica parcial auténtica. EE05, Copia compulsada EE06, Copia simple URI que identifica al documento padre del documento a copiar en el repositorio de PLATINO. Es un dato obligatorio en el caso de que el tipocopia sea EE02 o EE04. uridocumento URI que identifica al documento a copiar en el repositorio de PLATINO. firma Contenido de los datos firmados en formato bytes

7 Servicio de Sello Electrónico y Copia Electrónica Página 7 de 21 XMLSignature o binario (para aquellos formatos como CADES). copiardocumentos uriciudadano 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 copia. Se debe especificar en caso de que el parámetro copiardocumentos sea true. FUNCIONALIDAD DESHABILITADA boolean EJEMPLO DE ENTRADA <ssec:copiardocumento> <tipocopia>ee05</tipocopia> <uridocumentopadre>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumentopadre> <uridocumento>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumento> <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>

8 Servicio de Sello Electrónico y Copia Electrónica Página 8 de 21 <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 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:copiardocumento>

9 Servicio de Sello Electrónico y Copia Electrónica Página 9 de 21 Salida del servicio: No hay parámetros EJEMPLO DE SALIDA <ssec:copiardocumentoresponse/> Copiar documento por NDE Método para copiar un documento. Se debe especificar el tipo de copia, el identificador del documento padre mediante su NDE, en caso que sea obligatorio, el identificador del documento mediante su NDE y la firma de la copia. Cuando el docucumento proviene de una administración externa, no se incluye el cálculo de la uri del tercero ni el cargo que desempeña. Se calcula la uri del firmante a través de la firma de sellado. 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:

10 Servicio de Sello Electrónico y Copia Electrónica Página 10 de 21 Entrada del servicio: tipocopia NDEDocumentoPadr e Tipo de copia que se realiza. Los valores permitidos son: EE02, Copia electrónica auténtica con cambio de formato (Ley 11/2007 art. 30.1) EE03, Copia electrónica auténtica de documento papel (Ley 11/2007 art y 30.3) EE04, Copia electrónica parcial auténtica. EE05, Copia compulsada EE06, Copia simple NDE que identifica al documento padre del documento a copiar en el repositorio de PLATINO. Es un dato obligatorio en el caso de que el tipocopia sea EE02 o EE04. NDE NDE que identifica al documento a copiar en el repositorio de PLATINO. firma copiardocumentos Contenido de los datos firmados en formato XMLSignature o binaro (para aquellos formatos como CADES). bytes Indica si los documentos compulsados van a ser boolean

11 Servicio de Sello Electrónico y Copia Electrónica Página 11 de 21 copiados a la Carpeta de Documentos Administrativos del Ciudadano. uriciudadano URI que identifica al ciudadano propietario del documento de la copia. Se debe especificar en caso de que el parámetro copiardocumentos sea true. EJEMPLO DE ENTRADA

12 Servicio de Sello Electrónico y Copia Electrónica Página 12 de 21 <ssec:copiardocumentonde> <tipocopia>ee05</tipocopia> <NDEDocumentoPadre>0+q8H4/rWaD43GTr8bgDTO9hiWuBzQtD3</NDEDocumentoPadre> <NDE>0+q5NA/rWaV35BTr7vcDTO7kiWuBzQtC8</NDE> <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

13 Servicio de Sello Electrónico y Copia Electrónica Página 13 de 21 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:copiardocumentonde> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA

14 Servicio de Sello Electrónico y Copia Electrónica Página 14 de 21 <ssec:copiardocumentonderesponse/> 3.2 CU-SSECE-03: SELLAR DOCUMENTO Sellar documento Método para aplicar un sello electrónico a un documento del repositorio. Se debe especificar la URI documento, y el alias del certificado que se utilizará para firmar. El certificado debe estar almacenado en el servidor. Interfaz: Entrada del servicio: uridocumento alias URI que identifica al documento en el repositorio de PLATINO Alias del certificado, almacenado en el servidor, con el que se va firmar el documento. EJEMPLO DE ENTRADA

15 Servicio de Sello Electrónico y Copia Electrónica Página 15 de 21 <ssec:sellardocumento> <uridocumento>urn:uuid:17f4fab3-a954-11dc f28d1e72c </uridocumento> <alias>camerfirma</alias> </ssec:sellardocumento> Salida del servicio: No hay parámetros EJEMPLO DE SALIDA <ssec:sellardocumentoresponse/> Sellar documento por NDE Método para aplicar un sello electrónico a un documento del repositorio. Se debe especificar el identificador del documento mediante su NDE y el alias del certificado que se utilizará para firmar. El certificado debe estar almacenado en el servidor.

16 Servicio de Sello Electrónico y Copia Electrónica Página 16 de 21 Interfaz: Entrada del servicio: NDE alias NDE que identifica al documento en el repositorio de PLATINO Alias del certificado, almacenado en el servidor, con el que se va firmar el documento. EJEMPLO DE ENTRADA <ssec:sellardocumentonde> <NDE>0+f6HG/rDsV35BTr7vcDT75kiDsBzQtT5</NDE> <alias>camerfirma</alias> </ssec:sellardocumentonde> Salida del servicio:

17 Servicio de Sello Electrónico y Copia Electrónica Página 17 de 21 No hay parámetros EJEMPLO DE SALIDA <ssec:sellardocumentonderesponse/> 3.3 CU-SSECE-02: 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:

18 Servicio de Sello Electrónico y Copia Electrónica Página 18 de 21 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: return Resultado de la verificación del sellado. boolean EJEMPLO DE SALIDA <ssec:verificarselloresponse> <return>true</return> </ssec:verificarselloresponse>

19 Servicio de Sello Electrónico y Copia Electrónica Página 19 de 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: 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>

20 Servicio de Sello Electrónico y Copia Electrónica Página 20 de 21 Salida del servicio: return Resultado de la verificación del sellado. boolean EJEMPLO DE SALIDA <ssec:verificarsellonderesponse> <return>true</return> </ssec:verificarsellonderesponse>

21 Servicio de Sello Electrónico y Copia Electrónica Página 21 de 21 4 INFORMACIÓN ADICIONAL 4.1 CONTROL DE EXCEPCIONES SSECEEXCEPTION message Descripción textual del error. String