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

Configure SharePoint to work with SSL-secured sites

The components included in Esri Maps for SharePoint—the Silverlight-based ArcGIS Map Web Part, Esri MAPS Locate workflow, Esri MAPS Connect workflow, and Esri Maps Location field—each reference services from ArcGIS Online out of the box. By default, they access these services over HTTP. Due to the cross-scheme restrictions of Silverlight, the default use of HTTP introduces problems when Esri Maps for SharePoint is used within a SharePoint site that employs Secure Sockets Layer (SSL or HTTPS) protection. Since Esri Maps for SharePoint is highly configurable, all of the service endpoints used by the product can be updated to use HTTPS endpoints instead of HTTP. This topic explains how to use HTTPS instead of HTTP.

Updating configuration lists to use SSL

Much of the Esri Maps for SharePoint configuration is stored in lists, where each list item corresponds to a web service used by the product. The lists containing items you'll need to update include Basemaps, Connections, Locators, and the ArcGIS Online URL in the Configuration Settings list. Updating these to use HTTPS instead of HTTP is a matter of updating each list item to specify an equivalent HTTPS endpoint or deleting those items for which SSL equivalents do not exist. The specific steps to update each configuration list are as follows:

Updating the basemaps

Update the map services used as basemaps to point to HTTPS endpoints. These are the set of basemaps available in the ArcGIS Map Web Part basemap gallery.

Basemap gallery

  1. Within the SSL-secured site collection, browse to the settings page by selecting Site Settings from the Site Actions menu.
  2. Under Esri Maps for SharePoint Administration, click the Legacy ArcGIS Mapping Settings link and click Basemaps
  3. For each list item with a basemap type of ArcGIS Server, change the Map Service URL to point to an HTTPS equivalent. If no HTTPS equivalent exists, delete it. By default, the first eight basemaps should be changed to HTTPS.
    Map service list

    These eight map services are hosted on ArcGIS Online, and each have SSL equivalents. When editing each item, make sure to update the web address.

    Edit map service item

    While it's recommended to update the description as well, that's only used for display within the list. The web address is the uniform resource locator (URL) that's used by Esri Maps for SharePoint. This applies to the service endpoints in this list as well as the others that need to be updated (described below).

Update the ArcGIS Server connections

Update the default set of ArcGIS Server connections. These are the ArcGIS Server instances that appear by default in the ArcGIS Map Web Part Browse pane.

Server connections in Browse pane

  1. Return to the Site Settings page.
  2. Under Esri Maps for SharePoint Administration, click Connections.
  3. Edit the URL of any HTTPS entries to point to SSL equivalents. By default, the ArcGIS Online list item should be updated. As with the basemap URLs, make sure to update the web address.
    Edit Item drop-down menu
  4. Delete any items for which HTTPS equivalents do not exist. If the sampleserver1 and sampleserver3 endpoints are included in the list, delete them.
    List of HTTP endpoints

Update the geometry service

Update the geometry service endpoint. This endpoint is used by the ArcGIS Map Web Part for geometric operations, such as reprojecting graphics when switching between basemaps with different spatial references.

  1. Return to the Site Settings page.
  2. Under Esri Maps for SharePoint Administration, click Esri Maps Configuration Settings.
  3. Edit the URL of the geometry service list item to specify an HTTPS endpoint. If the default ArcGIS Online geometry service is listed here, it can be changed to https.
    Edit Geometry Service URL

Update the ArcGIS configuration settings

Update the ArcGIS configuration settings. These settings define the endpoints used by the Map Web Part for retrieving the web maps and groups provided by the Map Center. This file can be edited to specify use of an organization's Portal for ArcGIS instance instead of ArcGIS Online.

  1. Return to the Site Settings page.
  2. Under Esri Maps for SharePoint Administration, click Esri Maps Configuration Settings.
  3. For the ArcGISConnection list item, change the URL from HTTP to HTTPS.

Updating configuration files to use SSL

Some of the Esri Maps for SharePoint configuration is stored in configuration files. Unlike the configuration lists, which define the configuration of sets of equivalent items, the configuration files specify relatively complex configurations, such as the default map definition and default layout of the Map Web Part. Two of these files contain references to HTTP service endpoints. These can be changed to HTTPS as follows:

  1. From the Site Actions menu, choose View All Site Content.
  2. Under Document Libraries, choose Esri Maps Configuration Files.
    Esri Maps Configuration Files library
  3. Open the MapWebPartStartupMapDocument.xaml document for editing. This document specifies the map definition for new Map web parts. One convenient way to open it for editing is to click Open with Explorer from the List tab on the SharePoint ribbon. From there, files can be opened for editing with text editors such as Notepad or integrated development environments (IDEs) such as Visual Studio. Alternatively, the file can be downloaded, edited locally, and uploaded to the document library once editing is complete.
  4. In the markup, change any layers that reference an HTTP service endpoint to HTTPS. By default, only the URL for the ArcGISTiledMapServiceLayer needs to be updated.
    MapWebPartStartupMapDocument.xaml file
  5. Open the LocationOnMapStartupMapDocument.xaml document for editing. This document specifies the map definition for all ArcGIS Location Fields within the site collection.
  6. As with the previous document, change any HTTP service endpoints to HTTPS. By default, the LocationOnMapStartupMapDocument.xaml document is exactly the same as MapWebPartStartupMapDocument.xaml, so with a default installation, the change specified in step 4 can be applied here as well.

Once these steps have been completed, Esri Maps for SharePointcomponents will all work within the SSL site just as they do by default within any non-SSL site. New ArcGIS Map Web Part, Esri MAPS Locate workflows, and Esri Maps Location fields will all retrieve the updated configuration, using only HTTPS service endpoints and working within Silverlight's URL access restrictions.