Automation Security Reference

Using Security in CORBA Applications

DITobj_PrincipalAuthenticator.authenticate

Synopsis

Authenticates the client application.

MIDL Mapping

HRESULT authenticate(
     [in] long 						method,
     [in] BSTR 						security_name,
     [in] VARIANT 						auth_data,
     [in] VARIANT 						privileges,
     [out] DISecurityLevel2_Credentials**

						creds,
     [out] VARIANT* 						continuation_data,
     [out] VARIANT* 						auth_specific_data,
     [in,out,optional] VARIANT* 						exceptionInfo,
     [out,retval] Security_AuthenticationStatus* returnValue);

Automation Mapping

Function authenticate(method As Long, security_name As String, auth_data, privileges, creds As DISecurityLevel2_Credentials, continuation_data, auth_specific_data, [exceptionInfo]) As Security_AuthenticationStatus

Arguments

method

Must be Tobj::TuxedoSecurity. If method is invalid, authenticate raises CORBA::BAD_PARAM.

security_name

The BEA Tuxedo username.

auth_data

As returned by DITobj_PrincipalAuthenticator.build_auth_data. If auth_data is invalid, authenticate raises CORBA::BAD_PARAM.

privileges

As returned by DITobj_PrincipalAuthenticator.build_auth_data. If privileges is invalid, authenticate raises CORBA::BAD_PARAM.

creds

Placed into the SecurityCurrent object.

continuation_data

Always empty.

auth_specific_data

Always empty.

exceptioninfo

An optional input argument that allows the client application to get additional exception data if an error occurs.

Description

This method authenticates the client application via the IIOP Listener/Handler so that it can access a BEA Tuxedo domain.

Return Values

A Security_AuthenticationStatus Enum value. The following table describes the valid return values.

Return Value	Meaning
`Security::AuthenticationStatus:: SecAuthSuccess`	The authentication succeeded.
`Security::AuthenticationStatus:: SecAuthFailure`	The authentication failed, or the client application was already authenticated and did not invoke `Tobj::PrincipalAuthenticator:logoff` or `Tobj_Bootstrap::destroy_current`.