¿Problemas conectando tu Visual Studio Code con tu instancia de IRIS a través del WebGateway? ¡Pues aquí tienes unos consejos!

Como bien sabréis se ha procedido a eliminar el denominado Private Web Server que venía con cada instalación de IRIS, lo que hace necesario un servidor web externo.

En el caso de los despliegues en docker lo más común es hacer uso de la imagen webgateway (disponible aquí) junto con la de IRIS para poder acceder sin problemas al portal de gestión. Esta imagen se puede configurar para acceder vía HTTPS sin ningún problema configurando los certificados.

Problema 1: Unable to verify the first certificate

Posiblemente tu conexión SSL mediante el webgateway tiene configurado un certificado autofirmado y Visual Studio Code intenta verificarlo. Pues bien, quitemos dicha verificación:

Accediendo al menú de Settings y buscando por http encontraremos la opción Proxy Strict SSL, pues bien, desmarquémosla para que no intente validar el certificado. En Proxy Support seleccionaremos off.

Problema 2: /api/atelier web application not found

Os preguntareis que es eso de Atelier...pues muy sencillo, era el antiguo entorno de desarrollo de InterSystems basado en Eclipse y que ha quedado un poco..."legacy" en la configuración de IRIS.

Este a priori no debería ser muy común, pero es producido porque la aplicación web /api/atelier se encuentra deshabilitada. Para ello accederemos directamente al portal de gestión y buscamos la pantalla de administración de aplicaciones web desde el menú Administración > Seguridad > Aplicaciones > Aplicaciones Web buscamos /api/atelier

Efectivamente, la aplicación no está habilitada. Para modificarlo entramos en su configuración pulsando sobre el nombre y a continuación sólo tenemos que marcarla como Aplicación habilitada.

Con esa activación el problema debería quedar resuelto.

Problema 3: Servidor no disponible

Después de configurar todo el servidor sigue sin estar accesible mostrando un mensaje tal que así:

Lo más problable es que el WebGateway tenga configurado CSPSystems como el usuario de acceso a tu instancia de IRIS que por defecto aparece con el nombre de LOCAL. Para acceder a la consola del WebGateway lo puedes hacer desde el Portal de Gestión (Administración > Configuración > Gestión del Web Gateway) o bien directamente por la URL (https://IP_DEL_WEBGATEWAY:PUERTO_DEL_WEBGATEWAY/csp/bin/Systems/Module.cxw). Recordad que el usuario para acceder es CSPSystem (con la contraseña que se especificó durante la instalación).

La primera pantalla que veremos será la siguiente:

Desde aquí deberemos acceder a Server Access que os mostrará la siguiente pantalla:

Como veis únicamente tenemos configurado un servidor etiquetado como LOCAL que es el que nos permite acceder directamente al Portal de Gestión (en mi caso con la URL https://localhost/csp/sys/%25CSP.Portal.Home.zen). Veamos la configuración:

En efecto, el usuario configurado es CSPSystem y nuestra configuración de Visual Studio Code utiliza superuser para acceder, cambiemos la configuración para que haga uso de superuser y veamos que sucede:

¡Bingo! Problema resuelto. Ya estamos conectados a nuestro IRIS desde el Visual Studio Code WebGateway mediante.

Espero que os resulte de utilidad.