MicroStrategy ONE

Optimizing the Tyco C-CURE Adapter for MicroStrategy Identity

After the Tyco C-CURE physical access control system (PACS) adapter is installed, you can optimize it for MicroStrategy Identity. To do this, you customize configuration settings, some of which are not prompted when you install the adapter:

The sections below explain the settings you can change using a text editor to modify the tyco_adapter.json file.

Configuring How Frequently Automatic Cache Refresh Ooccurs

The cache_refresh_interval_sec setting controls how long, in seconds, between automatic cache refreshes. The cache refresh causes user, portal, and permission changes to take effect in MicroStrategy Identity. The default is 1800 seconds (30 minutes).

To change this setting, use a text editor to modify the tyco_adapter.json file.

The cache on the PACS adapter contains information about each user, door or portal, and permissions, such as whether a user has access to use a door. When that information changes in the Tyco C-CURE PACS, it becomes active in the adapter and, therefore, the physical access points, after the cache is refreshed in the adapter. The cache refresh can take several minutes. For example, with this setting configured as 30 minutes, when a new user is added in the PACS and given access to five doors, the longest they would have to wait until they can begin accessing those doors is 30 minutes. If this is set to 0, the cache is not automatically refreshed.

To initialize the cache, the adapter communicates with the Tyco C-CURE PACS to gather all the configuration information. The adapter uses two methods to get the information:

  • HTTP to get the AccessLevels, Portals, and ReadersGroups.
  • Connects directly to the Tyco C-CURE database to get Persons.

You can force a cache refresh at any time. For the URL to use, see Refreshing the Tyco C-CURE Adapter Cache.

Configuring the Location of the Cache

The cache_location setting notes the path name of the disk cache file on the machine hosting the Tyco C-CURE adapter. For example, /opt/apache-tomcat-8.0.28/UsherAdapter/tyco_adapter.cache.

The cache on the PACS adapter contains information about each user, door or portal, and permissions, such as whether a user has access to use a door.

To change this setting, use a text editor to modify the tyco_adapter.json file.

Configuring Tyco Server Settings

The configuration file lists Tyco C-CURE server information. To change these settings, use a text editor to modify the tyco_adapter.json file.

  • base_url. The URL of your Tyco C-CURE web service.
  • domainName. The domain name of your Tyco C-CURE server.
  • username and password. A user name and password for a user that has administrator access to the Tyco C-CURE server.
  • user_mapping_field. Determines which user property in Tyco C-CURE is used to uniquely identify a user. The default is email.
  • enable_https. When the adapter connects to the Tyco C-CURE server, this setting controls whether the protocol used is regular or secure. To use a secure protocol, change this setting to true. For regular protocol, change it to false or leave it blank.

Related Topics

Integrating Tyco C-CURE 9000 with MicroStrategy Identity

Verifying that the Tyco C-CURE Adapter Installation is Correct

Diagnosing the Tyco C-CURE Adapter Health

Refreshing the Tyco C-CURE Adapter Cache