user manual

Chapter 26: VisiConnect overview 279
Common Client Interface (CCI)
resource role to be used when allocating managed connections and
connection handles.
A default resource role can be defined for the connection factory in the
security-map element. To do this, specify a user-role value of "*" and a
corresponding resource-role value. The defined resource-role is then utilized
whenever the current identity if not matched elsewhere in the Security Map.
This is an optional element. However, it must be specified in some form when
container-managed sign-on is supported by the Resource Adapter and any
component uses it. Additionally, the deployment-time population of the
connection pool is attempted using the defined default resource role, given
that one is specified.
Security Policy Processing
The Connectors 1.0 specification defines default security policies for any
Resource Adapters running in an application server. It also defines a way for a
Resource Adapter to provide its own specific security policies overriding the
default.
In compliance with this specification, Borland Enterprise Server dynamically
modifies the runtime environment for Resource Adapters. If the Resource
Adapter has not defined specific security policies, Borland Enterprise Server
overrides the runtime environment for the Resource Adapter with the default
security policies specified in the Connectors 1.0 specification. If the Resource
Adapter has defined specific security policies, Borland Enterprise Server first
overrides the runtime environment for the Resource Adapter first with a
combination of the default security policies for Resource Adapters and the
specific policies defined for the Resource Adapter. Resource Adapters define
specific security policies using the security-permission-spec element in the
ra.xml deployment descriptor file.
For more information on security policy processing requirements, see Section
11.2, "Security Permissions", in the Connectors 1.0 specification (http://
java.sun/j2ee/download.html#connectorspec).
Common Client Interface (CCI)
The Common Client Interface (CCI) defines a standard client API for
application components. The CCI enables application components, Enterprise
Application Integration (EAI) frameworks, and development tools to drive
interactions across heterogeneous EISs using a common client API.
The CCI is targeted for use by EAI and enterprise tool vendors. The
Connectors 1.0 specification recommends that the CCI be the basis for richer
functionality provided by the tool vendors, rather than being an application-
level programming interface used by most application developers. Application
components themselves may also write to the API. As the CCI is a low-level
interface, this use is generally reserved for the migration of legacy modules to
the J2EE 1.3 Platform. Through the CCI, legacy EIS clients can integrate