Clover Coverage Report
Coverage timestamp: Sun Mar 23 2008 08:24:39 GMT
4   134   1   1
0   20   1   4
4     1  
1    
 
 
  ShibbolethURLHandler       Line # 97 4 1 75% 0.75
 
No Tests
 
1    /*
2    * Copyright (c) 2000-2005, University of Salford
3    * All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without
6    * modification, are permitted provided that the following conditions are met:
7    *
8    * Redistributions of source code must retain the above copyright notice, this
9    * list of conditions and the following disclaimer.
10    *
11    * Redistributions in binary form must reproduce the above copyright notice,
12    * this list of conditions and the following disclaimer in the documentation
13    * and/or other materials provided with the distribution.
14    *
15    * Neither the name of the University of Salford nor the names of its
16    * contributors may be used to endorse or promote products derived from this
17    * software without specific prior written permission.
18    *
19    * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20    * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21    * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22    * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23    * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24    * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25    * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26    * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27    * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28    * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29    * POSSIBILITY OF SUCH DAMAGE.
30    */
31    /*
32    * Copyright (c) 2006, University of Kent
33    * All rights reserved.
34    *
35    * Redistribution and use in source and binary forms, with or without
36    * modification, are permitted provided that the following conditions are met:
37    *
38    * Redistributions of source code must retain the above copyright notice, this
39    * list of conditions and the following disclaimer.
40    *
41    * Redistributions in binary form must reproduce the above copyright notice,
42    * this list of conditions and the following disclaimer in the documentation
43    * and/or other materials provided with the distribution.
44    *
45    * 1. Neither the name of the University of Kent nor the names of its
46    * contributors may be used to endorse or promote products derived from this
47    * software without specific prior written permission.
48    *
49    * 2. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
50    * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
51    * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
52    * PURPOSE ARE DISCLAIMED.
53    *
54    * 3. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
55    * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
56    * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
57    * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
58    * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
59    * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
60    * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
61    * POSSIBILITY OF SUCH DAMAGE.
62    *
63    * 4. YOU AGREE THAT THE EXCLUSIONS IN PARAGRAPHS 2 AND 3 ABOVE ARE REASONABLE
64    * IN THE CIRCUMSTANCES. IN PARTICULAR, YOU ACKNOWLEDGE (1) THAT THIS
65    * SOFTWARE HAS BEEN MADE AVAILABLE TO YOU FREE OF CHARGE, (2) THAT THIS
66    * SOFTWARE IS NOT "PRODUCT" QUALITY, BUT HAS BEEN PRODUCED BY A RESEARCH
67    * GROUP WHO DESIRE TO MAKE THIS SOFTWARE FREELY AVAILABLE TO PEOPLE WHO WISH
68    * TO USE IT, AND (3) THAT BECAUSE THIS SOFTWARE IS NOT OF "PRODUCT" QUALITY
69    * IT IS INEVITABLE THAT THERE WILL BE BUGS AND ERRORS, AND POSSIBLY MORE
70    * SERIOUS FAULTS, IN THIS SOFTWARE.
71    *
72    * 5. This license is governed, except to the extent that local laws
73    * necessarily apply, by the laws of England and Wales.
74    *
75    */
76   
77    package issrg.shibboleth;
78   
79    import issrg.pba.rbac.URLHandler;
80    import issrg.pba.rbac.BadURLException;
81    import issrg.pba.rbac.policies.Subtree;
82    import java.security.Principal;
83   
84    /**
85    * This class handles URLs with "shib:" protocol. These are normally used in
86    * PERMIS Policy to refer to Shibboleth Identity Provider sites in SOAPolicy.
87    *
88    * <p>E.g.&nbsp;"shib:kent.ac.uk" is an identifier of "kent.ac.uk" IdP, which
89    * will appear in attribute statements as the scope of the attribute.
90    *
91    * <p>This URLHandler knows how to construct Principals from a URL. It doesn't
92    * construct Subtrees, as Shibboleth URLs are not used to define subtrees in
93    * subject or target domains, and the subtree semantics are not defined.
94    * Shibboleth URLs are not used to construct Repositories, either, so
95    * Repository cannot be constructed.
96    */
 
97    public class ShibbolethURLHandler extends URLHandler {
98    public static final String SHIBBOLETH_PROTOCOL = "shib";
99   
 
100  1 toggle public ShibbolethURLHandler(){
101  1 super(SHIBBOLETH_PROTOCOL, -1);
102    }
103   
104    /**
105    * This method returns the protocol of the URLs that can be handled.
106    *
107    * @return SHIBBOLETH_PROTOCOL, which is "shib".
108    */
 
109  1 toggle public String getProtocol(){
110  1 return SHIBBOLETH_PROTOCOL;
111    }
112   
113    /**
114    * This method constructs a ShibbolethPrincipal from a URL. The attribute
115    * part of the URL is ignored, if present.
116    *
117    * @param url - the URL identifying a issuer of some attributes
118    *
119    * @return ShibbolethPrincipal
120    */
 
121  2 toggle public Principal getPrincipal(String url) throws BadURLException {
122  2 return new ShibbolethPrincipal(url);
123    }
124   
125    // getEntry method operates in the same manner, as in URLHandler: (Entry)getPrincipal()
126   
127    /**
128    * This method always returns null, as Subtrees cannot be constructed from
129    * Shibboleth URLs.
130    */
 
131  0 toggle public Subtree getSubtree(String url, int min, int max, Subtree [] exclude) throws BadURLException {
132  0 return null;
133    }
134    }