Configurer ArcGIS Web Adaptor

Après avoir installé ArcGIS Web Adaptor, vous devez le configurer pour qu’il fonctionne avec un site de serveur et avec votre portail ArcGIS Enterprise. À cette fin, vous utilisez la page Web de configuration ou un utilitaire de ligne de commande installé avec ArcGIS Web Adaptor.

L’état actuel d’ArcGIS Web Adaptor s’affiche lorsque vous ouvrez la page de configuration. Il indique si ArcGIS Web Adaptor a déjà été configuré auparavant. Pour afficher le type de plateforme et le numéro de version de Web Adaptor, cliquez sur About (À propos) dans la page de configuration.

Remarque :

À compter d’ArcGIS Enterprise 11.5, l’accès administratif au site ArcGIS Server via Web Adaptor est activé par défaut et ne peut pas être désactivé. Pour les déploiements ArcGIS Enterprise sur Internet, vous pouvez utiliser un équilibreur de charge géré par un pare-feu d’applications Web de production à la place de Web Adaptor. Pour plus d’informations, consultez le Guide de renforcement de la sécurité ArcGIS Enterprise.

Si vous avez déjà configuré une instance Web Adaptor avec votre portail ArcGIS Enterprise et que vous souhaitez actualiser ce dernier afin d’utiliser une autre instance Web Adaptor, vous devez d’abord désinscrire l’instance Web Adaptor en cours. Pour procéder à une désinscription vous devez passer par le répertoire du portail. La fonctionnalité de désinscription n’est pas disponible à partir de la page de configuration ou du site Web du portail. Pour obtenir des instructions complètes, reportez-vous à la rubrique Désinscrire ArcGIS Web Adaptor avec Portal for ArcGIS.

Attention :

Même si vous pouvez modifier l’instance Web Adaptor d’un portail en inscrivant une nouvelle instance, gardez à l’esprit que cette opération risque également d’impacter le contenu utilisateur dans le portail (par exemple, les notes de carte ou d’autres éléments).

Remarque :

L’utilisation du port HTTPS 443 par défaut convient à la majorité des utilisateurs. Dans de rares cas, il arrive qu’une instance d’ArcGIS Web Adaptor ne puisse pas utiliser le port 443 sur son serveur Web pour des raisons propres à l’organisation. Si votre organisation se trouve dans ce cas, consultez la rubrique Utiliser d’autres ports que ceux par défaut pour l’instance ArcGIS Web Adaptor du portail, qui décrit les étapes supplémentaires permettant de configurer une solution de remplacement.

Configurez ArcGIS Web Adaptor avec un site de serveur

Les sections suivantes décrivent comment configurer ArcGIS Web Adaptor avec un site de serveur depuis la page de configuration et l’utilitaire de ligne de commande.

Configurer à partir de la page Web de configuration

Pour configurer ArcGIS Web Adaptor avec un site de serveur à partir de la page Web de configuration installée avec le logiciel, suivez la procédure ci-après.

Remarque :

À ce stade, tenez également compte des remarques supplémentaires relatives à ArcGIS Mission Server, à ArcGIS Notebook Server et à ArcGIS Video Server.

Ouvrez la page de configuration dans un navigateur Web.

L’URL est au format suivant : https://webadaptorhost.example.com/webadaptorname/webadaptor.

Remarque :

Si le serveur Web sur lequel vous avez installé ArcGIS Web Adaptor est configuré pour utiliser un proxy de transfert, désactivez-le tout en inscrivant Web Adaptor. Sinon, vous ne serez pas en mesure d’accéder à la page de configuration de l’adaptateur Web.
Sélectionnez le type de serveur que vous souhaitez configurer avec Web Adaptor. Cliquez sur Next (Suivant).
Entrez le nom de machine de l’un des serveurs que vous inscrivez dans votre site.

Ce nom de machine permet de détecter tous les ordinateurs faisant partie de votre site de serveur et de les inscrire auprès de Web Adaptor. Le nom de machine doit respecter le format server.example.com.
Indiquez un nom d’utilisateur et un mot de passe d’un compte qui permet une connexion en tant qu’administrateur au site de serveur. Vous utilisez généralement le nom d’utilisateur et le mot de passe du compte de l’administrateur principal du site que vous avez choisi en créant le site. Si vous désactivez le compte d'administrateur de site principal, vous devez spécifier un compte disposant d'un accès administrateur au site.
Cliquez sur Configure (Configurer) pour appliquer vos paramètres à Web Adaptor.

