X-Git-Url: http://www.project-moonshot.org/gitweb/?p=shibboleth%2Fresolver.git;a=blobdiff_plain;f=shibresolver%2Fresolver.h;fp=shibresolver%2Fresolver.h;h=610ea46ee98f0ac269f72b6d9a180069fb22bac1;hp=0000000000000000000000000000000000000000;hb=c8a04029bd704fc787bf953a0c99fd1c0b371e7c;hpb=754d6309bad0a25b5d2d26e63341a4dd2a7d0ca7

diff --git a/shibresolver/resolver.h b/shibresolver/resolver.h
new file mode 100644
index 0000000..610ea46
--- /dev/null
+++ b/shibresolver/resolver.h
@@ -0,0 +1,202 @@
+/*
+ *  Copyright 2010 JANET(UK)
+ *
+ * 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 shibresolver/resolver.h
+ *
+ * An embeddable component interface to Shibboleth SP attribute processing.
+ */
+
+#ifndef __shibresolver_h__
+#define __shibresolver_h__
+
+#include <shibresolver/base.h>
+
+#include <shibsp/RequestMapper.h>
+#include <shibsp/SPConfig.h>
+
+#include <string>
+#include <vector>
+
+namespace xmltooling {
+    class XMLTOOL_API XMLObject;
+};
+
+#ifndef SHIBSP_LITE
+namespace opensaml {
+    namespace saml2 {
+        class SAML_API Assertion;
+    };
+};
+#endif
+
+namespace shibsp {
+    class SHIBSP_API Attribute;
+};
+
+namespace shibresolver {
+
+#if defined (_MSC_VER)
+    #pragma warning( push )
+    #pragma warning( disable : 4250 4251 )
+#endif
+
+    /**
+     * An embeddable component interface to Shibboleth SP attribute processing.
+     */
+    class SHIBRESOLVER_API ShibbolethResolver
+    {
+        MAKE_NONCOPYABLE(ShibbolethResolver);
+    protected:
+        ShibbolethResolver();
+    public:
+        virtual ~ShibbolethResolver();
+
+        /**
+         * Sets the calling service URI, making the Shibboleth SP responsible for
+         * mapping the service to an Application instance.
+         *
+         * @param uri identifies the service performing attribute resolution
+         */
+        void setServiceURI(const char* uri);
+
+        /**
+         * Sets the application ID to use for resolution, bypassing the mapping
+         * function of the Shibboleth SP.
+         *
+         * @param appID identifies an application in the SP configuration
+         */
+        void setApplicationID(const char* appID);
+
+        /**
+         * Sets the identity issuer to use for resolution.
+         *
+         * @param issuer    entityID of the identity "source", if known
+         */
+        void setIssuer(const char* issuer);
+
+        /**
+         * Adds a SAML token as input to the resolver.
+         * <p>The caller retains ownership of the object.
+         *
+         * @param token an input token to evaluate
+         */
+        void addToken(
+#ifdef SHIBSP_LITE
+            const xmltooling::XMLObject* token
+#else
+            const opensaml::saml2::Assertion* token
+#endif
+            );
+
+        /**
+         * Adds an Attribute as input to the resolver.
+         * <p>The caller retains ownership of the object, but it MAY be modified
+         * during the resolution process.
+         *
+         * @param attr  an input Attribute
+         */
+        void addAttribute(shibsp::Attribute* attr);
+
+        /**
+         * Resolves Attributes and attaches them to the resolver object.
+         * <p>The caller is responsible for transferring any Attributes it wishes to
+         * retain out of the resolver.
+         */
+        virtual void resolve();
+
+        /**
+         * Returns a modifiable array of resolved Attribute objects.
+         * <p>The caller may take ownership of any or all by removing them
+         * from the array.
+         *
+         * @return  array of resolved Attributes
+         */
+        std::vector<shibsp::Attribute*>& getResolvedAttributes() const;
+
+        /**
+         * Returns mapped PropertySet and AccessControl objects, if any.
+         *
+         * @return  mapped PropertySet/AccesssControl pair
+         */
+        shibsp::RequestMapper::Settings getSettings() const;
+
+        /**
+         * Initializes SP runtime objects based on an XML configuration string or a configuration pathname.
+         * <p>Each process using the library MUST call this function exactly once before using any library classes.
+         *
+         * @param features  bitmask of SP components to enable
+         * @param config    a snippet of XML to parse (it <strong>MUST</strong> contain a type attribute) or a pathname
+         * @param rethrow   true iff caught exceptions should be rethrown instead of just returning a true/false result
+         * @return true iff initialization was successful
+         */
+        static bool init(
+#ifdef SHIBSP_LITE
+            unsigned long features = (shibsp::SPConfig::Listener|shibsp::SPConfig::InProcess),
+#else
+            unsigned long features = shibsp::SPConfig::OutOfProcess,
+#endif
+            const char* config = nullptr,
+            bool rethrow = false
+            );
+
+        /**
+         * Shuts down runtime.
+         *
+         * Each process using the library SHOULD call this function exactly once before terminating itself.
+         */
+        static void term();
+
+        /**
+         * Returns a ShibbolethResolver instance.
+         *
+         * @return  a ShibbolethResolver instance, must be freed by the caller.
+         */
+        static ShibbolethResolver* create();
+
+    protected:
+        /** Service URI */
+        std::string m_serviceURI;
+
+        /** Application ID. */
+        std::string m_appID;
+
+        /** Source of identity, if known. */
+        std::string m_issuer;
+
+        /** Input tokens. */
+#ifdef SHIBSP_LITE
+        std::vector<const xmltooling::XMLObject*> m_tokens;
+#else
+        std::vector<const opensaml::saml2::Assertion*> m_tokens;
+#endif
+        /** Input attributes. */
+        std::vector<shibsp::Attribute*> m_inputAttributes;
+
+    private:
+        shibsp::ServiceProvider* m_sp;
+        shibsp::RequestMapper* m_mapper;
+        shibsp::RequestMapper::Settings m_settings;
+        std::vector<shibsp::Attribute*> m_resolvedAttributes;
+    };
+
+#if defined (_MSC_VER)
+    #pragma warning( pop )
+#endif
+
+};
+
+#endif /* __shibresolver_h__ */