- Author:
- David M. Lloyd
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final byte[]
A zero-length byte array, useful for sending and receiving empty SASL messages. -
Method Summary
Modifier and TypeMethodDescriptioncreatePropertyMap
(OptionMap optionMap, boolean secure) Create a SASL property map from an XNIO option map.static byte[]
evaluateChallenge
(SaslClient client, ByteBuffer source) Evaluate a sasl challenge.static boolean
evaluateChallenge
(SaslClient client, ByteBuffer destination, ByteBuffer source) Evaluate a sasl challenge.static byte[]
evaluateResponse
(SaslServer server, ByteBuffer source) Evaluate a sasl response.static boolean
evaluateResponse
(SaslServer server, ByteBuffer destination, ByteBuffer source) Evaluate a sasl response.static Iterator<SaslClientFactory>
Returns an iterator of all of the registeredSaslClientFactory
s where the order is based on the order of the Provider registration and/or class path order.static Iterator<SaslClientFactory>
getSaslClientFactories
(ClassLoader classLoader, boolean includeGlobal) Returns an iterator of all of the registeredSaslClientFactory
s where the order is based on the order of the Provider registration and/or class path order.static Iterator<SaslServerFactory>
Returns an iterator of all of the registeredSaslServerFactory
s where the order is based on the order of the Provider registration and/or class path order.static Iterator<SaslServerFactory>
getSaslServerFactories
(ClassLoader classLoader, boolean includeGlobal) Returns an iterator of all of the registeredSaslServerFactory
s where the order is based on the order of the Provider registration and/or class path order.static byte[]
unwrap
(SaslClient client, ByteBuffer source) Unwrap a message.static void
unwrap
(SaslClient client, ByteBuffer destination, ByteBuffer source) Unwrap a message.static byte[]
unwrap
(SaslServer server, ByteBuffer source) Unwrap a message.static void
unwrap
(SaslServer server, ByteBuffer destination, ByteBuffer source) Unwrap a message.static byte[]
wrap
(SaslClient client, ByteBuffer source) Wrap a message.static void
wrap
(SaslClient client, ByteBuffer destination, ByteBuffer source) Wrap a message.static byte[]
wrap
(SaslServer server, ByteBuffer source) Wrap a message.static void
wrap
(SaslServer server, ByteBuffer destination, ByteBuffer source) Wrap a message.
-
Field Details
-
EMPTY_BYTES
public static final byte[] EMPTY_BYTESA zero-length byte array, useful for sending and receiving empty SASL messages.
-
-
Method Details
-
getSaslServerFactories
public static Iterator<SaslServerFactory> getSaslServerFactories(ClassLoader classLoader, boolean includeGlobal) Returns an iterator of all of the registeredSaslServerFactory
s where the order is based on the order of the Provider registration and/or class path order. Class path providers are listed before global providers; in the event of a name conflict, the class path provider is preferred.- Parameters:
classLoader
- the class loader to useincludeGlobal
-true
to include globally registered providers,false
to exclude them- Returns:
- the
Iterator
ofSaslServerFactory
s
-
getSaslServerFactories
Returns an iterator of all of the registeredSaslServerFactory
s where the order is based on the order of the Provider registration and/or class path order.- Returns:
- the
Iterator
ofSaslServerFactory
s
-
getSaslClientFactories
public static Iterator<SaslClientFactory> getSaslClientFactories(ClassLoader classLoader, boolean includeGlobal) Returns an iterator of all of the registeredSaslClientFactory
s where the order is based on the order of the Provider registration and/or class path order. Class path providers are listed before global providers; in the event of a name conflict, the class path provider is preferred.- Parameters:
classLoader
- the class loader to useincludeGlobal
-true
to include globally registered providers,false
to exclude them- Returns:
- the
Iterator
ofSaslClientFactory
s
-
getSaslClientFactories
Returns an iterator of all of the registeredSaslClientFactory
s where the order is based on the order of the Provider registration and/or class path order.- Returns:
- the
Iterator
ofSaslClientFactory
s
-
evaluateChallenge
public static boolean evaluateChallenge(SaslClient client, ByteBuffer destination, ByteBuffer source) throws SaslException Evaluate a sasl challenge. If the result isfalse
then the negotiation is not yet complete and the data written into the destination buffer needs to be sent to the server as a response. If the result istrue
then negotiation was successful and no response needs to be sent to the server.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message. The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
client
- the SASL client to use to evaluate the challenge messagedestination
- the destination buffer into which the response message should be written, if anysource
- the source buffer from which the challenge message should be read- Returns:
true
if negotiation is complete and successful,false
otherwise- Throws:
SaslException
- if negotiation failed or another error occurred
-
evaluateChallenge
Evaluate a sasl challenge. If the result is non-null
then the negotiation is not yet complete and the data returned needs to be sent to the server as a response. If the result isnull
then negotiation was successful and no response needs to be sent to the server.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message. The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
client
- the SASL client to use to evaluate the challenge messagesource
- the source buffer from which the challenge message should be read- Returns:
null
if negotiation is complete and successful, or the response otherwise- Throws:
SaslException
- if negotiation failed or another error occurred
-
evaluateResponse
public static boolean evaluateResponse(SaslServer server, ByteBuffer destination, ByteBuffer source) throws SaslException Evaluate a sasl response. If the result isfalse
then the negotiation is not yet complete and the data written into the destination buffer needs to be sent to the server as a response. If the result istrue
then negotiation was successful and no response needs to be sent to the client (other than a successful completion message, depending on the protocol).The
source
buffer should have its position and remaining length set to encompass exactly one SASL message. The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
server
- the SASL server to use to evaluate the response messagedestination
- the destination buffer into which the response message should be written, if anysource
- the source buffer from which the response message should be read- Returns:
true
if negotiation is complete and successful,false
otherwise- Throws:
SaslException
- if negotiation failed or another error occurred
-
evaluateResponse
Evaluate a sasl response. If the result is non-null
then the negotiation is not yet complete and the data returned needs to be sent to the server as a response. If the result isnull
then negotiation was successful and no response needs to be sent to the client (other than a successful completion message, depending on the protocol).The
source
buffer should have its position and remaining length set to encompass exactly one SASL message. The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
server
- the SASL server to use to evaluate the response messagesource
- the source buffer from which the response message should be read- Returns:
true
if negotiation is complete and successful,false
otherwise- Throws:
SaslException
- if negotiation failed or another error occurred
-
wrap
public static void wrap(SaslClient client, ByteBuffer destination, ByteBuffer source) throws SaslException Wrap a message. Wrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
client
- the SASL client to wrap withdestination
- the buffer into which bytes should be writtensource
- the buffers from which bytes should be read- Throws:
SaslException
- if a SASL error occurs- See Also:
-
wrap
Wrap a message. Wrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
client
- the SASL client to wrap withsource
- the buffers from which bytes should be read- Returns:
- the wrap result
- Throws:
SaslException
- if a SASL error occurs- See Also:
-
wrap
public static void wrap(SaslServer server, ByteBuffer destination, ByteBuffer source) throws SaslException Wrap a message. Wrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
server
- the SASL server to wrap withdestination
- the buffer into which bytes should be writtensource
- the buffers from which bytes should be read- Throws:
SaslException
- if a SASL error occurs- See Also:
-
wrap
Wrap a message. Wrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
server
- the SASL server to wrap withsource
- the buffers from which bytes should be read- Returns:
- the wrap result
- Throws:
SaslException
- if a SASL error occurs- See Also:
-
unwrap
public static void unwrap(SaslClient client, ByteBuffer destination, ByteBuffer source) throws SaslException Unwrap a message. Unwrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
client
- the SASL client to unwrap withdestination
- the buffer into which bytes should be writtensource
- the buffers from which bytes should be read- Throws:
SaslException
- if a SASL error occurs- See Also:
-
unwrap
Unwrap a message. Unwrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
client
- the SASL client to unwrap withsource
- the buffers from which bytes should be read- Returns:
- the wrap result
- Throws:
SaslException
- if a SASL error occurs- See Also:
-
unwrap
public static void unwrap(SaslServer server, ByteBuffer destination, ByteBuffer source) throws SaslException Unwrap a message. Unwrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
server
- the SASL server to unwrap withdestination
- the buffer into which bytes should be writtensource
- the buffers from which bytes should be read- Throws:
SaslException
- if a SASL error occurs- See Also:
-
unwrap
Unwrap a message. Unwrapping occurs from the source buffer to the destination idea.The
source
buffer should have its position and remaining length set to encompass exactly one SASL message (without the length field). The SASL message itself does not encode any length information so it is up to the protocol implementer to ensure that the message is properly framed.- Parameters:
server
- the SASL server to unwrap withsource
- the buffers from which bytes should be read- Returns:
- the wrap result
- Throws:
SaslException
- if a SASL error occurs- See Also:
-
createPropertyMap
Create a SASL property map from an XNIO option map.- Parameters:
optionMap
- the option mapsecure
-true
if the channel is secure,false
otherwise- Returns:
- the property map
-