This represents an interface for retrieving additional information
about the current authenticated session. This interface should
be used when a customized authentication service component is
also used or a JAAS login module is used that invokes
There are 2 ways to implement this interface.
For example, to set the callerprincipal service, set the server level property to com.sybase.jaguar.server.callerprincipalservice=Security/CallerPrincipalService assuming, Security is the name of the Jaguar package that containing a Jaguar component called CallerPrincipalService that implements this interface.
Components implemented for pseudo component access, must be thread safe. Pseudo components cannot be refreshed. Hence, a server refresh, or refresh of the component using the EAServer Manager, will not have any effect on the refresh of the role service. You must restart the EAServer if there is a need to refresh the role service component. For more information on EAServer Pseudo components, please refer to your EAServer documentation.
For performance, the caller principal service component may be implemented as a pseudo C++ CORBA component.
CtsSecurity::CallerPrincipalas an additional interface for the authentication component. If this scheme is adopted, it is not necessary to set the server level caller principal service property as described above.
At runtime, the server will first check for the server level caller principal service property. If this property is set, the authentication service is not consulted at all. However, if the server level caller principal service property is not set, then the server will default to checking if the authentication service (if any) has implemented this interface.
It is optional to implement this interface.
Returns the original principal name given the
An Authentication service can modify the username
associated with an authenticated session by calling the
getCallerPrincipal method should perform
the reverse mapping of setName.
string getCallerPrincipal ( in string alternate_name );
This method is internally invoked by the server, when
a bean calls
If the authentication service does not implement this
interface, then this method is not invoked, and the
current username is returned.