Une fois la configuration effectuée, une liste de machines reconnues par Web Adaptor s’affiche au bas de la page de configuration (mise en surbrillance en vert). Vous pouvez revenir à tout moment à cette page pour consulter la liste des machines reconnues et régler les paramètres de l'adaptateur Web.

Configurer à partir de la ligne de commande

Vous pouvez configurer ArcGIS Web Adaptor avec un site de serveur grâce à l’utilitaire de ligne de commande (ConfigureWebAdaptor.exe) dans C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools.

Les paramètres disponibles sont les suivants :

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password>

Vous pouvez configurer ArcGIS Web Adaptor avec un site de serveur grâce à l’utilitaire de ligne de commande (ConfigureWebAdaptor.bat) dans <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools.

Les paramètres disponibles sont les suivants :

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

Vous pouvez configurer ArcGIS Web Adaptor avec un site de serveur grâce à l’utilitaire de ligne de commande (configurewebadaptor.sh) dans <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools. Cela est particulièrement avantageux si l'ordinateur hébergeant l'adaptateur Web ne possède pas d'interface utilisateur graphique (GUI).

Les paramètres disponibles sont les suivants :

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

<Mode> : composant avec lequel Web Adaptor sera configuré. Par défaut, ce paramètre est défini sur server, ce qui signifie que Web Adaptor peut être configuré pour fonctionner avec le site de serveur. Voici les paramètres que vous pouvez utiliser pour configurer les autres composants.
- Portal for ArcGIS : portal
- ArcGIS Mission Server : mission
- Notebook Server : notebook
- Video Server : video
- ArcGIS Monitor : monitor
- ArcGIS Data Pipelines : datapipelines
<WebAdaptorURL> : URL de Web Adaptor que vous souhaitez configurer à partir de la ligne de commande. C’est l’URL à utiliser pour accéder à la page de configuration de Web Adaptor dans un navigateur Web. Si Web Adaptor a été installé sur un port autre que le port 80 par défaut, spécifiez ce port dans l’URL.
<MachineName|URL> : nom de l’une des machines de votre site de serveur, par exemple server.example.com. Vous pouvez également utiliser l’URL de la machine serveur à la place du nom de machine. Si vous configurez Web Adaptor avec ArcGIS Server, l’URL ou le nom de la machine permettra de détecter toutes les machines faisant partie de votre site.
<Username> : nom d’utilisateur du compte qui permet une connexion en tant qu’administrateur au site de serveur. Pour ArcGIS Server, ce compte peut être le compte d’administrateur du site principal saisi lors de la création du site ou un compte doté de privilèges d’administrateur. Pour ArcGIS Mission Server, Notebook Server et Video Server, saisissez le nom d’utilisateur du compte d’administrateur du site principal utilisé lors de la création du site.
<Password> : mot de passe du compte détenant des privilèges administrateur pour le site de serveur.

Consultez l’exemple suivant : ConfigureWebAdaptor.exe /m server /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g server.example.com /u siteadmin /p secret

Consultez l’exemple suivant : ConfigureWebAdaptor.bat -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

Consultez l’exemple suivant : $ ./configurewebadaptor.sh -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

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 l’ordinateur hébergeant Web Adaptor. Si le JRE n’est pas présent sur la machine, une erreur se produit 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.

Configurer ArcGIS Web Adaptor avec un portail

Les sections suivantes décrivent comment configurer ArcGIS Web Adaptor avec votre portail ArcGIS Enterprise depuis la page de configuration et l’utilitaire de ligne de commande.

Configurer à partir de la page Web de configuration

Pour configurer ArcGIS Web Adaptor avec votre portail à partir de la page Web de configuration installée avec le logiciel, procédez comme suit :

Attention :

Pour ajouter un alias DNS ou un proxy inverse une fois qu’un site ArcGIS Server a été fédéré avec votre portail, reportez-vous à la rubrique Mettre à jour l’URL de l’organisation.

Si vous ne l’avez pas déjà fait, activez le protocole HTTPS sur votre serveur Web.
Ouvrez la page de configuration dans un navigateur Web via une URL HTTPS, telle que https://webadaptorhost.example.com/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.example.com>/<webadaptorname>/webadaptor.

Remarque :

