saml/signature/ContentReference.h

   1 /*
   2  *  Copyright 2001-2009 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 saml/signature/ContentReference.h
  19  *
  20  * SAML-specific signature reference profile.
  21  */
  22
  23 #ifndef __saml_sigref_h__
  24 #define __saml_sigref_h__
  25
  26 #include <saml/base.h>
  27
  28 #include <set>
  29 #include <string>
  30 #ifdef HAVE_GOOD_STL
  31 # include <xmltooling/unicode.h>
  32 #endif
  33 #include <xmltooling/signature/ContentReference.h>
  34
  35 namespace xmltooling {
  36     class XMLTOOL_API Namespace;
  37     class XMLTOOL_API XMLObject;
  38 };
  39
  40 namespace opensaml {
  41
  42     class SAML_API SignableObject;
  43
  44 #if defined (_MSC_VER)
  45     #pragma warning( push )
  46     #pragma warning( disable : 4251 )
  47 #endif
  48
  49     /**
  50      * SAML-specific signature reference profile.
  51      */
  52     class SAML_API ContentReference : public virtual xmlsignature::ContentReference
  53     {
  54     public:
  55         /**
  56          * Constructor.
  57          *
  58          * @param signableObject    reference to object being signed
  59          */
  60         ContentReference(const SignableObject& signableObject);
  61
  62         virtual ~ContentReference();
  63
  64         /**
  65          * Given a "blank" native signature, creates signature reference
  66          * appropriate for the SAML object being signed.
  67          *
  68          * @param sig   native signature interface
  69          */
  70         virtual void createReferences(DSIGSignature* sig);
  71
  72         /**
  73          * Adds a namespace prefix for "inclusive" processing by an
  74          * Exclusive C14N Transform applied to the object.
  75          * An empty string will be transformed into "#default".
  76          *
  77          * @param prefix    the prefix to add
  78          */
  79         void addInclusivePrefix(const XMLCh* prefix);
  80
  81         /**
  82          * Sets the digest algorithm for the signature reference,
  83          * using a constant.
  84          *
  85          * @param digest    the digest algorithm
  86          */
  87         void setDigestAlgorithm(const XMLCh* digest);
  88
  89         /**
  90          * Sets the canonicalization method to include in the reference,
  91          * using a constant.
  92          *
  93          * @param c14n  the canonicalization method
  94          */
  95         void setCanonicalizationMethod(const XMLCh* c14n);
  96
  97     private:
  98         void addPrefixes(const std::set<xmltooling::Namespace>& namespaces);
  99         void addPrefixes(const xmltooling::XMLObject& xmlObject);
 100
 101         const SignableObject& m_signableObject;
 102 #ifdef HAVE_GOOD_STL
 103         std::set<xmltooling::xstring> m_prefixes;
 104 #else
 105         std::set<std::string> m_prefixes;
 106 #endif
 107         const XMLCh* m_digest;
 108         const XMLCh* m_c14n;
 109     };
 110
 111 #if defined (_MSC_VER)
 112     #pragma warning( pop )
 113 #endif
 114 };
 115
 116 #endif /* __saml_sigref_h__ */