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:
|
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.
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.