Package org.bouncycastle.tls

Class TlsClientProtocol

java.lang.Object

org.bouncycastle.tls.TlsProtocol

org.bouncycastle.tls.TlsClientProtocol

All Implemented Interfaces:

TlsCloseable

public class TlsClientProtocol
extends TlsProtocol

Field Summary

Fields

Modifier and Type	Field	Description
protected TlsAuthentication	authentication
protected CertificateRequest	certificateRequest
protected CertificateStatus	certificateStatus
protected java.util.Hashtable	clientAgreements
protected TlsKeyExchange	keyExchange
protected TlsClient	tlsClient

Fields inherited from class org.bouncycastle.tls.TlsProtocol

ADS_MODE_0_N, ADS_MODE_0_N_FIRSTONLY, ADS_MODE_1_Nsub1, allowCertificateStatus, blocking, clientExtensions, connection_state, CS_CERTIFICATE_REQUEST, CS_CERTIFICATE_STATUS, CS_CERTIFICATE_VERIFY, CS_CLIENT_CERTIFICATE, CS_CLIENT_FINISHED, CS_CLIENT_HELLO, CS_CLIENT_KEY_EXCHANGE, CS_CLIENT_SUPPLEMENTAL_DATA, CS_END, CS_SERVER_CERTIFICATE, CS_SERVER_FINISHED, CS_SERVER_HELLO, CS_SERVER_HELLO_DONE, CS_SERVER_KEY_EXCHANGE, CS_SERVER_SESSION_TICKET, CS_SERVER_SUPPLEMENTAL_DATA, CS_START, expectSessionTicket, EXT_RenegotiationInfo, EXT_SessionTicket, inputBuffers, offeredCipherSuites, outputBuffer, receivedChangeCipherSpec, resumedSession, serverExtensions, sessionParameters, tlsSession

Constructor Summary

Constructors

Constructor	Description
TlsClientProtocol()	Constructor for non-blocking mode. When data is received, use TlsProtocol.offerInput(byte[]) to provide the received ciphertext, then use TlsProtocol.readInput(byte[], int, int) to read the corresponding cleartext. Similarly, when data needs to be sent, use TlsProtocol.writeApplicationData(byte[], int, int) to provide the cleartext, then use TlsProtocol.readOutput(byte[], int, int) to get the corresponding ciphertext.
TlsClientProtocol(java.io.InputStream input, java.io.OutputStream output)	Constructor for blocking mode.

Method Summary

Modifier and Type	Method	Description
protected void	beginHandshake(boolean renegotiation)
protected void	cleanupHandshake()
void	connect(TlsClient tlsClient)	Initiates a TLS handshake in the role of client. In blocking mode, this will not return until the handshake is complete.
protected TlsContext	getContext()
protected TlsPeer	getPeer()
protected void	handleHandshakeMessage(short type, java.io.ByteArrayInputStream buf)
protected void	handleServerCertificate()
protected void	handleSupplementalData(java.util.Vector serverSupplementalData)
protected void	receiveNewSessionTicketMessage(java.io.ByteArrayInputStream buf)
protected void	receiveServerHelloMessage(java.io.ByteArrayInputStream buf)
protected void	sendCertificateVerifyMessage(DigitallySigned certificateVerify)
protected void	sendClientHelloMessage()
protected void	sendClientKeyExchangeMessage()

Methods inherited from class org.bouncycastle.tls.TlsProtocol

