SERVICIO DE CONSULTA DE ESTADOS POR CÓDIGO DE CERTIFICADO

Transcripción

1 SERVICIO DE CONSULTA DE ESTADOS POR CÓDIGO DE CERTIFICADO

2 HISTÓRICO DE VERSIONES Fecha Versión Doc. Ref. Descripción Autor Revisado Aprobado 30/12/ DI_CONSULTA_ESTADOS_v1.0 Versión Inicial 08/10/ DI_CONSULTA_ESTADOS_v1.1 Se añaden servicios externos y información sobre el cliente web del servicio, se modifica la descripción del campo estado. Ivan Magdaleno Ivan Magdaleno Vanessa Herves Vanessa Herves Documento de Integración - Página 2 de 16

3 Contenidos 1. DESCRIPCIÓN DEL SISTEMA Servicio de INTERCAMBIO DE MENSAJES Servicio de Mensaje de Petición al Servicio de Formato de los Datos de la Petición al Servicio de Consulta de Estado por Código de Esquema de validación de la Petición al Servicio de Consulta de Estado por Código de Mensaje de Respuesta al Servicio de Formato de los Datos de la Respuesta del Servicio de Consulta de Estado por Código de Esquema de validación de la Respuesta al Servicio de Consulta de Estado por Código de Interfaz proporcionada por la Plataforma de Intermediación para el servicio de Consulta de Estado por Código de Cliente web PERSONAL DE CONTACTO DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS INDICE DE FIGURAS Documento de Integración - Página 3 de de Mayo de 2010

4 1. DESCRIPCIÓN DEL SISTEMA La Plataforma de Intermediación de Servicios se ha creado para poder intermediar cualquier tipo de certificado emitido por los Organismos que sea necesario dentro de cualquier procedimiento de tramitación que requiera de dicha información. El ámbito legal en el que se enmarca este proyecto se define dentro del Plan de Actuación de la Ley de Acceso Electrónico de los Ciudadanos a los Servicios Públicos (LAECSP) en la medida 14. La Plataforma de Intermediación de Servicios desarrollada por el Ministerio de Hacienda y Administaciones Públicas (MINHAP) hace uso de la infraestructura existente del Servicio de Verificación de Datos (SVD) para reaprovechar todas las características de estabilidad, monitorización y disponibilidad de la misma. Ésta plataforma podrá ser utilizada directamente por los empleados públicos de las unidades gestoras de cualquier Administración Pública autorizados a tal efecto, o de forma automatizada por las aplicaciones que sean adaptadas para incluir dichas consultas. El servicio pretende dar cobertura a todos los organismos gestores de la Administración susceptibles de proporcionar algún tipo de trámite administrativo a los ciudadanos. Además el nuevo sistema será lo suficientemente flexible como para ser utilizado en el ámbito de cada Ministerio, Organismo, Comunidad Autónoma y Ente Local. Las características, a grandes rasgos, incluidas en el sistema se enumeran a continuación: Proveer al sistema SVD de la capacidad de facilitar información de cualquier certificado que previamente se haya incluido en dicha Plataforma. Los datos del certificado serán proporcionados directamente por cada Organismo siendo la Plataforma de Intermediación de Servicios la encargada de interactuar con los distintos Organismos. Identificación del centro gestor y del usuario que accede a la aplicación a través de certificados digitales. Como plataforma de validación de certificados y comprobación de las firmas digitales se empleará la existente en el MINHAP. Capacidad de mantener esa gestión de centros gestores / usuarios a través de una herramienta de administración (centralizada/delegada). En esta versión de la Plataforma de Intermediación de Servicios se ha proporcionado una heramienta para consultar el estado de los diferentes servicios ofrecidos facilitando el código del certificado sobre el que se desea consultar la disponibilidad. La principal funcionalidad del producto es ofrecer información del estado en tiempo real de los Servicios Web de la Plataforma de Intermediación. En concreto se informa de: Número de peticiones tramitadas desde que el servicio está disponible Número de peticiones fallidas desde que el servicio está disponible Tiempo medio de respuesta Disponibilidad actual del servicio Documento de Integración - Página 4 de 16

