Package com.ongres.scram.client

Class ScramSession

java.lang.Object

com.ongres.scram.client.ScramSession

public class ScramSession
extends Object

A class that represents a SCRAM client. Use this class to perform a SCRAM negotiation with a SCRAM server. This class performs an authentication execution for a given user, and has state related to it. Thus, it cannot be shared across users or authentication executions.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	ScramSession.ClientFinalProcessor	Processor that allows to generate the client-final-message, as well as process the server-final-message and verify server's signature.
class	ScramSession.ServerFirstProcessor	Process a received server-first-message.

Constructor Summary

Constructors

Constructor	Description
ScramSession(com.ongres.scram.common.ScramMechanism scramMechanism, com.ongres.scram.common.stringprep.StringPreparation stringPreparation, String user, String nonce)	Constructs a SCRAM client, to perform an authentication for a given user.

Method Summary

Modifier and Type	Method	Description
String	clientFirstMessage()	Returns the text representation of a SCRAM client-first-message, with no channel binding nor authzid.
String	clientFirstMessage(com.ongres.scram.common.gssapi.Gs2CbindFlag gs2CbindFlag, String cbindName, String authzid)	Returns the text representation of a SCRAM client-first-message, with the GSS-API header values indicated.
ScramSession.ServerFirstProcessor	receiveServerFirstMessage(String serverFirstMessage)	Constructs a handler for the server-first-message, from its String representation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ScramSession

public ScramSession(com.ongres.scram.common.ScramMechanism scramMechanism,
                    com.ongres.scram.common.stringprep.StringPreparation stringPreparation,
                    String user,
                    String nonce)

Constructs a SCRAM client, to perform an authentication for a given user. This class can be instantiated directly, but it is recommended that a ScramClient is used instead.

Parameters:

scramMechanism - The SCRAM mechanism that will be using this client

stringPreparation -

user -

nonce -

Method Detail

clientFirstMessage

public String clientFirstMessage(com.ongres.scram.common.gssapi.Gs2CbindFlag gs2CbindFlag,
                                 String cbindName,
                                 String authzid)

Returns the text representation of a SCRAM client-first-message, with the GSS-API header values indicated.

Parameters:

gs2CbindFlag - The channel binding flag

cbindName - The channel binding algorithm name, if channel binding is supported, or null

authzid - The optional

Returns:

The message

clientFirstMessage

public String clientFirstMessage()

Returns the text representation of a SCRAM client-first-message, with no channel binding nor authzid.

Returns:

The message

receiveServerFirstMessage

public ScramSession.ServerFirstProcessor receiveServerFirstMessage(String serverFirstMessage)
                                                            throws com.ongres.scram.common.exception.ScramParseException,
                                                                   IllegalArgumentException

Constructs a handler for the server-first-message, from its String representation.

Parameters:

serverFirstMessage - The message

Returns:

The handler

Throws:

com.ongres.scram.common.exception.ScramParseException - If the message is not a valid server-first-message

IllegalArgumentException - If the message is null or empty