Borland VisiBroker® 7.0 - Borland Technical Publications

vbsec::AuthenticationMechanismsArgumentsReturnsExceptionsArgumentsReturnsExceptionsArgumentsExceptionsThis method acquires credentials for a given target. The credentials acquired dependon the mechanism and the information it requires for authentication.This method takes the following two arguments:■■A Target object.The callback handler to be used to communicate with the user for acquiring thecredentials for this Target.The Subject containing the acquired credentials (will be null in the case where theoperation fails).nonevirtual ::vbsec::Subject* acquireCredentials (const std::string& target,::vbsec::CallbackHandler*) =0;This method acquires credentials for a given string representation of the Target. Thecredentials acquired depend on the mechanism and the information it requires forauthentication.This method takes the following two arguments:■■A string representation of the Target.The corresponding callback handlers used to communicate with user for acquiringthe credential.A subject object containing the acquired credentials (will be null in the case where theoperation fails).nonevirtual void destroyPrivateCredentials (::vbsec::Subject&) =0;This method destroys the private credentials of the specified subject.The subject for which the private credentials are to be destroyed.noneContext-related methodsArgumentsReturnsExceptionsArgumentsExceptionsArgumentsvirtual ::CORBA::OctetSeq* createInitContext (::vbsec::Subject&) =0;Returns a mechanism-specific client authentication token. The token represents theauthentication credentials for the specified target.The target subject.The authentication token for the specified target subject.Throws NoCredentialsException if no authentication credentials recognized by thismechanism exist in this Subject.virtual ::vbsec::Target* processInitContext (::vbsec::Subject&,::CORBA::OctetSeq&) =0;This method consumes the mechanism-specific client authentication token. The initialauthentication token is decoded and the method populates the given subject with thecorresponding authentication credentials.The subject to be populated with authentication credentials.nonevirtual ::CSI::GSSToken* createFinalContext (::vbsec::Subject&) =0;This method creates a final context token to return to a client.The Subject.124 VisiBroker Security Guide