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.
This interface is implemented by setting the
CtsSecurity::CallerPrincipal
as an
additional interface for the authentication component.
It is optional to implement this interface.
Returns the original principal name given the
alternate_name
.
An Authentication service can modify the username
associated with an authenticated session by calling the
setName
method.
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 EJBContext.getCallerPrincipal
.
If the authentication service does not implement this
interface, then this method is not invoked, and the
current username is returned.