org.apache.sshd.server.auth.gss
Class UserAuthGSS

java.lang.Object
  org.apache.sshd.server.auth.gss.UserAuthGSS

All Implemented Interfaces:

HandshakingUserAuth, UserAuth

public class UserAuthGSS
extends java.lang.Object
implements HandshakingUserAuth

Prototype user authentication handling gssapi-with-mic. Implements HandshakingUserAuth because the process involves several steps. Several methods are available for overriding in specific circumstances.

Nested Class Summary

static class

UserAuthGSS.Factory Factory class.

Field Summary

static org.ietf.jgss.Oid	KRB5_MECH
static org.ietf.jgss.Oid	KRB5_NT_PRINCIPAL

Constructor Summary

UserAuthGSS()

Method Summary

java.lang.Boolean	auth(ServerSession sess, java.lang.String user, Buffer buff) Handle the first authentication step.
void	destroy() Free any system resources used by the module.
java.lang.String	getUserName() Get a user name which has been derived from the handshaking process, or the initial name if nothing has been found.
boolean	handles(SshConstants.Message msg) Check whether a particular message is handled here.
java.lang.Boolean	next(ServerSession session, SshConstants.Message msg, Buffer buffer) Handle another step in the authentication process.
void	setServiceName(java.lang.String service) Set the service name from the original request.

Methods inherited from class java.lang.Object

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

Field Detail

KRB5_MECH

public static final org.ietf.jgss.Oid KRB5_MECH

KRB5_NT_PRINCIPAL

public static final org.ietf.jgss.Oid KRB5_NT_PRINCIPAL

Constructor Detail

UserAuthGSS

public UserAuthGSS()

Method Detail

auth

public java.lang.Boolean auth(ServerSession sess,
                              java.lang.String user,
                              Buffer buff)
                       throws java.lang.Exception

Handle the first authentication step.

Specified by:

auth in interface UserAuth

Parameters:

sess - The server session

user - The user name from the request

buff - The request buffer

Returns:

True or false if the authentication succeeded, or null to continue further

Throws:

java.lang.Exception - If something went wrong

setServiceName

public void setServiceName(java.lang.String service)

Set the service name from the original request. This may be required for MIC verification later.

Specified by:

setServiceName in interface HandshakingUserAuth

Parameters:

service - The service name

handles

public boolean handles(SshConstants.Message msg)

Check whether a particular message is handled here.

Specified by:

handles in interface HandshakingUserAuth

Parameters:

msg - The message

Returns:

true if the message is handled

next

public java.lang.Boolean next(ServerSession session,
                              SshConstants.Message msg,
                              Buffer buffer)
                       throws java.lang.Exception

Handle another step in the authentication process.

Specified by:

next in interface HandshakingUserAuth

Parameters:

session - the current ssh session

buffer - the request buffer containing parameters specific to this request

msg - The message type

Returns:

true if the authentication succeeded, false if the authentication is not finished yet

Throws:

java.lang.Exception - if the authentication fails

getUserName

public java.lang.String getUserName()
                             throws org.ietf.jgss.GSSException

Get a user name which has been derived from the handshaking process, or the initial name if nothing has been found.

Specified by:

getUserName in interface HandshakingUserAuth

Returns:

The user name

Throws:

org.ietf.jgss.GSSException

destroy

public void destroy()

Free any system resources used by the module.

Specified by:

destroy in interface HandshakingUserAuth