Update copyright.
[shibboleth/cpp-xmltooling.git] / xmltooling / signature / KeyInfo.h
1 /*
2  *  Copyright 2001-2007 Internet2
3  * 
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *     http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 /**
18  * @file xmltooling/signature/KeyInfo.h
19  * 
20  * XMLObjects representing XML Digital Signature, version 20020212, KeyInfo element
21  * and related content.
22  */
23
24 #ifndef __xmltooling_keyinfo_h__
25 #define __xmltooling_keyinfo_h__
26
27 #include <xmltooling/ElementProxy.h>
28 #include <xmltooling/XMLObjectBuilder.h>
29 #include <xmltooling/util/XMLConstants.h>
30
31 /**
32  * Macro for declaring signature builders.
33  * 
34  * @param cname name of class being built
35  */
36 #define DECL_XMLSIGOBJECTBUILDER(cname) \
37     DECL_XMLOBJECTBUILDER(XMLTOOL_API,cname,xmlconstants::XMLSIG_NS,xmlconstants::XMLSIG_PREFIX)
38
39 namespace xmlsignature {
40
41     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,KeyName,Name,XML Digital Signature version 20020212 KeyName element);
42     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,MgmtData,Data,XML Digital Signature version 20020212 MgmtData element);
43     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,Modulus,Value,XML Digital Signature version 20020212 Modulus element);
44     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,Exponent,Value,XML Digital Signature version 20020212 Exponent element);
45     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,Seed,Value,XML Digital Signature version 20020212 Seed element);
46     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,PgenCounter,Value,XML Digital Signature version 20020212 PgenCounter element);
47     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,P,Value,XML Digital Signature version 20020212 P element);
48     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,Q,Value,XML Digital Signature version 20020212 Q element);
49     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,G,Value,XML Digital Signature version 20020212 G element);
50     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,Y,Value,XML Digital Signature version 20020212 Y element);
51     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,J,Value,XML Digital Signature version 20020212 J element);
52     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,XPath,Expression,XML Digital Signature version 20020212 XPath element);
53     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,X509IssuerName,Name,XML Digital Signature version 20020212 X509IssuerName element);
54     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,X509SerialNumber,SerialNumber,XML Digital Signature version 20020212 X509SerialNumber element);
55     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,X509SKI,Value,XML Digital Signature version 20020212 X509SKI element);
56     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,X509SubjectName,Name,XML Digital Signature version 20020212 X509SubjectName element);
57     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,X509Certificate,Value,XML Digital Signature version 20020212 X509Certificate element);
58     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,X509CRL,Value,XML Digital Signature version 20020212 X509CRL element);
59     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,SPKISexp,Value,XML Digital Signature version 20020212 SPKISexp element);
60     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,PGPKeyID,ID,XML Digital Signature version 20020212 PGPKeyID element);
61     DECL_XMLOBJECT_SIMPLE(XMLTOOL_API,PGPKeyPacket,Packet,XML Digital Signature version 20020212 PGPKeyPacket element);
62
63     BEGIN_XMLOBJECT(XMLTOOL_API,DSAKeyValue,xmltooling::XMLObject,XML Digital Signature version 20020212 DSAKeyValue element);
64         DECL_TYPED_CHILD(P);
65         DECL_TYPED_CHILD(Q);
66         DECL_TYPED_CHILD(G);
67         DECL_TYPED_CHILD(Y);
68         DECL_TYPED_CHILD(J);
69         DECL_TYPED_CHILD(Seed);
70         DECL_TYPED_CHILD(PgenCounter);
71         /** DSAKeyValueType local name */
72         static const XMLCh TYPE_NAME[];
73     END_XMLOBJECT;
74
75     BEGIN_XMLOBJECT(XMLTOOL_API,RSAKeyValue,xmltooling::XMLObject,XML Digital Signature version 20020212 RSAKeyValue element);
76         DECL_TYPED_CHILD(Modulus);
77         DECL_TYPED_CHILD(Exponent);
78         /** RSAKeyValueType local name */
79         static const XMLCh TYPE_NAME[];
80     END_XMLOBJECT;
81
82     BEGIN_XMLOBJECT(XMLTOOL_API,KeyValue,xmltooling::XMLObject,XML Digital Signature version 20020212 KeyValue element);
83         DECL_TYPED_CHILD(DSAKeyValue);
84         DECL_TYPED_CHILD(RSAKeyValue);
85         DECL_XMLOBJECT_CHILD(UnknownXMLObject);
86         /** KeyValueType local name */
87         static const XMLCh TYPE_NAME[];
88     END_XMLOBJECT;
89
90     BEGIN_XMLOBJECT(XMLTOOL_API,Transform,xmltooling::ElementExtensibleXMLObject,XML Digital Signature version 20020212 Transform element);
91         DECL_STRING_ATTRIB(Algorithm,ALGORITHM);
92         DECL_TYPED_CHILDREN(XPath);
93         /** TransformType local name */
94         static const XMLCh TYPE_NAME[];
95     END_XMLOBJECT;
96
97     BEGIN_XMLOBJECT(XMLTOOL_API,Transforms,xmltooling::XMLObject,XML Digital Signature version 20020212 Transforms element);
98         DECL_TYPED_CHILDREN(Transform);
99         /** TransformsType local name */
100         static const XMLCh TYPE_NAME[];
101     END_XMLOBJECT;
102
103     BEGIN_XMLOBJECT(XMLTOOL_API,RetrievalMethod,xmltooling::XMLObject,XML Digital Signature version 20020212 RetrievalMethod element);
104         DECL_STRING_ATTRIB(URI,URI);
105         DECL_STRING_ATTRIB(Type,TYPE);
106         DECL_TYPED_CHILD(Transforms);
107         /** RetrievalMethodType local name */
108         static const XMLCh TYPE_NAME[];
109         /** DSAKeyValue RetrievalMethod Type */
110         static const XMLCh TYPE_DSAKEYVALUE[];
111         /** RSAKeyValue RetrievalMethod Type */
112         static const XMLCh TYPE_RSAKEYVALUE[];
113         /** X509Data RetrievalMethod Type */
114         static const XMLCh TYPE_X509DATA[];
115     END_XMLOBJECT;
116
117     BEGIN_XMLOBJECT(XMLTOOL_API,X509IssuerSerial,xmltooling::XMLObject,XML Digital Signature version 20020212 X509IssuerSerial element);
118         DECL_TYPED_CHILD(X509IssuerName);
119         DECL_TYPED_CHILD(X509SerialNumber);
120         /** X509IssuerSerialType local name */
121         static const XMLCh TYPE_NAME[];
122     END_XMLOBJECT;
123
124     BEGIN_XMLOBJECT(XMLTOOL_API,X509Data,xmltooling::ElementExtensibleXMLObject,XML Digital Signature version 20020212 X509Data element);
125         DECL_TYPED_CHILDREN(X509IssuerSerial);
126         DECL_TYPED_CHILDREN(X509SKI);
127         DECL_TYPED_CHILDREN(X509SubjectName);
128         DECL_TYPED_CHILDREN(X509Certificate);
129         DECL_TYPED_CHILDREN(X509CRL);
130         /** X509DataType local name */
131         static const XMLCh TYPE_NAME[];
132     END_XMLOBJECT;
133
134     BEGIN_XMLOBJECT(XMLTOOL_API,SPKIData,xmltooling::XMLObject,XML Digital Signature version 20020212 SPKIData element);
135         /** SPKIDataType local name */
136         static const XMLCh TYPE_NAME[];
137         
138         /** Returns modifiable collection of SPKIsexp/XMLObject pairs. */
139         virtual VectorOfPairs(SPKISexp,xmltooling::XMLObject) getSPKISexps()=0;
140         
141         /** Returns reference to immutable collection of SPKIsexp/XMLObject pairs. */
142         virtual const std::vector< std::pair<SPKISexp*,xmltooling::XMLObject*> >& getSPKISexps() const=0;
143     END_XMLOBJECT;
144
145     BEGIN_XMLOBJECT(XMLTOOL_API,PGPData,xmltooling::ElementExtensibleXMLObject,XML Digital Signature version 20020212 PGPData element);
146         DECL_TYPED_CHILD(PGPKeyID);
147         DECL_TYPED_CHILD(PGPKeyPacket);
148         /** PGPDataType local name */
149         static const XMLCh TYPE_NAME[];
150     END_XMLOBJECT;
151
152     BEGIN_XMLOBJECT(XMLTOOL_API,KeyInfo,xmltooling::ElementExtensibleXMLObject,XML Digital Signature version 20020212 KeyInfo element);
153         DECL_STRING_ATTRIB(Id,ID);
154         DECL_TYPED_CHILDREN(X509Data);
155         DECL_TYPED_CHILDREN(KeyName);
156         DECL_TYPED_CHILDREN(KeyValue);
157         DECL_TYPED_CHILDREN(RetrievalMethod);
158         DECL_TYPED_CHILDREN(MgmtData);
159         DECL_TYPED_CHILDREN(PGPData);
160         DECL_TYPED_CHILDREN(SPKIData);
161         /** KeyInfoType local name */
162         static const XMLCh TYPE_NAME[];
163     END_XMLOBJECT;
164
165     DECL_XMLSIGOBJECTBUILDER(PGPData);
166     DECL_XMLSIGOBJECTBUILDER(PGPKeyID);
167     DECL_XMLSIGOBJECTBUILDER(PGPKeyPacket);
168     DECL_XMLSIGOBJECTBUILDER(SPKIData);
169     DECL_XMLSIGOBJECTBUILDER(SPKISexp);
170     DECL_XMLSIGOBJECTBUILDER(X509IssuerSerial);
171     DECL_XMLSIGOBJECTBUILDER(X509IssuerName);
172     DECL_XMLSIGOBJECTBUILDER(X509SerialNumber);
173     DECL_XMLSIGOBJECTBUILDER(X509SKI);
174     DECL_XMLSIGOBJECTBUILDER(X509SubjectName);
175     DECL_XMLSIGOBJECTBUILDER(X509Certificate);
176     DECL_XMLSIGOBJECTBUILDER(X509CRL);
177     DECL_XMLSIGOBJECTBUILDER(X509Data);
178     DECL_XMLSIGOBJECTBUILDER(XPath);
179     DECL_XMLSIGOBJECTBUILDER(Transform);
180     DECL_XMLSIGOBJECTBUILDER(Transforms);
181     DECL_XMLSIGOBJECTBUILDER(RetrievalMethod);
182     DECL_XMLSIGOBJECTBUILDER(KeyName);
183     DECL_XMLSIGOBJECTBUILDER(MgmtData);
184     DECL_XMLSIGOBJECTBUILDER(Modulus);
185     DECL_XMLSIGOBJECTBUILDER(Exponent);
186     DECL_XMLSIGOBJECTBUILDER(Seed);
187     DECL_XMLSIGOBJECTBUILDER(PgenCounter);
188     DECL_XMLSIGOBJECTBUILDER(P);
189     DECL_XMLSIGOBJECTBUILDER(Q);
190     DECL_XMLSIGOBJECTBUILDER(G);
191     DECL_XMLSIGOBJECTBUILDER(Y);
192     DECL_XMLSIGOBJECTBUILDER(J);
193     DECL_XMLSIGOBJECTBUILDER(DSAKeyValue);
194     DECL_XMLSIGOBJECTBUILDER(RSAKeyValue);
195     DECL_XMLSIGOBJECTBUILDER(KeyValue);
196     DECL_XMLSIGOBJECTBUILDER(KeyInfo);
197
198     /**
199      * Registers builders and validators for KeyInfo classes into the runtime.
200      */
201     void XMLTOOL_API registerKeyInfoClasses();
202
203 };
204
205 #endif /* __xmltooling_keyinfo_h__ */