This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.

Configure login settings

Esri Maps for IBM Cognos requires an ArcGIS Online organizational subscription or an on-premises Portal for ArcGIS deployment. It is assumed that the authentication method used to access the platform has been properly configured by the ArcGIS administrator.

Before you begin, you'll need the following information:

Specify login properties

The settings file is on the EM4C Gateway in the following location: <em4c_location>\webcontent\esrimap\configuration\settings.js

In most cases, you will configure only the following login properties:

  • arcgisUrlArcGIS Online organization or Portal for ArcGIS deployment.

    For ArcGIS Online, the default value is http://www.arcgis.com; to enter a different value, use the format http://[orgAccount].arcgis.com, where [orgAccount] is the name of your organization's ArcGIS Online account. For Portal for ArcGIS, the format is http://[portalUrl]/[portalVirtualDirectory].

  • arcgisAuthType—Login method. Available values are user and app; the default value is user.

  • arcgisAppId—Specifies a unique application ID (ArcGIS Online or Portal for ArcGIS 10.3 and later).

    For example (ArcGIS Online):

    arcgisUrl: "http://www.arcgis.com",
    arcgisAuthType: "user",
    arcgisAppId: "nvgHDDFXzMRWmKfY"
    

    For example (Portal for ArcGIS 10.3 and later, no web server authentication):

    arcgisUrl: "http://myportal.mycompany.com/arcgis",
    arcgisAuthType: "user",
    arcgisAppId: "nvgHDDFXzMRWmKfY"
    

    For example (Portal for ArcGIS earlier than version 10.3, or using web server authentication):

    arcgisUrl: "http://myportal.mycompany/arcgis",
    arcgisAuthType: "user",
    arcgisAppId: ""
    

Other login settings

In specific cases, you may optionally provision a Named User account to act on behalf of Esri Maps for IBM Cognos by setting the arcgisAuthType to app and specifying a user name (arcgisAppUser) and password (arcgisAppPassword). Keep in mind that this product is provided as an entitlement of your ArcGIS Online plan subscription or Portal for ArcGIS Named User License, and that all licensing requirements are in effect. All users are required to have a Named User license to access the ArcGIS and interact with the map. Contact your local Esri representative for more information.

For example:

arcgisUrl: "http://www.arcgis.com",
arcgisAuthType: "app",
arcgisAppUser: "arcgis_user",
arcgisAppPassword: "arcgis_pwd"