Instalar y configurar el sitio web de ArcGIS Survey123

Resumen

A veces, es necesario que las organizaciones trabajen en entornos totalmente desconectados donde no tienen acceso externo a Internet. Otras organizaciones pueden estar conectadas, pero deben alojar el sitio web de ArcGIS Survey123 o la API REST de Survey123 en su propia infraestructura.

La API REST de Survey123 se utiliza para realizar las configuraciones de la encuesta y convertirlas en formularios para su uso en las aplicaciones de Survey123 (aplicación de campo / formulario web), como los archivos .xlsx creados conectados o las configuraciones creadas por el sitio web. Por otro lado, el sitio web proporciona la funcionalidad de crear y administrar las encuestas, así como de ver y analizar los datos recopilados. Ambos componentes están separados, pero trabajan juntos para proporcionar la funcionalidad que se ve en el sitio web de ArcGIS Survey123 (https://survey123.arcgis.com).

Qué se incluye
Una instalación local de la API REST y el sitio web de Survey123 que permite crear y publicar encuestas desde Survey123 Connect o el sitio web en su propia infraestructura. Esto proporciona la mayoría de las funciones completas del sitio web de ArcGIS Survey123, con la excepción notable de que la API de informes todavía no se puede alojar localmente.

Qué se requiere
Es necesario descargar el archivo de instalador desde el sitio web de My Esri. Los pasos de instalación que aparecen a continuación son solo para las instalaciones de Windows. También se requieren credenciales de administrador del portal de ArcGIS Enterprise, así como acceso de administrador al servidor web. El instalador del sitio web de Survey123 se puede implementar en el mismo equipo que la instancia del portal o en un servidor web independiente. Aunque el sitio web de Survey123 instalado se ha probado correctamente con las versiones 10.5.1 y posteriores del portal de ArcGIS Enterprise, la versión inicial solo admite oficialmente las versiones 10.7 y posteriores.

Procedimiento

Instalación

Windows:
Descomprima el archivo descargado en el equipo deseado y, a continuación, ejecute Setup.exe. Acepte el Contrato marco, elija la ubicación de instalación y haga clic en Instalar. El proceso puede tardar aproximadamente 30 minutos. Cuando termine, haga clic en Finalizar para salir de la instalación.

Linux:

Precaución: Los archivos de archivado que se incluyen aquí se deben extraer en un equipo Unix. Si se realiza desde un equipo con Windows, pierden los permisos necesarios para ejecutar la instalación correctamente y pueden cambiarse algunos nombres de archivo.

1. Extraiga el contenido del archivo .tar.gz en el equipo en el que desea instalar el sitio web de Survey123 utilizando el comando gunzip [filename].tar.gz seguido de tar xf [filename].tar en Terminal.
2. Una vez extraídos, ejecute ./Setup en terminal, acepte el Contrato marco, elija la ubicación de instalación y haga clic en Instalar. El proceso puede tardar aproximadamente 5-10 minutos. Cuando termine, haga clic en Finalizar para salir de la instalación.

Nota: Su navegador puede encontrar una advertencia de seguridad. Acéptela y continúe en el sitio web; esto se soluciona configurando un certificado durante la postinstalación.

Nota: Realice una copia de seguridad del archivo config.json (la ubicación predeterminada es C:\Archivos de programa\ArcGIS\Survey123website) antes de ejecutar la postinstalación. Si la instalación está configurada incorrectamente, este archivo se puede utilizar para restaurar e iniciar de nuevo (o realizar ediciones manuales en el config.json existente).

Comprueba si su portal está limitando los dominios que se pueden conectar a través de Cross-Origin Resource Sharing (CORS) a la API REST de ArcGIS:

• Inicie sesión en ArcGIS Enterprise como administrador y vaya al grupo Organización > Configuración > Seguridad > Permitir orígenes. De forma predeterminada, se permiten todos los dominios, es decir, no hay direcciones URL en la lista aquí. Si ya está limitando los dominios, agregue la URL del host de Survey123 a la lista.
• Haga clic en Agregar y agregue la URL del host del sitio web de Survey123. Por ejemplo:
  • https://<survey123website.domain>:5443
  
  
• Haga clic en Agregar dominio. Esto permite que el dominio de la aplicación web Survey123 se conecte a través de (CORS) a la API REST de ArcGIS.

ArcGIS Enterprise con autenticación integrada
Ejecute la postinstalación abriendo https://localhost:5443/share/post-install.html en el equipo de instalación.

La postinstalación se presenta como un asistente similar a una encuesta para editar el archivo config.json. Esto configura lo siguiente:

• URL predeterminada de Portal for ArcGIS (la instalación apunta a ArcGIS Online de forma predeterminada)
• Credenciales de administrador de Portal for ArcGIS (necesita establecer la URI de redireccionamiento para el inicio de sesión del portal)
• API de JavaScript de ArcGIS (requerida para entornos sin conexión)
• Puertos HTTP(s)
• Certificado(s) SSL
• URL del host del sitio web de Survey123 (esta es la URL http o https del equipo que aloja su sitio web de Survey123; recuerde incluir el número de puerto). Se agrega como URI de redireccionamiento a su portal para permitir el inicio de sesión.
• Configuración para entornos sin conexión. Al seleccionar Sí para la pregunta '¿Está instalando el sitio web de Survey123 en un entorno sin conexión y sin acceso a Internet?', se establecen las propiedades de la organización de Survey123 que impiden que Survey123 Connect realice llamadas a Internet (para aspectos como videotutoriales, Twitter y GeoNet).

Confirmar la configuración y hacer clic en Enviar actualiza el archivo config.json, también

• Importa el o los archivos de certificado a la carpeta ~ArcGIS\Survey123website\server\cert\
• Incorpora la URL del host del sitio web de Survey123 como URI de redireccionamiento al Id. de aplicación survey123hub
• Actualiza las propiedades de la organización de Survey123 (basemapsGroupQuery, showCommunityContent y showTutorialContent)

Abra el archivo config.json en un editor de texto para ver la configuración actualizada.

ArcGIS Enterprise con autenticación de Windows (IWA)

• Si el sitio web de Survey123 no está instalado en la misma URL de host que ArcGIS Enterprise, consulte la sección Ejecutar postinstalación manualmente a continuación.
• Si el sitio web de Survey123 está instalado en la misma dirección URL de host que ArcGIS Enterprise, para permitir que las credenciales de inicio de sesión de ArcGIS Enterprise (IWA) se utilicen desde el navegador, vaya a la siguiente dirección URL para la postinstalación:

https://<survey123website.domain >:5443/share/post-install.html

Esto permite que las credenciales de inicio de sesión de ArcGIS Enterprise (IWA) se utilicen desde el navegador.

La postinstalación configura todo lo anterior, pero requiere que un administrador de ArcGIS Enterprise agregue manualmente la URL del host del sitio web de Survey123, https://<survey123website.domain >:5443, como URI de redireccionamiento al portal para permitir el inicio de sesión:

1. Inicie sesión en la interfaz REST del administrador del portal, por ejemplo:
   • https://portal_webadaptorhost.domain /portal_webadaptorname/portaladmin
   
   
2. Vaya a Seguridad > OAuth > Obtener información de aplicación e introduzca el Id. de aplicación survey123hub y haga clic en Obtener información de aplicación.
3. Copie el contenido de la respuesta.
4. Vuelva a OAuth y, esta vez, vaya a Actualizar información de aplicación.
5. Pegue la respuesta copiada en el cuadro de entrada, asegurándose de agregar la URL que utilizará para acceder a su sitio web de Survey123 a la lista de URI de redireccionamiento y haga clic en Actualizar aplicación. Esto puede incluir el punto de acceso proxy inverso si tiene previsto configurar uno, por ejemplo:
   • https://survey123website.domain /survey123
   
   
6. Repita el paso 2 para confirmar que su URI de redireccionamiento adicional se ha agregado correctamente a la lista.

Ejecutar postinstalación manualmente

1. Copie los archivos de certificado (.pfx o .pem) en la carpeta cert de su instalación, por ejemplo:
   • ~\ArcGIS\Survey123website\server\cert\
   • Si utiliza un archivo .pfx, deberá cifrar la contraseña realizando una solicitud a la API REST de Survey123 instalada. A continuación, la respuesta se puede copiar en el archivo config.json (consulte a continuación).
     • Esto se realiza incorporando su contraseña .pfx a la URL de la API utilizando el parámetro encrypt?text=, por ejemplo:
     • https://<survey123website.domain>:5443/api/encrypt?text=<your_pfx_password>
     
     
   • La respuesta estará en el formato: {'result':'a6c2812bed063dd9be'}, copie el resultado, es decir, a6c2812bed063dd9be, para su uso posterior en el archivo config.json.
   
   
2. Un administrador de ArcGIS Enterprise debe agregar manualmente la URL del host del sitio web de Survey123, por ejemplo:
   • https://<survey123website.domain >:5443 - Esta es la URI de redireccionamiento a su portal. Consulte los pasos del 1 al 5 de la sección anterior.
     
     
   
   
3. Abra config.json en un editor de texto. Se puede encontrar en la carpeta raíz del sitio web de Survey123, por ejemplo: ~\ArcGIS\Survey123website
   • Actualice los siguientes parámetros de acuerdo con sus requisitos:
     • portalUrl: URL de ArcGIS Enterprise, por ejemplo: https://portal_webadaptorhost.domain.com/portal_webadaptorname
     • arcgisJsAPi3Url: URL de la API de JavaScript de ArcGIS v3.x, por ejemplo: https://portal_webadaptorhost.domain.com/portal_webadaptorname/jsapi/jsapi/init.js
     • arcgisJsApiUrl: URL de la API de JavaScript de ArcGIS v4.x, por ejemplo: https://portal_webadaptorhost.domain.com/portal_webadaptorname/jsapi/jsapi4/init.js
     • httpPort: puerto HTTP del sitio web de Survey123 (el valor predeterminado es 5080)
     • https.port: puerto HTTPS del sitio web de Survey123 (el valor predeterminado es 5443)
     • https.cert: ruta a su certificado de servidor HTTPS Base64 Ascii (.pem) del sitio web de Survey123 ('./server/cert/cert.pem' es la opción predeterminada).
     • https.key: ruta a su clave de certificado de servidor HTTPS Base64 Ascii (.pem) del sitio web de Survey123 ('./server/cert/key.pem' es la opción predeterminada).
     • https.pfx: ruta a su archivo de certificado binario HTTPS (.pfx) del sitio web de Survey123, por ejemplo: './server/cert/your_certificate.pfx'
     • https.passphrase: contraseña cifrada de su certificado binario HTTPS del sitio web de Survey123. Utilice el resultado de https://<survey123website.domain>:5443/api/encrypt?text=<your_pfx_password> como se explicó anteriormente para obtener la contraseña cifrada.
     
     
   
   
4. Guarde el archivo config.json.
5.     Reinicie el servicio de Windows del sitio web de ArcGIS Survey123 y el servicio Survey123 en Linux para que los cambios surtan efecto.