Borland VisiBroker® 7.0 - Borland Technical Publications

SSL APIExceptionsCORBA::BAD_OPERATION if the object is null or the connection is not using SSL.CORBAsec::X509CertList_ptr getPeerCertificateChain(CORBA::Object_ptr peer)This method obtains the peer's certificate chain. It is usually invoked by a clientapplication to obtain information from a server, but a server can optionally requestinformation from a client.ParameterpeerDescriptionThe peer from which you obtain the negotiated cipher.ReturnsExceptionsA value representing the cipher used. (Use CipherSuiteName::toString to get a Stringrepresentation.)CORBA::BAD_OPERATION if the object is null or the connection is not using SSL.char* getPeerAddress(CORBA::Object_ptr peer)Returns a description of the socket parameters used by this connection.ParameterpeerDescriptionThe peer from which you obtain the information.ReturnsExceptionsPeer IP address in a string with the following format: xxx.xx.xx.xxCORBA::BAD_OPERATION if the object is null or the connection is not using SSL.CORBA::Boolean isPeerTrusted(CORBA::Object_ptr peer)Tests if the certificate chain of the peer is trusted—that is, if one certificate of the chainis in the trustpoint.ParameterpeerDescriptionThe peer from which you obtain the information.ReturnsExceptionsReturnstrue if the chain is trusted, false otherwise.CORBA::BAD_OPERATION if the object is null or the connection is not using SSL.trust::Trustpoints_ptr Trustpoints getTrustpointsObject()Returns a reference to the trustpoint repository. Use this API to access trustpointsobject and set trustpoints.A reference to the trustpoint repository, which should be assigned to a _var.void setPRNGSeed (const ssl::Current::PRNGseed& seed)Sets a seed for the pseudo-random number generator used by the SSL layer.ParameterseedDescriptionThe OctetSequenceseed for the PRNG.void setPKprincipal (const CORBAsec::ASN1ObjectList chain,&const CORBAsec::ASN1Object& privkey,&const char* password);Chapter 11: VisiSecure for C++ APIs 107