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

Pour la vaste majorité des utilisateurs d’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 les scénarios où il n’est pas possible de configurer Web Adaptor pour le portail sur les ports 80 et 443, vous pouvez l’autoriser à s’exécuter sur des ports autres que ceux par défaut. Pour ce faire, vous devez configurer un serveur proxy inverse ou un équilibreur de charge et l’intégrer à votre portail. Ainsi, les utilisateurs pourront accéder au portail via les ports par défaut, selon les besoins. L’utilisation de HTTPS doit encore être maintenue pour chiffrer les communications entre ArcGIS Web Adaptor et Portal for ArcGIS.

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 d’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 devant héberger ArcGIS Web Adaptor pour votre portail doit exécuter le logiciel sur des ports autres que les ports 80 et 443, vous devez suivre des étapes supplémentaires lors de la configuration de Web Adaptor à l’aide des 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 de ArcGIS Web Adaptor dans un navigateur Internet sur le port HTTPS utilisé par le serveur Web à l’aide d’une URL au format 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 disposant de privilèges d’administration pour 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 l’équilibreur de 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.

ArcGIS Web Adaptor est maintenant 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.

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 que vous puissiez 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 tel n’est pas le cas, une erreur se produit lors de l’exécution de l’utilitaire. Reportez-vous à la rubrique Téléchargements de Java SE pour savoir comment télécharger et 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. 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. 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 <Machine Name|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 d’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 d’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 disposant de privilèges d’administration pour 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 portal.domain.com -u initialadmin -p secret123

7. Configurez le portail avec le serveur proxy inverse ou l’équilibreur de 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.

ArcGIS Web Adaptor est maintenant 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.