org.bouncycastle.crypto.tls

Interface TlsServer

All Superinterfaces:

TlsPeer

All Known Implementing Classes:

AbstractTlsServer, DefaultTlsServer, PSKTlsServer, SRPTlsServer

public interface TlsServer
extends TlsPeer

Interface describing a TLS server endpoint.

Method Summary

Modifier and Type	Method and Description
CertificateRequest	getCertificateRequest()
CertificateStatus	getCertificateStatus() This method will be called (only) if the server included an extension of type "status_request" with empty "extension_data" in the extended server hello.
TlsCredentials	getCredentials()
TlsKeyExchange	getKeyExchange()
NewSessionTicket	getNewSessionTicket() RFC 5077 3.3.
int	getSelectedCipherSuite()
short	getSelectedCompressionMethod()
Hashtable	getServerExtensions()
Vector	getServerSupplementalData()
ProtocolVersion	getServerVersion()
void	init(TlsServerContext context)
void	notifyClientCertificate(Certificate clientCertificate) Called by the protocol handler to report the client certificate, only if getCertificateRequest() returned non-null.
void	notifyClientVersion(ProtocolVersion clientVersion)
void	notifyFallback(boolean isFallback)
void	notifyOfferedCipherSuites(int[] offeredCipherSuites)
void	notifyOfferedCompressionMethods(short[] offeredCompressionMethods)
void	processClientExtensions(Hashtable clientExtensions)
void	processClientSupplementalData(Vector clientSupplementalData)

Methods inherited from interface org.bouncycastle.crypto.tls.TlsPeer

getCipher, getCompression, notifyAlertRaised, notifyAlertReceived, notifyHandshakeComplete, notifySecureRenegotiation, requiresExtendedMasterSecret, shouldUseGMTUnixTime

Method Detail

init

void init(TlsServerContext context)

notifyClientVersion

void notifyClientVersion(ProtocolVersion clientVersion)
                  throws IOException

Throws:

IOException

notifyFallback

void notifyFallback(boolean isFallback)
             throws IOException

Throws:

IOException

notifyOfferedCipherSuites

void notifyOfferedCipherSuites(int[] offeredCipherSuites)
                        throws IOException

Throws:

IOException

notifyOfferedCompressionMethods

void notifyOfferedCompressionMethods(short[] offeredCompressionMethods)
                              throws IOException

Throws:

IOException

processClientExtensions

void processClientExtensions(Hashtable clientExtensions)
                      throws IOException

Throws:

IOException

getServerVersion

ProtocolVersion getServerVersion()
                          throws IOException

Throws:

IOException

getSelectedCipherSuite

int getSelectedCipherSuite()
                    throws IOException

Throws:

IOException

getSelectedCompressionMethod

short getSelectedCompressionMethod()
                            throws IOException

Throws:

IOException

getServerExtensions

Hashtable getServerExtensions()
                       throws IOException

Throws:

IOException

getServerSupplementalData

Vector getServerSupplementalData()
                          throws IOException

Throws:

IOException

getCredentials

TlsCredentials getCredentials()
                       throws IOException

Throws:

IOException

getCertificateStatus

CertificateStatus getCertificateStatus()
                                throws IOException

This method will be called (only) if the server included an extension of type "status_request" with empty "extension_data" in the extended server hello. See RFC 3546 3.6. Certificate Status Request. If a non-null CertificateStatus is returned, it is sent to the client as a handshake message of type "certificate_status".

Returns:

A CertificateStatus to be sent to the client (or null for none).

Throws:

IOException

getKeyExchange

TlsKeyExchange getKeyExchange()
                       throws IOException

Throws:

IOException

getCertificateRequest

CertificateRequest getCertificateRequest()
                                  throws IOException

Throws:

IOException

processClientSupplementalData

void processClientSupplementalData(Vector clientSupplementalData)
                            throws IOException

Throws:

IOException

notifyClientCertificate

void notifyClientCertificate(Certificate clientCertificate)
                      throws IOException

Called by the protocol handler to report the client certificate, only if getCertificateRequest() returned non-null. Note: this method is responsible for certificate verification and validation.

Parameters:

clientCertificate - the effective client certificate (may be an empty chain).

Throws:

IOException

getNewSessionTicket

NewSessionTicket getNewSessionTicket()
                              throws IOException

RFC 5077 3.3. NewSessionTicket Handshake Message.

This method will be called (only) if a NewSessionTicket extension was sent by the server. See RFC 5077 4. Recommended Ticket Construction for recommended format and protection.

Returns:

The ticket.

Throws:

IOException