Requisitos de Configuracion y Despliegue de Las Librerias SCSP 3.3.0

Requisitos para la configuracin y
despliegue de las libreras SCSPv 3.3.0

Proyecto:
Ttulo:
Revisin:
Fecha:
Libreras SCSP 3.3.0

2.7
Octubre 2013
Ficha del documento

Fecha
Revisin
Autor
Verificado por
31/03/2011
1.3.1
Daniel de Castro Portillo
Jos Antonio Eusamio
26/08/2011
1.4
14/10/2011
1.5
17/11/2011
1.6
25/11/2011
1.7
09/12/2011
1.8
16/03/2012
1.9
24/05/2012
2.0
13/06/2012
2.1
29/06/2012
2.2
03/09/2012
2.3
08/10/2012
2.4
02/01/2013
2.5
Eduardo Blzquez
13/05/2013
2.6
04/10/2013
2.7
Documentos relacionados
Fecha
Revisin
Titulo
Ruta
Lista de distribucin del documento

Fecha
Nombre
Empresa
Telfono
Libreras SCSPv 3.3.0

Control de versiones
Fecha
Revisin
Descripcin del cambio
14/07/2010
1.0
Versin Inicial
13/12/2010
1.1
Corregidas las nuevas IPs de los servicios
03/02/2011
1.2
Eliminacin del acceso por http a los servicios
31/03/2011
1.3.1
Paso
a
la
nueva
plantilla
de
manuales
Se aaden datos acerca de los prerrequisitos administrativos
Se aaden datos acerca de la descarga de documentacin
26/08/2011
1.4
Se aade una notacin para el servidor de aplicaciones tomcat, en

la que se deben poner los conectores de BBDD en el common/lib y
no en las aplicaciones a desplegar
14/10/2011
1.5
Se aade el requisito de autenticacin de cliente para el Cliente

Ligero
17/11/2011
1.6
Se aade nota para la versin de BBDD de Oracle 9
25/11/2011
1.7
Se aade nota recomendando la utilizacin de una JDK 1.6x
09/11/2011
1.8
Se aade compatibilidad con JBOSS 5.1 y con SQLServer 2008
16/03/2012
1.9
Se actualizan los datos del Ministerio a Hacienda y AAPP
24/05/2012
2.0
Se actualizan requisitos mnimos al usar la Web de Administracin

SCSP
13/06/2012
2.1
Se actualizan requisitos mnimos de JDK
29/06/2012
2.2
Se aade informacin del funcionamiento de las libreras con OAS
03/09/2012
2.3
Se eliminan Ips de las URLs para evitar equvocos
08/10/2012
2.4
Referencia a la configuracin de apache con el cliente ligero
02/01/2013
2.5
Configuracin para Postgresql 8.X
13/05/2013
2.6
Adaptacin a la versin 3.3.0

Se aade compatibilidad con JBOSS 7.2.X
04/10/2013
2.7
Se aaden compatibilidades con Apache Tomcat

Se aaden compatibilidades con MySQL
Requisitos para la configuracin y despliegue de las Libreras SCSP

de 14
Pgina 3

2013 Ministerio de Hacienda y Administraciones Pblicas

Reservados todos los derechos. Quedan rigurosamente prohibidas, sin el permiso escrito de los
titulares del copyright, la reproduccin o la transmisin total o parcial de esta obra por cualquier
procedimiento mecnico o electrnico, incluyendo la reprografa y el tratamiento informtico, y la
distribucin de ejemplares mediante alquiler o prstamos pblicos.
This work is protected by copyright. All rights reserved for reproduction or copying of this document or
parts thereof. This also applies to its translations. No parts of this work may, in any form whatsoever,
(print, photocopy, microfilm or any other procedures), including for training purpose, be reproduced or
electronically processed, duplicated or disseminated without the written permission of the copyright
owner.

de 14
Pgina 4

Contenido
FICHA DEL DOCUMENTO
DOCUMENTOS RELACIONADOS
LISTA DE DISTRIBUCIN DEL DOCUMENTO
CONTROL DE VERSIONES
CONTENIDO
INTRODUCCIN
1.1
Propsito
1.2
Alcance
1.3
Resumen
JDK
SISTEMAS OPERATIVOS
SERVIDOR DE APLICACIONES
4.1
Tomcat
4.2
JBoss
4.3
WebLogic
4.4
Oracle OAS
4.5
WebSphere
BASE DE DATOS
5.1
MySQL
5.2
ORACLE
10
5.3
Microsoft SQLServer
10
5.4
PostgreSQL
10
CERTIFICADOS
11
CONECTIVIDADES
11

