csbase.server.services.loginservice

Class LoginService

java.lang.Object

csbase.remote.RemoteObjectObservable

csbase.server.ServerRemoteObjectObservable

csbase.server.Service

csbase.server.services.loginservice.LoginService

All Implemented Interfaces:

csbase.remote.RemoteObservable, csbase.remote.RemoteObserverNotifierInterface, csbase.remote.ServiceInterface, Remote

public class LoginService
extends Service

A classe LoginService implementa o serviço de login de um usuário. É responsável pela autenticação do usuário no sistema e gerenciamento da sessão.

Esse serviço pode ser observado para eventos de logout.

Author:

Tecgraf/PUC-Rio

See Also:

LogoutEvent

Field Summary

Fields

Modifier and Type	Field and Description
static int	LDAP_DEFAULT_PORT Porta padrão para acesso a servidores LDAP.
static String	LDAP_LOGIN_METHOD Valor que indica que o método de autenticação usará servidores LDAP.
static String	LDAP_PATTERN_USER Marca a ser substituída no padrão LDAP pelo usuário.
static String	LOCAL_LOGIN_METHOD Valor que indica que o método de autenticação usará senhas próprias.
protected Hashtable<csbase.logic.SecureKey,ServerSession>	loggedUsers Guarda a sessão dos usuários que estão logados no servidor.
static String	LOGIN_METHOD Nome da propriedade que indica o método de autenticação.
static String	MAX_SIMULTANEOUS_SESSIONS Propriedade que armazena o número máximo de sessoes simultâneas para um mesmo usuário (0=infinito)
static String	PRE_LOGIN_DELAY Nome da propriedade que indica o tempo para expiração de uma solicitação de pré-login.
protected Hashtable<String,csbase.server.services.loginservice.LoginService.PreLoginInfo>	preLoggedUsers Essa tabela armazena as referência para os usuários que realizaram uma operação de preLogin para posterior login.
static String	SERVICE_NAME Nome do serviço para o ServiceManager

Fields inherited from class csbase.remote.RemoteObjectObservable

