Risk Analytics Web Services Overview

 
cara
 
CA Risk Analytics (referred to as RA later in this section) is an adaptive authentication solution that evaluates each online transaction in real time by examining a wide range of collected data against the configured rules. It then assigns each transaction a risk score and advice. The higher the risk score, the greater is the possibility of a fraud, the negative is the advice. Based on your business policies, your application can then use this risk score and advice to approve or decline a transaction, ask for additional authentication, or alert a customer service representative.
RA offers you the flexibility to modify the configuration parameters of any of the risk evaluation rules in keeping with your policies and risk-mitigation requirements. It also gives you the flexibility to modify the default scoring configurations, scoring priorities, and risk score for any rule and selectively enable or disable the execution of one or more rules.
Besides pre-configured out-of-the-box rules, RA’s field-programmable custom rules capability allows for industry-specific rules to be selectively deployed and augmented based on your requirements.
See thesection to understand the basic concepts of RA and its architecture.
This topic provides information about how to use RA Web services to enable your online application to programmatically perform risk evaluation and related tasks. It discusses the Web services provided by RA, the checks that you must perform before implementing the Web services, and steps to generate Java client stubs. It covers the following sub-topics:
Introduction to the Risk Analytics Web Services
RA provides a programmatic interface that you can use to integrate your application with RA. The following table describes the RA Web services:
Web Service
Description
Risk Evaluation Web Service
Provides the logic for evaluating the risk associated with a transaction and returning an appropriate advice.
Administration Web Service
Provides a limited number of administrative operations that you can perform either by using Administration Console or by using this Web service.
Organization Management Web Service
Enables you to programatically create and manage organizations
User Management Web Service
Enables you to manage users, user accounts, Personal Assurance Message (PAM), and authentication operations for LDAP users
Configuration Management Web Service
Enables you to perform additional configurations on account type, email, and telephone types.
Case Management Web Service
Enables external systems to interact with the RA Case Management system.
Risk Analytics Web Services Features
The salient features of RA Web services are:
  • Web Services Authentication and Authorization
    RA Web services are protected from rogue requests through authentication and authorization of all Web service requests. Authentication ensures that the incoming request to the Web service has valid credentials to access the Web service, while authorization ensures that the authenticated request has appropriate privileges to access the Web service.
    See "Managing Web Services Security" for more information.
    A Master Administrator (MA) can also enable Web services authentication and authorization by using the Authentication and Authorization page in Administration Console.
  • Support for Additional Parameters
    In addition to the mandatory inputs, Web services accept additional input that can be passed as a name-value pair. This input can include information, such as locale, calling application details, or profile.
Accessing the WSDL Documentation
You can access the latest WSDLDocs from the
CA Risk Analytics 5.0
Bookshelf
.
If you are updating an existing RA application, then you must consult the
Release Notes
and WSDLDoc documentation for deprecated APIs before making any changes.
Risk Evaluation Web Services
The following table lists the files that are installed as a part of the Risk Evaluation Web services component. The base location for these files is:
  • Microsoft Windows
    <install_location>\Arcot Systems\
  • UNIX-Based Platforms
    <install_location>/arcot/
Location
File Name
Description
 
 
 
 
docs\
riskfort
\
(Microsoft Windows)
 
 
 
 
 
docs/
riskfort
/
(UNIX Platforms)
Arcot-RiskFort-5.0-AdminWebService-wsdl
docs.zip
 
or
 
Arcot-RiskFort-5.0-AdminWebService-wsdl
docs.tar.gz
 
WSDL documentation for the Administration Web service.
 
 
Arcot-RiskFort-5.0-risk-evaluation-wsdl
docs.zip
 
or
 
Arcot-RiskFort-5.0-risk-evaluation-wsdl
docs.tar.gz
 
WSDL documentation for the Risk Evaluation Web service.
 
 
wsdls\
admin
\
(Microsoft Windows)
 
wsdls/
admin
/
(UNIX Platforms)
 
ArcotRiskFortAdminWebService.wsdl
This WSDL describes the Administration Web services and how to access them.
 
wsdls\
riskfort
\
(Microsoft Windows)
 
wsdls/
riskfort
/
(UNIX Platforms)
 
ArcotRiskFortEvaluateRiskService.wsdl
This WSDL describes the Risk Evaluation Web services and how to access them.
 
 
sdk\
devicedna
\
(Microsoft Windows)
 
 
sdk/
devicedna
/
(UNIX Platforms)
 
riskminder-client.js
This file contains the functions to gather the Device ID- and DeviceDNA-related information from the end user’s device and to generate the single-encoded String with all the DeviceDNA values.
User Data Service (UDS) Web Services
The following table lists the files that are installed as a part of the UDS Web services component. The base location for these files is:
  • Microsoft Windows
    <install_location>\Arcot Systems\
  • UNIX-Based Platforms
    <install_location>/arcot/
Location
File Name
Description
docs\
uds
\
(Microsoft Windows)
 
docs/
uds
/
(UNIX Platforms)
arcot-uds-2_0-wsdl-docs.zip
 
or
 
arcot-uds-2_0-wsdl-docs.tar.gz
WSDL documentation for the User Data Service (UDS) Web service.
 
 
This WSDL describes the UDS Web services and how to access them.
 
 
 
 
wsdls\
uds
\
(Microsoft Windows)
 
 
 
 
 
wsdls/
uds
/
(UNIX Platforms)
 
 
 
ArcotConfigManagementSvc.wsdl
This WSDL describes the UDS Configuration management Web services and how to access them.
These Web services are used to create and manage user account types.
ArcotOrganizationManagementSvc.wsdl
This WSDL describes the UDS Organization management Web services and how to access them.
These Web services are used to create and manage organizations in the system.
ArcotUserManagementSvc.wsdl
This WSDL describes the UDS User management Web services and how to access them.
These Web services are used to create and manage users in the system.
ArcotUserSchema.xsd
This is the XML Schema Definition that serves as the reference library that can be uses by your code for working with the preceding three UDS Web services.
Case Management Web Services
The following table lists the file that is installed as a part of the Case Management Web services component. The base location for the file is:
  • Microsoft Windows
    <install_location>\Arcot Systems\
  • UNIX-Based Platforms
    <install_location>/arcot/
Location
File Name
Description
wsdls\
riskfort
\
(Microsoft Windows)
 
wsdls/
riskfort
/
(UNIX Platforms)
 
ArcotRiskAnalyticsCaseMgmtService.wsdl
This WSDL describes the Case Management Web services and how to access them.