Utiliser des ports non par défaut pour l’instance ArcGIS Web Adaptor du portail

Pour la vaste majorité des utilisateurs de ArcGIS Enterprise, il est approprié d’exécuter ArcGIS Web Adaptor sur les ports par défaut 80 et 443. Dans certains cas rares toutefois, une instance de Web Adaptor ne peut pas utiliser ces ports par défaut sur le serveur web qui l’héberge. Par exemple, le serveur web hôte peut déjà disposer d’une application s’exécutant sur ces ports ou l’accès aux ports peut être restreint dans une organisation sécurisée.

Dans ces situations où les ports 80 et 443 ne peuvent pas être utilisés, une solution est disponible dans ArcGIS Enterprise 10.6.1 pour permettre à l’instance Web Adaptor du portail de s’exécuter sur des ports non par défaut. Un serveur proxy inverse ou un système d’équilibrage de la charge doit alors être configuré de sorte que les utilisateurs accèdent au portail via les ports par défaut. L’utilisation de HTTPS doit encore être maintenue pour chiffrer les communications entre ArcGIS Web Adaptor et Portal for ArcGIS.

Dans la version 10.6.1, le fichier de configuration ArcGIS Web Adaptor comporte une nouvelle propriété, EnableDefaultPortValidation, qui par défaut met en œuvre l’utilisation des ports par défaut 80 et 443 lors de la configuration de ArcGIS Web Adaptor avec un portail. Redéfinir la valeur de cette propriété sur false (faux) à pour effet de contourner cette validation, permettant à ArcGIS Web Adaptor de s’exécuter sur des ports non par défaut.

Configurer l’instance ArcGIS Web Adaptor du portail sur des ports non par défaut

Si le serveur web prévu pour héberger l’instance ArcGIS Web Adaptor de votre portail doit exécuter le logiciel sur des ports autres que les ports 80 et 443, vous devez effectuer quelques étapes supplémentaires lors de la configuration de Web Adaptor via les assistants d’installation et de configuration.

