issrg.pba
Interface PolicyParser

All Known Implementing Classes:
XMLPolicyParser

public interface PolicyParser

This interface defines the methods on the policy parser. The implementation objects should convert the policy into internal representation and return the internal representation in parts.

The policy is a PMI (Privilege Management Infrastructure) entity created by the SOA (Source of Authority; the owner of the Target) and which defines rules for accessing the target or targets. In particular, it contains parts defining domains of trust (what users can be trusted and how to establish the trust relationship) and defining target access rules (what the users of the domains can do on the targets). The interface defines the methods for retrieving the rules.

The parser also returns a map containing AuthTokenParser rules (the rules for the parser of authorisation tokens). The functionality of the AuthTokenParser depends on the policy because it must know what values can be interpreted by the policy.

Author:
A Otenko

Method Summary
 java.util.Map getAccessRules()
          This method returns a collection of rules for target access decision.
 java.util.Map getAssignmentRules()
          This method returns a collection of rules for delegation and assignment.
 java.util.Map getAuthTokenParsingRules()
          This method returns a set of Policy-dependant rules for the Authorisation Token parser.
 java.util.Vector getMSoDSet()
           
 java.lang.String getPolicyID()
          This method returns the ID of the Policy the parser has parsed.
 java.lang.String[] getRepositoryURLs()
          This method returns an array of URLs pointing to the repository with authorisation tokens, as specified in the policy.
 

Method Detail

getAssignmentRules

public java.util.Map getAssignmentRules()
This method returns a collection of rules for delegation and assignment.

Returns:
java.util.Map object with the rules; can be empty, but never null

getAccessRules

public java.util.Map getAccessRules()
This method returns a collection of rules for target access decision.

Returns:
java.util.Map object with the rules; can be empty, but never null

getAuthTokenParsingRules

public java.util.Map getAuthTokenParsingRules()
This method returns a set of Policy-dependant rules for the Authorisation Token parser.

Returns:
java.util.Map object that contains rules for extracting Credentials from a Token

getPolicyID

public java.lang.String getPolicyID()
This method returns the ID of the Policy the parser has parsed.

Returns:
the String representation of the identifier of the Policy

getRepositoryURLs

public java.lang.String[] getRepositoryURLs()
This method returns an array of URLs pointing to the repository with authorisation tokens, as specified in the policy. If the policy does not specify any repositories, null may be returned.

Returns:
String array of repository URLs

getMSoDSet

public java.util.Vector getMSoDSet()