observerManager

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LoginService() Constrói a instância do serviço.

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(LoginServiceListener listener) Adiciona um listener ao serviço.
protected csbase.logic.User	authenticateUser(csbase.logic.User user, String password) Método que efetivamente faz a autenticação do usuário, consultando os servidores.
boolean	canChangePasswords() Indica se o servidor permite a troca de senhas.
csbase.logic.User	checkLogin(String login, String password) Verifica o login de um usuário.
static void	createService() Constrói a instância do serviço.
protected csbase.logic.Session	createSession(csbase.logic.User user, Locale locale) Cria a sessão do usuário para a camada do cliente e inicia uma sessão do usuário no servidor.
protected void	fireConnectionLost(String login, Object sessionKey, String systemName, long time) Notifica todos listeners que a conexão com um usuário foi perdida
protected void	fireSessionCreated(String login, Object sessionKey, long time) Notifica todos listeners que uma sessão foi criada.
protected void	fireSystemNameSet(String login, Object sessionKey, String systemName, long time) Notifica todos listeners que o nome do sistema foi definido
protected void	fireUserLoggingOut(String login, Object sessionKey, String systemName, long time) Notifica todos listeners que um usuário está efetando um logout.
static LoginService	getInstance() Obtém a instância Singleton do serviço de login.
csbase.logic.UserOutline[]	getLoggedUsers() Obtém os usuários atualmente conectados ao sistema.
Map<String,Integer>	getLoginStats(boolean succeeded) Obtém estatísticas sobre os logins.
PublicKey	getPublicKey() Retorna a chave pública para criptografar a senha do login.
Map<String,Serializable>	getSessionAttributes(Object key)
<T> T	getSessionProperty(Object key, String propertyName) Obtém o valor de uma propriedade da sessão especificada.
TimeZone	getTimeZone() Obtém da sessão do usuário o TimeZone do cliente pelo qual ele se logou.
csbase.logic.User	getUserByKey(Object key) Obtém referência para o usuário especificado.
Locale	getUserSessionLocale(Object key) Informa o Locale de uma sessão.
protected boolean	has2Update(Object arg, Object event) Todos observadores serão sempre notificados.
void	initService() Inicialização do serviço.
void	install() Registra no servidor um observador.
boolean	isLocalLogin() Indica se o método de autenticação do servidor é local ou não.
boolean	isValidSession(Object sessionKey) Informa se uma dada sessão é válida.
csbase.logic.Session	login(csbase.logic.openbus.OpenBusLoginToken token, Locale locale, TimeZone timeZone) Executa o login de um usuário através de uma credencial do OpenBus.
csbase.logic.Session	login(csbase.logic.ServerURI referedServerURI, Map<String,Serializable> attr, boolean copyServerSessionAttrs, Object sessionkey, String login, String delegatedLogin, Locale locale, TimeZone tz) Executa o login de um usuário que é validado através de uma referência de outro servidor onde ele deve ter uma sessão válida.
csbase.logic.Session	login(String token) Executa o login de um usuário que fez preLogin.
csbase.logic.Session	login(String serverName, byte[] signedServerName, Locale locale) Executa o login de um servidor local.
csbase.logic.Session	login(String login, csbase.logic.EncryptedPassword encryptedPassword, Locale locale) Executa o login de um usuário via login e senha.
csbase.logic.Session	login(String login, csbase.logic.EncryptedPassword encryptedPassword, Locale locale, String delegatedLogin) Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission).
csbase.logic.Session	login(String login, csbase.logic.EncryptedPassword encryptedPassword, Locale locale, String delegatedLogin, TimeZone timeZone, Map<String,Serializable> params) Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission).
csbase.logic.Session	login(String login, csbase.logic.EncryptedPassword encryptedPassword, Locale locale, TimeZone timeZone) Executa o login de um usuário via login e senha.
csbase.logic.Session	login(String token, TimeZone timeZone) Executa o login de um usuário que fez preLogin.
void	logout(Object sessionKey) Faz o logout de um usuário do sistema.
csbase.logic.PreLoginData	preLogin(String login, String password, Locale locale) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
csbase.logic.PreLoginData	preLogin(String login, String password, Locale locale, Map<String,Serializable> attributes) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
csbase.logic.PreLoginData	preLogin(String login, String password, Locale locale, String delegatedLogin) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
csbase.logic.PreLoginData	preLogin(String login, String password, Locale locale, String delegatedLogin, Remote control, Serializable userData) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
boolean	removeListener(LoginServiceListener listener) Remove um listener do serviço.
void	removeSessionProperty(Object key, String propertyName) Remove uma propriedade da sessão especificada.
void	setSessionProperty(Object key, String propertyName, Serializable propertyValue) Atribui um valor a uma propriedade da sessão especificada.
void	setSystemName(Object sessionKey, String systemName) Define o nome do sistema onde uma determinada sessão está sendo usada.
void	shutdownService() Término do serviço.
void	uninstall() Remove do servidor o registro desse observador.

Methods inherited from class csbase.server.Service

getBooleanProperty, getDefaultLocale, getDoubleProperty, getExternalPropertyFile, getFormattedString, getFormattedString, getInitializationDependencies, getInstance, getIntProperty, getKey, getLongProperty, getName, getOptionalString, getOptionalString, getOSPropertyPath, getSenderName, getServices, getString, getString, getStringListProperty, getStringProperty, getSystemId, getThreadLocale, getUser, getUserPermission, hasProperty, incrCounter, isActive, isEnabled, isInternalServerRequest, isLoggingNotifications, isPropertyNull, logNotification, setEnabled, setKey, setSystemId, setUserId

Methods inherited from class csbase.server.ServerRemoteObjectObservable

handleException, handleFatalError

Methods inherited from class csbase.remote.RemoteObjectObservable

addObserver, countObservers, deleteObserver, deleteObserver, deleteObservers, has2update, notifyObservers

Methods inherited from class java.lang.Object

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

Field Detail

SERVICE_NAME

public static final String SERVICE_NAME

Nome do serviço para o ServiceManager

See Also:

Constant Field Values

