Vous rencontrez des difficultés pour connecter votre Visual Studio Code à votre instance IRIS via WebGateway ? Voici quelques conseils !

Comme vous le savez peut-être, le serveur web privé fourni avec chaque installation IRIS a été supprimé, rendant nécessaire l'utilisation d'un serveur web externe.

Pour les déploiements Docker, il est courant d'utiliser l'image de passerelle web (disponible ici) avec l'image IRIS pour accéder facilement au Portail de Gestion. Cette image peut être configurée pour un accès via HTTPS sans problème en configurant les certificats.

Problème 1 : Impossible de vérifier le premier certificat

Votre connexion SSL via la Web Gateway peut disposer d'un certificat auto-signé configuré, et Visual Studio Code tente de le vérifier. Supprimons cette vérification :

En accédant au menu Settings et en recherchant http, vous trouverez l'option Proxy Strict SSL. Décochez-la pour l'empêcher de tenter de valider le certificat. Dans Proxy Support, sélectionnez Off.

Problème 2 : application Web /api/atelier introuvable

Vous vous demandez peut-être ce qu'est Atelier… Eh bien, c'est très simple : c'était l'ancien environnement de développement InterSystems basé sur Eclipse, devenu un peu un « héritage » dans la configuration IRIS.

Ce problème ne devrait pas être très courant, mais il est dû à la désactivation de l'application web /api/atelier. Pour ce faire, accédez directement au portail de gestion et recherchez l'écran d'administration de l'application web. Dans le menu Administration > Sécurité > Applications > Applications web, recherchez /api/atelier.

En effet, l'application n'est pas activée. Pour modifier cela, accédez à ses paramètres en cliquant sur sa nom, puis sélectionnez « Enable Application ».

Avec cette activation, le problème devrait être résolu.

Problème 3 : Serveur indisponible

Après avoir tout configuré, le serveur n'est toujours pas accessible, affichant un message comme celui-ci :

Il est fort probable que la Web Gateway ait configuré CSPSystems comme utilisateur d'accès à votre instance IRIS, qui s'affiche par défaut sous le nom LOCAL. Pour accéder à la console de la Web Gateway, vous pouvez le faire depuis le pPortail de Gestion (Administration > Configuration > Web Gateway Management) ou directement via l'URL (https://WEBGATEWAY_IP:WEBGATEWAY_PORT/csp/bin/Systems/Module.cxw). N'oubliez pas que l'utilisateur d'accès est CSPSystem (avec le mot de passe spécifié lors de l'installation).

Le premier écran affiché est le suivant :

À partir de là, nous devons accéder à Server Access qui vous montrera l'écran suivant :

Comme vous pouvez le constater, nous n'avons configuré qu'un seul serveur, nommé LOCAL, qui nous permet d'accéder directement au Portail de Gestion (dans mon cas, via l'URL https://localhost/csp/sys/%25CSP.Portal.Home.zen). Voyons la configuration :

En effet, l'utilisateur configuré est CSPSystem et notre configuration Visual Studio Code utilise le superutilisateur pour accéder, modifions la configuration pour utiliser le superuser et voyons ce qui se passe :

Bingo ! Problème résolu. Nous sommes maintenant connectés à notre IRIS depuis la passerelle Web de Visual Studio Code.

J'espère que cela vous sera utile.