Skip To Content

Use ArcGIS Web Adaptor with portals

ArcGIS Web Adaptor (Java Platform) is a component of Portal for ArcGIS that allows you to integrate your portal with your existing web server and your organization's security mechanisms.

The Web Adaptor is an application that runs in your existing website and forwards requests to the machine hosting Portal for ArcGIS. The Java Platform setup is compatible with Java EE servers such as WebSphere and WebLogic.

Benefits of the Web Adaptor

You can do the following using the Web Adaptor:

  • Integrate Portal for ArcGIS with your organization's existing web server. By including a web server in your site, you can host web applications that use your GIS services.

  • Use your organization's identity store and security policies at the web-tier level. You can also use Public Key Infrastructure (PKI) or any other identity store for which the web server has built-in or extensible support. This allows you to provide a single sign-on or other custom authentication experience when logging in to use services, web applications, and Portal for ArcGIS.

  • Make Portal for ArcGIS available through a site name other than the default: arcgis.

  • Make Portal for ArcGIS available through port 80 or 443.

    Note:

    You can only use the Web Adaptor with port 80 or 443. Using other ports is not supported.

Web Adaptor deployment scenarios

The Web Adaptor version must always match the version of the ArcGIS Enterprise component with which it is configured.

The Web Adaptor is platform independent of ArcGIS Enterprise; therefore, the Web Adaptor you deploy does not have to match the operating system platform of your portal. For example, if your portal is running on Linux, you can deploy ArcGIS Web Adaptor (Java Platform) to work with Portal for ArcGIS.

Accessing your portal with the Web Adaptor installed

After installing and configuring the Web Adaptor, the URL that you use to access your portal will be in the format https://webadaptorhost.domain.com/webadaptorname/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, you'll access the portal using the URL https://wa.myorg.net/arcgis/home.

If you configured your portal to use HTTPS for all communication, 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.

Web Adaptor setup experience

The Web Adaptor has its own setup and installation guide that is separate from the Portal for ArcGIS installation. You must install the Web Adaptor on a machine running a web server. This can be a machine running Portal for ArcGIS or a separate machine.

To learn more about the setup experience, see Steps to implement ArcGIS Web Adaptor.