Configurar un servidor proxy

La página proxy consta de un código del lado del servidor que se ejecuta en el servidor Web. El navegador envía la solicitud a su servidor proxy, y su servidor proxy, a su vez, reenvía la solicitud al servicio de ArcGIS Server. ArcGIS Viewer for Silverlight proporciona dos páginas proxy de muestra que puede utilizar para manejar la comunicación con los servicios de ArcGIS Server utilizados en su aplicación.

La primera página proxy, BuilderProxy.ashx, está pensada para utilizarla al crear y revisar las aplicaciones de Visor. La segunda página proxy, Proxy.ashx, está pensada para implementar aplicaciones de Visor y es más seguro que la descarga de BuilderProxy.ashx. BuilderProxy.zip o bien, Proxy.zip.

Páginas proxy disponibles

BuilderProxy.ashx

Utilice BuilderProxy.ashx como punto de inicio al crear y revisar las aplicaciones Application Builder y Visor desplegado , a medida que permite que los tokens los compartan todas las aplicaciones del mismo servidor Web de Servicios de información de Internet (IIS). BuilderProxy.ashx solo envía el nombre del servidor Web (http://<hostname>) como el sitio de referencia en la solicitud HTTP transmitida, que es menos segura que lo que envía Proxy.ashx. Para configurar los tokens, modifique el archivo BuilderProxy.config incluido en el archivo BuilderProxy.zip.

Cuando se recuperan los tokens del directorio de servicios (por ejemplo, http://<servername>/ArcGIS/tokens/gettoken.html), asegúrese de utilizar http://hostname como el sitio de referencia HTTP. En el archivo BuilderProxy.config, pegue el token completo sin dejar espacios en blanco al inicio o al final. Ya que solo se utiliza como el nombre de host, el token y la página proxy funcionan tanto en Application Builder como en las aplicaciones de Visor , creadas siempre que se acceda a las aplicaciones a través del nombre de host en la dirección URL en lugar del host local o el nombre de dominio calificado completamente. Para establecer la dirección URL, asegúrese de que el archivo web.config de Application Builder utiliza el nombre del equipo real y no el localhost.

Proxy.ashx

Utilice Proxy.ashx para las aplicaciones de Visor en la producción. Proxy.ashx pasa a lo largo del sitio de referencia HTTP de las aplicaciones para el servidor; de ahí, Proxy.ashx es más segura. Normalmente, necesitará una página proxy por aplicación si está utilizando tokens ya que los tokens son específicos de la aplicación. Para configurar los tokens, modifique el archivo de Proxy.config que se incluye en el archivo Proxy.zip. Al recuperar un token, utilice la dirección URL para el archivo Viewer.xap en la aplicación implementada (por ejemplo, http://<hostname>/Apps/MyApplication/Viewer.xap) en vez de solo http://<hostname>. Después, en el archivo Proxy.config, pegue todo el token sin dejar espacios en blanco al inicio o al final.

Descargar y configurar la página proxy

Los siguientes pasos describen cómo descargar e instalar la página del servidor proxy en su servidor Web. La página proxy se ejecuta en su servidor Web local, no en un servidor de Esri o en el equipo de ArcGIS Server (a menos que su servidor Web también aloje la instancia de ArcGIS Server).

Antes de continuar, asegúrese de tener ASP.NET 2.0 o más reciente instalado y registrado con IIS. Si ASP.NET no está configurado con IIS, siga las instrucciones para la versión de IIS que está ejecutando en el tema de ayuda Configuración de IIS y ASP.NET en MSDN.

1. Descargar BuilderProxy.zip o bien, Proxy.zipy, a continuación, descomprima y guarde el contenido en una carpeta en el directorio raíz del servidor Web. En IIS, la ubicación predeterminada para la carpeta raíz del servidor Web es c:\inetpub\wwwroot. Si tiene previsto utilizar el servidor proxy para varios sitios, puede crear una carpeta en el directorio raíz Web denominado servidor proxy y colocar el contenido allí.
2. Abra Administrador de IIS. Este artículo Base de conocimiento de Microsoft proporciona instrucciones para abrir el Administrador de IIS según la versión de IIS que está utilizando.
3. Crear una Aplicación Web para la carpeta proxy; estos pasos varían según la versión de IIS que está utilizando.
   • Para IIS 5 o 6, utilice los siguientes pasos:
   1. En el Sitio Web predeterminado, haga clic con el botón derecho del ratón en el directorio de servidor proxy y haga clic en Propiedades.
   2. En la pestaña Directorio en la sección Configuración de la aplicación, haga clic en el botón Crear y, a continuación, haga clic en Aceptar:
   • Para IIS 7, utilice los siguientes pasos. Para obtener más información, consulte Crear un sitio Web (IIS 7).
   1. En el Sitio Web predeterminado, haga clic con el botón derecho del ratón en el directorio Proxy y haga clic en Agregar aplicación:
   2. Especifique el Alias y Ruta física en el cuadro de diálogo Agregar aplicación y haga clic en Aceptar:
4. Si va a utilizar la página proxy para los servicios con la autenticación basada en tokens, obtenga un token para el servicio. Si la aplicación utiliza varios sistemas de ArcGIS Server que requieren tokens, obtenga un token para cada servidor. Para obtener más información sobre cómo obtener un token, consulte Asegurar servicios en la documentación de ArcGIS for Silverlight. Para obtener información sobre la dirección URL que se especificará para el parámetro Sitio de referencia HTTP, consulte la sección anterior.
5. Abra la página proxy de configuración (Proxy.config) en un texto o editor de XML.
6. Para cada ArcGIS Server que utilizará la página proxy, agregue una entrada <serverUrl> al archivo XML de configuración en la sección <serverUrls>. Consulte el archivo de configuración proxy para obtener ejemplos. El elemento serverUrl puede tener los siguientes atributos:
   • url: URL del equipo de ArcGIS Server o el servicio. Si se utilizan varios servicios en el mismo servidor en la aplicación, la dirección URL puede señalar la raíz de los servicios. Si solo se utiliza un servicio único en el servidor, la dirección URL se puede establecer en la dirección URL del servicio completo.
   • matchAll: especifica si se debe utilizar el token para todas las solicitudes con esta dirección URL. Si este atributo es verdadero y el atributo de la dirección URL se establece en la raíz de los servicios, la entrada se puede utilizar para varios servicios en la aplicación.
   • token: el token de autenticación obtenido en el paso 1. Opcional: se utiliza solo para los servicios asegurados con la autenticación basada en el token.

   Si varios servicios en el mismo servidor se utilizan en la aplicación, la dirección URL puede señalar la raíz de servicio (por ejemplo, http://www.example.com/arcgis/rest/services), y el parámetro matchAll se establece como verdadero. Varias entradas del servidor se pueden agregar si más de un equipo de ArcGIS Server se utiliza en la aplicación.

   El atributo mustMatch en el elemento incluido controla si solo los sitios especificados pueden utilizar proxys. Este atributo por lo general se debe establecer como verdadero. Si se establece como falso, la página proxy enviará cualquier solicitud a cualquier servidor. Esto podría permitir que su página proxy se utilice para enviar solicitudes a servidores de terceros sin su permiso.

7. Guarde el archivo de configuración. Tenga en cuenta la dirección URL de su página proxy, ya que la necesitará al agregar un servicio de mapas asegurado en ArcGIS Viewer for Silverlight .