This is an archive related to a previous version of Esri Maps for SharePoint. If you need the current version go to http://doc.arcgis.com/en/maps-for-sharepoint/.
In the Silverlight-based ArcGIS Map Web Part, a proxy page can be used to access ArcGIS Server services secured with token-based authentication. A proxy page consists of server-side code that runs on your web server. The browser sends the request to your proxy and your proxy in turn forwards the request to the ArcGIS Server service. Esri Maps for SharePoint provides a proxy page, Proxy.ashx, that you can use to handle communication with the ArcGIS Server services used in your application. Download Proxy.zip.
The Proxy.ashx page passes along the HTTP referrer from the applications to the server. Typically, you need one proxy page per application if you are using tokens, because tokens are application specific. The scope for which you choose to define tokens (site, page, and so on) depend on the level at which you want to authenticate. If all Map Web Parts within an entire site consume securd ArcGIS Server services in the same way, it may make sense to define one proxy for the site. If various Map Web Parts within a site differ in how they access secured services,set up a proxy for each page or set of pages that use the same permissions.
When retrieving tokens from the Services Directory (for example, http://<servername>/ArcGIS/tokens/gettoken.html), use the entire URL to the SharePoint site or page instead of just http://<hostname>. In the Proxy.config file, paste the entire token without leading or trailing white spaces. Alternatively, use the URL of just the SharePoint site collection to have the proxy work for all site pages. Detailed instructions are in the next section.
The following steps describe how to download and install the proxy page on your web server. The proxy page runs on your local web server, not on an Esri server or on the ArcGIS Server computer (unless your web server also hosts the ArcGIS Server instance). The proxy page does not have to be located on your SharePoint server.
Before proceeding, ensure that you have ASP.NET 2.0 or higher installed and registered with IIS. If ASP.NET is not configured with IIS, follow the instructions for the version of IIS you are running in the ASP.NET and IIS Configuration help topic on MSDN.
If multiple services on the same server are used in the application, the URL can point to the service root (for example, http://www.example.com/arcgis/rest/services), and the matchAllparameter can be set to true. Multiple server entries can be added if more than one ArcGIS Server computer is used in the application.
The mustMatch attribute in the containing element controls whether only specified sites can be proxied. This attribute should generally be set to true. If set to false, the proxy page forwards any request to any server. This could potentially allow your proxy page to be used to send requests to third-party servers without your permission.
Once you have configured the proxy page with the application, test the application to ensure requests are processed correctly. The application should function normally as it did before the proxy page was implemented. If not, you may need to troubleshoot the proxy. If your application environment supports debugging mode, you may be able to set a breakpoint in the proxy page and detect whether it is operating correctly.