LOGIN_METHOD

public static final String LOGIN_METHOD

Nome da propriedade que indica o método de autenticação.

See Also:

Constant Field Values

LOCAL_LOGIN_METHOD

public static final String LOCAL_LOGIN_METHOD

Valor que indica que o método de autenticação usará senhas próprias.

See Also:

Constant Field Values

LDAP_LOGIN_METHOD

public static final String LDAP_LOGIN_METHOD

Valor que indica que o método de autenticação usará servidores LDAP.

See Also:

Constant Field Values

PRE_LOGIN_DELAY

public static final String PRE_LOGIN_DELAY

Nome da propriedade que indica o tempo para expiração de uma solicitação de pré-login.

See Also:

Constant Field Values

LDAP_DEFAULT_PORT

public static final int LDAP_DEFAULT_PORT

Porta padrão para acesso a servidores LDAP.

See Also:

Constant Field Values

LDAP_PATTERN_USER

public static final String LDAP_PATTERN_USER

Marca a ser substituída no padrão LDAP pelo usuário.

See Also:

Constant Field Values

MAX_SIMULTANEOUS_SESSIONS

public static final String MAX_SIMULTANEOUS_SESSIONS

Propriedade que armazena o número máximo de sessoes simultâneas para um mesmo usuário (0=infinito)

See Also:

Constant Field Values

loggedUsers

protected Hashtable<csbase.logic.SecureKey,ServerSession> loggedUsers

Guarda a sessão dos usuários que estão logados no servidor. A chave é da classe SecureKey. A estrutura é a seguinte: chave -> hash de propriedades da sessão. Ex: { (chave1 -> { (USER -> user1), (LOCALE -> locale) } ) }

preLoggedUsers

protected Hashtable<String,csbase.server.services.loginservice.LoginService.PreLoginInfo> preLoggedUsers

Essa tabela armazena as referência para os usuários que realizaram uma operação de preLogin para posterior login.

See Also:

preLogin(String, String, Locale), login(String)

Constructor Detail

LoginService

protected LoginService()
                throws ServerException

Constrói a instância do serviço. Construtor protegido para garantir a unicidade do Singleton.

Throws:

ServerException

Method Detail

createService

public static void createService()
                          throws ServerException

Constrói a instância do serviço.

Throws:

ServerException - caso ocorra um problema na instanciação.

getInstance

public static LoginService getInstance()

Obtém a instância Singleton do serviço de login.

Returns:

instância Singleton do serviço de login.

getPublicKey

public PublicKey getPublicKey()

Retorna a chave pública para criptografar a senha do login.

Returns:

chave pública para criptografia da senha do login.

addListener

public void addListener(LoginServiceListener listener)

Adiciona um listener ao serviço.

Parameters:

listener - O listener a ser adicionado.

Throws:

IllegalArgumentException - Caso o listener esteja nulo.

removeListener

public boolean removeListener(LoginServiceListener listener)

Remove um listener do serviço.

Parameters:

listener - O listener a ser removido.

Returns:

true, caso o listener tenha sido removido, ou false, caso o listener não esteja cadastrado.

Throws:

IllegalArgumentException - Caso o listener esteja nulo.

fireSessionCreated

protected void fireSessionCreated(String login,
                      Object sessionKey,
                      long time)

Notifica todos listeners que uma sessão foi criada.

Parameters:

login - Login do usuário

sessionKey - Chave da sessão do usuário

time - Hora em que ocorreu o evento representado em milisegundos

fireUserLoggingOut

protected void fireUserLoggingOut(String login,
                      Object sessionKey,
                      String systemName,
                      long time)

Notifica todos listeners que um usuário está efetando um logout.

Parameters:

login - Login do usuário

sessionKey - Chave da sessão do usuário

systemName - Nome do sistema definido pelo usuário.

time - Hora em que ocorreu o evento representado em milisegundos

fireConnectionLost

protected void fireConnectionLost(String login,
                      Object sessionKey,
                      String systemName,
                      long time)

Notifica todos listeners que a conexão com um usuário foi perdida

Parameters:

