Package org.glassfish.grizzly.ssl

Interface SSLSupport

All Known Implementing Classes:

SSLSupportImpl

public interface SSLSupport

SSLSupport Interface for SSL-specific functions

Author:

EKR

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	SSLSupport.CipherData	Simple data class that represents the cipher being used, along with the corresponding effective key size.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	CERTIFICATE_KEY	The Request attribute key for the client certificate chain.
static java.lang.String	CIPHER_SUITE_KEY	The Request attribute key for the cipher suite.
static java.lang.String	KEY_SIZE_KEY	The Request attribute key for the key size.
static java.lang.String	SESSION_ID_KEY	The Request attribute key for the session id.

Method Summary

Modifier and Type	Method	Description
java.lang.String	getCipherSuite()	The cipher suite being used on this connection.
java.lang.Integer	getKeySize()	Get the keysize.
default java.lang.Object[]	getPeerCertificateChain()	Deprecated, for removal: This API element is subject to removal in a future version. use getPeerCertificates() instead.
default java.lang.Object[]	getPeerCertificateChain(boolean force)	Deprecated, for removal: This API element is subject to removal in a future version. use getPeerCertificates(boolean) instead.
java.security.cert.Certificate[]	getPeerCertificates()
java.security.cert.Certificate[]	getPeerCertificates(boolean force)
java.lang.String	getSessionId()	The current session Id.

Field Detail

CIPHER_SUITE_KEY

static final java.lang.String CIPHER_SUITE_KEY

The Request attribute key for the cipher suite.

See Also:

Constant Field Values

KEY_SIZE_KEY

static final java.lang.String KEY_SIZE_KEY

The Request attribute key for the key size.

See Also:

Constant Field Values

CERTIFICATE_KEY

static final java.lang.String CERTIFICATE_KEY

The Request attribute key for the client certificate chain.

See Also:

Constant Field Values

SESSION_ID_KEY

static final java.lang.String SESSION_ID_KEY

The Request attribute key for the session id. This one is a Tomcat extension to the Servlet spec.

See Also:

Constant Field Values

Method Detail

getCipherSuite

java.lang.String getCipherSuite()
                         throws java.io.IOException

The cipher suite being used on this connection.

Throws:

java.io.IOException

getPeerCertificateChain

@Deprecated(forRemoval=true)
default java.lang.Object[] getPeerCertificateChain()
                                            throws java.io.IOException

Deprecated, for removal: This API element is subject to removal in a future version.

use getPeerCertificates() instead.

Returns:

The client certificate chain (if any).

Throws:

java.io.IOException

getPeerCertificates

java.security.cert.Certificate[] getPeerCertificates()
                                              throws java.io.IOException

Returns:

The client certificate chain (if any).

Throws:

java.io.IOException

getPeerCertificateChain

@Deprecated(forRemoval=true)
default java.lang.Object[] getPeerCertificateChain(boolean force)
                                            throws java.io.IOException

Deprecated, for removal: This API element is subject to removal in a future version.

use getPeerCertificates(boolean) instead.

Parameters:

force - If true, then re-negotiate the connection if necessary.

Returns:

The client certificate chain (if any).

Throws:

java.io.IOException

getPeerCertificates

java.security.cert.Certificate[] getPeerCertificates(boolean force)
                                              throws java.io.IOException

Parameters:

force - If true, then re-negotiate the connection if necessary.

Returns:

The client certificate chain (if any).

Throws:

java.io.IOException

getKeySize

java.lang.Integer getKeySize()
                      throws java.io.IOException

Get the keysize. What we're supposed to put here is ill-defined by the Servlet spec (S 4.7 again). There are at least 4 potential values that might go here: (a) The size of the encryption key (b) The size of the MAC key (c) The size of the key-exchange key (d) The size of the signature key used by the server Unfortunately, all of these values are nonsensical.

Throws:

java.io.IOException

getSessionId

java.lang.String getSessionId()
                       throws java.io.IOException

The current session Id.

Throws:

java.io.IOException