Procedimientos y Preguntas frecuentes integradores servicios web LexNet

Transcripción

1 Procedimientos y Preguntas frecuentes integradores servicios web LexNET LX8_031v2

2 FECHA NOMBRE FORMATO VersiónComentario 09/01/2012 DOC Versión 1.0 S.G. de Nuevas Tecnologías 11/01/2012 DOC Versión 2.0 Revisión

3 TABLA DE CONTENIDOS Procedimientos para integradores de servicios web Comunicación nuevo integrador Solicitud de usuarios de pruebas Desarrollo de la aplicación Superación de plan de pruebas Homologación y pase a producción... 4 Preguntas frecuentes: Integradores de aplicaciones... 6 En qué tecnología puedo programar mi aplicación para consumir los servicios ofrecidos por LEXNET?... 6 Qué pasos debo seguir para comenzar las pruebas de integración de mi aplicación con LEXNET?... 6 Disponiendo ya de identificador para mi aplicación, con qué usuario puedo iniciar mis pruebas de integración?... 6 Cómo puedo obtener mensajes para hacer pruebas de descarga con mi aplicación?... 7 Cómo puedo o a quién me dirijo para resolver las dudas surgidas en la integración?... 8 Soy un integrador y he detectado una incidencia en un servicio web, cómo debo comunicarlo?... 8 Qué pasos debo seguir para comenzar la utilización de mi aplicación en entorno real de producción de LEXNET?... 9 Qué sucede en caso de no superar el proceso de homologación?... 9 Quiero acceder a la aplicación web de Pruebas para realizar una solicitud de alta de un usuario de pruebas, Cuáles son los requisitos mínimos que tiene que tener mi ordenador para usar? Página 1

4 Procedimientos para integradores de servicios web Los desarrolladores de aplicaciones pueden integrar las funcionalidades proporcionadas por los servicios web de en sus aplicativos. Estas funcionalidades se encuentran detalladas en el documento Guía de uso de los Web Services de integración LexNET A continuación se resumen los pasos que deberá realizar cualquier aplicación que desee integrarse con los servicios web de desde el inicio de su desarrollo hasta su puesta en producción: 1. Comunicación nuevo integrador La integración de un aplicativo en requiere disponer de un identificador único para dicha aplicación que será utilizado en las peticiones realizadas a los servicios web Pruebas y en las comunicaciones con el equipo de desarrollo. Dicho identificador debe ser solicitado de acuerdo al siguiente procedimiento. El integrador, rellenará el formulario de comunicación cumplimentando las hojas INICIO y A, enviándolo a la dirección dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_nuevo]. En el plazo aproximado de una semana, el equipo de desarrollo de le responderá con la aceptación/denegación de la solicitud. En caso de aceptarse dicha solicitud, se le proporcionará: un identificador único identificativo de su aplicación contra los servicios web un paquete de documentación relacionada con el uso de los servicios web y procedimientos para la comunicación de su equipo de desarrollo con el equipo de desarrollo Página 2

5 2. Solicitud de usuarios de pruebas Una vez obtenido el identificador para comunicación de la nueva aplicación con los servicios web de, el integrador deberá disponer de, al menos, un usuario de pruebas con el que simulará el uso del sistema. Como, inicialmente, el nuevo integrador no dispondrá de ningún usuario dado de alta en pruebas, será necesario que entre en la aplicación web de pruebas ( ) utilizando el certificado digital personal en soporte físico (tarjeta) del usuario con el que realizará las pruebas. En dicha página podrá solicitar el alta del usuario asociado a ese certificado. Se recomienda solicitar el alta con el rol para el cual vaya a desarrollar su aplicación. Por ejemplo, si va a desarrollar una aplicación para procuradores, se recomienda darse de alta con este rol. Nota: antes de realizar esta solicitud de alta, debe asegurar que su ordenador cumple los requisitos mínimos para poder utilizar la aplicación web. Si desea conocer más detalle al respecto, consulte la pregunta frecuente Quiero acceder a la aplicación web de Pruebas para realizar una solicitud de alta de un usuario de pruebas, Cuáles son los requisitos mínimos que tiene que tener mi ordenador para usar? Una vez realizada la solicitud de alta, el integrador rellenará el formulario de comunicación cumplimentando las hojas INICIO y B, enviándolo a la dirección dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). En el plazo máximo de tres días, el equipo de desarrollo de le responderá con la aceptación/denegación de la solicitud de alta. 3. Desarrollo de la aplicación Una vez obtenido un identificador único para la aplicación y disponiendo de la aceptación de la solicitud de alta de, al menos, un usuario de pruebas, el integrador comenzará el desarrollo de su aplicación contra la URL de los servicios web de 3 pruebas Página 3

