Configurar un servidor proxy

Con ArcGIS Viewer for Silverlight podrá utilizar una página proxy para guardar credenciales de usuario que permitan acceder a servicios protegidos. 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 al servidor proxy, y a su vez este reenvía la solicitud al servicio de ArcGIS Server, que es el que permite el acceso al servicio protegido. La página proxy guarda un token de larga duración, o bien guarda las credenciales de autenticación para generar un token en el tiempo de ejecución. Las credenciales de usuario y el token se mantienen protegidos en la página proxy del lado del servidor y, por consiguiente, no son visibles para el cliente. Consulte información adicional en el Servicios protegidos de ArcGIS API for Silverlight.

ArcGIS Viewer for Silverlight incluye una página proxy de muestra que podrá utilizar para procesar las comunicaciones con los servicios de ArcGIS Server utilizados en la aplicación. Normalmente, necesitará una página proxy por aplicación si está utilizando tokens ya que los tokens son específicos de la aplicación.

Consulte más información en las siguientes secciones de este tema:

• Descargar e instalar la página proxy
• Obtener un token
• Configurar la página proxy

Descargar e instalar 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).

Nota:

La página proxy se utiliza para servicios con autenticación mediante token y para la obtención de token para el servicio. Si la aplicación utiliza varios sistemas de ArcGIS Server que requieren tokens, obtenga un token para cada servidor.

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. Descargue la página proxy de muestra y, a continuación, descomprima y guarde el contenido en una carpeta del 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 de 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 Sitio web predeterminado, haga clic con el botón secundario en el directorio Proxy y, a continuación, haga clic en Agregar aplicación:
   2. Especifique el Alias y la Ruta física en el cuadro de diálogo Agregar aplicación y, a continuación, haga clic en Aceptar:

Obtener un token

Podrá crear un token a través de la página web del servicio de token, o bien generarlo de manera programática. La página web del servicio de token se emplea para generar un token duradero (si se conoce el ID del cliente) a través de un origen de referencia o de una dirección IP. Por lo general, las soluciones programáticas generan tokens de corta duración en el momento de ejecución, lo cual reduce las posibilidades de que alguien pueda apropiárselo. Para crear un token a través de la página web servicio de token, efectúe el siguiente procedimiento:

1. Obtenga la dirección URL del servicio. La dirección URL puede solicitarse al administrador del sitio de ArcGIS Server, o bien obtenerse en el Directorio de servicios.
2. Vaya a la dirección URL. Será encaminado hacia el Directorio de servicios, y se le pedirá que inicie una sesión.
3. Haga clic en el Obtener token, en la esquina superior derecha de la página que presenta información acerca del servicio. Si no hay ningún vínculo Obtener token, puede ser porque el servicio no esté protegido o porque utilice la autenticación de HTTP/Windows.
4. De este modo se abrirá la página web del servicio de token de ArcGIS. Observe si en la dirección URL se utiliza HTTPS. Por lo general, el acceso al servicio de token se realiza a través de una conexión protegida, que garantice el cifrado de la transmisión de los datos del usuario. En la página, especifique la siguiente información:
   • el Nombre de usuario y la Contraseña que le habrá facilitado el administrador de ArcGIS Server.
   • Un identificador para definir un ID exclusivo para la aplicación web que utilizará el token. Tendrá dos opciones: Dirección URL/Origen de referencia HTTP o dirección IP de la aplicación web. Utilice la dirección URL para el archivo Viewer.xap de la aplicación implementada (por ejemplo, http://<nombre de host>/Apps/MyApplication/Viewer.xap), en vez de solo http://<nombre de host>. Si necesita crear un token de larga duración, utilice la opción IP con una página proxy.
   • Tiempo de expiración. Defina durante cuánto tiempo será válido el token. Son preferibles períodos cortos por ser más seguros en caso de que el token sea interceptado por usuarios no autorizados, aunque deberá solicitar un nuevo token y aplicarlo antes de que el antiguo caduque. Los tokens caducados provocarán que el servicio de ArcGIS Server rechace las peticiones.

5. Haga clic en Generar. De este modo aparecerá un token en la parte inferior de la página, Copie este valor y utilícelo en la página proxy (consulte la siguiente sección).
   Sugerencia:

   Si no aparece ningún token, o si aparece un mensaje de error, asegúrese de que los valores introducidos sean correctos.

Configurar la página proxy

1. Abra la página proxy de configuración (proxy.config) en un editor de texto o de XML.
2. 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: token de autenticación. Opcional; se utiliza solamente para servicios protegidos mediante autenticación basada en 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.

3. Guarde el archivo de configuración. Apunte la dirección URL de su página proxy, ya que la necesitará para agregar un servicio de mapas protegido a ArcGIS Viewer for Silverlight.