5 1.1 Servicio de Las aplicaciones clientes que deseen consultar este servicio, lo harán a través de la Plataforma de Intermediación de forma directa, podrán acceder al servicio a través del WebService expuesto por la Plataforma de Intermediación. La principal funcionalidad del servicio es ofrecer el estado en tiempo real de los servicios de la Plataforma de Intermediación y de la Plataforma del Servicio de Comunicación de Cambio de Domicilio. Para acceder a la información de acuerdo de nivel de servicio (SLA) de cada servicio de la Plataforma de Intermediación, es necesario utilizar como parámetro el código de certificado único que identifica el servicio. La lista de certificados admitidos es la siguiente: Organismo Emisor TGSS Servicio Estar al corriente de Pago con Seg.Social- Deuda Versión V3 Código Q ATGSS001 Alta en Fecha V3 Q ATGSS006 AEAT SPEE Servicio Público de Empleo Estatal DGP INE EDUCACION CATASTRO s de estar al corriente de las obligaciones tributarias i Contratación con las AAPP (Según ley de Contratos) V3 AEAT101I Obtención de licencias de transporte V3 AEAT102I Solicitud de ayudas y subvenciones V3 AEAT103I Tramitación de permisos de residencia y trabajo para extranjeros Servicios de Prestaciones por Desempleo V3 AEAT104I Situación actual de Desempleo V2 SVDSPEESITWS01 Importes de prestación de desempleo percibidos a fecha actual Importes de prestación de desempleo percibidos en un periodo V2 V2 SVDSPEEIACTWS01 SVDSPEEIPERWS01 Consulta de Datos de Identidad V2 CDISFWS01 Datos de Identidad-Verificación V2 VDISFWS01 Datos de Residencia ii V2 VDRSFWS01 Datos de Residencia Extendidos V2 VDRSFWS02 Títulos Universitarios V2 SVDTUWS01 Títulos No Universitarios V2 SVDTNUWS01 Consulta de Datos catastrales V2 SVDCDATWS01 Certificación de Titularidad V2 SVDCTITWS01 Consulta de Bienes Inmuebles V2 SVDCBIWS01 Obtención de Descriptiva y Gráfica V2 SVDCDYGWS01 MPTAP Cambio de domicilio V2 MAP01WS01 También es posible acceder a la información de los servicios externos que consume la propia Plataforma de Intermediació, es necesario utilizar como parámetro el código de servicio externo único que identifica el servicio. Documento de Integración - Página 5 de 16

6 La lista de códigos admitidos es la siguiente: Organismo Validación de firma Servicio Validación de certificados Código Serv. Externo AFVF AFVC TSA TSA TSA INE Datos de Residencia INE DGP Datos de Identidad DGP En los siguientes puntos, se especifican los mensajes que se intercambian en las comunicaciones establecidas durante la consulta de estados por certificado. Documento de Integración - Página 6 de 16

7 2. INTERCAMBIO DE MENSAJES Las peticiones realizadas a la plataforma de intermediación para obtener información acerca de este servicio se pueden llevar a cabo a través de un tipo de comunicación síncrona en la cual, un cliente realiza una petición al servicio deseado y permanece a la espera de la respuesta. El modelo de petición síncrono sólo admitirá una única solicitud de información dentro de cada petición recibida. El intercambio de mensajes será el siguiente. Figura 1. Esquema comunicaciones peticiones síncronas 2.1 Servicio de Mensaje de Petición al Servicio de A continuación se recoge el esquema de validación del mensaje de petición que debe recibir la plataforma de intermediación para una petición de. Como se aprecia en las figuras siguientes el servicio espera recibir un campo del tipo InfoType, que esta compuesto por un campo del tipo Info, y este a su vez por un campo del tipo certificado. Figura 2.Mensaje de Petición al Servicio de Consulta de Estado por Código de Figura 3.Mensaje detallado de Petición al Servicio de Consulta de Estado por Código de Documento de Integración - Página 7 de 16