de 14
Pgina 5

7.1 @Firma
7.1.1
Produccin
7.1.2
Pre Produccin
7.1.3
Cdigo de Aplicacin
11
11
11
11
7.2 Intermediacin
7.2.1
Produccin
7.2.2
Pre Produccin
12
12
12
12
AUTORIZACIONES Y PRERREQUISITOS ADMINISTRATIVOS
8.1 Intermediacin
8.1.1
Pre Produccin y Produccin
8.1.2
AEAT
12
12
13
NOTAS
14
10
DEFINICIONES, ACRNIMOS Y ABREVIATURAS
14
11
APNDICES
14

de 14
Pgina 6

1 Introduccin
Este manual comprende los requisitos tcnicos y administrativos necesarios para la
instalacin y uso de las libreras SCSP.
Propsito
1.1
El manual tiene como propsito establecer e indicar unos requisitos necesarios previos a
la configuracin y uso de las libreras SCSP.
El manual va dirigido a todos aquellos que deseen configurar y/o usar las libreras
SCSP.
Alcance
1.2
El manual comprende los requisitos para la configuracin de las libreras SCSP, tanto
manualmente como a travs del Wizard.
Resumen
1.3
El manual comprende tanto los requisitos tcnicos para la configuracin de las libreras
SCSP como los prerrequisitos administrativos necesarios para el uso de las mismas.
2 JDK
La versin mnima de JDK necesaria para la configuracin y para la ejecucin de las
libreras es la versin 1.6.0_20. Las libreras son compatibles con una versin de JDK
1.7.0_X
3 Sistemas Operativos
Las libreras funcionan tanto en Sistemas operativos Windows como Linux/Unix.
4 Servidor de Aplicaciones
Para la instalacin del cliente ligero, es requisito indispensable que el servidor de
aplicaciones, tenga activada la opcin de autenticacin de cliente. Se puede ver como
configurar para tomcat en el manual FAQs - Librerias SCSP J2EE.pdf
Los servidores de aplicaciones en los que se han probado las libreras son los siguientes:
Apache Tomcat
4.1
Versiones de Tomcat soportadas:
5.0.X (El Cliente Ligero y el Adiministrador, no son soportados por esta versin)
5.5.X (El Cliente Ligero y el Adiministrador, no son soportados por esta versin)
6.0.X
7.0.X

de 14
Pgina 7

Si se desea utilizar la Web de Administracin SCSP o el Cliente Ligero 3.3.0 el
requisito mnimo es un tomcat 6.0.29
Con la Apache Tomcat 6 existe un problema al parar tomcat con las libreras SCSP. Al
para el servidor se obtienen las siguientes trazas.
GRAVE: The web application [/xxxx] registered the JBDC driver [org.postgresql.Driver] but failed to
unregister it when the web application was stopped. To prevent a memory leak, the JDBC Driver
has been forcibly unregistered.
11-ago-2011 9:27:20 org.apache.catalina.loader.WebappClassLoader clearReferencesJdbc
GRAVE: The web application [/xxxx] registered the JBDC driver [com.mysql.jdbc.Driver] but failed
to unregister it when the web application was stopped. To prevent a memory leak, the JDBC Driver
has been forcibly unregistered.
Esto ocurre debido a un bug conocido en estas versiones de tomcat, para solucionarlo,
se deben de poner los drivers de base de datos en el common/lib de tomcat, y no en
las aplicaciones a desplegar. Este bug no influye en el funcionamiento de las
aplicaciones.
JBoss
4.2
Versiones de JBoss soportadas:
4.X
5.1.X
6.0.X
6.1.X
7.0.X
7.1.X
7.2.X
En versiones determinadas hace falta realizar cambios para poder arrancar las
aplicaciones, en diferentes documentos se propone esta configuracin especfica para
cada una de las versiones de JBOSS
No obstante la versin mnima recomendada para la instalacin de las libreras es la
versin 6.0.X, no siendo soportada la versin 4.X para el Administrador SCSP y el
Cliente Ligero 3.3.0.
Se ponen a disposicin de los usuarios las guas con las modificaciones necesarias para
la instalacin sobre las distintas versiones.
Manual de instalacion y despliegue en JBOSS 5.X de librerias SCSP v3.3.0 J2EE.pdf
4.3
WebLogic
Versiones de WebLogic soportadas:

de 14
Pgina 8

