Borland VisiBroker® 7.0 - Borland Technical Publications

SSL APISets a seed for the pseudo-random number generator used by the SSL layer.ParameterseedDescriptionThe seed for the PRNG.ReturnsReturnsconst ssl::CipherSuiteInfoList& listAvailableCipherSuites() constGets the list of cipher suites that are available for use with the SSL layer. Note that thisis different from the getEnabledCipherSuites call in that not all the available cipher suitesmay be currently enabled.List of cipher suits that are available but may not be enabled for use with the SSL layer.const CertificateFactory& getCertificateFactory() constGets a certificate Factory.A CertificateFactory object.class ssl::CurrentThe ssl::Current lets your client application or server object set its private key andoffer its certificate information to its peer. This interface also lets you configure the SSLconnection and associate your certificates and private key with an SSL connection.Be aware that private keys and certificates contain header and trailer lines, which markthe beginning and end of the key or certificate. All of the methods offered by thisinterface for setting private keys and certificate chains require that these header andtrailer lines be present. The parsing rules for these lines is:■■■The recognized header line format for certificates is:-----BEGIN CERTIFICATE-----The recognized header line format for private keys is:-----BEGIN ENCRYPTED PRIVATE KEY-----All header lines must end with a new line character.■All trailer lines must be preceded with, and end with, a newline character. PEM-styleprivate keys have two additional header lines that other private keys do not have:Proc-Type and DEK-Info. Both of these lines must be present and they must endwith new line characters.This object can be obtained through the following code:CORBA::Object_var obj = orb->resolve_initial_references("SSLCurrent");ssl::Current_var current = ssl::Current::_narrow(obj);Include FileThe ssl_c.hh file should be included when you use this class.MethodsCORBA::ULong getNegotiatedCipher(CORBA::Object_ptr peer)This method returns the negotiated cipher from the peer for a given SSL connection.ParameterpeerDescriptionThe peer from which you obtain the negotiated cipher.ReturnsA value (tag) representing the cipher used. (Use CipherSuiteName::toString to get aString representation.)106 VisiBroker Security Guide