Configuration d'un proxy

Une page proxy se compose d'un code côté serveur qui s'exécute sur votre serveur Web. Le navigateur envoie la requête à votre proxy et celui-ci transmet la requête au service ArcGIS Server. ArcGIS Viewer for Silverlight fournit deux pages proxy d'exemple qui vous permettent de gérer la communication avec les services ArcGIS Server utilisés dans votre application.

La première page proxy, BuilderProxy.ashx, est conçue pour être utilisée pendant la création et le test des applications de visionneuse. La deuxième page proxy, Proxy.ashx, est conçue pour les applications de visionneuse déployées et est plus sécurisée que BuilderProxy.ashx. Téléchargez BuilderProxy.zip ou Proxy.zip.

Pages proxy disponibles

BuilderProxy.ashx

Utilisez la page BuilderProxy.ashx comme point de départ pour créer et tester Application Builder et les applications de visionneuse déployées, car elle permet aux jetons d'être partagés par toutes les applications à partir du même serveur Web IIS (Internet Information Services). La page BuilderProxy.ashx envoie uniquement le nom du serveur Web (http://<nomhôte>) comme référent dans la requête HTTP transmise, qui est moins sécurisée que ce qui est envoyé par Proxy.ashx. Pour configurer les jetons, modifiez le fichier BuilderProxy.config qui est inclus dans le fichier BuilderProxy.zip.

Lors de la récupération des jetons du répertoire des services (par exemple, http://<nomserveur>/ArcGIS/tokens/gettoken.html), utilisez http://hostname comme référent HTTP. Dans le fichier BuilderProxy.config, collez l'intégralité du jeton sans ajouter d'espace à la fin ou au début. Comme seul le nom d'hôte est utilisé, le jeton et la page proxy fonctionneront tous les deux dans Application Builder et dans les applications de visionneuse créées, à condition que l'accès aux applications se fasse via le nom d'hôte dans l'URL et non via l'hôte local ou le nom de domaine complet. Pour définir l'URL, assurez-vous que le paramètre AppsBaseUrl dans le fichier web.config d'Application Builder utilise le nom de machine réel et non l'hôte local.

Proxy.ashx

Utilisez la page Proxy.ashx pour les applications de visionneuse en phase de production. Proxy.ashx transmet le référent HTTP des applications au serveur. Par conséquent, la page Proxy.ashx est plus sécurisée. En général, vous avez besoin d'une page proxy par application si vous utilisez des jetons, car ces derniers sont spécifiques à l'application. Pour configurer les jetons, modifiez le fichier Proxy.config qui est inclus dans le fichier Proxy.zip. Lors de la récupération d'un jeton, utilisez l'URL du fichier Viewer.xap dans l'application déployée (par exemple, http://<nomhôte>/Apps/MyApplication/Viewer.xap) au lieu de simplement http://<nomhôte>. Ensuite, dans le fichier Proxy.config , collez l'intégralité du jeton sans ajouter d'espace à la fin ou au début.

Télécharger et configurer la page proxy

Les étapes suivantes décrivent comment télécharger et installer la page proxy sur votre serveur Web. La page proxy s'exécute sur votre serveur Web local, et non sur un serveur Esri ou sur l'ordinateur ArcGIS Server (sauf si votre serveur Web héberge également l'instance ArcGIS Server).

Avant de poursuivre, assurez-vous qu'ASP.NET 2.0 ou version supérieure est installé et inscrit avec IIS. Si ASP.NET n'est pas configuré avec IIS, suivez les instructions de la version d'IIS que vous exécutez dans la rubrique d'aide Configuration ASP.NET et IIS sur MSDN.

1. Téléchargez BuilderProxy.zip ou Proxy.zip, puis décompressez le fichier et enregistrez son contenu dans un dossier du répertoire racine de votre serveur Web. Dans IIS, l'emplacement par défaut du dossier racine du serveur Web est c:\inetpub\wwwroot. Si vous prévoyez d'utiliser le proxy pour plusieurs sites, vous pouvez créer un dossier dans le répertoire racine Web appelé proxy et y placer le contenu.
2. Ouvrez Gestionnaire des services Internet. Cet article de la base de connaissances de Microsoft explique comment ouvrir le gestionnaire des services Internet en fonction de la version d'IIS que vous utilisez.
3. Créez une application Web pour le dossier proxy. Ces étapes diffèrent selon la version d'IIS que vous utilisez.
   • Pour IIS 5 ou 6, procédez comme suit :
   1. Dans Site Web par défaut, cliquez avec le bouton droit sur le répertoire proxy et cliquez sur Propriétés.
   2. Sous l'onglet Répertoire de la section Paramètres de l'application, cliquez sur le bouton Créer, puis sur OK:
   • Pour IIS 7, procédez comme suit : Pour plus d'informations, reportez-vous à la rubrique Créer un site Web (IIS 7).
   1. Dans Site Web par défaut, cliquez avec le bouton droit sur le répertoire Proxy et cliquez sur Ajouter une application :
   2. Spécifiez Alias et Chemin d'accès physique dans la boîte de dialogue Ajouter une application, puis cliquez sur OK:
4. Si vous comptez utiliser la page proxy pour les services utilisant une authentification à base de jetons, obtenez un jeton pour le service. Si votre application utilise plusieurs systèmes ArcGIS Server qui requièrent des jetons, obtenez un jeton pour chaque serveur. Pour plus d'informations sur l'obtention d'un jeton, reportez-vous à la rubrique Services sécurisés dans la documentation ArcGIS for Silverlight. Pour plus d'informations sur l'URL à spécifier pour le paramètre Référent HTTP, consultez la section précédente.
5. Ouvrez la page proxy de configuration (proxy.config) dans un éditeur de texte ou XML.
6. Pour chaque ArcGIS Server qui utilisera la page proxy, ajoutez une entrée <serverUrl> dans le fichier XML de configuration au sein de la section <serverUrls>. Consultez le fichier de configuration proxy pour obtenir des exemples. L'élément serverUrl peut avoir les attributs suivants :
   • url : URL de la machine ou du service ArcGIS Server. Si plusieurs services au sein du même serveur sont utilisés dans l'application, l'URL peut pointer vers la racine des services. Si un seul service sur le serveur est utilisé, l'URL peut être définie vers l'URL du service entier.
   • matchAll : indique si le jeton doit être utilisé pour toutes les requêtes avec l'URL. Si cet attribut est vrai et que l'attribut de l'URL est défini sur la racine des services, l'entrée peut être utilisée pour plusieurs services dans l'application.
   • token : jeton d'authentification obtenu à l'étape 1. Facultatif : utilisé uniquement pour les services sécurisés avec une authentification à base de jetons.

   Si plusieurs services sur le même serveur sont utilisés dans l'application, l'URL peut pointer vers la racine des services (par exemple, http://www.example.com/arcgis/rest/services), et le paramètre matchAll peut être défini sur vrai. Plusieurs entrées de serveur peuvent être ajoutées si plusieurs ordinateurs ArcGIS Server sont utilisés dans l'application.

   L'attribut mustMatch dans l'élément qui le contient détermine si uniquement les sites spécifiés peuvent faire l'objet d'un proxy. Cet attribut doit généralement être défini sur vrai. S'il est défini sur faux, la page proxy transmettra toutes les requêtes à n'importe quel serveur. Cela peut amener votre page proxy à être utilisée pour envoyer des requêtes à des serveurs tiers sans votre autorisation.

7. Enregistrez le fichier de configuration. Notez l'URL de votre page proxy, car vous en aurez besoin lors de l'ajout d'un service de carte sécurisé à ArcGIS Viewer for Silverlight .