Borland VisiBroker® 7.0 - Borland Technical Publications

vbsec::IdentityAdapterExceptionsArgumentsReturnsExceptionsArgumentsExceptionsArgumentsReturnsExceptionsArgumentsReturnsExceptionsArgumentsExceptionsArgumentsExceptionsnonevirtual ::CSI::IdentityToken* exportIdentity(::vbsec::Subject&,::CSI::IdentityToken&) =0;Exports the identity of the IdentityAdapter as an IdentityToken.The subject whose identity is to be exported.An IdentityToken data.Throws NoCredentialsException if no credentials recognized by this IdentityAdapterare found in the subject.virtual void importIdentity (::vbsec::Subject&, ::CSI::IdentityToken&) =0;Imports the IdentityToken and populates the caller subject with the appropriateprincipals associated with this identity.The subject whose identity is to be imported.Throws NoCredentialsException if no credentials recognized by this IdentityAdapterare found in the subject.virtual ::vbsec::Privileges* getPrincipal (::vbsec::Subject&anp;) =0;Returns a Principal representing this identity. This method is used for interfacing withEJBs and servlets.The principal subject.A principle object.nonevirtual ::vbsec::Privileges* getPrivileges (::vbsec::Subect&) =0;The target subject.The privilege attributes for this target subject recognized by this IdentityAdapter.nonevirtual ::vbsec::setPrivileges (::vbsec::Privileges*) =0;This methods sets the privilege attribute for the identity.The privilege attribute to be set for the identity.nonevirtual void deleteIdentity (::vbsec::Subject&) =0;This method deletes the principals and the credentials associated with the specifiedtarget subject.The target subject for which the principals and the credentials recognized by thisIdentityAdapter are to be deleted.nonevbsec::MechanismAdapterExtending from IdentityAdapter, a MechanismAdapter has the additional capability ofchanging the target information. This is very useful in the case where the mechanismused in a remote site is not available locally. Therefore, the local identity must beadapted before sending to the remote site.In the out-of-box installation of VisiSecure, there is no class direct implementation ofMechanismAdapter, while a few classes implement the sub-interfaceAuthenticationMechanism, which in turn gives the support of this interface.122 VisiBroker Security Guide