8 2.1.2 Formato de los Datos de la Petición al Servicio de Consulta de Estado por Código de En la siguiente tabla se resume el tipo de dato y la información que contienen cada uno de los campos del mensaje de petición. Ubicación Nombre Tipo Etiqueta Obligatoria Campo Obligatorio Descripción Info Info BLOQUE Sí No procede Bloque Único. Contiene los datos de solicitud del certificado a consultar. Info / certificado certificado String Sí Sí Código del certificado a solicitar. En el caso de ser un certificado que no existe el sistema devolverá los campos a cero y un estado de no disponible. Como ejemplo XML de petición tenemos: <soapenv:envelope xmlns:soapenv=" xmlns:tns=" <soapenv:header/> <soapenv:body> <tns:info> <certificado>aeat101i</certificado> </tns:info> </soapenv:body> </soapenv:envelope> Esquema de validación de la Petición al Servicio de Consulta de Estado por Código de A continuación se describe el esquema de validación que se aplicará sobre los datos que la Plataforma de Intermediación reciba para una petición al servicio de Consulta de Estado por Código de, al ser un servicio muy sencillo el esquema de petición y respuesta se incluyen en el propio wsdl. <xsd:element name="info" type="impl:infotype"/> <xsd:complextype name="infotype"> <xsd:sequence> <xsd:element name="certificado" type="xsd:string" minoccurs="1"/> </xsd:sequence> </xsd:complextype> Mensaje de Respuesta al Servicio de A continuación se recoge el esquema de validación del mensaje de petición que debe recibir la plataforma de intermediación para una respuesta de. Documento de Integración - Página 8 de 16

9 Como se aprecia en las figuras siguientes el servicio espera recibir un campo del tipo EstadoType, que esta compuesto por un campo del tipo Estado, y este a su vez por una secuencia de campos del tipo throughput, avgresptime, faul, available. Figura 4.Mensaje de Respuesta del Servicio de Consulta de Estado por Código de Figura 5.Mensaje detallado de Respuesta del Servicio de Consulta de Estado por Código de Formato de los Datos de la Respuesta del Servicio de Consulta de Estado por Código de En la siguiente tabla se resume el tipo de dato y la información que contienen cada uno de los campos del mensaje de petición. Ubicación Nombre Tipo Etiqueta Obligatoria Campo Obligatorio Descripción Estado Estado BLOQUE Sí No procede Estado / throughput throughput String Sí Sí Estado / avgresptime avgresptime String Sí Sí Bloque Único. Contiene los datos de solicitud del certificado consultado. Indica el total de peticiones correctas gestionadas desde que el Servidor de Aplicaciones (Servicio) está disponible, son datos agregados sin más información. Se reinicia cada vez que el Servidor de Aplicaciones (servicio) se reinicia. Media agregada del tiempo de respuesta del servicio medido en milisegundos. Documento de Integración - Página 9 de 16

10 Estado / fault fault String Sí Sí Estado / available available String Sí Sí Indica el total de peticiones fallidas gestionadas desde que el Servidor de Aplicaciones (Servicio) está disponible, son datos agregados sin más información. Se reinicia cada vez que el Servidor de Aplicaciones (servicio) se reinicia. Ofrece dos valores en función a la última petición recibida en servicio consultado: -DISPONIBLE (1) -NO DISPONIBLE (0) Como ejemplo de respuesta tenemos: <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <Estado> <throughput>84</throughput> <fault>1</fault> <avgresptime> </avgresptime> <available>0</available> </Estado> </soapenv:body> </soapenv:envelope> Esquema de validación de la Respuesta al Servicio de Consulta de Estado por Código de A continuación se describe el esquema de validación que se aplicará sobre los datos que la Plataforma de Intermediación reciba para una petición al servicio de Consulta de Estado por Código de, al ser un servicio muy sencillo el esquema de petición y respuesta se incluyen en el propio wsdl. <xsd:element name="estado" type="impl:estadotype"/> <xsd:complextype name="estadotype"> <xsd:sequence> <xsd:element name="throughput" type="xsd:string" minoccurs="1"/> <xsd:element name="avgresptime" type="xsd:string" minoccurs="1"/> <xsd:element name="fault" type="xsd:string" minoccurs="1"/> <xsd:element name="available" type="xsd:string" minoccurs="1"/> </xsd:sequence> </xsd:complextype> Interfaz proporcionada por la Plataforma de Intermediación para el servicio de Consulta de Estado por Código de A continuación se introduce el WSDL o formato XML que describe el servicio de red como un punto final que opera sobre mensajes que contienen información orientada a documentos o a procesos. Documento de Integración - Página 10 de 16