Si vous avez un proxy de transfert en cours d’exécution sur le serveur Web sur lequel vous avez installé ArcGIS Web Adaptor, désactivez-le tout en inscrivant Web Adaptor. Sinon, vous ne serez pas en mesure d’accéder à la page de configuration de l’adaptateur Web.
Choisissez Portal for ArcGIS et cliquez sur Suivant.
Entrez le nom de la machine hébergeant Portal for ArcGIS. Incluez le nom de domaine complet, par exemple, portal.example.com.
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 le nom d’utilisateur et le mot de passe 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 disposant d’un accès administrateur au site Web du portail.
Cliquez sur Configurer.

ArcGIS Web Adaptor est configuré pour être utilisé avec la machine hébergeant Portal for ArcGIS. Vous accédez désormais à votre portail par l’intermédiaire de l’URL d’ArcGIS Web Adaptor, au lieu du port 7443. L’URL se présente comme suit : https://webadaptorhost.example.com/webadaptorname/home.

Si vous avez configuré votre portail pour qu’il utilise le protocole HTTPS dans toutes les communications, vous devez mettre à jour le site Web du portail installé et les URL des raccourcis d’aide de manière à utiliser https au lieu de http. Sinon, des échecs se produiront lorsque votre navigateur essaiera d’accéder aux URL des raccourcis d’origine.

Si vous comptez configurer Portal for ArcGIS avec le serveur proxy inverse de votre organisation, vous devez fournir à votre portail certaines informations concernant le serveur proxy. Pour obtenir des instructions complètes, reportez-vous à la rubrique Intégrer votre portail à un serveur proxy inverse ou à un système d’équilibrage de la charge.

Configurer à partir de la ligne de commande

Vous pouvez configurer ArcGIS Web Adaptor avec votre portail grâce à l’utilitaire de ligne de commande (ConfigureWebAdaptor.exe) dans C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools.

Les paramètres disponibles sont les suivants :

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password> -r <ReindexPortal>

Vous pouvez configurer ArcGIS Web Adaptor avec votre portail grâce à l’utilitaire de ligne de commande (ConfigureWebAdaptor.bat) dans <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools.

Les paramètres disponibles sont les suivants :

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

Vous pouvez configurer ArcGIS Web Adaptor avec votre portail grâce à l’utilitaire de ligne de commande (configurewebadaptor.sh) dans <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools. Cela est particulièrement avantageux si l'ordinateur hébergeant l'adaptateur Web ne possède pas d'interface utilisateur graphique (GUI).

Les paramètres disponibles sont les suivants :

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

<Mode> : composant avec lequel Web Adaptor sera configuré. Par défaut, ce paramètre est défini sur server, ce qui signifie que Web Adaptor sera configuré pour être utilisé avec GIS Server, Image Server ou GeoAnalytics Server. Comme vous configurez Web Adaptor de manière à l’utiliser avec Portal for ArcGIS, définissez ce paramètre sur portal.
<WebAdaptorURL> : URL de Web Adaptor que vous souhaitez configurer à partir de la ligne de commande. C’est l’URL à utiliser pour accéder à la page de configuration de Web Adaptor dans un navigateur Web. Vous devez spécifier l’URL HTTPS de Web Adaptor, par exemple https://webadaptorhost.example.com/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.example.com>/<webadaptorname>/webadaptor.
<MachineName|URL> : nom d’une des machines hébergeant Portal for ArcGIS. Incluez le nom de domaine complet de la machine, par exemple, portal.example.com. Vous pouvez également utiliser l’URL de la machine hébergeant Portal for ArcGIS à la place du nom de la machine.
<Username> : nom d’utilisateur d’un compte disposant de privilèges d’administration pour Portal for ArcGIS. Ce compte peut être le compte d’administrateur initial saisi lorsque vous avez configuré votre portail pour la première fois ou un compte doté de privilèges d’administrateur.
<Password> : mot de passe du compte disposant de privilèges d’administration pour Portal for ArcGIS.
<ReindexPortal> : indique si le contenu par défaut dans le portail doit être réindexé ou non lors de l’inscription de Web Adaptor. Cette option est utile si vous comptez configurer votre déploiement avec un proxy inverse ou un système d’équilibrage de la charge. L’inscription de Web Adaptor est plus rapide sans indexation. Une fois la configuration de webContextURL terminée, le contenu intégré fait référence à webContextURL.

Exemple : ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g portal.example.com /u initialadmin /p secret -r true

