Portal for ArcGIS | Administrator Guide - Configuring the ArcGIS Web Adaptor

After you install the ArcGIS Web Adaptor, you must configure it to work with Portal for ArcGIS. You'll do this from a configuration web page that was installed with the Web Adaptor.

As a security measure, you can only access the configuration page from the machine hosting the Web Adaptor. For full instructions on how to configure the Web Adaptor, follow the steps below.

Note:

Before proceeding, ensure that the Web Adaptor is installed on a website running on port 80. The Web Adaptor cannot be configured with Portal for ArcGIS if it is installed on website running on a port other than 80.

Steps:

If you haven't done so already, enable SSL on port 443 of your web server. To learn more, see Enabling SSL on your web server.
Open the Web Adaptor configuration page in a web browser using an HTTPS URL such as https://webadaptor.domain.com/arcgis/webadaptor. For example, if the machine hosting your Web Adaptor is named wa with the domain myorg.net and your Web Adaptor is named arcgis, the URL is https://wa.myorg.net/arcgis/webadaptor.
Select Portal for ArcGIS and click Next.
For Portal URL, type the URL to the machine hosting Portal for ArcGIS. Include the fully qualified domain name of the server. For example, the URL should take the form http://portal.domain.com:7080.
Navigate to <Portal for ArcGIS installation directory>/etc and open the portal-config.properties file in a text editor.
Locate the security.shared.key value and copy the shared key. For example, vxhUZ+qox+a9OH88cQq/gNkmvwK8phPHPwbGiJv80J/S58Muh2zLLajADpjOTfO5. Leave the file open as you will edit it in another step.
Note:
The Portal for ArcGIS setup creates a unique shared key for your organization; it cannot be modified and must be used as is in the Web Adaptor configuration.
On the Web Adaptor configuration page, paste the shared key into the Shared Key field. This establishes a trust relationship between the Web Adaptor and the machine hosting Portal for ArcGIS.
Click Configure to apply your settings to the Web Adaptor.

Copy the content in the green status box on the configuration page, for example:

webadaptor.url=https://webadaptor.domain.com/arcgis
webadaptor.http.port=80
webadaptor.https.port=443
webadpator.server.name=webadaptor.domain.com

In the portal-config.properties file on the machine hosting Portal for ArcGIS, replace the following with the content you copied from the configuration page:
```
webadaptor.url=
webadaptor.http.port=
webadaptor.https.port=
webadpator.server.name=
```
The above properties should now be identical to the content you copied from the configuration page.
Save and close the portal-config.properties file.
Stop and then start Portal for ArcGIS. You can do this from the command line or use your operating system's tools. For more information, see Stopping and starting the portal.

The Web Adaptor is now configured for use with the machine hosting Portal for ArcGIS. Now, you'll access your portal through the Web Adaptor URL, instead of port 7080. The URL is in the following format: https://webadaptor.domain.com/arcgis/home. For example, if the machine hosting your Web Adaptor is named wa with the domain myorg.net and your Web Adaptor is named arcgis, the URL is https://wa.myorg.net/arcgis/home.

If you have configured your portal to use SSL for all communication, you should update the installed portal website and help shortcut URLs to use https instead of http. Otherwise you will see failures in your browser when attempting to access the original shortcut URLs.

If you'll be configuring Portal for ArcGIS with your organization's reverse proxy server, you'll need to provide some information to your portal about the proxy server. For full instructions, see Configuring a reverse proxy server with your portal.

12/13/2013