www.project-moonshot.org Git - mech_eap.orig/blob - util_saml.h

   1 /*
   2  * Copyright (c) 2011, JANET(UK)
   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
   7  * are met:
   8  *
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  *
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  *
  16  * 3. Neither the name of JANET(UK) nor the names of its contributors
  17  *    may be used to endorse or promote products derived from this software
  18  *    without specific prior written permission.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30  * SUCH DAMAGE.
  31  */
  32
  33 /*
  34  * SAML attribute provider.
  35  */
  36
  37 #ifndef _UTIL_SAML_H_
  38 #define _UTIL_SAML_H_ 1
  39
  40 #ifdef __cplusplus
  41
  42 namespace opensaml {
  43     namespace saml2 {
  44         class Attribute;
  45         class Assertion;
  46         class NameID;
  47     };
  48 };
  49
  50 struct gss_eap_saml_assertion_provider : gss_eap_attr_provider {
  51 public:
  52     gss_eap_saml_assertion_provider(void);
  53     ~gss_eap_saml_assertion_provider(void);
  54
  55     bool initFromExistingContext(const gss_eap_attr_ctx *source,
  56                                  const gss_eap_attr_provider *ctx);
  57     bool initFromGssContext(const gss_eap_attr_ctx *source,
  58                             const gss_cred_id_t cred,
  59                             const gss_ctx_id_t ctx);
  60
  61     bool getAttributeTypes(gss_eap_attr_enumeration_cb, void *data) const;
  62     bool setAttribute(int complete,
  63                       const gss_buffer_t attr,
  64                       const gss_buffer_t value);
  65     bool deleteAttribute(const gss_buffer_t value);
  66     bool getAttribute(const gss_buffer_t attr,
  67                       int *authenticated,
  68                       int *complete,
  69                       gss_buffer_t value,
  70                       gss_buffer_t display_value,
  71                       int *more) const;
  72     gss_any_t mapToAny(int authenticated,
  73                        gss_buffer_t type_id) const;
  74     void releaseAnyNameMapping(gss_buffer_t type_id,
  75                                gss_any_t input) const;
  76
  77     const char *prefix(void) const;
  78     const char *marshallingKey(void) const {
  79         return NULL;
  80     }
  81     bool unmarshallAndInit(const gss_eap_attr_ctx *manager GSSEAP_UNUSED,
  82                            DDF &object GSSEAP_UNUSED) {
  83         return false;
  84     }
  85     DDF marshall(void) const {
  86         return DDF(NULL);
  87     }
  88
  89     opensaml::saml2::Assertion *initAssertion(void);
  90
  91     opensaml::saml2::Assertion *getAssertion(void) const {
  92         return m_assertion;
  93     }
  94     bool authenticated(void) const {
  95         return m_authenticated;
  96     }
  97
  98     time_t getExpiryTime(void) const;
  99     OM_uint32 mapException(OM_uint32 *minor, std::exception &e) const;
 100
 101     static bool init(void);
 102     static void finalize(void);
 103
 104     static gss_eap_attr_provider *createAttrContext(void);
 105
 106 private:
 107     static opensaml::saml2::Assertion *
 108         parseAssertion(const gss_buffer_t buffer);
 109
 110     void setAssertion(const opensaml::saml2::Assertion *assertion,
 111                       bool authenticated = false);
 112     void setAssertion(const gss_buffer_t buffer,
 113                       bool authenticated = false);
 114
 115     opensaml::saml2::Assertion *m_assertion;
 116     bool m_authenticated;
 117 };
 118
 119 struct gss_eap_saml_attr_provider : gss_eap_attr_provider {
 120 public:
 121     gss_eap_saml_attr_provider(void) {}
 122     ~gss_eap_saml_attr_provider(void) {}
 123
 124     bool getAttributeTypes(gss_eap_attr_enumeration_cb, void *data) const;
 125     bool setAttribute(int complete,
 126                       const gss_buffer_t attr,
 127                       const gss_buffer_t value);
 128     bool deleteAttribute(const gss_buffer_t value);
 129     bool getAttribute(const gss_buffer_t attr,
 130                       int *authenticated,
 131                       int *complete,
 132                       gss_buffer_t value,
 133                       gss_buffer_t display_value,
 134                       int *more) const;
 135     gss_any_t mapToAny(int authenticated,
 136                        gss_buffer_t type_id) const;
 137     void releaseAnyNameMapping(gss_buffer_t type_id,
 138                                gss_any_t input) const;
 139
 140 <<<<<<< HEAD
 141 <<<<<<< HEAD
 142     const char *prefix(void) const;
 143
 144     void exportToBuffer(gss_buffer_t buffer) const;
 145     bool initFromBuffer(const gss_eap_attr_ctx *ctx,
 146                         const gss_buffer_t buffer);
 147 =======
 148     bool unmarshallAndInit(const gss_eap_attr_ctx *manager,
 149                            DDF &object GSSEAP_UNUSED);
 150     DDF marshall(void) const;
 151 >>>>>>> 1ef293a... in progress use DDF to serialise names
 152 =======
 153     const char *marshallingKey(void) const {
 154         return NULL;
 155     }
 156     bool unmarshallAndInit(const gss_eap_attr_ctx *manager GSSEAP_UNUSED,
 157                            DDF &object GSSEAP_UNUSED) {
 158         return false;
 159     }
 160     DDF marshall(void) const {
 161         return DDF(NULL);
 162     }
 163 >>>>>>> eef7b3b... get DDF marshalling working
 164
 165     bool getAttribute(const gss_buffer_t attr,
 166                       int *authenticated,
 167                       int *complete,
 168                       const opensaml::saml2::Attribute **pAttribute) const;
 169     bool getAssertion(int *authenticated,
 170                       opensaml::saml2::Assertion **pAssertion,
 171                       bool createIfAbsent = false) const;
 172
 173     static bool init(void);
 174     static void finalize(void);
 175
 176     static gss_eap_attr_provider *createAttrContext(void);
 177
 178 private:
 179 };
 180
 181 extern "C" {
 182 #endif
 183
 184 OM_uint32 gssEapSamlAttrProvidersInit(OM_uint32 *minor);
 185 OM_uint32 gssEapSamlAttrProvidersFinalize(OM_uint32 *minor);
 186
 187 #ifdef __cplusplus
 188 }
 189 #endif
 190
 191 #endif /* _UTIL_SAML_H_ */