9.X
Con las versiones 9.2 y 10.3 se han encontrado incompatibilidades, para la 9.2 es un
bug reconocido por ORACLE
http://download.oracle.com/docs/cd/E13222_01/wls/docs92/issues/known_resolved.html
CR303287 y CR310307
Para la versin 10.3 ORACLE proporciona parches de mejora a sus clientes
http://forums.oracle.com/forums/thread.jspa?threadID=945168&tstart=47
Tambin se reconocen incompatibilidades con las libreras Saaj, para este problema el
Wizard es capaz de solventarlo por si solo en la instalacin, si elegimos la opcin de
WebLogic.
Oracle OAS
4.4
Se ha comprobado que las libreras (Recubrimiento WS y Emisor)

funcionan
correctamente en un servidor de aplicaciones OAS 10.1.3.5.0, para el correcto
funcionamiento, se debe modificar seguir la gua creada para tal fin.
Manual de instalacion y despliegue en Oracle OAS 10.1.X de librerias SCSP v3.3.0
J2EE.pdf
WebSphere
4.5
Se ha comprobado que las libreras (Recubrimiento WS y Emisor) funcionan

correctamente en un Servidor de Aplicaciones WebSphere 7.0.0.23, para el correcto
funcionamiento, se debe modificar seguir la gua creada para tal fin.
Manual de instalacion y despliegue en WebSphere 7.X de librerias SCSP v3.3.0
J2EE.pdf
5 Base de Datos
Los tipos de Base de Datos soportada por las libreras son los siguientes.
MySQL
5.1
Versiones de MySQL soportadas, tambin son soportadas versiones superiores
5.1.X
5.5.X

de 14
Pgina 9

5.6.X
ORACLE
5.2
Versiones de ORACLE soportadas:
9i
10g
11g
Con la versin 9i de Oracle es necesario utilizar el driver de la versin 10g, esto es

debido a un bug con al driver, el cual hace que al escribir un BLOB mediante Hibernate,
ocurra el siguiente error.
011-11-08 16:22:01 [org.hibernate.util.JDBCExceptionReporter] WARN - SQL Error: 17090, SQLState: null
2011-11-08 16:22:01 [org.hibernate.util.JDBCExceptionReporter] ERROR - operation not allowed: streams type
cannot be used in batching
2011-11-08 16:22:02 [org.hibernate.event.def.AbstractFlushingEventListener] ERROR - Could not synchronize
database state with session
org.hibernate.exception.GenericJDBCException: could not insert: [es.scsp.common.domain.Token]
at org.hibernate.exception.SQLStateConverter.handledNonSpecificException(SQLStateConverter.java:103)
at org.hibernate.exception.SQLStateConverter.convert(SQLStateConverter.java:91)
at org.hibernate.exception.JDBCExceptionHelper.convert(JDBCExceptionHelper.java:43)
at org.hibernate.persister.entity.AbstractEntityPersister.insert(AbstractEntityPersister.java:2262)
at org.hibernate.persister.entity.AbstractEntityPersister.insert(AbstractEntityPersister.java:2655)
at org.hibernate.action.EntityInsertAction.execute(EntityInsertAction.java:60)
at org.hibernate.engine.ActionQueue.execute(ActionQueue.java:279)
at org.hibernate.engine.ActionQueue.executeActions(ActionQueue.java:263)
at org.hibernate.engine.ActionQueue.executeActions(ActionQueue.java:167)
at
org.hibernate.event.def.AbstractFlushingEventListener.performExecutions(AbstractFlushingEventListener.java:
298)
[.]
2011-11-08 16:22:02 [es.scsp.client.BasicServiceClient] ERROR - Error durante la llamada al servicio web.
could not insert: [es.scsp.common.domain.Token]
2011-11-08 16:22:02 [es.scsp.client.BasicServiceClient] DEBUG - Recuperando registro de peticion/respuesta
con identificador 'MPTAP000000000000000000013'.
2011-11-08 16:22:02 [es.scsp.client.ws.service.ClienteUnicoServiceImpl] ERROR es.scsp.common.exceptions.ScspException: Error al contactar con el servicio Web especificado
https://intermediacionpp.redsara.es/AEAT/services/CorrientePago [^] PeticionSincrona
Microsoft SQLServer
5.3
Versiones de SQLServer soportadas:
5.4
2000
2005
2008
PostgreSQL
Versiones de PostgreSQL soportadas, tambin son soportadas versiones superiores

de 14
Pgina 10

