Академический Документы
Профессиональный Документы
Культура Документы
Revisin
Autor
Verificado por
31/03/2011
1.3.1
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
Nombre
Empresa
Telfono
Control de versiones
Fecha
Revisin
14/07/2010
1.0
Versin Inicial
13/12/2010
1.1
03/02/2011
1.2
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
14/10/2011
1.5
17/11/2011
1.6
25/11/2011
1.7
09/11/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
13/05/2013
2.6
04/10/2013
2.7
Pgina 3
Pgina 4
Contenido
FICHA DEL DOCUMENTO
DOCUMENTOS RELACIONADOS
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
Pgina 5
11
11
11
11
7.2 Intermediacin
7.2.1
Produccin
7.2.2
Pre Produccin
12
12
12
12
8.1 Intermediacin
8.1.1
Pre Produccin y Produccin
8.1.2
AEAT
12
12
13
NOTAS
14
10
14
11
APNDICES
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
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
Pgina 7
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
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
Manual de instalacion y despliegue en JBOSS 6.X de librerias SCSP v3.3.0 J2EE.pdf
Manual de instalacion y despliegue en JBOSS 7.X de librerias SCSP v3.3.0 J2EE.pdf
4.3
WebLogic
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
WebSphere
4.5
5 Base de Datos
Los tipos de Base de Datos soportada por las libreras son los siguientes.
MySQL
5.1
5.1.X
5.5.X
Pgina 9
5.6.X
ORACLE
5.2
9i
10g
11g
Microsoft SQLServer
5.3
5.4
2000
2005
2008
PostgreSQL
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
Pgina 11
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.
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
Pgina 12
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
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.
11 Apndices
No aplica
Pgina 14