SSLSession

public interface SSLSession

In SSL, sessions are used to describe an ongoing relationship between two entities. Each SSL connection involves one session at a time, but that session may be used on many connections between those entities, simultaneously or sequentially. The session used on a connection may also be replaced by a different session. Sessions are created, or rejoined, as part of the SSL handshaking protocol. Sessions may be invalidated due to policies affecting security or resource usage, or by an application explicitly calling invalidate. Session management policies are typically used to tune performance.

In addition to the standard session attributes, SSL sessions expose these read-only attributes:

  • Peer Identity. Sessions are between a particular client and a particular server. The identity of the peer may have been established as part of session setup. Peers are generally identified by X.509 certificate chains.
  • Cipher Suite Name. Cipher suites describe the kind of cryptographic protection that's used by connections in a particular session.
  • Peer Host. All connections in a session are between the same two hosts. The address of the host on the other side of the connection is available.

Sessions may be explicitly invalidated. Invalidation may also be done implicitly, when faced with certain kinds of errors.

Public Method Summary

abstract int
getApplicationBufferSize()
Gets the current size of the largest application data that is expected when using this session.
abstract String
getCipherSuite()
Returns the name of the SSL cipher suite which is used for all connections in the session.
abstract long
getCreationTime()
Returns the time at which this Session representation was created, in milliseconds since midnight, January 1, 1970 UTC.
abstract byte[]
getId()
Returns the identifier assigned to this Session.
abstract long
getLastAccessedTime()
Returns the last time this Session representation was accessed by the session level infrastructure, in milliseconds since midnight, January 1, 1970 UTC.
abstract Certificate[]
getLocalCertificates()
Returns the certificate(s) that were sent to the peer during handshaking.
abstract Principal
getLocalPrincipal()
Returns the principal that was sent to the peer during handshaking.
abstract int
getPacketBufferSize()
Gets the current size of the largest SSL/TLS packet that is expected when using this session.
abstract