org.jasig.cas.services
Interface RegisteredService

All Superinterfaces:

Cloneable, Serializable

All Known Implementing Classes:

AbstractRegisteredService, RegexRegisteredService, RegisteredServiceImpl

public interface RegisteredService
extends Cloneable, Serializable

Interface for a service that can be registered by the Services Management interface.

Since:

3.1

Version:

$Revision$ $Date$

Author:

Scott Battaglia

Method Summary

Object	clone()
List<String>	getAllowedAttributes() Returns the list of allowed attributes.
String	getDescription() Returns the description of the service.
int	getEvaluationOrder() Gets the relative evaluation order of this service when determining matches.
long	getId() The numeric identifier for this service.
String	getName() Returns the name of the service.
String	getServiceId() The unique identifier for this service.
String	getTheme() Returns a short theme name.
String	getUsernameAttribute() Get the name of the attribute this service prefers to consume as username.
boolean	isAllowedToProxy() Is this application allowed to take part in the proxying capabilities of CAS?
boolean	isAnonymousAccess() Determines whether the service is allowed anonymous or privileged access to user information.
boolean	isEnabled() Is this application currently allowed to use CAS?
boolean	isIgnoreAttributes() Sets whether we should bother to read the attribute list or not.
boolean	isSsoEnabled() Does this application participate in the SSO session?
boolean	matches(Service service) Returns whether the service matches the registered service.
void	setEvaluationOrder(int evaluationOrder) Sets the relative evaluation order of this service when determining matches.

Method Detail

isEnabled

boolean isEnabled()

Is this application currently allowed to use CAS?

Returns:

true if it can use CAS, false otherwise.

isAnonymousAccess

boolean isAnonymousAccess()

Determines whether the service is allowed anonymous or privileged access to user information. Anonymous access should not return any identifying information such as user id.

Returns:

if we should use a pseudo random identifier instead of their real id

isIgnoreAttributes

boolean isIgnoreAttributes()

Sets whether we should bother to read the attribute list or not.

Returns:

true if we should read it, false otherwise.

getAllowedAttributes

List<String> getAllowedAttributes()

Returns the list of allowed attributes.

Returns:

the list of attributes

isAllowedToProxy

boolean isAllowedToProxy()

Is this application allowed to take part in the proxying capabilities of CAS?

Returns:

true if it can, false otherwise.

getServiceId

String getServiceId()

The unique identifier for this service.

Returns:

the unique identifier for this service.

getId

long getId()

The numeric identifier for this service.

Returns:

the numeric identifier for this service.

getName

String getName()

Returns the name of the service.

Returns:

the name of the service.

getTheme

String getTheme()

Returns a short theme name. Services do not need to have unique theme names.

Returns:

the theme name associated with this service.

isSsoEnabled

boolean isSsoEnabled()

Does this application participate in the SSO session?

Returns:

true if it does, false otherwise.

getDescription

String getDescription()

Returns the description of the service.

Returns:

the description of the service.

getEvaluationOrder

int getEvaluationOrder()

Gets the relative evaluation order of this service when determining matches.

Returns:

Evaluation order relative to other registered services. Services with lower values will be evaluated for a match before others.

setEvaluationOrder

void setEvaluationOrder(int evaluationOrder)

Sets the relative evaluation order of this service when determining matches.

getUsernameAttribute

String getUsernameAttribute()

Get the name of the attribute this service prefers to consume as username.

Returns:

Either of the following values:

• String representing the name of the attribute to consume as username
• null indicating the default username

matches

boolean matches(Service service)

Returns whether the service matches the registered service.

Note, as of 3.1.2, matches are case insensitive.

Parameters:

service - the service to match.

Returns:

true if they match, false otherwise.

clone

Object clone()
             throws CloneNotSupportedException

Throws:

CloneNotSupportedException