Wikis - CCIO

En la elaboración de un conector o mismo en su ejecución para consumir el servicio, uno se puede encontrar con dudas o dificultades de distinta índole. Esto lo podríamos agrupar respecto al área donde reside la duda o dificultad, es decir, temas de configuración, temas de ejecución y temas de plataforma.

**Configuración**

Una vez descargado e instalado el Conector PGE, se pueden presentar dificultades al momento de levantar el servidor.

Una de las problematicas más comunes corresponde a temas de memoria, como se especifica en el archivo error.txt. Este problema indica que la memoria asignada a la JVM no es suficiente y es recomendable aumentarla. La configuración que se recomienda para el servidor es la que se describe aquí debajo.

Windows:

set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx1024m -XX:PermSize=200M -XX:MaxPermSize=200M

set JAVA_OPTS=%JAVA_OPTS% -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000

Linux:

JAVA_OPTS="-Xms512m -Xmx1024m -XX:PermSize=200M -XX:MaxPermSize=200M -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"

Otros problemas que surgen comunmente son los de configuración de certificados del Conector PGE. A continuación se muestran imagenes de los errores indicados por la herramienta.

• El Keystore no contiene ningún certificado con el alias especificado

Para resolver este problema se debe verificar que el Alias indicado en la configuración coincida con el certificado que se encuentra dentro del keystore de organismo.

Truststore: Password incorrecto

​​​​​​​

Se debe revisar la contraseña ingresada tanto en el truststore como en la configuración.

No se pudo obtener la URL del wsdl o No se pudo procesar las operaciones del wsdl

Este problema es causado tipicamente por problemas en la estructura del WSDL, ya sea porque no contiene la URL del servicio o hay estructura mal formadas.

Ejecución

Una vez configurado, al momento de ejecutar el consumo de un servicio, se pueden encontrar errores que en algunos casos corresponden al Conector PGE, mientras que otros son propios de la plataforma. En este sentido nos parece importante diferenciar cuáles corresponden al Conector PGE y cuáles no.

Listado de códigos de error manejados por el Conector PGE

- 900: Error de certificado

- 901: Error de I/O

- 902: Error de Key

- 903: Error de Keystore

- 904: Error de RST

- 905: Error de parseo de token

- 906: Error de assertion

- 907: Error de unmarshall de token

- 908: Error al invocar STS

- 909: El mensaje no tiene MessageID

- 910: No se pudo conectar con el servicio

- 911: Url inválida

- 999: Error desconocido

A continuación repasamos los mensajes asociados a algunos de estos errores junto con sus posibles causas.

Error 901: java.io.IOException: Keystore was tampered with, or password was incorrect

Esta respuesta indica un problema en el acceso a alguno de los keystores o truststore y por lo general es debido a un error en la constraseña de alguno de ellos.

Error 901: java.net.UnknownHostException: testservicios.pge.red.uy

Esta respuesta indica que hay un problema de conectividad del Conector PGE. Lo recomendable en estos casos es ejecutar en línea de comandos lo siguiente:

telnet testservicios.pge.red.uy 6051

Si se tiene un problema de conexión, esta prueba devolverá un error.

Error 901: java.net.ssl.SSLPeerUnverifiedException: peer not authenticated

Este caso es el más común de los tres y está fuertemente relacionado con la confección del keystore y truststore SSL. Si alguno de ellos tiene algún error, como por ejemplo que el truststore no tenga el certificado correcto, se devuelve este mensaje.

Error 901: java.io.IOException: Invalid keystore format

Este error en general sucede cuando los certificados no están correctamente configurados en el Conector PGE. Tener en cuenta que los certificados que hay que subir al conector no son los archivos ".cer", sino que hay que subir los almacenes de certificados correspondientes. Estos son identificados típicamente con la extensión ".keystore" y ".truststore"

Error 902: java.security.UnrecoverableKeyException: Cannot recover key

Este error es provocado por diferencias en las constraseñas del keystore SSL. El problema surge a partir de que el Conector PGE utiliza la misma contraseña tanto para abrir el keystore como para abrir la clave privada del certificado que se encuentra dentro, Si el keystore y la clave privada del certificado tienen contraseñas distintas, se devuelve este mensaje.

Error 903:

Este problema se da con el keystore de organismo, cuando no se encuentra un certificado con el alias especificado.

Error 908: uy.gub.agesic.exceptions.RequestSecurityTokenException

Este mensaje representa un error en los datos enviado para obtener el token de seguridad, en particular con el dato de tipo de token y el rol. Para corregir este problema se debe revisar que el tipo de token sea urn:tokensimple, para el ambiente de testing y urn:std15 para el ambiente de producción. En cuanto al rol, se debe verificar que tenga la estructura ou={nombre1},o={nombre2}.

Por otra parte, este error hace referencia a un problema con el certificado de persona jurídica. Cuando se envía un request de token, este es firmado por un certificado que debe ser de confianza de la plataforma. Si este request no es firmado con un certificado válido para la plataforma, se devuelve este error.

Error 910:

Como lo indica el mensaje de error esto es causado porque el Conector PGE no puede conectarse a la url especificada. Se debe revisar en primera instancia que la url sea correcta y adicionalmente que no tenga espacios al principio o al final.

Error 999:

Los errores catalogados con este código refieren a errores no identificados por el Conector PGE. Para estos casos es recomendable comunicarse con soporte@agesic.gub.uy adjuntando el log para analizar en profundidad.Algunos errores de ejemplo son:

999 Error desconocido: unsupported protocol: 'testservicios.pge.red.uy'

En este caso el problema se origina con un error en la url especificada, en la cual no se está indicando un protocolo o se está indicando uno no soportado.

999 Error desconocido: El path /test/OrdenCompr no se encuentra asociado a ningún conector

Este mensaje es devuelto cuando se está intentando acceder a un conector pero que no se encuentra publicado el path especificado.

Plataforma

Por otra parte, al momento de consumir un servicio, se pueden encontrar otros errores distintos a los mencionados y que no necesariamente pueden estar relacionados con la configuración del Conector PGE. A continuación se muestran algunos ejemplos.

En este caso el problema es entre la plataforma y el servicio final. Para más información se puede buscar en los foros las posibles causas.

En este caso el problema es entre el que invoca y la plataforma. Los motivos de este error son variados. Se recomienda buscar información en los foros o consultar con soporte@agesic.gub.uy

Esto es un problema con el campo wsa:To, ya sea porque no se configuró el dato correcto o no se registró en la plataforma.

El problema en estos casos es no es claro y requiere un mayor análisis. Se recomienda revisar en los foros o comunicarse con soporte@agesic.gub.uy