CA RiskMinder Administration Guide › RiskMinder Rule Tags

RiskMinder Rule Tags

Rules take data elements, called Tags, as input. For example, two common data elements are the end user's country and the transaction amount. This data is provided in the evaluateRisk()API call through extensible data structures called contexts. For more information, see the CA RiskMinder Java Developer’s Guide.

This appendix describes the tags that you can use in your rules.

Data elements are referenced in RiskMinder rules either using an explicit reference called a TagName, or implicit reference by the context of the rule. You can use the data listed in the following table to include in your rules. Some of this data is provided in the RiskMinder evaluateRisk() API call and other data is derived through lookup, such as the geolocation of the end user's or cardholder's IP address.

The data in the following table is classified into the following categories:

User: Provides information about the user and the account.
Device: Provides information about the device used to originate the transaction.
General Transaction: Provides information about elements of every transaction, such as the channel and action.
Currency: Provides information such as currency conversion rate and base currency.
Location: These elements are derived from a maintained database of IP geolocation, which provides location data and connection attributes of the IP address.
Internal Parameters: Support the construction of custom rule types.

Tag Name	Description

User Information
IDENTITY.USERID	The encrypted version of the user identifier.
RULESET.GROUPNAME	The organization name.
Device Information
DEVICEID.http	The alpha-numeric ID assigned by RiskMinder for this device.
DEVICEID.flash	The Flash device ID string specific to the transaction.
DEVICESIG	The device signature.
SHORTDEVICESIG	The compact form of the device signature.
AGGREGATORINFO	Aggregator ID string specific to the transaction.
RULE.SIGPASSTHRESHOLD	Pass threshold used by the Device MFP Not Match rule.
General Transaction Information
RULESET.CHANNELNAME	The channel using which the user accesses the system.
TRANSACTION.TXNID	The numeric identifier for this transaction generated by RiskMinder.
TRANSACTION.EXT	Name-value Extensible element string sent by the client.
Currency Information
BASE_CURR_CODE	Numeric designation corresponding to the 3-letter designation of the base currency of the organization.
BASE_CURR_AMOUNT	Transaction amount converted to the Base Currency.
BASE_CONVERSION_RATE	Conversion rate from transaction currency to the base currency of the organization.
Location Information
RULESET.COUNTRYISO	Contains the two letter ISO 3166 alpha country code of the country, for example AU.
RULESET.STARTIP	Starting IP for the user IP block.
RULESET.ENDIP	Ending IP for the user IP block.
RULESET.GEOLAT	Latitude is expressed as a floating point number with positive numbers representing North and negative numbers representing South.
RULESET.GEOLONG	Longitude is expressed as a floating point number with positive numbers representing East and negative numbers representing West.
RULESET.GEOCF	Confidence Factor (CF) in the geolocation. Confidence Factors are calculated based on the precision, completeness, and consistency of the data available to assign a specific geographic location to an IP address range. Confidence Factors are provided for Country, State, and City. Their value ranges from 1 to 99. A higher value indicates that the likelihood of a correct location assignment is higher; a lower value indicates the opposite. These values are not percentages. Their intended use is as a relative measure of "confidence" on the correctness of the corresponding location assignment.
Internal Parameters
RULE.USERCONTEXT	User context information used internally by the rules engine to store state information.
RULE.DEVICECONTEXT	Device context information used internally by the rules engine to store state information.
ADDONRULE.DESCRRESULT	The concatenated string of results from the add-on rules called till this point.
ADDONRULE.ANNOTATION	The concatenated strings of annotations set by all add-on rules called till this point.
RULE.PARAMETERS	Name-Value parameters configured for the rule.
RULE.RULEMNEMONIC	Rule mnemonic configured for the rule.