de.fraunhofer.iese.ind2uce.api.component.interfaces

Interface IPolicyDecisionPoint

All Superinterfaces:

IComponent, Serializable

public interface IPolicyDecisionPoint
extends IComponent

The PolicyDecisionPoint draws decisions based on the currently deployed policies.

Author:

Fraunhofer IESE

Method Summary

Modifier and Type	Method and Description
boolean	addToBlacklist(List<EnforcementScopeId> ids)
boolean	clearAllCaches() Clears all caches of the PDP (response and connector caches).
AuthorizationDecision	decisionRequest(Event event) Notifies the PDP about a certain event.
boolean	deploy(String policy) Deploys a policy directly.
List<PolicyId>	listDeployedPolicies() Provides a list of currently deployed policy names.
boolean	removeFromBlacklist(List<EnforcementScopeId> ids)
boolean	revokePolicy(PolicyId policyId) Revokes a policy.
Map<Event,AuthorizationDecision>	timerDecisionRequest(List<Event> events)

Methods inherited from interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IComponent

getHealth, getId, initialize, reset

Method Detail

clearAllCaches

boolean clearAllCaches()
                throws IOException

Clears all caches of the PDP (response and connector caches).

Returns:

true, if cache was cleaned

Throws:

IOException - if there occurs a connection problem.

decisionRequest

AuthorizationDecision decisionRequest(Event event)
                               throws IOException,
                                      IllegalArgumentException,
                                      EvaluationUndecidableException

Notifies the PDP about a certain event. Based on the events, the policies are evaluated and decision is drawn.

Parameters:

event - the occurred event

Returns:

the AuthorizationDecision with respect to the event and deployed policies

Throws:

IOException - if there occurs a connection problem.

IllegalArgumentException - if event is semantically invalid

EvaluationUndecidableException - if PDP can't evaluate the event due to internal ambiguity.

deploy

boolean deploy(String policy)
        throws IOException,
               IllegalArgumentException,
               ConflictingPolicyException

Deploys a policy directly.

Parameters:

policy - the policy in XML format

Returns:

true if the policy is deployed, false otherwise

Throws:

IOException - if there occurs a connection problem.

IllegalArgumentException - if policyId is syntactically invalid

ConflictingPolicyException - if multiple policy with same id are found in PMP

listDeployedPolicies

List<PolicyId> listDeployedPolicies()
                             throws IOException

Provides a list of currently deployed policy names.

Returns:

list of currently deployed policy names

Throws:

IOException - if there occurs a connection problem.

revokePolicy

boolean revokePolicy(PolicyId policyId)
              throws IOException,
                     IllegalArgumentException,
                     PolicyRevokationException

Revokes a policy.

Parameters:

policyId - the name of the policy to be revoked

Returns:

true if the policy is revoked, false otherwise

Throws:

IOException - if there occurs a connection problem.

IllegalArgumentException - if policyId is syntactically invalid

PolicyRevokationException - fails to revoke the policy

addToBlacklist

boolean addToBlacklist(List<EnforcementScopeId> ids)
                throws IOException

Throws:

IOException

removeFromBlacklist

boolean removeFromBlacklist(List<EnforcementScopeId> ids)
                     throws IOException

Throws:

IOException

timerDecisionRequest

Map<Event,AuthorizationDecision> timerDecisionRequest(List<Event> events)
                                               throws IOException,
                                                      EvaluationUndecidableException

Throws:

IOException

EvaluationUndecidableException