login - Login do usuário que perdeu a conexão

sessionKey - Chave da sessão do usuário

systemName - Nome do sistema definido pelo usuário ou NULL se não tiver sido definido.

time - Hora em que ocorreu o evento representado em milisegundos

fireSystemNameSet

protected void fireSystemNameSet(String login,
                     Object sessionKey,
                     String systemName,
                     long time)

Notifica todos listeners que o nome do sistema foi definido

Parameters:

login - Login do usuário

sessionKey - Chave da sessão do usuário

systemName - Nome do sistema definido pelo usuário

time - Hora em que ocorreu o evento representado em milisegundos

initService

public void initService()
                 throws ServerException

Inicialização do serviço.

Specified by:

initService in class Service

Throws:

ServerException - se ocorrer um erro na inicialização

install

public void install()
             throws RemoteException

Registra no servidor um observador.

Throws:

RemoteException - Em caso de falha.

shutdownService

public void shutdownService()
                     throws ServerException

Término do serviço.

Specified by:

shutdownService in class Service

Throws:

ServerException - caso ocorra um problema na finalização.

uninstall

public void uninstall()
               throws RemoteException

Remove do servidor o registro desse observador.

Throws:

RemoteException - Em caso de falha.

has2Update

protected boolean has2Update(Object arg,
                 Object event)

Todos observadores serão sempre notificados.

Specified by:

has2Update in class csbase.remote.RemoteObjectObservable

Parameters:

arg - Argumento do Observador

event - Evento gerado para notificar o observador

Returns:

true

canChangePasswords

public boolean canChangePasswords()

Indica se o servidor permite a troca de senhas.

Returns:

true se a alteração de senhas for permitida, false caso contrário.

isLocalLogin

public boolean isLocalLogin()

Indica se o método de autenticação do servidor é local ou não.

Returns:

true se os usuários forem autenticados localmente, false caso contrário.

preLogin

public csbase.logic.PreLoginData preLogin(String login,
                                 String password,
                                 Locale locale)

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

Returns:

Uma string que é o token para identificação de um prelogin válido. null se o login e/ou senha forem inválidos.

See Also:

login(String)

preLogin

public csbase.logic.PreLoginData preLogin(String login,
                                 String password,
                                 Locale locale,
                                 Map<String,Serializable> attributes)

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

attributes - Os atributos da sessão do usuário.

Returns:

Uma string que é o token para identificação de um prelogin válido. null se o login e/ou senha forem inválidos.

Throws:

IllegalArgumentException - se login for nulo ou password for nulo ou locale for nulo.

See Also:

login(String)

preLogin

public csbase.logic.PreLoginData preLogin(String login,
                                 String password,
                                 Locale locale,
                                 String delegatedLogin,
                                 Remote control,
                                 Serializable userData)

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.

