C++ Security Reference

Using Security in CORBA Applications

Tobj::PrincipalAuthenticator::build_auth_data

Synopsis

Creates authentication data and attributes for use by SecurityLevel2::PrincipalAuthenticator::authenticate.

OMG IDL Definition


void build_auth_data(
       in string                     user_name,
       in string                     client_name,
       in string                     system_password,
       in string                     user_password,
       in UserAuthData               user_data,
       out Security::Opaque          auth_data,
       out Security::AttributeList   privileges
);

Arguments

user_name

The BEA Tuxedo username.

client_name

The CORBA client name.

system_password

The CORBA client application password.

user_password

The user password (default BEA Tuxedo authentication service).

user_data

Client application-specific data (custom BEA Tuxedo authentication service).

auth_data

For use by authenticate.

privileges

For use by authenticate.

Note: If user_name, client_name, or system_password is NULL or empty, or exceeds 30 characters, the subsequent authenticate method invocation raises the CORBA::BAD_PARAM exception.

Note: The user_password and user_data parameters are mutually exclusive, depending on the requirements of the authentication service used in the configuration of the BEA Tuxedo domain. The BEA Tuxedo default authentication service expects a user password. A customized authentication service may require user data. If both user_password and user_data are specified, the subsequent authentication call raises the CORBA::BAD_PARAM exception.

Description

This method is a helper function that creates authentication data and attributes to be used by SecurityLevel2::PrincipalAuthenticator::authenticate.

Note: This method raises CORBA::BAD_INV_ORDER if it is called with an invalid SecurityCurrent object.

Return Values

None.