com.sun.identity.policy

Class PolicyManager

java.lang.Object

com.sun.identity.policy.PolicyManager

Deprecated.

since 12.0.0

@Deprecated
public final class PolicyManager
extends Object

The PolicyManager class manages policies for a specific organization, sub organization or a container. This class is the starting point for policy management, and provides methods to create/modify/delete policies.

It is a final class and hence cannot be further extended. The methods in this class works directly with the backend datastore (usually a directory server) to store and manage policies. Hence, user of this class must have valid SSOToken and privileges to the backend datastore.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ORGANIZATION_NAME Deprecated. The key for the plugins to get the organization name.
static String	POLICY_SERVICE_NAME Deprecated. The service name for Policy component.

Constructor Summary

Constructors

Constructor and Description
PolicyManager(SSOToken token) Deprecated. Constructor for PolicyManager for the top (or root) organization.
PolicyManager(SSOToken token, String name) Deprecated. Constructor for PolicyManager for the specified organization, sub organization or a container object.

Method Summary

Modifier and Type	Method and Description
void	addPolicy(Policy policy) Deprecated. Adds a policy to the data store.
ConditionTypeManager	getConditionTypeManager() Deprecated. Gets the ConditionTypeManager object instance associated with this PolicyManager object instance
String	getOrganizationName() Deprecated. Gets the organization name for which the policy manager was initialized with.
Policy	getPolicy(String policyName) Deprecated. Gets the policy object given the name of the policy.
Set	getPolicyNames() Deprecated. Gets a set of names of polices defined in the organization for which the policy manager was instantiated.
Set	getPolicyNames(String pattern) Deprecated. Gets a set of selected policy names matching the pattern in the given organization.
ReferralTypeManager	getReferralTypeManager() Deprecated. Returns ReferralTypeManager associated with this policy manager.
ResourceManager	getResourceManager() Deprecated. Gets the ResourceManager object instance associated with this PolicyManager object instance
SubjectTypeManager	getSubjectTypeManager() Deprecated. Gets the SubjectTypeManager object instance associated with this PolicyManager object instance
void	removePolicy(String policyName) Deprecated. Deletes a policy in the organization with the given name.
void	replacePolicy(Policy policy) Deprecated. Replaces a policy object in the data store with the same policy name

Methods inherited from class java.lang.Object

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

Field Detail

POLICY_SERVICE_NAME

public static final String POLICY_SERVICE_NAME

Deprecated.

The service name for Policy component.

See Also:

Constant Field Values

ORGANIZATION_NAME

public static final String ORGANIZATION_NAME

Deprecated.

The key for the plugins to get the organization name.

See Also:

Constant Field Values

Constructor Detail

PolicyManager

public PolicyManager(SSOToken token)
              throws SSOException,
                     PolicyException

Deprecated.

Constructor for PolicyManager for the top (or root) organization. It requires a SSOToken which will be used to perform all data store operations. If the user does not have sufficient privileges NoPermissionException will be thrown.

Parameters:

token - SSOToken of the user managing policy

Throws:

SSOException - invalid or expired single-sign-on token

PolicyException - for any other abnormal condition

PolicyManager

public PolicyManager(SSOToken token,
                     String name)
              throws SSOException,
                     NameNotFoundException,
                     PolicyException

Deprecated.

Constructor for PolicyManager for the specified organization, sub organization or a container object. The names of the organization, sub organization or the container object could be either "/" separated (as per SMS) or could be the complete DN of the object. For example: /isp/coke, /isp/pepsi/tacobell, etc., or "ou=tacobell, o=pepsi, o=isp", "o=coke, o=isp", etc. The constructor also requires a single sign on token. which will be used to perform all data store operations. If the user does not have sufficient privileges NoPermissionException will be thrown.

Parameters:

token - single-sign-on token of the user managing policies

name - name of the organization, sub organization or container for which to manage policies. The name could be either slash (/) separated or the complete DN.

Throws:

SSOException - invalid or expired single-sign-on token

NameNotFoundException - if the given organization, sub-organization or container name is not present

PolicyException - for any other abnormal condition

Method Detail

getOrganizationName

public String getOrganizationName()

Deprecated.

Gets the organization name for which the policy manager was initialized with. The organization name could either be slash ("/") separated or could be the distinguished name depending on the manner in which it was initialized.

Returns:

