de.fraunhofer.iese.ind2uce.pep

Class DefaultPolicyEnforcementPoint

java.lang.Object

de.fraunhofer.iese.ind2uce.pep.DefaultPolicyEnforcementPoint

All Implemented Interfaces:

de.fraunhofer.iese.ind2uce.api.component.interfaces.IComponent, de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint, Serializable

Direct Known Subclasses:

PolicyEnforcementPoint

public class DefaultPolicyEnforcementPoint
extends Object
implements de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint

This class should be used with Spring auto registration

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected de.fraunhofer.iese.ind2uce.connectors.OAuthCredentials	oauthClientCredentials
protected URI	pmpUrl

Constructor Summary

Constructors

Constructor and Description
DefaultPolicyEnforcementPoint(URI pmpUrl, DecisionEnforcer decisionEnforcer, de.fraunhofer.iese.ind2uce.connectors.OAuthCredentials oauthClientCredentials) Constructor

Method Summary

Modifier and Type	Method and Description
boolean	assurePDP() Make sure the PDP is available
void	enforce(de.fraunhofer.iese.ind2uce.api.policy.Event event) Publish the event and enforce the AuthorizationDecision to Event
void	enforceDecision(de.fraunhofer.iese.ind2uce.api.policy.Event event, de.fraunhofer.iese.ind2uce.api.policy.AuthorizationDecision authorizationDecision) Impose the AuthorizationDecision authorizationDecision on Event event.
de.fraunhofer.iese.ind2uce.api.policy.AuthorizationDecision	getDecision(de.fraunhofer.iese.ind2uce.api.policy.Event event) Fetch the AuthorizationDecision from PDP against the Event.
String	getHealth()
de.fraunhofer.iese.ind2uce.api.component.identifier.ComponentId	getId()
boolean	initialize(String... strings) Default initializer that establishes the connection to PDP.
de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyDecisionPoint	initPpdConnection() Initialize the PDP connection
boolean	reset() Reset the PDP connection.

Methods inherited from class java.lang.Object

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

Field Detail

oauthClientCredentials

protected final de.fraunhofer.iese.ind2uce.connectors.OAuthCredentials oauthClientCredentials

pmpUrl

protected URI pmpUrl

Constructor Detail

DefaultPolicyEnforcementPoint

public DefaultPolicyEnforcementPoint(URI pmpUrl,
                                     DecisionEnforcer decisionEnforcer,
                                     de.fraunhofer.iese.ind2uce.connectors.OAuthCredentials oauthClientCredentials)

Constructor

Parameters:

pmpUrl - pmp url

decisionEnforcer - concrete implementation of decisionEnforcer

oauthClientCredentials - OAuth Credentials

Method Detail

assurePDP

public boolean assurePDP()
                  throws IOException

Make sure the PDP is available

Returns:

true if the pdp is available.

Throws:

IOException - If connection could not be established.

enforce

public void enforce(de.fraunhofer.iese.ind2uce.api.policy.Event event)
             throws de.fraunhofer.iese.ind2uce.api.component.exception.EvaluationUndecidableException,
                    de.fraunhofer.iese.ind2uce.api.component.exception.InhibitException,
                    IOException

Publish the event and enforce the AuthorizationDecision to Event

Specified by:

enforce in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint

Parameters:

event - The event to publish.

Throws:

de.fraunhofer.iese.ind2uce.api.component.exception.EvaluationUndecidableException - if PDP can't decide.

de.fraunhofer.iese.ind2uce.api.component.exception.InhibitException - if event is not allowed

IOException - if connection to PDP is not established

enforceDecision

public void enforceDecision(de.fraunhofer.iese.ind2uce.api.policy.Event event,
                            de.fraunhofer.iese.ind2uce.api.policy.AuthorizationDecision authorizationDecision)
                     throws de.fraunhofer.iese.ind2uce.api.component.exception.InhibitException

Impose the AuthorizationDecision authorizationDecision on Event event.

Specified by:

enforceDecision in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint

Parameters:

event - on which authorizationDecision to be impose

authorizationDecision - the decision to enforce on event

Throws:

de.fraunhofer.iese.ind2uce.api.component.exception.InhibitException - if event is not allowed

getDecision

public de.fraunhofer.iese.ind2uce.api.policy.AuthorizationDecision getDecision(de.fraunhofer.iese.ind2uce.api.policy.Event event)
                                                                        throws de.fraunhofer.iese.ind2uce.api.component.exception.EvaluationUndecidableException,
                                                                               IOException

Fetch the AuthorizationDecision from PDP against the Event.

Specified by:

getDecision in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyEnforcementPoint

Parameters:

event - Event to send.

Returns:

The decision from PDP

Throws:

de.fraunhofer.iese.ind2uce.api.component.exception.EvaluationUndecidableException - if Event is not allowed.

IOException - if connection to pdp could not be established.

getId

public de.fraunhofer.iese.ind2uce.api.component.identifier.ComponentId getId()
                                                                      throws IOException

Specified by:

getId in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IComponent

Returns:

The id of the component.

Throws:

IOException - not used here

initialize

public boolean initialize(String... strings)
                   throws IOException

Default initializer that establishes the connection to PDP.

Specified by:

initialize in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IComponent

Parameters:

strings - not needed here.

Returns:

true, if connection could be established.

Throws:

IOException - If no connection could be established.

initPpdConnection

public de.fraunhofer.iese.ind2uce.api.component.interfaces.IPolicyDecisionPoint initPpdConnection()
                                                                                           throws IOException

Initialize the PDP connection

Returns:

The connection to PDP.

Throws:

IOException - If connection could not be established.

reset

public boolean reset()
              throws IOException

Reset the PDP connection.

Specified by:

reset in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IComponent

Returns:

true, if successful.

Throws:

IOException - if connection could not be reset.

getHealth

public String getHealth()
                 throws IOException

Specified by:

getHealth in interface de.fraunhofer.iese.ind2uce.api.component.interfaces.IComponent

Throws:

IOException