Borland VisiBroker® 7.0 - Borland Technical Publications
Borland VisiBroker® 7.0 - Borland Technical Publications Borland VisiBroker® 7.0 - Borland Technical Publications
vbsec::LoginModulevbsec::LoginModuleLoginModule serves as the parent of all login modules. User plugin login modules mustextend this class. Login modules are configured in the authentication configuration fileand called during the login process. Login modules are responsible of authenticatingthe given subject and associating relevant Principals and Credentials with the subject.It is also responsible for removing and disposing of such security information duringlogout.Include FileThe vbauthn.h file should be included when you use this class.MethodsArgumentsReturnsReturnsReturnsReturnsReturnsvoid initialize (Subject* subj=0,CallbackHandler *handler=0,LoginModule::states* sharedStates=0,LoginModule::options* options=0)This method initializes the login module.This method utilizes the following four arguments:■■■■subj: the subject to be authenticated.handler: the callback handler to use.sharedStates: additional authentication state provided by other login modules.Currently not used.options: configuration options specified in the authentication configuration file.Void.bool login()Performs the login. This is called during the login process. The login module shallauthenticate the subject located in the module and determine if the login is successful.true if the login succeeds, false otherwise.bool logout()Performs the logout. This is called during the logout process. The login module shalllogout the subject located in the module and determine if the logout is successful. Thelogin module might remove any credentials or identities that were established duringlogin and dispose of them.true if the logout succeeds, false otherwise.bool commit()Commits the login. This is part of the login process, called when the login succeedsaccording to the configuration options specified in the pertinent login modules. Thelogin module then associates relevant Principals and Credentials with the Subjectlocated in the module if its own authentication attempt succeeded. Or if not, it shallremove and destroy any state was saved before.true if the commit succeeds, false otherwise.bool abort()Aborts the login. This is part of the login process, called when the overall login failsaccording to the configuration options specified in the login modules. The login moduleshall remove and destroy any state was saved before.true if the abort succeeds, false otherwise.120 VisiBroker Security Guide
vbsec::CallbackHandlervbsec::CallbackHandlerCallbackHandler is the mechanism that produces any necessary user callbacks forauthentication credentials and other information. Seven types of callbacks areprovided. There is a default handler that handles all callbacks in interactive text mode.Include fileThe vbauthn.h file should be included when you use this class.MethodsArgumentsReturnsvoid handle (Callback::array& callbacks)Handle the callbacks.the array of callbacks to be processed.Void.vbsec::IdentityAdapterIdentityAdapter binds to a particular mechanism. The main purpose of anIdentityAdapter is to interpret identities specific to a mechanism. It is used to performthe decoding and encoding between mechanism-specific and mechanism-independentrepresentations of the entities.IdentityAdapters included with the VisiSecureThe following IdentityAdapters are provided with the VisiSecure:■■■■AnonymousAdapter, with the name "anonymous"DNAdapter, with the name "DN"X509CertificateAdapter (as an implementation of the sub-interfaceAuthenticationMechanism)GSSUPAuthenticationMechanism (as an implementation of the sub-interfaceAuthenticationMechanism)MethodsArgumentsExceptionsReturnsVirtual void initialize (const std::string& name, ::vbsec::InitOptions&) =0;This method initializes the IdentityAdapter with the given name and set of options.This method takes the following two arguments:■■The IdentityAdapter name.A set of InitOptions for the specified IdentityAdapter.Throws InitializationException if initialization fails.virtual std::string getName() const=0;This returns the name of the IdentityAdapter.The name of the IdentityAdapter.Chapter 12: Security SPI for C++ 121
- Page 75 and 76: Examining SSL related informationEx
- Page 77 and 78: Chapter7Making Secure Connections (
- Page 79 and 80: Steps to secure clients and servers
- Page 81 and 82: Creating Custom PluginsLoginModules
- Page 83 and 84: ChapterChapter8Security for the Web
- Page 85 and 86: Security for the Apache web serverC
- Page 87 and 88: Enabling certificate passthrough to
- Page 89 and 90: Security for the Borland web contai
- Page 91 and 92: Three-tier authorization schemeNote
- Page 93 and 94: Chapter9Security Properties for Jav
- Page 95 and 96: Security Properties for JavaPropert
- Page 97 and 98: Chapter10Security Properties for C+
- Page 99 and 100: Security Properties for C++Property
- Page 101 and 102: Chapter11VisiSecure for C++ APIsCha
- Page 103 and 104: General APIUse this to login to the
- Page 105 and 106: General APISets the cipher suites t
- Page 107 and 108: General APIReturnsA set of the publ
- Page 109 and 110: SSL APISSL APIThis section explains
- Page 111 and 112: SSL APIclass CipherSuiteNameThis cl
- Page 113 and 114: SSL APIExceptionsCORBA::BAD_OPERATI
- Page 115 and 116: Certificate APICertificate APIThis
- Page 117 and 118: Certificate APIclass CORBAsec::X509
- Page 119 and 120: QoP APIQoP APIThe following section
- Page 121 and 122: Authorization APIAuthorization APIT
- Page 123 and 124: ChapterChapter12Security SPIfor C++
- Page 125: ProvidersProvidersTable 12.1Each pr
- Page 129 and 130: vbsec::AuthenticationMechanismsMeth
- Page 131 and 132: vbsec::TargetReturnsExceptionsArgum
- Page 133 and 134: vbsec::Resourcevbsec::ResourceThe R
- Page 135 and 136: vbsec::AttributeCodecFor the provid
- Page 137 and 138: vbsec::PermissionCollectionvbsec::P
- Page 139 and 140: vbsec::InitOptionsvbsec::InitOption
- Page 141 and 142: IndexSymbols... ellipsis 4.defaultA
- Page 143 and 144: Iidentitiessetting up 36setting up
- Page 145 and 146: security (C++)AttributeCodec 119, 1
- Page 147 and 148: VisiSecure APIs (C++) 95VisiSecure
vbsec::CallbackHandlervbsec::CallbackHandlerCallbackHandler is the mechanism that produces any necessary user callbacks forauthentication credentials and other information. Seven types of callbacks areprovided. There is a default handler that handles all callbacks in interactive text mode.Include fileThe vbauthn.h file should be included when you use this class.MethodsArgumentsReturnsvoid handle (Callback::array& callbacks)Handle the callbacks.the array of callbacks to be processed.Void.vbsec::IdentityAdapterIdentityAdapter binds to a particular mechanism. The main purpose of anIdentityAdapter is to interpret identities specific to a mechanism. It is used to performthe decoding and encoding between mechanism-specific and mechanism-independentrepresentations of the entities.IdentityAdapters included with the VisiSecureThe following IdentityAdapters are provided with the VisiSecure:■■■■AnonymousAdapter, with the name "anonymous"DNAdapter, with the name "DN"X509CertificateAdapter (as an implementation of the sub-interfaceAuthenticationMechanism)GSSUPAuthenticationMechanism (as an implementation of the sub-interfaceAuthenticationMechanism)MethodsArgumentsExceptionsReturnsVirtual void initialize (const std::string& name, ::vbsec::InitOptions&) =0;This method initializes the IdentityAdapter with the given name and set of options.This method takes the following two arguments:■■The IdentityAdapter name.A set of InitOptions for the specified IdentityAdapter.Throws InitializationException if initialization fails.virtual std::string getName() const=0;This returns the name of the IdentityAdapter.The name of the IdentityAdapter.Chapter 12: Security SPI for C++ 121