rulecomparator.java

一个完整的XACML工程,学习XACML技术的好例子!

/*
* Copyright (c) 2006, University of Kent
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without 
* modification, are permitted provided that the following conditions are met:
*
* Redistributions of source code must retain the above copyright notice, this 
* list of conditions and the following disclaimer.
* 
* Redistributions in binary form must reproduce the above copyright notice, 
* this list of conditions and the following disclaimer in the documentation 
* and/or other materials provided with the distribution. 
*
* 1. Neither the name of the University of Kent nor the names of its 
* contributors may be used to endorse or promote products derived from this 
* software without specific prior written permission. 
*
* 2. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS  
* IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
* PURPOSE ARE DISCLAIMED. 
*
* 3. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
* POSSIBILITY OF SUCH DAMAGE.
*
* 4. YOU AGREE THAT THE EXCLUSIONS IN PARAGRAPHS 2 AND 3 ABOVE ARE REASONABLE
* IN THE CIRCUMSTANCES.  IN PARTICULAR, YOU ACKNOWLEDGE (1) THAT THIS
* SOFTWARE HAS BEEN MADE AVAILABLE TO YOU FREE OF CHARGE, (2) THAT THIS
* SOFTWARE IS NOT "PRODUCT" QUALITY, BUT HAS BEEN PRODUCED BY A RESEARCH
* GROUP WHO DESIRE TO MAKE THIS SOFTWARE FREELY AVAILABLE TO PEOPLE WHO WISH
* TO USE IT, AND (3) THAT BECAUSE THIS SOFTWARE IS NOT OF "PRODUCT" QUALITY
* IT IS INEVITABLE THAT THERE WILL BE BUGS AND ERRORS, AND POSSIBLY MORE
* SERIOUS FAULTS, IN THIS SOFTWARE.
*
* 5. This license is governed, except to the extent that local laws
* necessarily apply, by the laws of England and Wales.
*/

/*
 * Comparator.java
 *
 * Created on February 21, 2006, 9:51 AM
 */

package issrg.pba.rbac;

import issrg.pba.ParsedToken;
import issrg.pba.rbac.policies.AssignmentRule;
import java.util.Vector;


public interface RuleComparator {
     /**
     *This function will take the vector of asserted RARs of issuer, ignore unrelevant RARs for the assertion,
     * and sort relevant RARs according to the assertion
     *@param assertion is either a credentials or a RoleAssignmentRule of the holder that needs to be validated
     *@param tokens stores all the RARs of issuer
     *@param holder is the holder of the assertion credentials or the RoleAssignmentRule
     *@return an array of ParsedToken that is sorted according to the assertion.
     */
    
    public ParsedToken[] predict(Object assertion, Vector tokens, issrg.utils.repository.Entry holder);
    
    /**
     * This function test whether the constrained assertion is good enough
     *@param asRAR is the RoleAssignmentRule of the issuer
     *@param vaRAR is the validated RoleAssignmentRule of the issuer. Both of these RoleAssignmentRules may be null.
     *If they are null, it means RoleAssignmentRule of the issuer is totally trusted and we do not care about it.
     *@param assertion is either a credentials or a RoleAssignmentRule of the holder that needs to be validated
     *@param validated is a validated credentials or validated RoleAssignmentRules of the holder
     *@return a boolean value. If it is true then the issuer's RAR is good enough for validating the request and 
     *we do not need to use another issuer'RAR for validating the request. Otherwise, we need to use another RAR
     *to validate the request. Currently, this function simply return true.
     *
     */
    public boolean isSufficient(AssignmentRule asRAR, AssignmentRule vaRAR, Object assertion, Object validated);
    
}