8.X
NOTA para versiones 8.3 y posteriores: Tras la creacin y configuracin del modelo
de datos usado para un requirente/emisor debe ejecutarse la siguiente sentencia:
CREATE CAST (integer AS text) WITH INOUT AS IMPLICIT ;
6 Certificados
Es necesario que el certificado utilizado para firmar las peticiones sea un certificado de
Sello de rgano y est en formato .p12 o .pfx. Para el caso de envo de peticiones directas
a AEAT (No al servicio intermediado) debe de ser un certificado de sello de rgano o un
certificado de persona jurdica para mbito tributario.
7 Conectividades
En este apartado se describen las direcciones de los servicios con los que interactan las
libreras (y las aplicaciones que las usen).
La opcin recomendada de uso es por nombre (Resolviendo por DNS)
Las IPs que se indican son las que se acceden en SARA sin uso de sistemas de traduccin
de IPs (NAT). Recomendamos confirme con su Administrador de Sistemas o
Comunicaciones los datos concretos. Para ms informacin puede consultar con el Centro
de Soporte de Red SARA, en incidencias.redsara@seap.minhap.es o en el telfono
912732032 en horario de 9:00 a 17:30. Resto de horarios: 902013114.
7.1
@Firma
7.1.1 Produccin
Se debe tener conectividad con los servidores de @Firma de produccin al
servicio de validar certificado
http://afirma.redsara.es/afirmaws/services/ValidarCertificado
7.1.2 Pre Produccin

Se debe tener conectividad con los servidores de @Firma de produccin al
servicio de validar certificado
http://des-afirma.redsara.es/afirmaws/services/ValidarCertificado
7.1.3 Cdigo de Aplicacin

Se debe tener un cdigo de aplicacin para enviar peticiones a @Firma, este
cdigo ser proporcionado por @Firma.
de 14
Pgina 11

Las peticiones a @Firma van firmadas y este ser el mtodo de autenticacin
para sus servicios. Esto implica que al cdigo de aplicacin se le debe asociar un
certificado por parte de @Firma, el cual servir para validar las peticiones, tal y
como viene definido en el ACL del servicio.
Esto se debe tener en cuenta para quienes ya tengan un cdigo de aplicacin que
no soporte esta funcionalidad, pues debern solicitan uno nuevo.
Para ms informacin sobre este apartado consulte al Centro de Soporte @firma
del Ministerio de Hacienda y Administraciones Pblicas.
Telfono: 902 934 405
eMail: soporte.afirma5@seap.minhap.es
7.2
Intermediacin
7.2.1 Produccin
Para enviar peticiones al entorno de produccin de intermediacin, se debe tener
conectividad con la siguiente URL
https://intermediacion.redsara.es
El acceso se realizar por el puerto estndar https (443), para invocar al servicio
debemos de introducir en nuestro almacn de confianza la parte pblica
proporcionada por intermediacin.
7.2.2 Pre Produccin

Para enviar peticiones al entorno de pre produccin de intermediacin, se debe
tener conectividad con la siguiente URL
https://intermediacionpp.redsara.es
El acceso se realizar por el puerto estndar https (443), para invocar al servicio
debemos de introducir en nuestro almacn de confianza la parte pblica
proporcionada por intermediacin.
8 Autorizaciones y Prerrequisitos Administrativos

8.1
Intermediacin
8.1.1 Pre Produccin y Produccin
Para poder usar satisfactoriamente las libreras SCSP es necesario tener
autorizado el uso del servicio a los distintos Certificados/Emisores. Para mas
informacin respecto al protocolo a seguir para la autorizacin, formularios de

de 14
Pgina 12

autorizacin, solicitudes de autorizacin y datos de contacto, pueden consultar al
centro de Atencin a Integradores y Desarrolladores del MPTAP:
Servicio de Intermediacin de Datos.
Divisin de Proyectos Tecnolgicos
TLF: 902 93 44 05 Fax. 902 627 480
eMail: soporte.supresionfotocopias@seap.minhap.es
Los formularios y procedimientos de autorizacin se pueden obtener de la URL
http://administracionelectronica.gob.es/es/ctt/svd
Al final del enlace (rea Pblica de descargas) se encuentra informacin sobre
los servicios actualmente disponibles y las condiciones de acceso a los mismos
o
Procedimiento de autorizacin de consulta de datos, excepto Residencia
Servicios Disponibles en la Plataforma de Intermediacin
Descripcin de los servicios. Manuales de integracin, ejemplos, SLA y

