Proxy verwenden
Wenn Sie eine App bereitstellen, müssen Sie gegebenenfalls einen Proxy verwenden. Web AppBuilder unterstützt die Verwendung von Proxys in den folgenden Situationen:
- Zugriff auf domänenübergreifende Ressourcen
- Anforderungen, die mehr als 2048 Zeichen enthalten
- Zugriff auf durch eine Token-basierte Authentifizierung geschützte Ressourcen
- OAuth 2.0-basierte App-Anmeldungen.
- Aktivierte Protokollierung
- Sowohl Ressourcen- als auch Referrer-basierte Ratenbeschränkung
Die heruntergeladene App verwendet standardmäßig den von Portal for ArcGIS bereitgestellten Proxy. Legen Sie Ihren eigenen Proxy und Ihre Regeln in der Eigenschaft httpProxy in der Konfigurationsdatei der App fest. httpProxy enthält folgende Attribute.
| Attribut | Beschreibung |
| useProxy | Boolesch. Optional. Standard: „true“. Wenn „false“, verwenden alle Anforderungen keinen Proxy. |
| URL | Zeichenfolge. Optional. Die URL zum Proxy. Wenn die Anforderung keine Proxy-Regel erfüllt, jedoch einen Proxy verwenden muss, wie bei einer domänenübergreifenden Anforderung, dann wird dieser Proxy verwendet. |
| alwaysUseProxy | Boolesch. Optional. Gibt an, ob der Proxy immer für die Kommunikation mit einem REST-Endpunkt verwendet werden soll. Standard: „false“. Wenn die Anforderung keine Proxy-Regel erfüllt und keinen Proxy benötigt, prüft die Anwendung diese Eigenschaft, um zu entscheiden, wie der Proxy weiter verwendet wird. Wenn „false“, verläuft die Anforderung nicht über den durch url referenzierten Proxy. Wenn „true“, verläuft die Anforderung über den durch url referenzierten Proxy. |
| Regeln | Objekt[]. Optional. Definiert den Proxy für einen Satz Ressourcen mit demselben URL-Präfix. Wenn die Anforderungs-URL einer Regel entspricht, wird die Anforderung durch den Proxy geleitet. Jede Regel besitzt zwei Eigenschaften:
|
Der folgende Ablauf zeigt, wie Proxys im Bezug auf die obigen Attribute arbeiten:
- Zuerst prüft die App useProxy.
- Wenn „false“, verwenden alle Anforderungen keinen Proxy.
- Wenn „true“, prüft die App als Nächstes rules.
- Wenn die Anforderung den Proxy-Regeln entspricht, verwendet die App den in den Regeln festgelegten Wert von proxyUrl.
- Wenn die Anforderung keine Proxy-Regel erfüllt, jedoch einen Proxy verwenden muss, wie bei einer domänenübergreifenden Anforderung, dann verwendet die App den durch url referenzierten Proxy.
- Wenn die Anforderung den Proxy-Regeln nicht entspricht und auch keinen Proxy erfordert, prüft die App alwaysUseProxy.
- Wenn „false“, verläuft die Anforderung nicht über den durch url referenzierten Proxy.
- Wenn „true“, verläuft die Anforderung über den durch url referenzierten Proxy.
Beispiel:
"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"
}]
}
Esri bietet zusätzlich drei Proxys, die jeweils auf eine bestimmte serverseitige Plattform ausgerichtet sind: ASP.NET, Java/JSP und PHP. Laden Sie den für Ihre Plattform passenden Proxy von GitHub herunter und stellen Sie ihn bereit. Details finden Sie auch unter Verwenden der Proxy-Seite.