Installation du site Web Survey123 pour ArcGIS Enterprise

Naviam

October 26, 2022

Si vous utilisez Survey123 sans installation du site Web Survey123 local sur une plateforme ArcGIS Enterprise utilisant l'authentification Windows intégrée (IWA), vous avez peut-être remarqué que le processus de connexion à l'IWA ne se déroule pas toujours correctement. L'installation d'un déploiement local du site Web Survey123, avec les configurations appropriées, créera une expérience de connexion plus prévisible à Survey123 via IWA.

Suivez les étapes ci-dessous pour configurer le site Web Survey123 sur un serveur local (physique ou virtuel) avec IWA. Cette configuration permettra également de se connecter à l'aide de comptes Portal intégrés. Le site Web Survey123 doit être installé sur une machine sur laquelle ArcGIS Portal est déjà installé et configuré.

Étapes de configuration

  1. Exécutez le programme d'installation du site Web Survey123 (doit être téléchargé depuis My ESRI)
  2. Effectuez une sauvegarde/copie du fichier config.json à l'emplacement suivant : C:\Program Files \ ArcGIS \ Survey123Website
  3. Vérifiez Portal CORS sur l'API REST d'ArcGIS. Si aucune URL n'est répertoriée, vous pouvez poursuivre l'installation.
  4. Connectez-vous au portail, accédez à Organisation > Paramètres > Sécurité > Autoriser les origines.
  5. Dans le dossier wwwroot (C:\inetpub\wwwroot), créez un dossier appelé enquête123.
  6. Dans le enquête123 dossier, créez un fichier appelé web.config et collez le contenu ci-dessous :
1<?xml version="1.0" encoding="UTF-8"?>2<configuration>3    <system.webServer>4        <rewrite>5            <rules>6                <clear />7                <rule name="ReverseProxyHTML" 
stopProcessing="false">8                    <match url="(^$|.*\.html$)" />9                    <conditions logicalGrouping="MatchAll" trackAllCaptures="false" />10                    <action type="Rewrite" 
url="http://localhost:5080/{R:1}" />11                    <serverVariables>12                        <set name="HTTP_X_ORIGINAL_ACCEPT_ENCODING" value="{HTTP_ACCEPT_ENCODING}" />13                        <set 
name="HTTP_ACCEPT_ENCODING" value="" />14                    </serverVariables>15                </rule>16                <rule name="ReverseProxyInboundRule1" stopProcessing="true">17                    <match 
url="(.*)" />18                    <conditions logicalGrouping="MatchAll" trackAllCaptures="false" />19                    <action type="Rewrite" url="http://localhost:5080/{R:1}" />20                </rule>21            
		</rules>22            <outboundRules>23                <rule name="update base tag" preCondition="isHTML">24                    <match filterByTags="Base" pattern="^/(.*)" />25                    
    <action type="Rewrite" value="/survey123/" />26                    <conditions trackAllCaptures="false">27                        <add input="{URL}" pattern="/" />28                    </conditions>29                
    	</rule>30                <preConditions>31                    <preCondition name="isHTML">32                        <add input="{RESPONSE_CONTENT_TYPE}" pattern="^text/html" />33                    
    </preCondition>34                </preConditions>35            </outboundRules>36        </rewrite>37    </system.webServer>38</configuration>39Convert survey123 folder to an application in IIS (right click folder)

  1. Installez le module de réécriture d'URL pour IIS (le téléchargement se trouve ici : https://www.iis.net/downloads/microsoft/url-rewrite)
  2. Dans le volet Actions de réécriture d'URL, cliquez sur Afficher les variables du serveur. Si les variables ci-dessous existent déjà, passez à l'étape 9.
  3. Cliquez sur Ajouter et ajoutez trois variables
    • HTTP_ACCEPT_ENCODING
    • HTTP_X_ORIGINAL_ACCEPT_ENCODING
    • HTTP_X_ORIGINAL_HOST
  4. Ajoutez des règles au module de réécriture d'URL sous les actions (celles-ci doivent être héritées du fichier web.config)
    • Choisir une règle vide pour les appels entrants
    • Créer une deuxième règle vide pour les appels entrants
    • Ajouter une règle de sortie vide
    • La réécriture d'IIS devrait désormais avoir ces règles
  1. Installez le module de routage des demandes d'application IIS.
    • Assurez-vous également que le module de routage des demandes d'application IIS est installé sur le serveur Web. Une fois installée, activez la fonctionnalité proxy car elle est désactivée par défaut :
    • Ouvrez le gestionnaire IIS sur le serveur Web,
    • Sélectionnez votre serveur dans l'arborescence de gauche.
    • Double-cliquez sur Routage des demandes d'application.
    • Sélectionnez Paramètres du proxy du serveur dans la fenêtre Actions sur la droite.
    • Cochez la case Activer le proxy, puis cliquez sur Appliquer.
  2. Effectuer une post-installation pour IWA
    • URL du portail : https://{yourportalurl}/portal
    • Entrez les informations d'identification d'administrateur
    • Laisser les URL JavaScript par défaut
    • Laisser les ports par défaut
    • Sélectionnez le type de certificat SSL (pfx nécessite un mot de passe connu)
    • Ajoutez l'URL survey123 souhaitée : https://{yourportalurl1]/survey123

La post-installation configure tout ce qui est répertorié ci-dessus, mais nécessite qu'un administrateur ArcGIS Enterprise ajoute manuellement l'URL de l'hôte du site Web Survey123, https : //:5443<survey123website.domain >, en tant qu'interface de redirection vers Portal pour permettre la connexion. Pour ce faire :

  1. Connectez-vous à l'interface REST de l'administrateur du portail, par exemple :
  2. https://portal_webadaptorhost.domain/portal_webadaptorname/portaladmin
  3. Accédez à Sécurité > OAuth > Obtenir les informations sur l'application, saisissez l'ID de l'application survey123hub, puis cliquez sur Obtenir les informations sur l'application.
  4. Copiez le contenu de la réponse.
  5. Revenez à OAuth et cette fois, accédez à Mettre à jour les informations sur l'application.
  6. Collez la réponse copiée dans la zone de saisie, en veillant à ajouter l'URL que vous utiliserez pour accéder à votre site Web Survey123 à la liste de RedirectURIS, puis cliquez sur Mettre à jour l'application.

Cela peut inclure le point d'accès proxy inversé si vous avez l'intention d'en configurer un, par exemple : https://survey123website.domain/survey123

  1. Répétez l'étape 2 pour confirmer que votre RedirectURI supplémentaire a bien été ajoutée à la liste.
  2. Le site web de Survey123 est accessible via ce lien : https://{yourportalurl}/survey123/
  3. La configuration du site Web est terminée !

Unlock the Ultimate Guide to IBM Maximo Application Suite (MAS)

Discover everything you need to know to modernize your asset management strategy.

Inside, you’ll learn:

  • What’s new in IBM Maximo Application Suite 9.0
  • Key differences between Maximo 7.6 and MAS
  • How AppPoints and OpenShift change the game
  • Industry use cases across energy, manufacturing, and transportation
  • Step-by-step guidance for upgrading and migration readiness
Cover of 'The Ultimate Guide to MAS Maximo Application Suite' by Naviam featuring a man in a yellow construction helmet and safety vest holding a tablet.
×

ActiveG, BPD Zenith, EAM Swiss, InterPro Solutions, Lexco, Peacock Engineering, Projetech, Sharptree, and ZNAPZ have united under one brand: Naviam.

You’ll be redirected to the most relevant page at Naviam.io in a few seconds — or you can go now.

Read Press Release