Skip To Content

Configure login settings

In this topic

Esri Maps for MicroStrategy 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.

Note:

If your organization's Portal for ArcGIS is secured using PKI or IWA authentication and users within your organization use a non CORS-enabled browser (such as Microsoft IE8 or IE9), you must configure your environment so that your Portal for ArcGIS and the web server component of your Business Intelligence system are served from the same origin; that is, they must be on the same host, domain, and port, and use the same protocol.

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

  • The URL of your ArcGIS organization.

    Tip:

    Browse to <arcgisUrl>/sharing/?f=pjson in a browser; if the arcgisUrl is correct, the browser displays current version information. For example, see http://www.arcgis.com/sharing/?f=json.

  • The app ID generated when you registered your application. This is not required when connecting to a Portal for ArcGIS deployment that uses web server authentication or a Portal for ArcGIS deployment earlier than version 10.3.

Configuration file

On Windows, the configuration file is in the following location: <MicroStrategy plugin directory>\em4mstr\javascript\configuration\settings.js

On Linux, the configuration file is in the following location: <MicroStrategy plugin directory>/em4mstr/javascript/configuration/settings.js

Specify login properties

In most cases, you'll 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: ""

Note:

Do not include /home when specifying the arcgisUrl.

After you save and close the file, restart your web application server. You may need to clear the browser cache to implement changes.

Other login settings

In specific cases, you can optionally provision a Named User account to act on behalf of Esri Maps for MicroStrategy 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 all licensing requirements are in effect. All users are required to have a Named User license to access 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"

Note:

When using the app arcgisAuthType, it is strongly recommended that you set the arcgisSharing property to false; see Configure administrative settings for details.