Als u Survey123 gebruikt zonder een lokale Survey123-website-installatie op een ArcGIS Enterprise-platform dat gebruik maakt van Integrated Windows Authentication (IWA), is het u misschien opgevallen dat het aanmeldingsproces van de IWA niet altijd soepel verloopt. Het installeren van een lokale implementatie van de Survey123-website, met de juiste configuraties, zorgt voor een meer voorspelbare inlogervaring met Survey123 via IWA.

Volg de onderstaande stappen om de Survey123-website te configureren op een lokale (fysieke of vm) server met IWA. Deze configuratie maakt het ook mogelijk om in te loggen met ingebouwde Portal-accounts. De Survey123-website moet geïnstalleerd zijn op een machine waarop ArcGIS Portal al is geïnstalleerd en geconfigureerd.

Configuratiestappen

1. Voer het installatieprogramma van de Survey123-website uit (moet worden gedownload via My ESRI)
2. Maak een reservekopie/kopie van het bestand config.json op deze locatie: C:\Program Files\ ArcGIS\ Survey123Website
3. Controleer Portal CORS op ArcGIS REST API. Als er geen URL's worden vermeld, kunt u doorgaan met de installatie.
4. Meld u aan bij Portal, ga naar Organisatie > Instellingen > Beveiliging > Origins toestaan.
5. Maak in de map wwwroot (C:\inetpub\wwwroot) een map met de naam enquête 123.
6. In het enquête 123 map, maak een bestand met de naam web.config en plak de inhoud hieronder:

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)

‍

7. Installeer de URL-herschrijfmodule voor IIS (download vindt u hier: https://www.iis.net/downloads/microsoft/url-rewrite)
8. Klik in het venster met acties voor het herschrijven van URL's op Servervariabelen bekijken. Als de onderstaande variabelen al bestaan, ga dan naar stap 9.
9. Klik op Toevoegen en voeg drie variabelen toe
   • HTTP_ACCEPT_ENCODING
   • HTTP_X_ORIGINAL_ACCEPT_ENCODING
   • HTTP_X_ORIGINAL_HOST
10. Regels toevoegen aan de URL Rewrite-module onder acties (deze moeten worden overgenomen van het web.config-bestand)
    • Kies een regel voor binnenkomende blanco
      

7. • Maak een tweede regel voor binnenkomende blanco
     

7. • Lege uitgaande regel toevoegen
     

7. • IIS-herschrijving zou nu deze regels moeten hebben
     

7. Installeer de IIS Application Request Routing module.
   • Zorg er ook voor dat de IIS Application Request Routing module is geïnstalleerd op de webserver. Schakel na de installatie de proxyfunctionaliteit in, aangezien deze standaard is uitgeschakeld:
   • Open IIS Manager op de webserver,
   • Selecteer je server in de structuurweergave aan de linkerkant.
   • Dubbelklik op Application Request Routing.
   • Selecteer Serverproxy-instellingen in het venster Acties aan de rechterkant.
   • Vink het selectievakje Proxy inschakelen aan en klik op Toepassen.
8. Voer de post-installatie uit voor IWA
   • Portaal-URL: https://{yourportalurl}/portal
   • Voer beheerdersgegevens in
   • JavaScript-URL's als standaard laten
   • Laat poorten standaard staan
   • Selecteer het SSL-certificaattype (pfx vereist het bekende wachtwoord)
   • Voeg de gewenste enquête123-URL toe: https://{yourportalurl1]/survey123
     

Na de installatie wordt alles wat hierboven is vermeld ingesteld, maar moet een ArcGIS Enterprise-beheerder handmatig de host-URL van de Survey123-website, https: //:5443<survey123website.domain >, toevoegen als een doorverwijzing naar Portal om inloggen mogelijk te maken. Om dit te doen:

7. Meld u aan bij de REST-interface van de portaalbeheerder, bijvoorbeeld:
8. https://portal_webadaptorhost.domain/portal_webadaptorname/portaladmin
9. Ga naar Beveiliging > OAuth > App-informatie ophalen, voer de App ID survey123hub in en klik op App-informatie ophalen.
10. Kopieer de inhoud van het antwoord.
11. Ga terug naar OAuth en deze keer naar Update App Info.
12. Plak het gekopieerde antwoord in het invoervak, zorg ervoor dat u de URL toevoegt die u wilt gebruiken voor toegang tot uw Survey123-website aan de lijst met doorverwijzingen en klik op App bijwerken.

Dit kan ook het reverse proxy-toegangspunt omvatten als u van plan bent er een in te stellen, bijvoorbeeld: https://survey123website.domain/survey123

7. Herhaal stap 2 om te bevestigen dat uw aanvullende RedirectURI succesvol aan de lijst is toegevoegd.
8. De Survey123-website is te bereiken via deze link: https://{yourportalurl}/survey123/
9. De configuratie van de website is voltooid!

‍