SISTEMA INTEGRADO DE GESTIÓN DE EXPEDIENTES MODULAR (SIGM) CONFIGURACIÓN PARA LA INTEGRACIÓN CON SISNOT Y CORREOS SIGM v3 Administración Local Soluciones
Control de versiones Versión Fecha aprobación Cambio producido Autor 01 09-10-2012 Versión inicial IECISA AL SIGM v3 Configuración para la integración con Sisnot y Correos 2
ÍNDICE 1 INTRODUCCIÓN... 4 1.1 VISIÓN GENERAL DEL SISTEMA... 4 1.2 FINALIDAD DEL DOCUMENTO... 4 1.3 DEFINICIONES Y ABREVIATURAS... 4 2 SOLICITUD DE ALTA DE NUEVA ENTIDAD EN EL SNTS DE CORREOS... 5 3 INSTALACIÓN Y CONFIGURACIÓN DE SISNOT... 6 3.1 CREACIÓN DE ESQUEMA EN BASE DE DATOS... 6 3.2 INSTALACIÓN Y CONFIGURACIÓN DEL SERVIDOR DE APLICACIONES... 8 3.3 DESPLIEGUE DE APLICACIONES... 8 3.4 CONFIGURACIÓN DE SISNOT... 9 4 ALTA DE PROCEDIMIENTOS PARA LA ENTIDAD EN CORREOS... 9 5 [OPCIONAL] COMPROBACIÓN DE CORRECTA INSTALACIÓN DE SISNOT.. 10 6 INTEGRACIÓN CON AL SIGM... 10 AL SIGM v3 Configuración para la integración con Sisnot y Correos 3
1 Introducción 1.1 Visión general del sistema AL SIGM es la plataforma de Tramitación Electrónica del MINETUR, solución integral para la tramitación electrónica de los procedimientos administrativos, que fomenta la interoperabilidad entre administraciones mediante su adaptación a estándares de comunicación así como la reutilización de recursos e información pública. 1.2 Finalidad del documento El objetivo del presente documento es explicar la configuración para la integración de SIGEM con el Servicio de Notificaciones Telemáticas Seguras (SNTS) de Correos a través de Sisnot, como aplicación web intermediaría. El SNTS es un servicio desarrollado por el Ministerio de Administraciones Públicas en colaboración con Correos, que permite a ciudadanos y empresas recibir, en un único buzón, las notificaciones administrativas que actualmente reciben en papel. Se puede obtener más información en las direcciones: http://administracionelectronica.gob.es/?_nfpb=true&iniciativa=261 http://notificaciones.administracion.es los pasos para realizar esta integración entre Correos, Sisnot y AL SIGM. Los pasos a seguir para realizar la integración entre Correos, Sisnot y AL SIGM son: el alta de una nueva entidad en el SNTS de Correos, la instalación y configuración de Sisnot, el alta de procedimientos en correos y la configuración de la integración de AL SIGEM con Sisnot. En los siguientes apartados, se comentará en más detalle, cada uno de los pasos anteriores. 1.3 Definiciones y Abreviaturas A continuación se expone una tabla con los diferentes acrónimos y abreviaturas utilizados a lo largo del documento, con su correspondiente definición. Acrónimo / Abreviatura MINETUR IECISA SIGM Definición Ministerio de Industria, Energía y Turismo Informática El Corte Inglés S.A. Sistema Integrado de Gestión de Expedientes AL SIGM v3 Configuración para la integración con Sisnot y Correos 4
Modular AL Administración Local 2 Solicitud de alta de nueva entidad en el SNTS de Correos Para solicitar el alta, es necesario enviar el Formulario de Alta de Nueva Entidad correctamente rellenado, a soporte técnico del SNTS, en la dirección snts@correos.es. La obtención del formulario, también se realizar en la misma dirección de correo electrónico. A continuación se enumeran los datos que es necesario rellenar en el formulario junto con una breve explicación: IP o IPs que utilizará el servidor (Sisnot) del Organismo Emisor, desde donde se enviarán peticiones a los servicios de Correos. Desde Correos se habilitará el acceso a sus Sistemas, desde estas IPs. URL de intercambio de la clave simétrica. Correos permite el envío de dos tipos de notificaciones, cifradas y sin cifrar. Las notificaciones cifradas están basadas en un cifrado con clave simétrica. Por esta razón, en el caso de querer usar notificaciones cifradas, es necesario habilitar el acceso desde Correos a una URL desde la que se pueda recuperar la clave simétrica. Sisnot ya incluye esta funcionalidad. Parte pública/certificado de firma: Las peticiones que se envíen a Correos desde Sisnot, deben estar firmadas. Además desde Correos se comprueba que lleguen firmadas con el certificado correspondiente a la entidad emisora. Este certificado debe contener un CIF/NIF que se pueda ser extraído por @firma. Este CIF/NIF debe de coincidir con el campo CIF del formulario, ya que se verifica desde Correos, en cada una de las peticiones. Parte pública/certificado de administración: Correos dispone de una aplicación web, desde donde se pueden gestionar los procedimientos de la entidad, a los que se podrán suscribir los ciudadanos para recibir las notificaciones. Estos procedimientos también deben de darse de alta en Sisnot, utilizando el mismo código asociado. Posteriormente, desde dicha aplicación, también se pueden añadir a otros administradores. Un mismo certificado/parte pública sólo puede ser administrador de una única entidad en Correos. Alias de la entidad emisora: Cadena de 10 caracteres identificadora de la entidad. Puede ser cambiada desde correos en el momento del alta. Nombre, Descripción y CIF/NIF de la entidad emisora: El CIF/NIF debe de coincidir con el extraído del certificado de firma AL SIGM v3 Configuración para la integración con Sisnot y Correos 5
Teléfono/s e email de atención al cliente: Direcciones de contacto del servicio de soporte de la entidad emisora, que pueden ser utilizados por el ciudadano o el servicio de soporte de Correos. Descripción y Logo de la entidad emisora: El Logo debe ser una imagen de tamaño máximo 50KB. En dicho formulario, entre otra información también se incluye las URLs de acceso a los Web Services ofrecidos desde Correos, con los que habrá que configurar Sisnot, según el entorno sobre el que se vaya a utilizar (Preproducción o producción). También se distribuye la parte pública de los certificados SSL y de firma utilizados por Correos en los diferentes entornos. El certificado SSL debe ser incluido en el almacén de confianza de certificados SSL de Sisnot (si no existe ya), mientras que el certificado de firma, se puede usar de forma opcional, para la validación de las respuestas SOAP enviadas desde Correos. Nota: Por defecto se dan de alta ambos entornos, por lo que se exige que el certificado utilizado para la entidad en Correos, sea un certificado válido reconocido por las entidades certificadores soportadas por @firma (https://sede.mjusticia.gob.es/cs/satellite/sede/es/1215197884574/sdinf ormacion/1215327446031/detalle.html) 3 Instalación y Configuración de Sisnot NOTA: AL SIGM v3 es compatible con la versión 2.3 de Sisnot, actualmente la última liberada oficialmente. Los detalles técnicos sobre la instalación y configuración de Sisnot, se explican en detalle, en el manual SISNOT_Manual_Explotacion_V1.3.pdf incluido en la documentación de SISNOT. En este apartado, se muestra un breve resumen sobre las distintas fases que tiene la instalación de SISNOT, evitando en la medida de lo posible, repetir la información incluida en el manual citado anteriormente. La instalación de SISNOT, se divide en las siguientes partes: Creación de esquema en base de datos, instalación y configuración del Servidor de aplicaciones, Despliegue de SISNOT en Servidor de aplicaciones y configuración de Sisnot. 3.1 Creación de esquema en Base de Datos Aunque la distribución de SISNOT, incluye un script, para la creación del esquema, este script no incluye los cambios necesarios, para el correcto funcionamiento de SISNOT con AL SIGM. Estos cambios son los siguientes: Tabla: sn_sistema_emisor cod_emisor dir_servicio descripcion AL SIGM v3 Configuración para la integración con Sisnot y Correos 6
SIGEM (*) Sistema Integrado de Gestión Municipal (*) Este valor debe de coincidir con el indicado en el fichero de configuración de SISNOT, ubicado en /sisnot/config/sisnot.properties; concretamente su campo Cod_Admon. También debe coincidir con el alias de la entidad emisora asignado por Correos en el formulario de alta. Tabla: sn_tipo_correspondencia tipo_correspondencia Descripción encriptar CENSO CENSO FALSE (*)NOT1 SIN CIFRAR FALSE (*)NOT1CIFR CIFRADAS TRUE (*) Estos valores deben de coincidir también con los asignados por Correos, para los tipos de notificaciones, a través del formulario de alta de entidad. El esquema usado por SISNOT, tiene las siguientes tablas y secuencias: Tablas: sn_doc_notificacion, sn_notificacion, sn_procedimiento, sn_remesa, sn_sistema_emisor, sn_suscripcion, sn_tipo_correspondencia y sn_usuario. Secuencias: sn_doc_notificacion_cod_notificacion_seq, sn_notificacion_ncc_seq y sn_remesa_cod_remesa_seq AL SIGM v3 Configuración para la integración con Sisnot y Correos 7
3.2 Instalación y configuración del Servidor de aplicaciones SISOT utiliza internamente EJBs. Debido a esto no puede usar cualquier servidor de aplicaciones. En la distribución de SISNOT, se da soporte a dos: Webpshere y JBoss. En caso, de que no se pueda usar el mismo servidor de aplicaciones, que el utilizado por SIGEM, se recomienda usar JBoss por ser más ligero, tanto en requisitos mínimos de memoria, como en requisitos de espacio en disco. La versión recomendada de JBoss es la 4.2.3. La versión de Java a usar es la 1.5 o superior. Tras la instalación del JBoss, hay crear una nueva instancia y configurarla para que soporte el tipo de base de datos, en la que se ha creado el esquema (Postgre, Oracle, etc), siguiendo los pasos, descritos en gran detalle, en el manual de instalación y configuración incluido en la documentación de SISNOT. Aunque también está incluido en dicho manual, en el caso de usar JBoss como servidor de aplicaciones, se recuerda la necesidad de crear dos datasources, de nombres DefaultDS y SisnotDS, que apunten al esquema de SISNOT creado en BD. Estos datasources, se referencian en el fichero xml ubicado en./deploy/<bd>-ds.xml, en el directorio de la instancia de JBoss correspondiente a SISNOT (Normalmente./server/sisnotPostgre ). Por último, se recuerda un problema, que suele aparecer si se utilizan varios servidores de aplicaciones, en la misma máquina física. Se trata del conflicto de puertos. Si tenemos un servidor de aplicaciones ya instalado, que utiliza el puerto 8080, entonces tenemos que cambiar los puertos que utiliza en JBoss de SISNOT. El proceso detallado puede encontrarse también en el manual de instalación de SISNOT. 3.3 Despliegue de aplicaciones SISNOT básicamente consiste en dos ears: snsisnot.ear y snclientesisnot.ear. El primero de ellos contiene los EJBs que se van a usar, junto con las aplicaciones, de los servicios web, y aplicación web de administración, además de las librerías comunes. Por otra parte snclientesisnot.ear, contiene una sencilla aplicación web, que permite la creación de notificaciones, para de esta forma poder probar el correcto funcionamiento de SISNOT. La distribución de SISNOT incluye varias versiones de estos ears, según el Sistema Operativo sobre el que se despliegue, según el tipo de Base de Datos, etc. Es importante escoger el correcto. Por ejemplo, si se trata de desplegar el ear de Linux, sobre un SO Windows, los accesos a los ficheros de configuración log, etc van a fallar, ya que dentro del ear, tendrán el formato /home/sisnot/ cuando, por ser Windows correspondería c:/sisnot/ AL SIGM v3 Configuración para la integración con Sisnot y Correos 8
3.4 Configuración de SISNOT La configuración de SISNOT se basa en una serie de ficheros, externos a los ears, que deben estar en una determinada ruta del Sistema Operativo. Estos ficheros de configuración, están agrupados en varios directorios, que a su vez se agrupan en un directorio de nombre sisnot. Para facilitar el proceso de configuración de SISNOT, en la distribución de SISNOT, se incluye un directorio de configuración, para cada uno de los sistemas Operativos soportados (Windows y Linux). En el caso de un SO Windows, este directorio debe copiarse en c:\, mientras que en el caso de Linux, debe copiarse en /home y asignarle los permisos adecuados Se remite al manual de instalación de SISNOT, para información detallada sobre los parámetros de configuración de SISNOT, y funcionalidad de directorios incluidos en dicha configuración. Se estima que el crecimiento de este directorio puede llegar hasta los 30 MB de memoria física para este aspecto. SISNOT debe de tener acceso para conectarse al sistema SNTS. El acceso se consigue conectándose a la siguiente dirección IP: Desarrollo / Pruebas Producción http://193.148.128.102 (pre-sne.correos.es) (Consultar al organismo SNTS) Para configurar la dirección IP a la que conectarse, u otros parámetros se puede utilizar el entorno web de administración de SISNOT (recomendado) o modificar directamente el fichero de configuración ubicado en sisnot/config/sisnot.xml. Por último, es necesario dar de alta de todos los procedimientos correspondientes a la entidad emisora, desde los que se pueden enviar notificaciones. De forma opcional, se pueden configurar a través de la aplicación de administración, una serie de tareas, que se encargarán de enviar periódicamente las notificaciones creadas y de recuperar los acuses de disposición y de recibo de Correos 4 Alta de procedimientos para la entidad en Correos Se trata de dar de alta, a través de la aplicación de administración de entidades emisoras de Correos, a los procedimientos asociados con la entidad, que pueden generar notificaciones. De esta forma, la entidad es visible para los ciudadanos, permitiendo la suscripción. En el entorno de preproducción, la URL de esta aplicación es https://pre-sne.correos.es:8080/issuingentity/login_execute.action Los procedimientos se agrupan en categorías para facilitar al ciudadano la localización de los procedimientos a los que se quiere suscribir. Para dar de alta un procedimiento, es necesario especificar el código, descripción, y la fecha de fin de vigencia. De forma opcional, se puede especificar la descripción en otros idiomas, la fecha de inicio de vigencia, y la URL de descripción del procedimiento. AL SIGM v3 Configuración para la integración con Sisnot y Correos 9
Nota: El código del procedimiento dado de alta en Correos, debe coincidir con el código del mismo procedimiento en Sisnot. 5 [Opcional] Comprobación de correcta instalación de Sisnot Con el fin de poder aislar más fácilmente los problemas que pueden aparecer durante la integración de Sisnot con AL SIGM, se recomienda realizar previamente una prueba de envío de notificaciones a Correos, para verificar la correcta instalación y configuración de Sisnot. Para poder realizar esta prueba, es necesario disponer de una DEH, en el entorno que se desea probar. Desde el portal del ciudadano de las notificaciones electrónicas, se puede realizar la solicitud de creación de la DEH (hay que firmar electrónicamente la petición), la suscripción a los procedimientos, y el acceso al buzón de notificaciones asociado con la DEH creada. Desde este Portal del Ciudadano, también se pueden consultar los requisitos de acceso de este servicio. La URL actual de acceso al portal, en Preproducción es https://pre-sne.correos.es:8080/pc/. A continuación se enumeran los pasos de la prueba a realizar: 1. Suscribirse al procedimiento asociado con la entidad emisora correspondiente al Sisnot que se desea probar. 2. Desde Sisnot, tras recuperar el censo, comprobar que aparece la suscripción del paso anterior. 3. Generar una notificación para ese Ciudadano y procedimiento, a través de la aplicación web clientesisnot, distribuida junto con Sisnot, y comprobar que ésta se crea correctamente 4. Enviar las notificaciones pendientes en Sisnot a Correos, y comprobar que el estado de la notificación recién creada ha cambiado. 5. Recuperar los acuses de puesta a disposición y comprobar que el estado de la notificación, ahora es puesta a disposición. 6. Acceder al buzón asociado a la DEH, y leer la notificación, firmando la petición de lectura, y descargando el documento asociado con dicha notificación. 7. Desde Sisnot recuperar los acuses de recibo y comprobar que el estado de la notificación ha cambiado a Leida. 6 Integración con AL SIGM La integración de Sisnot con AL SIGM, se realiza a través de dos ficheros de propiedades, que pueden ser personalizados por entidad. Para más información sobre cómo realizar este paso se remite al documento SGM_2012_**_Configuración Notificación Telemática de la documentación de AL SIGM3. AL SIGM v3 Configuración para la integración con Sisnot y Correos 10