com.sun.identity.policy.interfaces
Interface Referral

public interface Referral

interface to facilitate delegating policy evaluation There would be many implementations with different policy delegation mechanisms such as delegating to peer organizations only or delegating to sub organizations only.

Method Summary

java.lang.String	getDisplayNameForValue(java.lang.String value, java.util.Locale locale) Returns the display name for the value for the given locale.
PolicyDecision	getPolicyDecision(SSOToken token, java.lang.String resourceType, java.lang.String resourceName, java.util.Set actionNames, java.util.Map envParameters) Gets policy results
java.lang.String	getReferralTypeName() Gets the name of the ReferralType
java.util.Set	getResourceNames(SSOToken token, java.lang.String serviceTypeName, java.lang.String resourceName) Gets resource names that are exact matches, sub resources or wild card matches of argument resource name.
ValidValues	getValidValues(SSOToken token) Gets the valid values for this referral
ValidValues	getValidValues(SSOToken token, java.lang.String pattern) Gets the valid values for this referral matching a pattern
java.util.Set	getValues() Gets the values of this referral
Syntax	getValueSyntax(SSOToken token) Gets the syntax for the value
void	initialize(java.util.Map configurationMap) Initilizes the Referral with a Map
void	setValues(java.util.Set values) Sets the values of this referral

Method Detail

initialize

public void initialize(java.util.Map configurationMap)

Initilizes the Referral with a Map

Parameters:

configurationMap - a map containing configuration information. Each key of the map is a configuration parameter. Each value of the key would be a set of values for the parameter. The map is cloned and a reference to the clone is stored in the referral

setValues

public void setValues(java.util.Set values)
               throws InvalidNameException

Sets the values of this referral

Parameters:

values - set of values for this referral. Each element of the set has to be a String

Throws:

InvalidNameException - if any value passed in values is not valid

getValues

public java.util.Set getValues()

Gets the values of this referral

Returns:

the values of this referral Each element of the returned set is a String

getDisplayNameForValue

public java.lang.String getDisplayNameForValue(java.lang.String value,
                                               java.util.Locale locale)
                                        throws NameNotFoundException

Returns the display name for the value for the given locale. For all the valid values obtained through the methods getValidValues this method must be called by web and command line interfaces to get the corresponding display name. The locale variable could be used by the plugin to customize the display name for the given locale. The locale variable could be null, in which case the plugin must use the default locale (most probably en_US). This method returns only the display name and should not be used for the method setValues. Alternatively, if the plugin does not have to localize the value, it can just return the value as is.

Parameters:

value - one of the valid value for the plugin

locale - locale for which the display name must be customized

Returns:

the display name for the value for the given locale.

Throws:

NameNotFoundException - if the given value is not one of the valid values for the plugin

getValidValues

public ValidValues getValidValues(SSOToken token)
                           throws SSOException,
                                  PolicyException

Gets the valid values for this referral

Parameters:

token - SSOToken

Returns:

ValidValues object

Throws:

SSOException, - PolicyException

SSOException

PolicyException

getValidValues

public ValidValues getValidValues(SSOToken token,
                                  java.lang.String pattern)
                           throws SSOException,
                                  PolicyException

Gets the valid values for this referral matching a pattern

Parameters:

token - SSOToken

pattern - a pattern to match against the value

Returns:

ValidValues object

Throws:

SSOException, - PolicyException

SSOException

PolicyException

getValueSyntax

public Syntax getValueSyntax(SSOToken token)
                      throws SSOException,
                             PolicyException

Gets the syntax for the value

Parameters:

token - SSOToken

Throws:

SSOException

PolicyException

See Also:

Syntax

getReferralTypeName

public java.lang.String getReferralTypeName()

Gets the name of the ReferralType

Returns:

name of the ReferralType representing this referral

getPolicyDecision

public PolicyDecision getPolicyDecision(SSOToken token,
                                        java.lang.String resourceType,
                                        java.lang.String resourceName,
                                        java.util.Set actionNames,
                                        java.util.Map envParameters)
                                 throws SSOException,
                                        PolicyException

Gets policy results

Parameters:

token - SSOToken

resourceType - resourceType

resourceName - name of the resource

actionNames - a set of action names

envParameters - a map of enivronment parameters. Each key is an environment parameter name. Each value is a set of values for the parameter.

Returns:

policy decision

Throws:

PolicyException

SSOException

getResourceNames

public java.util.Set getResourceNames(SSOToken token,
                                      java.lang.String serviceTypeName,
                                      java.lang.String resourceName)
                               throws PolicyException,
                                      SSOException

Gets resource names that are exact matches, sub resources or wild card matches of argument resource name. To determine whether to include a resource name of a resource, argument resource name and policy resource name are compared treating wild characters in the policy resource name as wild. If the comparsion resulted in EXACT_MATCH, WILD_CARD_MACTH or SUB_RESOURCE_MACTH, the resource result would be included.

Parameters:

token - sso token

serviceTypeName - service type name

Returns:

names of sub resources for the given resourceName. The return value also includes the resourceName.

Throws:

PolicyException

SSOException

See Also:

ResourceMatch.EXACT_MATCH, ResourceMatch.SUB_RESOURCE_MATCH, ResourceMatch.WILDCARD_MATCH