org.eclipse.equinox.security.auth

Interface ILoginContext

public interface ILoginContext

The ILoginContext is the central entry point for the authentication support. Use it to perform login, logout, and retrieve information associated with the security subject.

This interface is not intended to be implemented by clients.

Restriction:

This interface is not intended to be implemented by clients.

Method Summary

Modifier and Type	Method and Description
javax.security.auth.login.LoginContext	getLoginContext() The method exposes underlying JAAS LoginContext.
javax.security.auth.Subject	getSubject() Retrieves the current Subject.
void	login() Call this method to perform a login.
void	logout() Call this method to perform a logout.
void	registerListener(ILoginContextListener listener) Adds listener to be notified on security-related events.
void	unregisterListener(ILoginContextListener listener) Removes listener previously registered to receive notifications on security-related events.

Method Detail

login

void login()
    throws javax.security.auth.login.LoginException

Call this method to perform a login.

Throws:

javax.security.auth.login.LoginException

See Also:

LoginContext.login()

logout

void logout()
     throws javax.security.auth.login.LoginException

Call this method to perform a logout.

Throws:

javax.security.auth.login.LoginException

See Also:

LoginContext.logout()

getSubject

javax.security.auth.Subject getSubject()
                                throws javax.security.auth.login.LoginException

Retrieves the current Subject. Calling this method will force a login to occur if the user is not already logged in.

Returns:

the Subject

Throws:

javax.security.auth.login.LoginException

See Also:

LoginContext.getSubject()

registerListener

void registerListener(ILoginContextListener listener)

Adds listener to be notified on security-related events.

Parameters:

listener - the listener to be registered

See Also:

ILoginContextListener

unregisterListener

void unregisterListener(ILoginContextListener listener)

Removes listener previously registered to receive notifications on security-related events.

Parameters:

listener - the listener to be unregistered

See Also:

ILoginContextListener

getLoginContext

javax.security.auth.login.LoginContext getLoginContext()
                                                throws javax.security.auth.login.LoginException

The method exposes underlying JAAS LoginContext.

Using the LoginContext directly will bypass some of the processing offered by this interface and should be used only when other methods are not sufficient.

Returns:

the underlying JAAS LoginContext

Throws:

javax.security.auth.login.LoginException - if exception was encountered while creating LoginContext