Exemple : ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Exemple : ConfigureWebAdaptor.sh -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Une fois la commande exécutée, ArcGIS Web Adaptor est configuré pour être utilisé avec la machine hébergeant Portal for ArcGIS. Vous accédez désormais à votre portail par l’intermédiaire de l’URL d’ArcGIS Web Adaptor, au lieu du port 7443. L’URL se présente comme suit : https://webadaptorhost.example.com/webadaptorname/home.

Si vous comptez configurer Portal for ArcGIS avec le serveur proxy de votre organisation, vous devez fournir à votre portail certaines informations concernant le serveur proxy. Pour obtenir des instructions complètes, reportez-vous à la rubrique Intégrer votre portail à un serveur proxy inverse ou à un système d’équilibrage de la charge.

Configurer plusieurs instances ArcGIS Web Adaptor

Plusieurs instances ArcGIS Web Adaptor sont nécessaires lors de la configuration d’un portail haute disponibilité utilisant l’authentification au niveau du Web. Si vous souhaitez configurer plusieurs instances ArcGIS Web Adaptor avec Portal for ArcGIS, vous devez utiliser un seul point de terminaison pour accéder au portail. Cette URL doit être définie dans la propriété WebContextURL. Il est possible de configurer plusieurs adaptateurs Web avec le portail en suivant la procédure ci-après.

Configurez la première instance ArcGIS Web Adaptor avec votre portail.
Ajoutez Portal for ArcGIS à votre serveur proxy inverse. Définissez la propriété WebContextURL comme suit :
1. Ouvrez un navigateur Web et connectez-vous au répertoire d’administrateur de portail en tant qu’administrateur de votre organisation.
  
  L’URL est au format https://portal.example.com:7443/arcgis/portaladmin.
2. Cliquez sur System (Système) > Properties (Propriétés) > Update Properties (Mettre à jour les propriétés).
  
  Le service Portal for ArcGIS redémarre automatiquement. Vous devez attendre que le redémarrage soit terminé pour continuer.
3. Dans la boîte de dialogue Update System Properties (Mettre à jour les propriétés du système), insérez la notation JSON suivante en remplaçant l’URL de l’alias DNS ou de votre serveur proxy inverse, telle qu’elle apparaît aux utilisateurs en dehors du pare-feu de votre organisation.
```
   {
      "WebContextURL": "https://reverseproxy.example.com/myorg"
   }
```
1. Cliquez sur Update Properties (Mettre à jour les propriétés).
Configurez des instances d’ArcGIS Web Adaptor supplémentaires.

Toutes les instances de Web Adaptor configurées avec le portail sont répertoriées sur la page du récapitulatif de la configuration. Les utilisateurs accèdent au portail via le serveur proxy inverse ou l’URL de l’alias DNS.

Remarque :

Portal for ArcGIS ne prend en charge qu’une seule URL d’organisation.

Après configuration d’ArcGIS Web Adaptor

Maintenant qu’ArcGIS Web Adaptor est configuré en vue de son utilisation, tenez compte des éléments suivants :

Ajout ou suppression de machines serveurs

Si vous ajoutez ou supprimez des machines serveurs de votre site, il faut 1 minute à Web Adaptor pour reconnaître les changements apportés au site. Si vous souhaitez que l'adaptateur Web reconnaisse immédiatement les machines ajoutées ou supprimées, vous pouvez le configurer en suivant les instructions ci-dessus.

Installation de plusieurs instances Web Adaptor

Vous pouvez indiquer des points d’entrée Web différents dans votre site serveur en installant plusieurs instances Web Adaptor. Cela permet d’améliorer la haute disponibilité de votre site pour les clients, de prendre en charge les applications héritées et permet à des utilisateurs spécifiques de publier dans un environnement hautement sécurisé. Pour plus d'informations, reportez-vous à la rubrique Scénarios de déploiement.

Il est possible d’installer plusieurs instances Web Adaptor sur le même ordinateur en même temps, ou sur plusieurs ordinateurs. Pour installer plusieurs instances Web Adaptor sur le même site Web (port), utilisez des noms différents pour chacune d’entre elles. Par exemple, deux instances Web Adaptor nommées arcgis ne peuvent pas coexister sur le même site Web. Si vous souhaitez disposer de plusieurs instances Web Adaptor portant le même nom, vous devez les installer sur des sites Web différents (ports).