Skip To Content

Utiliser un proxy

Lorsque vous déployez une application, vous devez généralement utiliser un proxy. Web AppBuilder prend en charge l'utilisation des proxy dans les situations suivantes :

  • Accès à des ressources interdomaines
  • Requêtes dépassant 2048 caractères
  • Accès à des ressources sécurisées par authentification à base de jetons
  • Identifiants de connexion d'application OAuth 2.0
  • Activation de la consignation
  • Limitation de débit basée sur la ressource et le référant

Par défaut, l'application téléchargée utilise le proxy fourni par Portal for ArcGIS. Spécifiez votre proxy et vos règles en modifiant la propriété httpProxy dans le fichier de configuration de l'application. httpProxy contient les attributs suivants.

Attribut

Description

useProxy

Booléen. Facultatif. Valeur par défaut : true (vrai). Si la valeur est false (faux), les requêtes n'utilisent aucun proxy.

URL

Chaîne. Facultatif. URL indiquant l'emplacement du proxy. Si la requête ne correspond à aucune règle de proxy, mais qu'un proxy doit être utilisé, par exemple dans le cas d'une requête interdomaines, alors ce proxy sera utilisé.

alwaysUseProxy

Booléen. Facultatif. Indique si le proxy doit toujours être utilisé pour assurer la communication avec une extrémité REST. Valeur par défaut : false (faux). Si la requête ne correspond à aucune règle de proxy et qu'aucun proxy n'est nécessaire, l'application vérifie cette propriété pour déterminer comment utiliser le proxy ultérieurement. Si la valeur est false, la requête n'est pas transmise au proxy référencé par l'URL. Si la valeur est true, la requête est transmise au proxy référencé par l'URL.

règle

Objet[]. Facultatif. Définit le proxy pour un jeu de ressources présentant le même préfixe d'URL. Si l'URL de demande correspond à une règle, la requête est acheminée via le proxy. Chaque règle a deux propriétés :

  • urlPrefix-string. Préfixe de l'URL pour les ressources qui doivent être accessibles via le proxy spécifié.
  • proxyUrl-string. URL du proxy.

L'exemple suivant illustre le fonctionnement des proxy avec les attributs ci-dessus :

  • L'application commence par vérifier useProxy.
    • Si la valeur est false (faux), les requêtes n'utilisent aucun proxy.
    • Si la valeur est true (vrai), l'application vérifie ensuite les règles.
      • Si la requête correspond aux règles de proxy, l'application utilise le jeu proxyUrl dans les règles.
      • Si la requête ne correspond à aucune règle de proxy, mais qu'un proxy doit être utilisé, par exemple dans le cas d'une requête interdomaines, l'application utilise le proxy référencé par l'URL.
      • Si la requête ne correspond à aucune règle de proxy et si aucun proxy n'est nécessaire, l'application vérifie ensuite alwaysUseProxy.
        • Si la valeur est false, la requête n'est pas transmise au proxy référencé par l'URL.
        • Si la valeur est true, la requête est transmise au proxy référencé par l'URL.
Diagramme du proxy

Exemple :

"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"
		}]
	}

En outre, Esri fournit trois serveurs proxy, chacun ciblant une plateforme côté serveur spécifique : ASP.NET, Java/JSP et PHP. Téléchargez et déployez le proxy approprié à votre plateforme sur GitHub. Reportez-vous également à la page Using the proxy (Utilisation du proxy) pour plus de détails.