com.atlassian.crowd.service
Interface UserService

All Known Implementing Classes:

UserServiceImpl

public interface UserService

Method Summary

boolean	authenticate(String username, String password) Given a usernamen & password, this method checks, whether or not the provided user can be authenticated
String	getAuthenticatedUsername(javax.servlet.http.HttpServletRequest request) Returns the username of the currently logged in user or null if no user can be found.
String	getRemoteUsername() Deprecated. use getAuthenticatedUsername(javax.servlet.http.HttpServletRequest)
boolean	isSystemAdmin(String username) Returns true or false depending on if a user has been granted the system admin permission within Crowd.
boolean	isUserInGroup(String username, String group) Returns whether the user is in the specify group
Principal	resolve(String username) Returns the user that made this request or null if this application does not have such a user.
boolean	setAuthenticatedUser(String username) Authenticate the current user by setting an appropriate authentication token in Spring Security's SecurityContext.

Method Detail

getRemoteUsername

@Deprecated
String getRemoteUsername()

Deprecated. use getAuthenticatedUsername(javax.servlet.http.HttpServletRequest)

Returns the username of the currently logged in user or null if no user can be found.

Returns:

The user name of the logged in user or null

getAuthenticatedUsername

String getAuthenticatedUsername(javax.servlet.http.HttpServletRequest request)

Returns the username of the currently logged in user or null if no user can be found.

Parameters:

request - The request to retrieve the username from

Returns:

The user name of the logged in user or null

isUserInGroup

boolean isUserInGroup(String username,
                      String group)

Returns whether the user is in the specify group

Parameters:

username - The username to check

group - The group to check

Returns:

True if the user is in the specified group

isSystemAdmin

boolean isSystemAdmin(String username)
                      throws org.springframework.dao.DataAccessException

Returns true or false depending on if a user has been granted the system admin permission within Crowd. This will usually mean that the user is a member of the crowd-administrators group OR the user is a member of a group assigned to the crowd application.

Parameters:

username - The username of the user to check

Returns:

true or false depending on if a user has been granted the system admin permission.

Throws:

org.springframework.dao.DataAccessException - if there was an error retrieving the username

authenticate

boolean authenticate(String username,
                     String password)

Given a usernamen & password, this method checks, whether or not the provided user can be authenticated

Parameters:

username - Username of the user

password - Password of the user

Returns:

True if the user can be authenticated, false otherwise

resolve

Principal resolve(String username)
                  throws org.springframework.dao.DataAccessException

Returns the user that made this request or null if this application does not have such a user.

Parameters:

username - Username of the user a consumer is making a request on behalf of

Returns:

Principal corresponding to the username, null if the user does not exist

Throws:

org.springframework.dao.DataAccessException - if there was an error retrieving the username

setAuthenticatedUser

boolean setAuthenticatedUser(String username)

Authenticate the current user by setting an appropriate authentication token in Spring Security's SecurityContext. This method should only be called if the user has been authenticated via some other mean (e.g OAuth or Trusted Apps).

Parameters:

username - the username of the user to authenticate

Returns:

true if the username was correctly resolved and authenticated, false otherwise