AuthenticationService (Alfresco 5.1.4.1 Public Java API)

org.alfresco.service.cmr.security

Interface AuthenticationService

All Known Subinterfaces:

@org.alfresco.api.AlfrescoPublicApi
public interface AuthenticationService

The authentication service defines the API for managing authentication information against a user id.

Method Summary
void	authenticate(String userName, char[] password) Carry out an authentication attempt.
void	authenticateAsGuest() Authenticate as the guest user.
boolean	authenticationExists(String userName) Check if the given authentication exists.
void	clearCurrentSecurityContext() Remove the current security information
boolean	getAuthenticationEnabled(String userName) Is an authentication enabled or disabled?
String	getCurrentTicket() Get the current ticket as a string
String	getCurrentUserName() Get the name of the currently authenticated user.
Set<String>	getDefaultAdministratorUserNames() Gets a set of user names who should be considered 'administrators' by default.
Set<String>	getDefaultGuestUserNames() Gets a set of user names who should be considered 'guests' by default.
Set<String>	getDomains() Get the domain to which this instance of an authentication service applies.
Set<String>	getDomainsThatAllowUserCreation() Does this instance alow user to be created?
Set<String>	getDomainsThatAllowUserDeletion() Does this instance allow users to be deleted?
Set<String>	getDomiansThatAllowUserPasswordChanges() Does this instance allow users to update their passwords?
String	getNewTicket() Get a new ticket as a string
boolean	guestUserAuthenticationAllowed() Check if Guest user authentication is allowed.
void	invalidateTicket(String ticket) Invalidate a single ticket by ID
void	invalidateUserSession(String userName) Invalidate any tickets held by the user.
boolean	isCurrentUserTheSystemUser() Is the current user the system user?
void	validate(String ticket) Validate a ticket.

getAuthenticationEnabled

@Auditable(parameters="userName")
boolean getAuthenticationEnabled(String userName)
throws AuthenticationException

Is an authentication enabled or disabled?

@Auditable(parameters={
  "userName",
  "password"
},
           recordable={
  true,
  false
})
void authenticate(String userName,
                  char[] password)
           throws AuthenticationException

Carry out an authentication attempt. If successful the user is set to the current user. The current user is a part of the thread context.

userName - the username

password - the passowrd

@Auditable
void authenticateAsGuest()
throws AuthenticationException

Authenticate as the guest user. This may not be allowed and throw an exception.

guestUserAuthenticationAllowed

@Auditable
boolean guestUserAuthenticationAllowed()

Check if Guest user authentication is allowed.

true if Guest user authentication is allowed, false otherwise

authenticationExists

@Auditable(parameters="userName")
boolean authenticationExists(String userName)

Check if the given authentication exists.

userName - the username

Returns true if the authentication exists

@Auditable
String getCurrentUserName()
throws AuthenticationException

Get the name of the currently authenticated user.

invalidateUserSession

@Auditable(parameters="userName")
void invalidateUserSession(String userName)
throws AuthenticationException

Invalidate any tickets held by the user.

@Auditable(parameters="ticket",
recordable=false)
void invalidateTicket(String ticket)
throws AuthenticationException

Invalidate a single ticket by ID

@Auditable(parameters="ticket",
recordable=false)
void validate(String ticket)
throws AuthenticationException

Validate a ticket. Set the current user name accordingly.

@Auditable
String getCurrentTicket()

Get the current ticket as a string

@Auditable
String getNewTicket()

Get a new ticket as a string

clearCurrentSecurityContext

@Auditable
void clearCurrentSecurityContext()

Remove the current security information

isCurrentUserTheSystemUser

@Auditable
boolean isCurrentUserTheSystemUser()

Is the current user the system user?

@Auditable
Set<String> getDomains()

Get the domain to which this instance of an authentication service applies.

getDomainsThatAllowUserCreation

@Auditable
Set<String> getDomainsThatAllowUserCreation()

Does this instance alow user to be created?

getDomainsThatAllowUserDeletion

@Auditable
Set<String> getDomainsThatAllowUserDeletion()

Does this instance allow users to be deleted?

getDomiansThatAllowUserPasswordChanges

@Auditable
Set<String> getDomiansThatAllowUserPasswordChanges()

Does this instance allow users to update their passwords?

getDefaultAdministratorUserNames

@Auditable
Set<String> getDefaultAdministratorUserNames()

Gets a set of user names who should be considered 'administrators' by default.

getDefaultGuestUserNames

@Auditable
Set<String> getDefaultGuestUserNames()

Gets a set of user names who should be considered 'guests' by default.

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