Clover Coverage Report
Coverage timestamp: Sun Mar 23 2008 08:24:39 GMT
3   150   1   0.75
4   21   1.33   4
4     1  
1    
 
 
  PKCRepository       Line # 88 3 1 63.6% 0.6363636
 
  (1)
 
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    package issrg.security;
77   
78    import issrg.utils.repository.AttributeRepository;
79    import issrg.utils.repository.MultiRepository;
80    import issrg.utils.repository.RepositoryException;
81    import issrg.utils.repository.TokenLocator;
82   
83    /**
84    * This class is the interface to a repository of X.509 PKCs. It wraps an
85    * AttributeRepository to do the actual certificate retrieval.
86    */
87   
 
88    public class PKCRepository {
89   
90    private MultiRepository attributeRepository=null;
91   
92    /**
93    * This is the name of the userCertificate attribute, compatible with LDAPv3
94    * naming convention ("userCertificate").
95    * Assign a different name, if your repository does not support LDAPv3 naming.
96    */
97    public static String USER_PKC_ATTRIBUTE="userCertificate";
98   
99    /**
100    * This is the name of the caCertificate attribute, compatible with LDAPv3
101    * naming convention ("caCertificate").
102    * Assign a different name, if your repository does not support LDAPv3 naming.
103    */
104    public static String CA_PKC_ATTRIBUTE="caCertificate";
105   
 
106  0 toggle protected PKCRepository() {
107    }
108   
109    /**
110    * This constructor builds a PKCRepository given the AttributeRepository to
111    * retrieve the certificates from.
112    *
113    * @param ar - the AttributeRepository to retrieve the certificates from
114    */
 
115  4 toggle public PKCRepository (AttributeRepository ar){
116    // a MultiRepository is wrapped around arbitrary AttributeRepositories
117    // so that the attributes can be retrieved using TokenLocator efficiently
118  4 attributeRepository=ar==null?null: ar instanceof MultiRepository? (MultiRepository)ar: new MultiRepository(ar);
119    }
120   
121    /**
122    * This method returns the User Certificates given the TokenLocator, pointing
123    * to the entry of the principal in question. Note that unlike Principal,
124    * TokenLocator is a chain of primary and alternative locations, each
125    * applicable to a specific repository or the default repository. All
126    * locations in the chain are treated equally.
127    *
128    * @param subject - the TokenLocator indicating the entry with the
129    * certificates
130    */
 
131  1009 toggle public javax.naming.directory.Attribute getUserCertificate(TokenLocator subject) throws RepositoryException {
132  1009 return attributeRepository.getAttribute(subject, USER_PKC_ATTRIBUTE);
133    }
134   
135   
136    /**
137    * This method returns the CA Certificates given the TokenLocator, pointing
138    * to the entry of the principal in question. Note that unlike Principal,
139    * TokenLocator is a chain of primary and alternative locations, each
140    * applicable to a specific repository or the default repository. All
141    * locations in the chain are treated equally.
142    *
143    * @param subject - the TokenLocator indicating the entry with the
144    * certificates
145    */
 
146  0 toggle public javax.naming.directory.Attribute getCACertificate(TokenLocator subject) throws RepositoryException {
147  0 return attributeRepository.getAttribute(subject, CA_PKC_ATTRIBUTE);
148    }
149    }
150