formularios de alta
Procedimiento de autorizacin de Consultas de datos de Residencia
8.1.2 AEAT
Para enviar directamente peticiones a los servicios de AEAT, se deben tener las
autorizaciones con este organismo.
El formulario de autorizaciones as como consultas al respecto del funcionamiento
de los servicios se puede tambin enviar a travs del CAID del Ministerio de
Poltica Territorial:
Servicio de Intermediacin de Datos.
Divisin de Proyectos Tecnolgicos
TLF: 902 93 44 05 Fax. 902 627 480
eMail: soporte.supresionfotocopias@seap.minhap.es
Gua de autorizaciones
http://www.aeat.es/AEAT/Contenidos_Comunes/La_Agencia_Tributaria/Modelos_
y_formularios/Administraciones_Publicas/Guiasweb.pdf
Formulario de autorizaciones
http://www.aeat.es/AEAT/Contenidos_Comunes/La_Agencia_Tributaria/Modelos_
y_formularios/Administraciones_Publicas/Formsweb.pdf

de 14
Pgina 13

9 Notas
La parte correspondiente al cliente que est por encima de las libreras, necesita
autenticacin de cliente para acceder a l, ser necesario un certificado propio para
poder acceder y para poder utilizar los servicios, puesto que las autorizaciones a estos
se dan al usuario. Cliente ligero
Se ha probado satisfactoriamente con un apache delante de Tomcat, para ello hay que
tener en cuenta que no debe estar activada la cach de sesiones SSL en apache, y
tampoco debe estar activada la autenticacin en apache para el contexto del cliente.
Se recomienda consultar la documentacin de Administracin de Apache y Tomcat (o el
Servidor de aplicaciones que se use) para ms informacin.
En el documento FAQs - Librerias SCSP J2EE.pdf en el punto 3 existe un ejemplo de
esta configuracin.
10 Definiciones, acrnimos y abreviaturas

No aplica
11 Apndices
No aplica

de 14
Pgina 14

Requisitos de Configuracion y Despliegue de Las Librerias SCSP 3.3.0

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Requisitos de Configuracion y Despliegue de Las Librerias SCSP 3.3.0

Hochgeladen von

Copyright:

Verfügbare Formate

Requisitos para la configuracin y

despliegue de las libreras SCSPv 3.3.0

Libreras SCSP 3.3.0

Ficha del documento

Daniel de Castro Portillo

Jos Antonio Eusamio

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Daniel de Castro Portillo

Lista de distribucin del documento

Libreras SCSPv 3.3.0

Descripcin del cambio

Corregidas las nuevas IPs de los servicios

Eliminacin del acceso por http a los servicios

Se aade una notacin para el servidor de aplicaciones tomcat, en

Se aade el requisito de autenticacin de cliente para el Cliente

Se aade nota para la versin de BBDD de Oracle 9

Se aade nota recomendando la utilizacin de una JDK 1.6x

Se aade compatibilidad con JBOSS 5.1 y con SQLServer 2008

Se actualizan los datos del Ministerio a Hacienda y AAPP

Se actualizan requisitos mnimos al usar la Web de Administracin

Se actualizan requisitos mnimos de JDK

Se aade informacin del funcionamiento de las libreras con OAS

Se eliminan Ips de las URLs para evitar equvocos

Referencia a la configuracin de apache con el cliente ligero

Configuracin para Postgresql 8.X

Adaptacin a la versin 3.3.0

Se aaden compatibilidades con Apache Tomcat

Requisitos para la configuracin y despliegue de las Libreras SCSP

Libreras SCSPv 3.3.0

2013 Ministerio de Hacienda y Administraciones Pblicas

Requisitos para la configuracin y despliegue de las Libreras SCSP

Libreras SCSPv 3.3.0

LISTA DE DISTRIBUCIN DEL DOCUMENTO

Requisitos para la configuracin y despliegue de las Libreras SCSP

Libreras SCSPv 3.3.0

AUTORIZACIONES Y PRERREQUISITOS ADMINISTRATIVOS

DEFINICIONES, ACRNIMOS Y ABREVIATURAS

Requisitos para la configuracin y despliegue de las Libreras SCSP

Libreras SCSPv 3.3.0

Versiones de Tomcat soportadas:

Requisitos para la configuracin y despliegue de las Libreras SCSP

Libreras SCSPv 3.3.0

Versiones de JBoss soportadas:

Versiones de WebLogic soportadas:

Libreras SCSPv 3.3.0

Se ha comprobado que las libreras (Recubrimiento WS y Emisor)

Se ha comprobado que las libreras (Recubrimiento WS y Emisor) funcionan

Versiones de MySQL soportadas, tambin son soportadas versiones superiores

Requisitos para la configuracin y despliegue de las Libreras SCSP

Libreras SCSPv 3.3.0

Versiones de ORACLE soportadas:

Con la versin 9i de Oracle es necesario utilizar el driver de la versin 10g, esto es

Versiones de SQLServer soportadas:

Versiones de PostgreSQL soportadas, tambin son soportadas versiones superiores