Borland VisiBroker® 7.0 - Borland Technical Publications

More documents

Recommendations

Info

General APIAssert a subject as caller identity.ParametercallerDescriptionThe caller name of the subject.ReturnsReturnsvoid clearAssertion ()Clear an assertion made by any previous API call of asserting. The caller before theassertion is made will be restored as the caller for next invocation. This API shall beused in conjunction with asserting. Mismatching calls of these two methods may causeundesired caller identities or unexpected exceptions.const vbsec::Subject* getPeerSubject ()Accesses the peer subject.The pointer to a Subject object representing the peer.const vbsec::Subject* getCallerSubject ()Accesses the caller subject.The pointer to a Subject object representing the caller.const vbsec::SSLSession* getPeerSession (CORBA::Object* peer)Get the peer SSLSession. This call returns the SSLSession of the client peer for thisrequest. This method cannot be called outside the context of a request.ParameterpeerDescriptionA peer object retrieved from the bind.ReturnsExceptionsThe pointer to a SSLSession currently established.BAD_OPERATION is thrown if this method is called outside the context of a request or whencalled in a request context where the request was received over a clear TCPconnection.class vbsec::ContextContext represents the security context under which a client will execute. This class canbe obtained through the following code:CORBA::Object_var obj = orb->resolve_initial_references("VBSecurityContext");Context* c = dynamic_cast(obj.in());Include FileThe vbsec.h file should be included when you use this class.Methodsvoid login()Login into the system. This logs-in to the realms defined in the propertyvbroker.security.loginRealms. It traverses the list of realms specified and authenticatesagainst each realm.void login (vbsec::CallbackHandler& handler)96 VisiBroker Security Guide
General APIUse this to login to the system using the specified CallbackHandler to obtain the logininformation.ParameterhandlerDescriptionThe default callback handler to be use for acquiring information.void login (const std::string& realm)Login into the system for a specific realm.ParameterrealmDescriptionThe realm to login to.void login (const std::string& realm, vbsec::CallbackHandler& handler)Login into the system for a given realm, using a given callback handler for acquiringinformation.ParameterrealmhandlerDescriptionThe realm to login to.The default callback handler to be use for acquiring information.void login (const vbsec::Wallet& wallet)Login into the system with a wallet. Wallet can be created using WalletFactory API.ParameterwalletDescriptionThe wallet to be used for login.void login (const std::vector& wallet)Login into the system with a set of wallets specified as a vector.ParameterwalletDescriptionA wallet to be used for loginconst vbsec::Subject* getSubject (const std::string& realm)Gets the Subject corresponding to a given realm.ParameterrealmDescriptionThe Realm for the PrincipalReturnsA pointer to the Subject object representing the subject of the realm.void loadVault (std::istream& stream, const CSI::UTF8String& vaultPass)Loads a given vault. The identities in the vault are loaded into the system. No loginrequired when this method is used.ParameterstreamvaultPassDescriptionStream that the vault information will be read from, in binary format.Password used to decrypt the vault information.void logout()Log the user out from all the realms.void logout (const std::string& realm)Chapter 11: VisiSecure for C++ APIs 97
Page 1 and 2:
Security GuideBorlandVisiBroker ®
Page 3 and 4:
ContentsChapter 1Introduction to Bo
Page 5 and 6:
Security for the Borland web contai
Page 7 and 8:
Chapter1Introduction to Borland Vis
Page 9 and 10:
VisiBroker DocumentationImportant
Page 11 and 12:
Contacting Borland support■■■
Page 13 and 14:
Chapter2Getting Started with Securi
Page 15 and 16:
Basic security model■■■■Web
Page 17 and 18:
Distributed environments and VisiSe
Page 19 and 20:
Authentication and IdentificationAu
Page 21 and 22:
Authentication and IdentificationDi
Page 23 and 24:
Secure TransportationSecure Transpo
Page 25 and 26:
Context PropagationContext Propagat
Page 27 and 28:
Context PropagationTrusting Asserti
Page 29 and 30:
Using IIOP/HTTPSHere are several ex
Page 31 and 32:
ChapterChapter 3AuthenticationJAAS
Page 33 and 34:
Authentication mechanisms and Login
Page 35 and 36:
LoginContext class and LoginModule
Page 37 and 38:
Associating a LoginModule with a re
Page 39 and 40:
Borland LoginModulesThe elements in
Page 41 and 42:
Borland LoginModulesLDAP LoginModul
Page 43 and 44:
Server and Client IdentificationIn
Page 45 and 46:
Server and Client IdentificationCre
Page 47 and 48:
Server and Client IdentificationCli
Page 49 and 50:
ChapterChapter4AuthorizationAuthori
Page 51 and 52: Defining access control with Role D
Page 53 and 54: Authorization domainsTo accomplish
Page 55 and 56: CORBA authorizationwhere is a taut
Page 57 and 58: Chapter5Configuring Security Profil
Page 59 and 60: Security ProfilesEnabling SecurityF
Page 61 and 62: Security ProfilesConfiguring Authen
Page 63 and 64: Security ProfilesTo access the Auth
Page 65 and 66: Security ProfilesWorking with Autho
Page 67 and 68: Security ProfilesAdding and Removin
Page 69 and 70: Associating a Profile with a Domain
Page 71 and 72: Chapter6Making Secure Connections (
Page 73 and 74: Steps to secure clients and servers
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: Chapter11VisiSecure for C++ APIsCha
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 and 126: ProvidersProvidersTable 12.1Each pr
Page 127 and 128: vbsec::CallbackHandlervbsec::Callba
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
show all

Borland VisiBroker® 7.0 - Borland Technical Publications

Create successful ePaper yourself

Delete template?

Save as template?