organization name for which the policy manager was instantiated

getPolicyNames

public Set getPolicyNames()
                   throws SSOException,
                          NoPermissionException,
                          PolicyException

Deprecated.

Gets a set of names of polices defined in the organization for which the policy manager was instantiated. If there are no policies defined, this method returns an empty set (not null).

Returns:

Set of names of policies defined in the organization

Throws:

SSOException - invalid or expired single-sign-on token

NoPermissionException - user does not have sufficient privileges to get policy names

PolicyException - for any other abnormal condition

getPolicyNames

public Set getPolicyNames(String pattern)
                   throws SSOException,
                          NoPermissionException,
                          PolicyException

Deprecated.

Gets a set of selected policy names matching the pattern in the given organization. The pattern accepts "*" as the wild card for searching policy names. For example if the pattern is "co*", it returns policies starting with "co". Similarly, if the pattern is "*net", it returns policies ending with "net". The wildcard can be anywhere in the the string. If there are no policies that match the provided filter, this method returns an empty set (not null).

Parameters:

pattern - search pattern that will be used to select policy names

Returns:

Set of policy names that satisfy the pattern

Throws:

SSOException - invalid or expired single-sign-on token

NoPermissionException - user does not have sufficient privileges to get policy names

PolicyException - for any other abnormal condition

getPolicy

public Policy getPolicy(String policyName)
                 throws SSOException,
                        NoPermissionException,
                        InvalidFormatException,
                        NameNotFoundException,
                        InvalidNameException,
                        PolicyException

Deprecated.

Gets the policy object given the name of the policy.

Parameters:

policyName - name of the policy

Returns:

policy with the given policy name

Throws:

SSOException - if single sign on token associated with the policy manager is not valid.

NoPermissionException - if not enough permissions.

InvalidFormatException - if policyName has invalid format.

NameNotFoundException - if the policy is not found.

InvalidNameException - if policyName is invalid.

PolicyException - for any other abnormal condition.

addPolicy

public void addPolicy(Policy policy)
               throws SSOException,
                      NameAlreadyExistsException,
                      NoPermissionException,
                      InvalidFormatException,
                      PolicyException

Deprecated.

Adds a policy to the data store.

Parameters:

policy - policy object to be added to the organization

Throws:

SSOException - invalid or expired single-sign-on token

NoPermissionException - user does not have sufficient privileges to add policy

InvalidFormatException - the data in the policy object has been corrupted or does not have a valid format

NameAlreadyExistsException - a policy with the same name already exists

PolicyException - for any other abnormal condition

replacePolicy

public void replacePolicy(Policy policy)
                   throws SSOException,
                          NameNotFoundException,
                          NoPermissionException,
                          InvalidFormatException,
                          PolicyException

Deprecated.

Replaces a policy object in the data store with the same policy name

Parameters:

policy - policy object to be added to the organization

Throws:

SSOException - invalid or expired single-sign-on token

NoPermissionException - user does not have sufficient privileges to replace policy

NameNotFoundException - policy with the same name does not exist.

InvalidFormatException - the provide policy from the data store has been corrupted or does not have a valid format

PolicyException - for any other abnormal condition.

removePolicy

public void removePolicy(String policyName)
                  throws SSOException,
                         NoPermissionException,
                         PolicyException

Deprecated.

Deletes a policy in the organization with the given name.

Parameters:

policyName - name of the policy to be deleted

Throws:

SSOException - invalid or expired single-sign-on token

NoPermissionException - user does not have sufficient privileges to remove policies

PolicyException - for any other abnormal condition

getResourceManager

public ResourceManager getResourceManager()

Deprecated.

Gets the ResourceManager object instance associated with this PolicyManager object instance

Returns:

ResourceManager object

getSubjectTypeManager

public SubjectTypeManager getSubjectTypeManager()

Deprecated.

Gets the SubjectTypeManager object instance associated with this PolicyManager object instance

Returns:

SubjectTypeManager object

getConditionTypeManager

public ConditionTypeManager getConditionTypeManager()

Deprecated.

Gets the ConditionTypeManager object instance associated with this PolicyManager object instance

Returns:

ConditionTypeManager object

getReferralTypeManager

public ReferralTypeManager getReferralTypeManager()

Deprecated.

Returns ReferralTypeManager associated with this policy manager.

Returns:

ReferralTypeManager associated with this policy manager.