ESRI ArcGIS Integration (GISINT)

The purpose of this documentation is to document only the parts that needs to be done by a technician regarding the ESRI ArcGIS Integration. All other details, technical as well as functional, that an IFS administrator or power user can perform, are described in the end user documentation as about documents, activity diagrams and activity descriptions.

When to use this information:

Use this page when you want to invoke the integration between IFS Applications and ESRI ArcGIS Server. Both systems needs to be installed prior to this setup.

Contents

• Prerequisites
• Token based security for accessing an ArcGIS Server or an ArcGIS Online account

Prerequisites
 

• Install ArcGIS for Server: A requirement for the GIS integration to work is that ESRI ArcGIS for Server is installed. Information about how to do this is not part of this document, but is part of the documentation in ArcGIS for Server. For actual supported versions of ESRI products, please refer to the pages on IFS Supported Platforms (IFS internal).
• Install ArcGIS for Desktop (ArcMap): If you want to create new maps that are to be published to the ArcGIS server as services and that are later used by the GIS integration, you have to have the ArcGIS for Desktop tools installed, and use the ArcMap program to do it. It is strictly not needed for the integration to run, but the customer must be able to create their maps in some way.
• This document does not explain how to install this software. Instead, please refer to the online documentation that comes with ArcGIS for Desktop, or centrally via ESRI ArcGIS Resources.
   

Token based security for accessing an ArcGIS Server or an ArcGIS Online account

A token is used when ArcGIS Server security is configured to the ArcGIS Managed Authentication option. A token represents the identity of a user to an ArcGIS Web service. A token is issued to a client application by a token service, which is a Web service. A client application must provide a valid token to a secured ArcGIS Web service to access it. Below is an example on how this can be implemented in our integration.

The following example illustrates an address to an ArcGIS server where login is required:

http://<GisServer>:6080/arcgis/rest/services/Labels/FeatureServer

The next example with a token does not require logon:

http://<GisServer>:6080/arcgis/rest/services/Labels/FeatureServer?token=<TokenID> (where <TokenID> is a random generated string)

A token is created with the following example, where <Username>, <Password> and <NumberOfMinutes> are entered. The last parameter decides the valid time in minutes for the token:

http://<GisServer>:6080/arcgis/tokens/generateToken?password=<Password>&f=json&username=<Username>&referer=sfal-maps&ip=&expiration=<NumberOfMinutes>&encrypted=false

We have now created a token. The next step is to add the token in a GIS proxy file in an IFS Application server, and test this on GIS service where only the actual user has access. This must be edited in the GISINT source code before the application server is built. The file location is:

gisint/source/gisint/framework/giswebcontent/src/proxy/proxy.jsp

In the proxy file proxy.jsp the following code is entered.

String[] serverUrls = {
"<GisServer>:6080/arcgis/rest/services,<TokenID>",
"arcgis/rest/services"
};