issrg.pba.rbac
Interface RoleHierarchyPolicy

All Known Implementing Classes:

XMLPolicyParser.RoleHierarchyPolicyNode

public interface RoleHierarchyPolicy

This interface provides the methods for enquiring the Role Hierarchy Policy. The users of the policy will normally only need to know how to convert the role OID into the type as it is specified in the policy (the authorisation tokens may contain an OID as the identifier of the role type, which is not human readable in the policy, and would probably be replaced by a human-readable string). The other thing the users may wish to know is the reference to the node representing the given role value of a particular type. The node can tell the hierarchical relationship to other nodes.

Author:

A.Otenko

Method Summary

RoleHierarchyNode	getRole(java.lang.String roleType, java.lang.String roleValue) This method returns a reference to the role in the hierarchy.
java.lang.String	getTypeByOID(java.lang.String roleOID) This method returns the type of the attribute corresponding to the given OID.
java.util.Map	getTypeOid() This method returns a hashtable that map between type and corresponding OID

Method Detail

getTypeByOID

java.lang.String getTypeByOID(java.lang.String roleOID)

This method returns the type of the attribute corresponding to the given OID. If the policy does not have the requested OID, the method should return null.

Parameters:

roleOID - is the requested OID in the dotted form

Returns:

the human-readable string used in the policy, and that should be used when getting a role hierarchy node

getTypeOid

java.util.Map getTypeOid()

This method returns a hashtable that map between type and corresponding OID

Returns:

a hashtable that map between type and corresponding OID

getRole

RoleHierarchyNode getRole(java.lang.String roleType,
                          java.lang.String roleValue)

This method returns a reference to the role in the hierarchy. The returned object can tell the hierarchical relationship to other nodes.

Parameters:

roleType - is the identifier of the role type in the policy

roleValue - is the value of the role to give the reference to

Returns:

the reference to the node, or null, if no such role is defined