org.apache.qpid.proton.engine
Interface Sasl


public interface Sasl


Nested Class Summary
static class Sasl.SaslOutcome
           
static class Sasl.SaslState
           
 
Field Summary
static Sasl.SaslOutcome PN_SASL_AUTH
           
static Sasl.SaslOutcome PN_SASL_NONE
           
static Sasl.SaslOutcome PN_SASL_OK
           
static Sasl.SaslOutcome PN_SASL_PERM
           
static Sasl.SaslOutcome PN_SASL_SYS
           
static Sasl.SaslOutcome PN_SASL_TEMP
           
 
Method Summary
 void client()
           
 void done(Sasl.SaslOutcome outcome)
          Set the outcome of SASL negotiation Used by the server to set the result of the negotiation process.
 Sasl.SaslOutcome getOutcome()
          Retrieve the outcome of SASL negotiation.
 java.lang.String[] getRemoteMechanisms()
          Retrieve the list of SASL mechanisms provided by the remote.
 Sasl.SaslState getState()
          Access the current state of the layer.
 int pending()
          Determine the size of the bytes available via recv().
 void plain(java.lang.String username, java.lang.String password)
          Configure the SASL layer to use the "PLAIN" mechanism.
 int recv(byte[] bytes, int offset, int size)
          Read challenge/response data sent from the peer.
 int send(byte[] bytes, int offset, int size)
          Send challenge or response data to the peer.
 void server()
           
 void setMechanisms(java.lang.String... mechanisms)
          Set the acceptable SASL mechanisms for the layer.
 

Field Detail

PN_SASL_NONE

static final Sasl.SaslOutcome PN_SASL_NONE

PN_SASL_OK

static final Sasl.SaslOutcome PN_SASL_OK

PN_SASL_AUTH

static final Sasl.SaslOutcome PN_SASL_AUTH

PN_SASL_SYS

static final Sasl.SaslOutcome PN_SASL_SYS

PN_SASL_PERM

static final Sasl.SaslOutcome PN_SASL_PERM

PN_SASL_TEMP

static final Sasl.SaslOutcome PN_SASL_TEMP
Method Detail

getState

Sasl.SaslState getState()
Access the current state of the layer.

Returns:
The state of the sasl layer.

setMechanisms

void setMechanisms(java.lang.String... mechanisms)
Set the acceptable SASL mechanisms for the layer.

Parameters:
mechanisms - a list of acceptable SASL mechanisms

getRemoteMechanisms

java.lang.String[] getRemoteMechanisms()
Retrieve the list of SASL mechanisms provided by the remote.

Returns:
the SASL mechanisms advertised by the remote

pending

int pending()
Determine the size of the bytes available via recv(). Returns the size in bytes available via recv().

Returns:
The number of bytes available, zero if no available data.

recv

int recv(byte[] bytes,
         int offset,
         int size)
Read challenge/response data sent from the peer. Use pending to determine the size of the data.

Parameters:
bytes - written with up to size bytes of inbound data.
offset - the offset in the array to begin writing at
size - maximum number of bytes that bytes can accept.
Returns:
The number of bytes written to bytes, or an error code if < 0.

send

int send(byte[] bytes,
         int offset,
         int size)
Send challenge or response data to the peer.

Parameters:
bytes - The challenge/response data.
offset - the point within the array at which the data starts at
size - The number of data octets in bytes.
Returns:
The number of octets read from bytes, or an error code if < 0

done

void done(Sasl.SaslOutcome outcome)
Set the outcome of SASL negotiation Used by the server to set the result of the negotiation process.


plain

void plain(java.lang.String username,
           java.lang.String password)
Configure the SASL layer to use the "PLAIN" mechanism. A utility function to configure a simple client SASL layer using PLAIN authentication.

Parameters:
username - credential for the PLAIN authentication mechanism
password - credential for the PLAIN authentication mechanism

getOutcome

Sasl.SaslOutcome getOutcome()
Retrieve the outcome of SASL negotiation.


client

void client()

server

void server()