1. Activez HTTPS sur le serveur web allant héberger l’instance Web Adaptor. Prenez note du port utilisé pour les communications HTTPS, car il sera utilisé pour accéder à ArcGIS Web Adaptor pendant la configuration initiale avec le portail.
2. Installez ArcGIS Web Adaptor sur le serveur web, en utilisant l’assistant d’installation Setup.exe comme utilisateur disposant de privilèges administratifs.
3. Sur la machine hébergeant ArcGIS Web Adaptor, accédez au fichier webadaptor.config et ouvrez-le dans un éditeur de texte. Par défaut, ce fichier figure dans le dossier /root.webadaptor/<web adaptor name>.
4. Dans le fichier webadaptor.config, localisez la propriété EnableDefaultPortValidation, dont la valeur par défaut est true (vrai). Redéfinissez la valeur sur false (faux) : <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
5. Redémarrez le serveur web.
6. Ouvrez la page de configuration ArcGIS Web Adaptor dans un navigateur Internet sur le port HTTPS utilisé par le serveur web à l’aide du format d’URL https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor/portal. Si un alias DNS doit être utilisé avec le portail, Web Adaptor doit être configuré via l’alias à la place, à l’aide d’une URL telle que https://dnsalias.domain.com:<https_port>/<webadaptorname>/webadaptor/portal.
7. Pour la propriété Portal URL (URL de portail), tapez l’URL de la machine hébergeant le logiciel Portal for ArcGIS à l’aide du nom de domaine complet de la machine dans l’URL (par exemple, https://portal.domain.com:7443).
8. Indiquez le nom d’utilisateur et le mot de passe d’un compte qui permet une connexion en tant qu’administrateur à Portal for ArcGIS. Vous utilisez généralement l’identifiant du compte d’administrateur initial que vous avez défini lors de la première configuration de votre portail. Si vous rétrogradez ou supprimez le compte d’administrateur initial, vous devez spécifier un compte différent disposant d’un accès administrateur au site web du portail.
9. Cliquez sur Configurer.
10. Configurez le portail avec le serveur proxy inverse ou le système d’équilibrage de la charge de votre organisation, de sorte que les utilisateurs accèdent au portail via les ports par défaut. Pour ce faire, vous devez fournir au portail certaines informations sur le serveur proxy inverse ou le système d’équilibrage de la charge. Pour obtenir des instructions complètes, reportez-vous à la rubrique Utilisation d’un serveur proxy inverse avec Portal for ArcGIS.
11. Après avoir configuré le serveur proxy inverse ou le système d’équilibrage de la charge avec votre portail, actualisez la page de configuration ArcGIS Web Adaptor pour la mettre à jour.

Une fois ce processus terminé, ArcGIS Web Adaptor est configuré pour être utilisé avec votre portail ArcGIS Enterprise. Les utilisateurs accéderont uniquement au portail et au répertoire administrateur ArcGIS Portal via le serveur proxy inverse, avec le format d’URL https://reverseproxy.domain.com/webadaptorname/home, plutôt que via le port 7443.

Astuce:

Si vous avez configuré votre portail de manière à utiliser HTTPS pour toutes les communications, mettez à jour le site web du portail installé et les URL des raccourcis d’aide afin d’utiliser https au lieu de http.

Configurer en mode silencieux l’instance ArcGIS Web Adaptor (Java Platform) du portail sur des ports non par défaut

L’installation et la configuration de votre instance ArcGIS Web Adaptor (Java Platform) peuvent également s’effectuer via la ligne de commande, avec des étapes supplémentaires pour une exécution sur des ports non par défaut.

Remarque :

Pour exécuter l’utilitaire de ligne de commande, l’environnement d’exécution Java (JRE) doit être présent sur la machine qui héberge ArcGIS Web Adaptor. Si l'environnement d'exécution Java n'est pas installé sur votre ordinateur, une erreur se produira lors de l'exécution de l'utilitaire. Reportez-vous à la rubrique Téléchargements de Java SE pour des instructions sur la façon de télécharger et d'installer l'environnement d'exécution Java sur l'ordinateur.

1. Activez HTTPS sur le serveur web allant héberger l’instance Web Adaptor. Prenez note du port utilisé pour les communications HTTPS, car il sera utilisé pour accéder à ArcGIS Web Adaptor pendant la configuration initiale avec le portail.
2. Installez ArcGIS Web Adaptor sur le serveur web, en utilisant l’utilitaire de ligne de commande d’installation comme utilisateur disposant de privilèges administratifs.
3. Sur la machine hébergeant ArcGIS Web Adaptor, accédez au fichier webadaptor.config et ouvrez-le dans un éditeur de texte.
4. Dans le fichier webadaptor.config, localisez la propriété EnableDefaultPortValidation, dont la valeur par défaut est true (vrai). Redéfinissez la valeur sur false (faux) : <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
5. Redémarrez le serveur web.
6. Configurez ArcGIS Web Adaptor à l’aide de l’utilitaire de ligne de commande configurewebadaptor.sh, situé dans le dossier <ArcGIS Web Adaptor installation directory>/webadaptor<version>/java/tools. Vous utiliserez la syntaxe ConfigureWebAdaptor.sh -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password>. Les paramètres à fournir sont les suivants :

   • <Mode> : mode du produit dans lequel ArcGIS Web Adaptor sera configuré. Définissez ce paramètre sur portal pour l’utiliser avec Portal for ArcGIS.
   • <WebAdaptorURL> : l’URL de ArcGIS Web Adaptor que vous souhaitez configurer à partir de la ligne de commande. Il s’agit de l’URL à utiliser pour accéder à la page de configuration dans un navigateur web. Vous devez spécifier l’URL HTTPS de ArcGIS Web Adaptor (par exemple, https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor). Si un alias DNS doit être utilisé avec le portail, Web Adaptor doit être configuré via l’alias DNS, à l’aide d’une URL telle que https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor.
   • <URL> : URL de la machine qui héberge Portal for ArcGIS. Incluez le nom de domaine complet de la machine dans l’URL (par exemple, https://portal.domain.com:7443).
   • <Username> : nom d’utilisateur d’un compte qui permet une connexion en tant qu’administrateur à Portal for ArcGIS. Vous utilisez généralement le compte d'administrateur initial que vous avez défini lors de la première configuration de votre portail.
   • <Password> : mot de passe d’un compte qui permet une connexion en tant qu’administrateur à Portal for ArcGIS. Vous utilisez généralement le compte d'administrateur initial que vous avez défini lors de la première configuration de votre portail.

   Exemple de commande

   configurewebadaptor.sh -m portal -w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor -g https://portal.domain.com:7443 -u initialadmin -p secret123

7. Configurez le portail avec le serveur proxy inverse ou le système d’équilibrage de la charge de votre organisation, de sorte que les utilisateurs accèdent au portail via les ports par défaut. Pour ce faire, vous devez fournir au portail certaines informations sur le serveur proxy inverse ou le système d’équilibrage de la charge. Pour obtenir des instructions complètes, reportez-vous à la rubrique Utilisation d’un serveur proxy inverse avec Portal for ArcGIS.

Une fois ce processus terminé, ArcGIS Web Adaptor est configuré pour être utilisé avec votre portail ArcGIS Enterprise. Les utilisateurs accéderont uniquement au portail et au répertoire administrateur ArcGIS Portal via le serveur proxy inverse, avec le format d’URL https://reverseproxy.domain.com/webadaptorname/home, plutôt que via le port 7443.

Astuce:

Si vous avez configuré votre portail de manière à utiliser HTTPS pour toutes les communications, mettez à jour le site web du portail installé et les URL des raccourcis d’aide afin d’utiliser https au lieu de http.