Package com.logicaldoc.gui.common.client.services

Interface SecurityService

All Superinterfaces:

com.google.gwt.user.client.rpc.RemoteService

All Known Implementing Classes:

SecurityServiceImpl

@RemoteServiceRelativePath("security")
public interface SecurityService
extends com.google.gwt.user.client.rpc.RemoteService

The client side stub for the Security Service. This service gives all needed methods to handle user sessions.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	SecurityService.Instance

Method Summary

Modifier and Type	Method	Description
void	addUserToGroup(long groupId, long userId)	Adds a user to a group
void	applyRights(GUIMenu menu)	Applies all security settings to menu
int	changePassword(Long requestorUserId, long userId, String oldPassword, String newPassword, boolean notify)	Changes the password of a user
void	deleteGroup(long groupId)	Deletes a given group
void	deleteUser(long userId)	Deletes a given user
GUIGroup	getGroup(long groupId)	Loads a given group from the database
GUIMenu	getMenu(long id)	Retrieves the specified menu
GUISession	getSession(String locale)	Logs-in a user by an existing session ID (session reuse)
GUIUser	getUser(long userId)	Loads a given user from the database
void	kill(String sid)	Kill the session with the given sid
GUISequence[]	loadBlockedEntities()	Retrieves the list of actually blocked usernames and IPs detected as Brute Force Attack
GUISecuritySettings	loadSettings()	Loads security settings
void	logout()	Logs out the current user
void	removeBlockedEntities(long[] id)	Removes blocked entries detected as Brute Force Attack
void	removeFromGroup(long groupId, long[] userIds)	Removes users from a group
void	replicateUsersSettings(long masterUserId, Long[] userIds, boolean gui, boolean groups)	Replicates the settings of a given user to a selection of other users
GUIGroup	saveGroup(GUIGroup group)	Creates or updates a group
GUIUser	saveInterfaceSettings(GUIUser user)	Saves the interface settings only
GUIUser	saveProfile(GUIUser user)	Saves the profile data only
boolean	saveSettings(GUISecuritySettings settings)	Saves security settings
GUIUser	saveUser(GUIUser user, GUIInfo info)	Creates or updates a user
GUIUser[]	searchUsers(String username, String groupId)	Searches for users

Method Detail

getSession

GUISession getSession(String locale)

Logs-in a user by an existing session ID (session reuse)

Parameters:

locale - the currently used language specification

Returns:

session informations

changePassword

int changePassword(Long requestorUserId,
                   long userId,
                   String oldPassword,
                   String newPassword,
                   boolean notify)

Changes the password of a user

Parameters:

requestorUserId - The user Identifier of the requestor

userId - The user Identifier

oldPassword - can be null

newPassword - the new password

notify - If the new credentials have to be notified

Returns:

0 if all is ok, 1 if the password is incorrect, 2 if the new password cannot be notified, otherwise a positive number grater than 2

logout

void logout()

Logs out the current user

deleteUser

void deleteUser(long userId)
         throws ServerException

Deletes a given user

Parameters:

userId - identifier of the user

Throws:

ServerException - error generated in the server application

saveUser

GUIUser saveUser(GUIUser user,
                 GUIInfo info)
          throws ServerException

Creates or updates a user

Parameters:

user - the user to save

info - informations about the User Interface

Returns:

the saved user

Throws:

ServerException - error generated in the server application

replicateUsersSettings

void replicateUsersSettings(long masterUserId,
                            Long[] userIds,
                            boolean gui,
                            boolean groups)
                     throws ServerException

Replicates the settings of a given user to a selection of other users

Parameters:

masterUserId - identifier of the user with the settings you want to replicate

gui - if the user interface settings must be replicated

groups - if the groups must be replicated(the read-only users will not be affected by this flag)

Throws:

ServerException - error generated in the server application

saveProfile

GUIUser saveProfile(GUIUser user)
             throws ServerException

Saves the profile data only

Parameters:

user - the user to save

Returns:

the updated user

Throws:

ServerException - error generated in the server application

saveInterfaceSettings

GUIUser saveInterfaceSettings(GUIUser user)
                       throws ServerException

Saves the interface settings only

Parameters:

user - the user to save

Returns:

the updated user

Throws:

ServerException - error generated in the server application

getUser

GUIUser getUser(long userId)
         throws ServerException

Loads a given user from the database

Parameters:

userId - identifier of the user

Returns:

the user retrieved from the server application

Throws:

ServerException - error generated in the server application

getGroup

GUIGroup getGroup(long groupId)
           throws ServerException

Loads a given group from the database

Parameters:

groupId - identifier of the group

Returns:

group retrieved from the server application

Throws:

ServerException - error generated in the server application

saveGroup

GUIGroup saveGroup(GUIGroup group)
            throws ServerException

Creates or updates a group

Parameters:

group - the group to save

Returns:

the updated group

Throws:

ServerException - error generated in the server application

deleteGroup

void deleteGroup(long groupId)
          throws ServerException

Deletes a given group

Parameters:

groupId - identifier of the group

Throws:

ServerException - error generated in the server application

removeFromGroup

void removeFromGroup(long groupId,
                     long[] userIds)
              throws ServerException

Removes users from a group

Parameters:

groupId - identifier of the group

userIds - array of user identifiers

Throws:

ServerException - error generated in the server application

addUserToGroup

void addUserToGroup(long groupId,
                    long userId)
             throws ServerException

Adds a user to a group

Parameters:

groupId - identifier of the group

userId - identifier of the user

Throws:

ServerException - error generated in the server application

saveSettings

boolean saveSettings(GUISecuritySettings settings)
              throws ServerException

Saves security settings

Parameters:

settings - settings about security

Returns:

True if the application has to be restarted

Throws:

ServerException - error generated in the server application

loadSettings

GUISecuritySettings loadSettings()
                          throws ServerException

Loads security settings

Returns:

the security settings

Throws:

ServerException - error generated in the server application

kill

void kill(String sid)
   throws ServerException

Kill the session with the given sid

Parameters:

sid - identifier of the session

Throws:

ServerException - error generated in the server application

applyRights

void applyRights(GUIMenu menu)
          throws ServerException

Applies all security settings to menu

Parameters:

menu - the menu

Throws:

ServerException - error generated in the server application

getMenu

GUIMenu getMenu(long id)
         throws ServerException

Retrieves the specified menu

Parameters:

id - identifier of the menu

Returns:

the menu retrieved from the server application

Throws:

ServerException - error generated in the server application

searchUsers

GUIUser[] searchUsers(String username,
                      String groupId)
               throws ServerException

Searches for users

Parameters:

username - The username used in the like operator (optional)

groupId - The group ID (optional)

Returns:

Array of found users

Throws:

ServerException - error generated in the server application

loadBlockedEntities

GUISequence[] loadBlockedEntities()
                           throws ServerException

Retrieves the list of actually blocked usernames and IPs detected as Brute Force Attack

Returns:

the array of blocked usernames and IPs

Throws:

ServerException - error generated in the server application

removeBlockedEntities

void removeBlockedEntities(long[] id)
                    throws ServerException

Removes blocked entries detected as Brute Force Attack

Parameters:

id - identifiers of entities from the BFA list

Throws:

ServerException - error generated in the server application