O usuário é autenticado por um super-usuário, que é um usuário com permissão de super-usuário(SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado.

OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Parameters:

login - o identificador do super-usuário.

password - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

control - Objeto de controle.

userData - Identificação do usuário.

Returns:

Dados sobe o preLogin realizado.

preLogin

public csbase.logic.PreLoginData preLogin(String login,
                                 String password,
                                 Locale locale,
                                 String delegatedLogin)

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.

O usuário é autenticado por um super-usuário, que é um usuário com permissão de super-usuário(SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado.

OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Parameters:

login - o identificador do super-usuário.

password - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

Returns:

Dados sobe o preLogin realizado.

login

public csbase.logic.Session login(String login,
                         csbase.logic.EncryptedPassword encryptedPassword,
                         Locale locale)

Executa o login de um usuário via login e senha. Autentica e cria no servidor uma sessão do usuário logado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do usuário que deseja fazer seu login.

encryptedPassword - a senha do respectivo usuário.

locale - A Locale que o usuário escolheu no login.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

See Also:

logout(Object)

login

public csbase.logic.Session login(String login,
                         csbase.logic.EncryptedPassword encryptedPassword,
                         Locale locale,
                         TimeZone timeZone)

Executa o login de um usuário via login e senha. Autentica e cria no servidor uma sessão do usuário logado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor. Armazena na sessão o TimeZone do usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do usuário que deseja fazer seu login.

encryptedPassword - a senha do respectivo usuário.

locale - A Locale que o usuário escolheu no login.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

See Also:

logout(Object)

login

public csbase.logic.Session login(String login,
                         csbase.logic.EncryptedPassword encryptedPassword,
                         Locale locale,
                         String delegatedLogin)

Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor. OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do super-usuário.

encryptedPassword - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

IllegalArgumentException - se login for nulo ou password for nulo ou locale for nulo.

See Also:

SuperUserPermission, logout(Object)

login

public csbase.logic.Session login(String login,
                         csbase.logic.EncryptedPassword encryptedPassword,
                         Locale locale,
                         String delegatedLogin,
                         TimeZone timeZone,
                         Map<String,Serializable> params)

Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor. OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário. Armazena na sessão o TimeZone do usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do super-usuário.

encryptedPassword - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

params - Parâmetros que serão armazenados na sessão do usuário

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

IllegalArgumentException - se login for nulo ou password for nulo ou locale for nulo.

See Also:

SuperUserPermission, logout(Object)

login

public csbase.logic.Session login(csbase.logic.ServerURI referedServerURI,
                         Map<String,Serializable> attr,
                         boolean copyServerSessionAttrs,
                         Object sessionkey,
                         String login,
                         String delegatedLogin,
                         Locale locale,
                         TimeZone tz)

Executa o login de um usuário que é validado através de uma referência de outro servidor onde ele deve ter uma sessão válida. O servidor deve possuir o certificado do servidor referenciado para garantir a relação de confiança. Se o servidor referenciado for o mesmo (mesmo host e porta deste servidor) então basta verificar se a sessão é valida.

Parameters:

referedServerURI - A URI do servidor de referência para validação

attr - Os atributos para serem armazenados na sessão do usuário

sessionkey - A chave da sessão a ser validada no servidor de referência

copyServerSessionAttrs - se true copia os atributos de sessão do servidor de referência para a sessão criada nesse servidor

login - O login do usuário

delegatedLogin - O login do usuário para delegação ou null para o caso sem delegação

locale - O Locale

tz - O Timezone

Returns:

A sessão do usuário ou null caso o usuário não seja validado no servidor de referência ou ocorra algum erro durante o login.

checkLogin

public csbase.logic.User checkLogin(String login,
                           String password)

Verifica o login de um usuário. É utilizado pelos outros serviços. Este método não está na interface remota. Se o usuário for um administrador, a validação da sua senha será sempre feita localmente. É também possível para o administrador configurar alguns usuários para que estes sempre sejam validados localmente, independentemente do método de validação em uso no servidor. Se o usuário tentando o login tiver este atributo, sua senha será validada localmente.

Parameters:

login - o identificador do usuário que deseja fazer seu login.

password - a senha digitada pelo usuário.

Returns:

O usuário que se logou ou null se o login e/ou a senha forem inválidos.

authenticateUser

protected csbase.logic.User authenticateUser(csbase.logic.User user,
                                 String password)

Método que efetivamente faz a autenticação do usuário, consultando os servidores. A implementação default faz autenticação via LDAP, mas subclasses podem redefinir este método para usar outros esquemas para autenticação.

Parameters:

user - - usuário

password - - senha

Returns:

O usuário que se logou ou null se o login e/ou a senha forem inválidos.

login

public csbase.logic.Session login(String token)

Executa o login de um usuário que fez preLogin. Verifica a validade do token de identificação do preLogin e cria no servidor uma sessão do usuário logado.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

token - Identificação de um pré-login.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

IllegalArgumentException - se token for null

See Also:

preLogin(String, String, Locale), logout(Object)

login

public csbase.logic.Session login(String token,
                         TimeZone timeZone)

Executa o login de um usuário que fez preLogin. Verifica a validade do token de identificação do preLogin e cria no servidor uma sessão do usuário logado. Armazena na sessão o TimeZone do usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

token - Identificação de um pré-login.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

IllegalArgumentException - se token for null

See Also:

preLogin(String, String, Locale), logout(Object)

login

public csbase.logic.Session login(String serverName,
                         byte[] signedServerName,
                         Locale locale)

Executa o login de um servidor local. Autentica e cria no servidor uma sessão do usuário logado.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

serverName - O nome do servidor local

signedServerName - O nome do servidor local, assinado.

locale - O locale do servidor local.

Returns:

A sessão do usuário logado. null se chave e/ou senha foram inválidos

Throws:

IllegalArgumentException

See Also:

logout(Object)

login

public csbase.logic.Session login(csbase.logic.openbus.OpenBusLoginToken token,
                         Locale locale,
                         TimeZone timeZone)

Executa o login de um usuário através de uma credencial do OpenBus.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

token - O token de login no Openbus.

locale - A Locale que o usuário escolheu no login.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

See Also:

logout(Object)

createSession

protected csbase.logic.Session createSession(csbase.logic.User user,
                                 Locale locale)

Cria a sessão do usuário para a camada do cliente e inicia uma sessão do usuário no servidor.

Parameters:

user - Usuário da sessão corrente.

locale - Locale da sessão corrente.

Returns:

Sessão para a camada do cliente.

isValidSession

public boolean isValidSession(Object sessionKey)

Informa se uma dada sessão é válida.

Parameters:

sessionKey - Chave da sessão.

Returns:

Verdadeiro se a sessão for válida, falso caso contrário.

logout

public void logout(Object sessionKey)

Faz o logout de um usuário do sistema. Finaliza a sessão e avisa os observadores.

Parameters:

sessionKey - O usuário que está efetuando o logout.

Throws:

IllegalArgumentException

See Also:

LogoutEvent

getUserSessionLocale

public Locale getUserSessionLocale(Object key)

Informa o Locale de uma sessão.

Parameters:

key - A chave da sessão.

Returns:

O Locale da sessão.

getLoggedUsers

public csbase.logic.UserOutline[] getLoggedUsers()

Obtém os usuários atualmente conectados ao sistema.

Returns:

usuários atualmente conectados ao sistema.

getUserByKey

public csbase.logic.User getUserByKey(Object key)

Obtém referência para o usuário especificado.

Parameters:

key - chave para a sessão do usuário.

Returns:

User representando o usuário. null se chave não representa uma sessão válida.

getSessionProperty

public <T> T getSessionProperty(Object key,
                       String propertyName)

Obtém o valor de uma propriedade da sessão especificada.

Parameters:

key - chave para a sessão do usuário.

propertyName - nome da propriedade a ser buscada.

Returns:

valor da propriedade na sessão especificada.

setSessionProperty

public void setSessionProperty(Object key,
                      String propertyName,
                      Serializable propertyValue)

Atribui um valor a uma propriedade da sessão especificada.

Parameters:

key - chave para a sessão do usuário.

propertyName - nome da propriedade.

propertyValue - valor da propriedade.

removeSessionProperty

public void removeSessionProperty(Object key,
                         String propertyName)

Remove uma propriedade da sessão especificada.

Parameters:

key - chave para a sessão do usuário.

propertyName - nome da propriedade.

setSystemName

public void setSystemName(Object sessionKey,
                 String systemName)

Define o nome do sistema onde uma determinada sessão está sendo usada.

Parameters:

sessionKey - A chave da sessão.

systemName - O nome do sistema.

getTimeZone

public TimeZone getTimeZone()

Obtém da sessão do usuário o TimeZone do cliente pelo qual ele se logou. Caso não exista TimeZone na sessão do usuário, retornará o TimeZone default do servidor.

Returns:

TimeZone

getSessionAttributes

public Map<String,Serializable> getSessionAttributes(Object key)

Parameters:

key - Identificador da sessão do usuário

Returns:

Os atributos do servidor da sessão de um usuário logado

getLoginStats

public Map<String,Integer> getLoginStats(boolean succeeded)

Obtém estatísticas sobre os logins.

Parameters:

succeeded - true para estatísticas dos logins bem-sucedidos, false para as falhas de autenticação

Returns:

estatísticas sobre os logins