COM.claymoresystems.sslg
Interface SSLSocketXInt

All Known Implementing Classes:
SSLSocket

public interface SSLSocketXInt

Extended socket functions that only apply to SSL Sockets


Field Summary
static int CLIENT
           
static int SERVER
           
 
Method Summary
 java.util.Vector getCertificateChain()
          get the certificate chain presented by the peer.
 int getCipherSuite()
          get the cipherSuite that was negotiated on this socket
 SSLPolicyInt getPolicy()
          Get the policy associated with this socket
 byte[] getSessionID()
          Get the SessionID associated with this session
 int getVersion()
          Get the version of SSL negotiated.
 void renegotiate(SSLPolicyInt policy)
          Renegotiate this connection using the specified policy.
 void sendClose()
          Send our half of the SSL close_notify handshake
 void waitForClose(boolean enforceFinished)
          Wait to receive a close_notify from the other side.
 

Field Detail

CLIENT

static final int CLIENT
See Also:
Constant Field Values

SERVER

static final int SERVER
See Also:
Constant Field Values
Method Detail

getCipherSuite

int getCipherSuite()
                   throws java.io.IOException
get the cipherSuite that was negotiated on this socket

Returns:
the cipherSuite as one of the integers defined in SSLPolicyInt
Throws:
java.io.IOException

getCertificateChain

java.util.Vector getCertificateChain()
                                     throws java.io.IOException
get the certificate chain presented by the peer. This is relevant for clients and servers if Client Authentication is being used.

Returns:
the certificate chain as a Vector of Certificates, null if unavailable
Throws:
java.io.IOException

getPolicy

SSLPolicyInt getPolicy()
Get the policy associated with this socket

Returns:
the policy

getSessionID

byte[] getSessionID()
                    throws java.io.IOException
Get the SessionID associated with this session

Throws:
java.io.IOException

getVersion

int getVersion()
               throws java.io.IOException
Get the version of SSL negotiated.

Returns:
768 (0x300) for SSLv3 or 769 (0x301) for TLSv1
Throws:
java.io.IOException

renegotiate

void renegotiate(SSLPolicyInt policy)
                 throws java.io.IOException
Renegotiate this connection using the specified policy. This may be used (for instance) to renegotiate using client authentication. If renegotiation is successful, this policy becomes the current policy for this socket

Parameters:
the - policy specified
Throws:
java.io.IOException - if something goes wrong in renegotiation

sendClose

void sendClose()
               throws java.io.IOException
Send our half of the SSL close_notify handshake

Throws:
java.io.IOException - if the close_notify alert can't be sent

waitForClose

void waitForClose(boolean enforceFinished)
                  throws java.io.IOException
Wait to receive a close_notify from the other side.

Parameters:
enforceFinished - insist that no more data be present on the connection before the close_notify is received. This ensures that the application has read all the data that the peer sent
Throws:
java.io.IOException - if the close_notify couldn't be read or if enforceFinished is true and more data was present.


Copyright (c) 1999-2001 Claymore Systems, Inc., All Rights Reserved.