X-Git-Url: http://www.project-moonshot.org/gitweb/?a=blobdiff_plain;f=saml%2FSAMLConfig.h;h=17c6c5ae78447888c19927f58d651030d174445b;hb=a30857e2c0f4bcd1817aa2939ffdc0856e93a533;hp=cd9dfa1e7f309e3f7ebea24a06f225766d62d6fc;hpb=be0b6f800ddf54b62d31342576c917b4fb59533c;p=shibboleth%2Fcpp-opensaml.git diff --git a/saml/SAMLConfig.h b/saml/SAMLConfig.h index cd9dfa1..17c6c5a 100644 --- a/saml/SAMLConfig.h +++ b/saml/SAMLConfig.h @@ -1,102 +1,201 @@ -/* - * Copyright 2001-2006 Internet2 - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -/** - * @file SAMLConfig.h - * - * Library configuration - */ - -#ifndef __saml_config_h__ -#define __saml_config_h__ - -#include -#include -#include - -#include - -/** - * @namespace opensaml - * Common classes for OpenSAML library - */ -namespace opensaml { - - /** - * Singleton object that manages library startup/shutdown.configuration. - */ - class SAML_API SAMLConfig - { - MAKE_NONCOPYABLE(SAMLConfig); - public: - virtual ~SAMLConfig() {} - - /** - * Returns the global configuration object for the library. - * - * @return reference to the global library configuration object - */ - static SAMLConfig& getConfig(); - - /** - * Initializes library - * - * Each process using the library MUST call this function exactly once - * before using any library classes. - * - * @return true iff initialization was successful - */ - virtual bool init()=0; - - /** - * Shuts down library - * - * Each process using the library SHOULD call this function exactly once - * before terminating itself - */ - virtual void term()=0; - - /** - * Generate random information using the underlying security library - * - * @param buf buffer for the information - * @param len number of bytes to write into buffer - */ - virtual void generateRandomBytes(void* buf, unsigned int len)=0; - - /** - * Generate random information using the underlying security library - * - * @param buf string buffer for the information - * @param len number of bytes to write into buffer - */ - virtual void generateRandomBytes(std::string& buf, unsigned int len)=0; - - /** - * Generate a valid XML identifier of the form _X{32} where X is a - * random hex character. The caller is responsible for freeing the result. - * - * @return a valid null-terminated XML ID - */ - virtual XMLCh* generateIdentifier()=0; - - protected: - SAMLConfig() {} - }; - -}; - -#endif /* __saml_config_h__ */ +/* + * Copyright 2001-2006 Internet2 + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @file saml/SAMLConfig.h + * + * Library configuration + */ + +#ifndef __saml_config_h__ +#define __saml_config_h__ + +#include + +#include +#include + +#include + +/** + * @namespace opensaml + * Common classes for OpenSAML library + */ +namespace opensaml { + + class SAML_API ArtifactMap; + class SAML_API MessageEncoder; + class SAML_API MessageDecoder; + class SAML_API SAMLArtifact; + class SAML_API SecurityPolicyRule; + class SAML_API URLEncoder; + + namespace saml2md { + class SAML_API MetadataProvider; + class SAML_API MetadataFilter; + }; + +#if defined (_MSC_VER) + #pragma warning( push ) + #pragma warning( disable : 4250 4251 ) +#endif + + /** + * Singleton object that manages library startup/shutdown.configuration. + */ + class SAML_API SAMLConfig + { + MAKE_NONCOPYABLE(SAMLConfig); + public: + virtual ~SAMLConfig() {} + + /** + * Returns the global configuration object for the library. + * + * @return reference to the global library configuration object + */ + static SAMLConfig& getConfig(); + + /** + * Initializes library + * + * Each process using the library MUST call this function exactly once + * before using any library classes. The flag controls whether this is the + * "dominant" library or not and can allow the SAML library to be loaded + * as an extension of XMLTooling rather than subsuming it. + * + * @param initXMLTooling true iff this method should initialize the XMLTooling layer + * @return true iff initialization was successful + */ + virtual bool init(bool initXMLTooling=true)=0; + + /** + * Shuts down library + * + * Each process using the library SHOULD call this function exactly once + * before terminating itself. The flag controls whether this is the + * "dominant" library or not and can allow the SAML library to be loaded + * as an extension of XMLTooling rather than subsuming it. + * + * @param termXMLTooling true iff this method should shutdown the XMLTooling layer + */ + virtual void term(bool termXMLTooling=true)=0; + + /** + * Sets the global ArtifactMap instance. + * This method must be externally synchronized with any code that uses the object. + * Any previously set object is destroyed. + * + * @param artifactMap new ArtifactMap instance to store + */ + void setArtifactMap(ArtifactMap* artifactMap); + + /** + * Returns the global ArtifactMap instance. + * + * @return global ArtifactMap or NULL + */ + ArtifactMap* getArtifactMap() const { + return m_artifactMap; + } + + /** + * Sets the global URLEncoder instance. + * This method must be externally synchronized with any code that uses the object. + * Any previously set object is destroyed. + * + * @param urlEncoder new URLEncoder instance to store + */ + void setURLEncoder(URLEncoder* urlEncoder); + + /** + * Returns the global URLEncoder instance. + * + * @return global URLEncoder or NULL + */ + URLEncoder* getURLEncoder() const { + return m_urlEncoder; + } + + /** + * Generate random information using the underlying security library + * + * @param buf buffer for the information + * @param len number of bytes to write into buffer + */ + virtual void generateRandomBytes(void* buf, unsigned int len)=0; + + /** + * Generate random information using the underlying security library + * + * @param buf string buffer for the information + * @param len number of bytes to write into buffer + */ + virtual void generateRandomBytes(std::string& buf, unsigned int len)=0; + + /** + * Generate a valid XML identifier of the form _X{32} where X is a + * random hex character. The caller is responsible for freeing the result. + * + * @return a valid null-terminated XML ID + */ + virtual XMLCh* generateIdentifier()=0; + + /** + * Generate the SHA-1 hash of a string + * + * @param s NULL-terminated string to hash + * @param toHex true iff the result should be encoded in hexadecimal form or left as raw bytes + * + * @return SHA-1 hash of the data + */ + virtual std::string hashSHA1(const char* s, bool toHex=false)=0; + + /** Manages factories for MessageDecoder plugins. */ + xmltooling::PluginManager MessageDecoderManager; + + /** Manages factories for MessageEncoder plugins. */ + xmltooling::PluginManager MessageEncoderManager; + + /** Manages factories for SAMLArtifact plugins. */ + xmltooling::PluginManager SAMLArtifactManager; + + /** Manages factories for SecurityPolicyRule plugins. */ + xmltooling::PluginManager SecurityPolicyRuleManager; + + /** Manages factories for MetadataProvider plugins. */ + xmltooling::PluginManager MetadataProviderManager; + + /** Manages factories for MetadataFilter plugins. */ + xmltooling::PluginManager MetadataFilterManager; + + protected: + SAMLConfig() : m_artifactMap(NULL), m_urlEncoder(NULL) {} + + /** Global ArtifactMap instance for use by artifact-related functions. */ + ArtifactMap* m_artifactMap; + + /** Global URLEncoder instance for use by URL-related functions. */ + URLEncoder* m_urlEncoder; + }; + +#if defined (_MSC_VER) + #pragma warning( pop ) +#endif + +}; + +#endif /* __saml_config_h__ */