TicketComponent (Alfresco 5.1.4.1 Public Java API)

org.alfresco.repo.security.authentication

Interface TicketComponent

@org.alfresco.api.AlfrescoPublicApi
public interface TicketComponent

Manage authentication tickets

Method Summary
void	clearCurrentTicket() Clear the current ticket
int	countTickets(boolean nonExpiredOnly) Count tickets This may be higher than the user count, since a user can have more than one ticket/session
String	getAuthorityForTicket(String ticket) Get the authority for the given ticket
String	getCurrentTicket(String userName, boolean autoCreate) Get the current ticket
String	getNewTicket(String userName) Register a new ticket
Set<String>	getUsersWithTickets(boolean nonExpiredOnly) Get set of users with tickets This may be lower than the ticket count, since a user can have more than one ticket/session
boolean	getUseSingleTicketPerUser() Does this ticket component support a single ticket per user or one ticket for each time they login?
void	invalidateTicketById(String ticket) Invalidate the tickets by id
void	invalidateTicketByUser(String userName) Invalidate all user tickets
int	invalidateTickets(boolean expiredOnly) Invalidate tickets
String	validateTicket(String ticket) Check that a certificate is valid and can be used in place of a login.

String getNewTicket(String userName)
throws AuthenticationException

String getCurrentTicket(String userName,
boolean autoCreate)

Get the current ticket

autoCreate - should we create one automatically if there isn't one?

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

Check that a certificate is valid and can be used in place of a login. Tickets may be rejected because:

The certificate does not exists
The status of the user has changed
1. The user is locked
2. The account has expired
3. The credentials have expired
4. The account is disabled
The ticket may have expired
1. The ticked my be invalid by timed expiry
2. An attemp to reuse a once only ticket

invalidateTicketById

@Auditable(parameters="ticket",
recordable=false)
void invalidateTicketById(String ticket)

Invalidate the tickets by id

invalidateTicketByUser

void invalidateTicketByUser(String userName)

Invalidate all user tickets

int countTickets(boolean nonExpiredOnly)

Count tickets This may be higher than the user count, since a user can have more than one ticket/session

nonExpiredOnly - true for non expired tickets, false for all (including expired) tickets

int number of tickets

Set<String> getUsersWithTickets(boolean nonExpiredOnly)

Get set of users with tickets This may be lower than the ticket count, since a user can have more than one ticket/session

nonExpiredOnly - true for non expired tickets, false for all (including expired) tickets

Set set of users with (one or more) tickets

int invalidateTickets(boolean expiredOnly)

expiredOnly - true for EXPIRED tickets, false for ALL (including non-expired) tickets

int count of invalidated tickets

getAuthorityForTicket

String getAuthorityForTicket(String ticket)

Get the authority for the given ticket

void clearCurrentTicket()

Clear the current ticket

getUseSingleTicketPerUser

boolean getUseSingleTicketPerUser()

Does this ticket component support a single ticket per user or one ticket for each time they login?

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