6 proporcionada en el paso anterior, utilizando para ello la documentación relativa a los servicios web de y contando con dos sistemas de apoyo al desarrollo ofrecida por el equipo de desarrollo : Solicitud de mensajes de prueba para un determinado usuario/entidad. Solicitud de ayuda relacionada con el uso e integración con los servicios web de. Para realizar cualquiera de estas solicitudes, será necesario cumplimentar el formulario de comunicación (rellenando las hojas INICIO y C de dicho formulario, en el caso de Solicitud de mensajes de prueba y las hojas INICIO y D en el caso de Solicitud de ayuda) y enviarlo a dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). 4. Superación de plan de pruebas Una vez finalizado el desarrollo de su aplicación, será necesario que el integrador realice un plan de pruebas sobre su aplicación. Puede utilizar el modelo de Plan de Pruebas como referencia de la guía de pruebas de los servicios web utilizados. 5. Homologación y pase a producción Una vez finalizado el desarrollo de su aplicación y superado el plan de pruebas recomendado, el integrador podrá solicitar el pase a producción de su aplicación. Previamente al pase a producción de su aplicación, requiere la superación de un proceso de homologación consistente en una validación presencial por parte del equipo del desarrollo realizado y del cumplimiento de los requisitos impuestos por el RD 84/2007 regulador del sistema. Para realizar una solicitud de homologación, será necesario cumplimentar el formulario de comunicación, rellenando las hojas INICIO y F de dicho formulario, y enviarlo a dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de Página 4

7 aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). En respuesta a la solicitud de homologación, la Subdirección de Nuevas Tecnologías del Ministerio de Justicia enviará al integrador un correo electrónico aceptando/denegando la homologación junto con una propuesta de fecha/hora y dirección donde se efectuará la homologación, en caso de aceptación o la explicación de los motivos de rechazo, en caso de denegación. Una vez superado el proceso de homologación, la Subdirección le comunicará la nueva URL a la que deberá apuntar el integrador sus servicios web para la integración con el sistema real así como el nuevo identificador para su aplicativo en dicho entorno. Página 5

8 Preguntas frecuentes: Integradores de aplicaciones En qué tecnología puedo programar mi aplicación para consumir los servicios ofrecidos por LEXNET? La integración con los servicios ofrecidos por se realiza mediante servicios web lo que aporta la posibilidad de interoperabilidad con con independencia del lenguaje de programación. Por tanto, es decisión del integrador la elección de la tecnología de programación así como los sistemas operativos a los que dará soporte su aplicativo. Qué pasos debo seguir para comenzar las pruebas de integración de mi aplicación con LEXNET? Para poder comenzar a hacer pruebas de integración contra los servicios web de es necesario cumplimentar el formulario de comunicación (rellenando las hojas INICIO y A) y enviarlo a la dirección dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_nuevo] En el plazo aproximado de una semana, el equipo de desarrollo de le responderá con la aceptación/denegación de la solicitud. En caso de aceptarse dicha solicitud, se le proporcionará un identificador único para la integración de su aplicación con los servicios web Pruebas así como los pasos siguientes recomendados para iniciar las pruebas de integración. Disponiendo ya de identificador para mi aplicación, con qué usuario puedo iniciar mis pruebas de integración? Una vez disponga de un identificador único para su aplicación proporcionado por esta Subdirección, las pruebas de integración con deberá realizarlas utilizando un certificado digital personal en soporte físico (tarjeta), correspondiente a un usuario dado de alta previamente en pruebas ( Como, inicialmente, no dispondrá de ningún usuario dado de alta en pruebas, es necesario que entre en la aplicación web de pruebas Página 6

9 ( utilizando su certificado digital para poder solicitar el alta del usuario asociado a ese certificado. Se recomienda solicitar el alta con el rol para el cual vaya a desarrollar su aplicación. Por ejemplo, si va a desarrollar una aplicación para procuradores, se recomienda darse de alta con este rol. Antes de realizar esta solicitud de alta, debe asegurar que su ordenador cumple los requisitos mínimos para poder utilizar. Si desea conocer más detalle al respecto, consulte la pregunta frecuente Quiero acceder a la aplicación web de Pruebas para realizar una solicitud de alta de un usuario de pruebas, Cuáles son los requisitos mínimos que tiene que tener mi ordenador para usar? Una vez realizada la solicitud de alta, envíe un correo electrónico a dessarrollo_lexnet@lista.mju.es adjuntando el formulario de comunicación (rellenando las hojas INICIO y B) e indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). Cómo puedo obtener mensajes para hacer pruebas de descarga con mi aplicación? Si ya dispone de un identificador para su aplicativo proporcionado por esta Subdirección para sus Pruebas en y un usuario dado de alta, puede solicitar el envío de mensajes de prueba para realizar pruebas de integración relacionadas con la descarga de mensajes. Ej: descarga de notificaciones. Para ello, cumplimente el formulario de comunicación (rellenando las hojas INICIO y C) y envíelo a dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). Página 7

