AuthenticationUtil (Alfresco 5.1.4.1 Public Java API)

org.alfresco.repo.security.authentication

Class AuthenticationUtil

org.alfresco.repo.security.authentication.AuthenticationUtil

All Implemented Interfaces:

org.springframework.beans.factory.InitializingBean

@org.alfresco.api.AlfrescoPublicApi
public class AuthenticationUtil

implements org.springframework.beans.factory.InitializingBean

Utility helper methods to change the authenticated context for threads.

Nested Class Summary
static interface	AuthenticationUtil.RunAsWork<Result>

Field Summary
static String	SYSTEM_USER_NAME

Constructor Summary
AuthenticationUtil()

Method Summary
void	afterPropertiesSet()
static void	clearCurrentSecurityContext() Remove the current security information
static String	getAdminRoleName()
static String	getAdminUserName() Get the name of the default admin user (the admin user created during bootstrap)
static net.sf.acegisecurity.Authentication	getFullAuthentication() WARN: Advanced usage only. Get the authentication for that was set by an real authentication.
static String	getFullyAuthenticatedUser() Get the fully authenticated user.
static String	getGuestRoleName() Get the name of the guest role
static String	getGuestUserName() Get the name of the Guest User
static net.sf.acegisecurity.Authentication	getRunAsAuthentication() Get the current authentication for application of permissions.
static String	getRunAsUser() Get the user that is currently in effect for purposes of authentication.
static String	getSystemUserName() Get the name of the system user
static Pair<String>	getUserTenant(String userName)
static boolean	isMtEnabled()
static boolean	isRunAsUserTheSystemUser()
static void	logAuthenticatedUsers() Logs the current authenticated users
static void	logNDC(String userNameIn)
static void	popAuthentication() Pop the authentication context from a threadlocal stack.
static void	pushAuthentication() Push the current authentication context onto a threadlocal stack.
static <R> R	runAs(AuthenticationUtil.RunAsWork<R> runAsWork, String uid) Execute a unit of work as a given user.
static <R> R	runAsSystem(AuthenticationUtil.RunAsWork<R> runAsWork)
static net.sf.acegisecurity.Authentication	setAdminUserAsFullyAuthenticatedUser() Authenticate as the Admin user.
void	setDefaultAdminUserName(String defaultAdminUserName)
void	setDefaultGuestUserName(String defaultGuestUserName)
static net.sf.acegisecurity.Authentication	setFullAuthentication(net.sf.acegisecurity.Authentication authentication) Re-authenticate using a previously-created authentication.
static net.sf.acegisecurity.Authentication	setFullyAuthenticatedUser(String userName) Authenticate as the given user.
static void	setMtEnabled(boolean mtEnabled)
static net.sf.acegisecurity.Authentication	setRunAsUser(String userName) WARN: Advanced usage only. Switch to the given user for all authenticated operations.
static net.sf.acegisecurity.Authentication	setRunAsUserSystem() WARN: Advanced usage only. Set the system user as the currently running user for authentication purposes.

Methods inherited from class java.lang.Object

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

public static final String SYSTEM_USER_NAME

public AuthenticationUtil()

public void afterPropertiesSet()
throws Exception

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

setDefaultAdminUserName

public void setDefaultAdminUserName(String defaultAdminUserName)

setDefaultGuestUserName

public void setDefaultGuestUserName(String defaultGuestUserName)

public static void setMtEnabled(boolean mtEnabled)

public static boolean isMtEnabled()

setAdminUserAsFullyAuthenticatedUser

public static net.sf.acegisecurity.Authentication setAdminUserAsFullyAuthenticatedUser()

Authenticate as the Admin user. The Admin user will be authenticated and all operations with be run in the context of this Admin user.

the authentication token

setFullyAuthenticatedUser

public static net.sf.acegisecurity.Authentication setFullyAuthenticatedUser(String userName)

Authenticate as the given user. The user will be authenticated and all operations with be run in the context of this user.

userName - the user name

the authentication token

setFullAuthentication

public static net.sf.acegisecurity.Authentication setFullAuthentication(net.sf.acegisecurity.Authentication authentication)

Re-authenticate using a previously-created authentication.

public static net.sf.acegisecurity.Authentication setRunAsUserSystem()

WARN: Advanced usage only.
Set the system user as the currently running user for authentication purposes.

public static net.sf.acegisecurity.Authentication setRunAsUser(String userName)

WARN: Advanced usage only.
Switch to the given user for all authenticated operations. The original, authenticated user can still be found using getFullyAuthenticatedUser().

userName - the user to run as

the new authentication

getRunAsAuthentication

public static net.sf.acegisecurity.Authentication getRunAsAuthentication()
throws AuthenticationException

Get the current authentication for application of permissions. This includes the any overlay details set by setRunAsUser(String).

Authentication Returns the running authentication

getFullAuthentication

public static net.sf.acegisecurity.Authentication getFullAuthentication()
throws AuthenticationException

WARN: Advanced usage only.
Get the authentication for that was set by an real authentication.

Authentication Returns the real authentication

public static String getRunAsUser()
throws AuthenticationException

Get the user that is currently in effect for purposes of authentication. This includes any overlays introduced by runAs.

Returns the name of the user

isRunAsUserTheSystemUser

public static boolean isRunAsUserTheSystemUser()

getFullyAuthenticatedUser

public static String getFullyAuthenticatedUser()
throws AuthenticationException

Get the fully authenticated user. It returns the name of the user that last authenticated and excludes any overlay authentication set by runAs.

Returns the name of the authenticated user

public static String getSystemUserName()

Get the name of the system user

public static String getAdminUserName()

Get the name of the default admin user (the admin user created during bootstrap)

public static String getAdminRoleName()

public static String getGuestUserName()

Get the name of the Guest User

public static String getGuestRoleName()

Get the name of the guest role

clearCurrentSecurityContext

public static void clearCurrentSecurityContext()

Remove the current security information

public static <R> R runAs(AuthenticationUtil.RunAsWork<R> runAsWork,
String uid)

Execute a unit of work as a given user. The thread's authenticated user will be returned to its normal state after the call.

runAsWork - the unit of work to do

Returns the work's return value

public static <R> R runAsSystem(AuthenticationUtil.RunAsWork<R> runAsWork)

public static void pushAuthentication()

Push the current authentication context onto a threadlocal stack.

public static void popAuthentication()

Pop the authentication context from a threadlocal stack.

logAuthenticatedUsers

public static void logAuthenticatedUsers()

Logs the current authenticated users

public static void logNDC(String userNameIn)

public static Pair<String> getUserTenant(String userName)

Java API documentation generated with DocFlex/Javadoc 1.6.1 using JavadocPro template set.