11 Protocolo sincrono El nombre del servicio publicado en la interfaz WSDL es ConsultaEstado. Este servicio contiene una única operación estadopor con un parámetro de entrada InfoType y uno de salida EstadoType. El tipo de transporte para la operación es SOAP y el valor de SOAPAction definido es realizapeticion. El valor que tome la variable servidor de conexión dependerá del entorno sobre el que se realice la petición: Preproducción: Producción: Figura 6.WSDL del Servicio de Consulta de Estado por Código de Documento de Integración - Página 11 de 16

12 <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions xmlns=" xmlns:impl=" xmlns:soapenc=" xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" targetnamespace=" <wsdl:types> <schema targetnamespace=" xmlns=" <xsd:element name="estado" type="impl:estadotype"/> <xsd:element name="info" type="impl:infotype"/> <xsd:complextype name="estadotype"> <xsd:sequence> <xsd:element name="throughput" type="xsd:string" minoccurs="1"/> <xsd:element name="avgresptime" type="xsd:string" minoccurs="1"/> <xsd:element name="fault" type="xsd:string" minoccurs="1"/> <xsd:element name="available" type="xsd:string" minoccurs="1"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="infotype"> <xsd:sequence> <xsd:element name="certificado" type="xsd:string" minoccurs="1"/> </xsd:sequence> </xsd:complextype> </schema> </wsdl:types> <wsdl:message name="info"> <part name="parameters" element="impl:info"/> </wsdl:message> <wsdl:message name="estado"> <part name="parameters" element="impl:estado"/> </wsdl:message> <wsdl:porttype name="peticionporttype"> <wsdl:operation name="estadopor"> <wsdl:input message="impl:info"/> <wsdl:output message="impl:estado"/> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="estadoserviciosscspsoapbinding" type="impl:peticionporttype"> <wsdlsoap:binding style="document" transport=" <wsdl:operation name="estadopor"> <wsdlsoap:operation soapaction="realizapeticion" style="document"/> <wsdl:input> <wsdlsoap:body use="literal"/> </wsdl:input> <wsdl:output> <wsdlsoap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="estadoserviciosscsp"> <wsdl:port name="estadoserviciosscsp" binding="impl:estadoserviciosscspsoapbinding"> <wsdlsoap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> Documento de Integración - Página 12 de 16

13 3. CLIENTE WEB Es posible acceder a la invocación de estos servicios de forma automática, por medio de la URL a continuación y pulsando sobre solicitor datos para conocer el estado de los diferentes certificados: Preproducción: o Producción: o Figura 7.Captura de pantalla cliente web de consulta de estados Documento de Integración - Página 13 de 16

14 4. PERSONAL DE CONTACTO Nombre Soporte Intermediación Teléfono Documento de Integración - Página 14 de 16

15 5. DEFINICIONES, ACRÓNIMOS Y ABREVIATURAS LAECSP: Ley de Acceso Electrónico de los Ciudadanos a los Servicios Públicos. SVD: Servicio de Verificación de Datos. SLA: Acuerdo de Nivel de Servicio. WSDL: Lenguaje de descripción de servicios web (Web Services Description Language). XSD: Definición de esquema XML (XML Schema Definition) XML: Lenguaje extensible de etiquetas (Extensible Markup Language) Documento de Integración - Página 15 de 16

16 6. INDICE DE FIGURAS FIGURA 1. ESQUEMA COMUNICACIONES PETICIONES SÍNCRONAS... 7 FIGURA 2. MENSAJE DE PETICIÓN AL SERVICIO DE CONSULTA DE ESTADO POR CÓDIGO DE CERTIFICADO... 7 FIGURA 3. MENSAJE DETALLADO DE PETICIÓN AL SERVICIO DE CONSULTA DE ESTADO POR CÓDIGO DE CERTIFICADO... 7 FIGURA 4. MENSAJE DE RESPUESTA DEL SERVICIO DE CONSULTA DE ESTADO POR CÓDIGO DE CERTIFICADO... 9 FIGURA 5. MENSAJE DETALLADO DE RESPUESTA DEL SERVICIO DE CONSULTA DE ESTADO POR CÓDIGO DE CERTIFICADO... 9 FIGURA 6. WSDL DEL SERVICIO DE CONSULTA DE ESTADO POR CÓDIGO DE CERTIFICADO FIGURA 7. CAPTURA DE PANTALLA CLIENTE WEB DE CONSULTA DE ESTADOS Documento de Integración - Página 16 de 16