applicationDataAvailable, applyMaxFragmentLengthExtension, assertEmpty, blockForHandshake, checkReceivedChangeCipherSpec, close, closeConnection, closeInput, completeHandshake, createRandomBlock, createRenegotiationInfo, createVerifyData, establishMasterSecret, flush, getAppDataSplitMode, getApplicationDataLimit, getAvailableInputBytes, getAvailableOutputBytes, getInputStream, getOutputStream, getPRFAlgorithm, getRenegotiationPolicy, handleAlertMessage, handleAlertWarningMessage, handleChangeCipherSpecMessage, handleClose, handleException, handleFailure, handleRenegotiation, invalidateSession, isClosed, isHandshaking, isResumableHandshake, offerInput, offerInput, previewInputRecord, previewOutputRecord, processFinishedMessage, processMaxFragmentLengthExtension, processRecord, raiseAlertFatal, raiseAlertWarning, readApplicationData, readExtensions, readExtensionsData, readInput, readOutput, readSupplementalDataMessage, refuseRenegotiation, resumeHandshake, safePreviewRecordHeader, safeReadFullRecord, safeReadRecord, safeWriteRecord, sendCertificateMessage, sendChangeCipherSpecMessage, sendFinishedMessage, sendSupplementalDataMessage, setAppDataSplitMode, setResumableHandshake, validateCredentials, writeApplicationData, writeExtensions, writeHandshakeMessage, writeSelectedExtensions, writeSupplementalData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

tlsClient

protected TlsClient tlsClient

clientAgreements

protected java.util.Hashtable clientAgreements

keyExchange

protected TlsKeyExchange keyExchange

authentication

protected TlsAuthentication authentication

certificateStatus

protected CertificateStatus certificateStatus

certificateRequest

protected CertificateRequest certificateRequest

Constructor Detail

TlsClientProtocol

public TlsClientProtocol()

Constructor for non-blocking mode.

When data is received, use TlsProtocol.offerInput(byte[]) to provide the received ciphertext, then use TlsProtocol.readInput(byte[], int, int) to read the corresponding cleartext.

Similarly, when data needs to be sent, use TlsProtocol.writeApplicationData(byte[], int, int) to provide the cleartext, then use TlsProtocol.readOutput(byte[], int, int) to get the corresponding ciphertext.

TlsClientProtocol

public TlsClientProtocol(java.io.InputStream input,
                         java.io.OutputStream output)

Constructor for blocking mode.

Parameters:

input - The stream of data from the server

output - The stream of data to the server

Method Detail

connect

public void connect(TlsClient tlsClient)
             throws java.io.IOException

Initiates a TLS handshake in the role of client.

In blocking mode, this will not return until the handshake is complete. In non-blocking mode, use TlsPeer.notifyHandshakeComplete() to receive a callback when the handshake is complete.

Parameters:

tlsClient - The TlsClient to use for the handshake.

Throws:

java.io.IOException - If in blocking mode and handshake was not successful.

beginHandshake

protected void beginHandshake(boolean renegotiation)
                       throws java.io.IOException

Overrides:

beginHandshake in class TlsProtocol

Throws:

java.io.IOException

cleanupHandshake

protected void cleanupHandshake()

Overrides:

cleanupHandshake in class TlsProtocol

getContext

protected TlsContext getContext()

Specified by:

getContext in class TlsProtocol

getPeer

protected TlsPeer getPeer()

Specified by:

getPeer in class TlsProtocol

handleHandshakeMessage

protected void handleHandshakeMessage(short type,
                                      java.io.ByteArrayInputStream buf)
                               throws java.io.IOException

Specified by:

handleHandshakeMessage in class TlsProtocol

Throws:

java.io.IOException

handleServerCertificate

protected void handleServerCertificate()
                                throws java.io.IOException

Throws:

java.io.IOException

handleSupplementalData

protected void handleSupplementalData(java.util.Vector serverSupplementalData)
                               throws java.io.IOException

Throws:

java.io.IOException

receiveNewSessionTicketMessage

protected void receiveNewSessionTicketMessage(java.io.ByteArrayInputStream buf)
                                       throws java.io.IOException

Throws:

java.io.IOException

receiveServerHelloMessage

protected void receiveServerHelloMessage(java.io.ByteArrayInputStream buf)
                                  throws java.io.IOException

Throws:

java.io.IOException

sendCertificateVerifyMessage

protected void sendCertificateVerifyMessage(DigitallySigned certificateVerify)
                                     throws java.io.IOException

Throws:

java.io.IOException

sendClientHelloMessage

protected void sendClientHelloMessage()
                               throws java.io.IOException

Throws:

java.io.IOException

sendClientKeyExchangeMessage

protected void sendClientKeyExchangeMessage()
                                     throws java.io.IOException

Throws:

java.io.IOException