Skip To Content

Utilizar proxy

Cuando se implementa una aplicación, puede ser necesario usar un proxy. Web AppBuilder admite el uso de proxies en las siguientes situaciones:

  • Al acceder a recursos de distintos dominios
  • Solicitudes que superan los 2048 caracteres
  • Al acceder a recursos protegidos mediante autenticación basada en token
  • Inicios de sesión de aplicación con OAuth 2.0.
  • Habilita el registro
  • Limitación de velocidad basada en recurso y en referencia

De manera predeterminada, la aplicación descargada utiliza el servidor proxy proporcionado por Portal for ArcGIS. Especifique su propio proxy y sus reglas modificando la propiedad httpProxy del archivo de configuración de la aplicación. httpProxy contiene los siguientes atributos.

Atributo

Descripción

useProxy

Booleano. Opcional. Valor predeterminado: true. Si es false, las solicitudes no usarán un proxy.

url

Cadena de caracteres. Opcional. Dirección URL para especificar la ubicación del proxy. Si la solicitud no coincide con ninguna regla de proxy, pero debe usar uno, como sucede con las solicitudes entre distintos dominios, se usará este proxy.

alwaysUseProxy

Booleano. Opcional. Especifica si el proxy se debe usar siempre para la comunicación con un extremo REST. Valor predeterminado: false. Si la solicitud no coincide con ninguna regla de proxy y no necesita uno, la aplicación comprueba esta propiedad para decidir cómo se debe usar el proxy. Si es valor es false, la solicitud no pasa por el proxy al que se hace referencia en url. Si es true, la solicitud pasa por el proxy al que se hace referencia en url.

reglas

Objeto[]. Opcional. Define el proxy para un conjunto de recursos con el mismo prefijo de dirección URL. Si la dirección URL de la solicitud coincide con una regla, la solicitud se envía a través del proxy. Cada regla tiene dos propiedades:

  • urlPrefix: cadena de caracteres. Prefijo de dirección URL para los recursos a los que se debe acceder a través del proxy especificado.
  • proxyUrl: cadena de caracteres. Dirección URL del proxy.

En la siguiente sección se muestra cómo funcionan los proxies en relación con los atributos anteriores:

  • En primer lugar, la aplicación comprueba useProxy.
    • Si es false, las solicitudes no usarán un proxy.
    • Si es true, la aplicación comprueba rules a continuación.
      • Si la solicitud coincide con las reglas del proxy, la aplicación utilizará el valor de proxyUrl definido en las reglas.
      • Si la solicitud no coincide con ninguna regla de proxy, pero debe usar uno, como sucede con las solicitudes entre distintos dominios, la aplicación usará el proxy al que hace referencia url.
      • Si la solicitud no coincide con las reglas de proxy y no requiere uno, la aplicación comprobará alwaysUseProxy.
        • Si es valor es false, la solicitud no pasa por el proxy al que se hace referencia en url.
        • Si es true, la solicitud pasa por el proxy al que se hace referencia en url.
Diagrama de proxy

Ejemplo:

"httpProxy": {
		"useProxy": true,
		"url": "http://gallery.chn.esri.com/arcgis/sharing/proxy",
		"alwaysUseProxy": false,
		"rules": [{
			"urlPrefix": "http://route.arcgis.com/",
			"proxyUrl": "resource-proxy-1.0/DotNet/proxy.ashx"
		}]
	}

Además, Esri proporciona tres proxies, cada uno de ellos dirigido a una plataforma de servidor: ASP.NET, Java/JSP y PHP. Descargue e implemente el proxy adecuado para su plataforma desde GitHub. Consulte también Usar la página de proxy para obtener información detallada.