10 En caso de no disponer de un identificador único para su aplicativo por tratarse de un integrador nuevo, consulte la pregunta frecuente Qué pasos debo seguir para comenzar las pruebas de integración de mi aplicación con LEXNET? En caso de no disponer de un usuario dado de alta en pruebas, consulte la pregunta frecuente Disponiendo ya de identificador para mi aplicación, con qué usuario puedo iniciar mis pruebas de integración? Cómo puedo o a quién me dirijo para resolver las dudas surgidas en la integración? Si ya dispone de un identificador para su aplicativo proporcionado por esta Subdirección para sus Pruebas en, puede realizar consultas asociadas a la integración de los servicios web de al equipo de desarrollo del mismo. Para ello, cumplimente el formulario de comunicación (rellenando las hojas INICIO y D) y envíelo a dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). Soy un integrador y he detectado una incidencia en un servicio web, cómo debo comunicarlo? Para la resolución rápida de incidencias en, es recomendable que cumplimente el formulario de comunicación (rellenando las hojas INICIO y E) y lo envíe a dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). En dicho formulario deberá rellenar un conjunto de apartados donde se identificará el entorno (PRUEBAS/PRODUCCIÓN) en el que se ha producido la incidencia así como el servicio web en el que se detectó dicha incidencia. Página 8

11 Qué pasos debo seguir para comenzar la utilización de mi aplicación en entorno real de producción de LEXNET? Una vez desarrollada una aplicación de integración con los servicios web de, es necesario superar un proceso de homologación. La homologación es el proceso que debe superar toda aplicación que desee empezar a utilizar el entorno real de, tras el desarrollo de la misma y la realización del Plan de Pruebas mínimo de. Si considera que su aplicación cumple los requisitos impuestos por el RD 84/2007 de y las condiciones básicas para llevar a cabo el proceso de homologación, puede realizar una solicitud enviando el formulario de comunicación (rellenando las hojas INICIO y F) a dessarrollo_lexnet@lista.mju.es indicando en el asunto [Servicios web_identificador de aplicación] (En identificador de aplicación se rellenará el identificador de la aplicación que se está desarrollando tal y como fue proporcionado por esta Subdirección). En respuesta a su solicitud de homologación, la Subdirección de Nuevas Tecnologías del Ministerio de Justicia le enviará un correo electrónico aceptando/denegando la homologación junto con una propuesta de fecha/hora y dirección donde se efectuará la homologación, en caso de aceptación o la explicación de los motivos de rechazo, en caso de denegación. Qué sucede en caso de no superar el proceso de homologación? En caso de que un desarrollador no supere el proceso de homologación, se le otorgará un plazo para realizar las modificaciones indicadas. Transcurrido dicho plazo, el desarrollador podrá volver a solicitar una nueva homologación. Si desea conocer cómo solicitar un proceso de homologación, consulte la pregunta frecuente Qué pasos debo seguir para comenzar la utilización de mi aplicación en entorno real de producción de LEXNET? Página 9

12 Quiero acceder a la aplicación web de Pruebas para realizar una solicitud de alta de un usuario de pruebas, Cuáles son los requisitos mínimos que tiene que tener mi ordenador para usar? Para poder acceder a Lexnet es necesario previamente que se cumpla todo lo siguiente: Disponer de un lector de tarjetas y haber instalado el software (drivers) correspondiente para permitir su uso y detección por parte de su ordenador. Disponer de un certificado digital importado en un dispositivo físico (tarjeta criptográfica) o un DNI electrónico y haber instalado o el software correspondiente a ese lector. Ej: cryptokit de la FNMT o Certificado Raíz de la Autoridad de Certificación de su tarjeta. Ej: certificados raíz de la FNMT Disponer, en el ordenador del usuario, de lo que sigue: o Sistema Operativo Windows XP, Windows Vista o Windows 7 de 32 bits o Navegador Internet Explorer 6, 7, 8 o 9 configurado para permitir ejecutar javascript y cookies. o Tener instalada la máquina virtual de Java 1.6. o superior (JRE o JDK). o Componente de firma (applet ).Si ya ha realizado las comprobaciones e instalaciones anteriores y dispone de todos esos elementos, al acceder a 3 Pruebas ( por primera vez, teniendo su tarjeta criptográfica insertada en su lector, se descargará e instalará de forma automática el componente de firma de. Para ello, es recomendable que la primera vez que acceda a disponga de permisos de administrador en su ordenador. Página 10