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:
- Configuring How Frequently Automatic Cache Refresh Ooccurs
- Configuring the Location of the Cache
- Configuring Tyco Server Settings
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 tofalse
or leave it blank.
Related Topics
Integrating Tyco C-CURE 9000 with MicroStrategy Identity
Verifying that the Tyco C-CURE Adapter Installation is Correct