libsaml2-dev 2.5.3-2+deb8u2 / usr / include / saml / saml2 / core / Protocols.h

/**
 * Licensed to the University Corporation for Advanced Internet
 * Development, Inc. (UCAID) under one or more contributor license
 * agreements. See the NOTICE file distributed with this work for
 * additional information regarding copyright ownership.
 *
 * UCAID licenses this file to you 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/saml2/core/Protocols.h
 * 
 * XMLObjects representing the SAML 2.0 Protocols schema
 */

#ifndef __saml2_protocols_h__
#define __saml2_protocols_h__

#include <saml/saml2/core/Assertions.h>

#include <xercesc/util/XMLUniDefs.hpp>

#define DECL_SAML2POBJECTBUILDER(cname) \
    DECL_XMLOBJECTBUILDER(SAML_API,cname,samlconstants::SAML20P_NS,samlconstants::SAML20P_PREFIX)

namespace opensaml {

    /**
     * @namespace opensaml::saml2p
     * SAML 2.0 protocol namespace
     */
    namespace saml2p {

        DECL_XMLOBJECT_SIMPLE(SAML_API,Artifact,Artifact,SAML 2.0 Artifact element);
        DECL_XMLOBJECT_SIMPLE(SAML_API,GetComplete,GetComplete,SAML 2.0 GetComplete element);
        DECL_XMLOBJECT_SIMPLE(SAML_API,RequesterID,RequesterID,SAML 2.0 RequesterID element);
        DECL_XMLOBJECT_SIMPLE(SAML_API,SessionIndex,SessionIndex,SAML 2.0 SessionIndex element);
        DECL_XMLOBJECT_SIMPLE(SAML_API,StatusMessage,Message,SAML 2.0 StatusMessage element);

        DECL_XMLOBJECT_SIMPLE(SAML_API,RespondTo,Name,SAML 2.0 third-party request RespondTo extension element);

        BEGIN_XMLOBJECT(SAML_API,Asynchronous,xmltooling::XMLObject,SAML 2.0 Asynchronous logout extension element);
            /** AsynchronousType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,Extensions,xmltooling::ElementExtensibleXMLObject,SAML 2.0 protocol Extensions element);
            /** ExtensionsType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,RequestAbstractType,saml2::RootObject,SAML 2.0 RequestAbstractType base type);
            DECL_INHERITED_STRING_ATTRIB(ID,ID);
            DECL_INHERITED_STRING_ATTRIB(Version,VER);
            DECL_INHERITED_DATETIME_ATTRIB(IssueInstant,ISSUEINSTANT);
            DECL_STRING_ATTRIB(Destination,DESTINATION);
            DECL_STRING_ATTRIB(Consent,CONSENT);
            DECL_INHERITED_TYPED_FOREIGN_CHILD(Issuer,saml2);
            DECL_TYPED_CHILD(Extensions);
            /** RequestAbstractType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,StatusCode,xmltooling::XMLObject,SAML 2.0 StatusCode element);
            DECL_STRING_ATTRIB(Value,VALUE);
            DECL_TYPED_CHILD(StatusCode);
            /** StatusCodeType local name */
            static const XMLCh TYPE_NAME[];

            /**
              * @name StatusCode Value Attribute URI Reference Constants
              *
              * SAML 2.0 Core, section 3.2.2.2, predefines several URI
              * references for use in the Value attribue of the StatusCode
              * element.  Other values may be defined elsewhere.
              */
            /*@{*/
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:Success' */
            static const XMLCh SUCCESS[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:Requester' */
            static const XMLCh REQUESTER[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:Responder' */
            static const XMLCh RESPONDER[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:VersionMismatch' */
            static const XMLCh VERSION_MISMATCH[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:AuthnFailed' */
            static const XMLCh AUTHN_FAILED[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:InvalidAttrNameOrValue' */
            static const XMLCh INVALID_ATTR_NAME_OR_VALUE[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:InvalidNameIDPolicy' */
            static const XMLCh INVALID_NAMEID_POLICY[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:NoAuthnContext' */
            static const XMLCh NO_AUTHN_CONTEXT[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:NoAvailableIDP' */
            static const XMLCh NO_AVAILABLE_IDP[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:NoPassive' */
            static const XMLCh NO_PASSIVE[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:NoSupportedIDP' */
            static const XMLCh NO_SUPPORTED_IDP[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:PartialLogout' */
            static const XMLCh PARTIAL_LOGOUT[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:ProxyCountExceeded' */
            static const XMLCh PROXY_COUNT_EXCEEDED[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:RequestDenied' */
            static const XMLCh REQUEST_DENIED[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:RequestUnsupported' */
            static const XMLCh REQUEST_UNSUPPORTED[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:RequestVersionDeprecated' */
            static const XMLCh REQUEST_VERSION_DEPRECATED[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:RequestVersionTooHigh' */
            static const XMLCh REQUEST_VERSION_TOO_HIGH[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:RequestVersionTooLow' */
            static const XMLCh REQUEST_VERSION_TOO_LOW[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:ResourceNotRecognized' */
            static const XMLCh RESOURCE_NOT_RECOGNIZED[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:TooManyResponses' */
            static const XMLCh TOO_MANY_RESPONSES[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:UnknownAttrProfile' */
            static const XMLCh UNKNOWN_ATTR_PROFILE[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:UnknownPrincipal' */
            static const XMLCh UNKNOWN_PRINCIPAL[];
            /** StatusCode Value 'urn:oasis:names:tc:SAML:2.0:status:UnsupportedBinding' */
            static const XMLCh UNSUPPORTED_BINDING[];
            /*@{*/
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,StatusDetail,xmltooling::ElementExtensibleXMLObject,SAML 2.0 StatusDetail element);
            /** StatusDetailType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,Status,opensaml::Status,SAML 2.0 Status element);
            DECL_TYPED_CHILD(StatusCode);
            DECL_TYPED_CHILD(StatusMessage);
            DECL_TYPED_CHILD(StatusDetail);
            /** StatusType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,StatusResponseType,saml2::RootObject,SAML 2.0 StatusResponseType base type);
            DECL_INHERITED_STRING_ATTRIB(ID,ID);
            DECL_STRING_ATTRIB(InResponseTo,INRESPONSETO);
            DECL_INHERITED_STRING_ATTRIB(Version,VER);
            DECL_INHERITED_DATETIME_ATTRIB(IssueInstant,ISSUEINSTANT);
            DECL_STRING_ATTRIB(Destination,DESTINATION);
            DECL_STRING_ATTRIB(Consent,CONSENT);
            DECL_INHERITED_TYPED_FOREIGN_CHILD(Issuer,saml2);
            DECL_TYPED_CHILD(Extensions);
            DECL_TYPED_CHILD(Status);
            /** StatusResponseType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,AssertionIDRequest,RequestAbstractType,SAML 2.0 AssertionIDRequest element);
            DECL_TYPED_FOREIGN_CHILDREN(AssertionIDRef,saml2);
            /** AssertionIDRequest local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,SubjectQuery,RequestAbstractType,SAML 2.0 SubjectQuery abstract element);
            DECL_TYPED_FOREIGN_CHILD(Subject,saml2);
            /** SubjectQueryAbstractType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,RequestedAuthnContext,xmltooling::XMLObject,SAML 2.0 RequestedAuthnContext element);
            //TODO whether, and how, to enforce the controlled vocabulary (schema enumeration) for the Comparison attrib, as in the Java ? 
            DECL_STRING_ATTRIB(Comparison,COMPARISON);
            DECL_TYPED_FOREIGN_CHILDREN(AuthnContextClassRef,saml2);
            DECL_TYPED_FOREIGN_CHILDREN(AuthnContextDeclRef,saml2);
            /** RequestedAuthnContextType local name */
            static const XMLCh TYPE_NAME[];

            /**
             * @name RequestedAuthnContext Comparison Attribute Constants
             *
             * These are the allowed values for the Comparison attribute of
             * the RequestedAuthnContext element, as defined by SAML 2.0 Core.
             */
            /*@{*/
            /** 'exact' Comparison */
            static const XMLCh COMPARISON_EXACT[];
            /** 'minimum' Comparison */
            static const XMLCh COMPARISON_MINIMUM[];
            /** 'maximum' Comparison */
            static const XMLCh COMPARISON_MAXIMUM[];
            /** 'better' Comparison */
            static const XMLCh COMPARISON_BETTER[];
            /*@}*/
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,AuthnQuery,SubjectQuery,SAML 2.0 AuthnQuery element);
            DECL_STRING_ATTRIB(SessionIndex,SESSIONINDEX);
            DECL_TYPED_CHILD(RequestedAuthnContext);
            /** AuthnQueryType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,AttributeQuery,SubjectQuery,SAML 2.0 AttributeQuery element);
            DECL_TYPED_FOREIGN_CHILDREN(Attribute,saml2);
            /** AttributeQueryType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;
        
        BEGIN_XMLOBJECT(SAML_API,AuthzDecisionQuery,SubjectQuery,SAML 2.0 AuthzDecisionQuery element);
            DECL_STRING_ATTRIB(Resource,RESOURCE);
            DECL_TYPED_FOREIGN_CHILDREN(Action,saml2);
            DECL_TYPED_FOREIGN_CHILD(Evidence,saml2);
            /** AuthzDecisionQueryType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,NameIDPolicy,xmltooling::XMLObject,SAML 2.0 NameIDPolicy element);
            DECL_STRING_ATTRIB(Format,FORMAT);
            DECL_STRING_ATTRIB(SPNameQualifier,SPNAMEQUALIFIER);
            DECL_BOOLEAN_ATTRIB(AllowCreate,ALLOWCREATE,false);
            /** NameIDPolicyType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,IDPEntry,xmltooling::XMLObject,SAML2.0 IDPEntry element);
            DECL_STRING_ATTRIB(ProviderID,PROVIDERID);
            DECL_STRING_ATTRIB(Name,NAME);
            DECL_STRING_ATTRIB(Loc,LOC);
            /** IDPEntryType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,IDPList,xmltooling::XMLObject,SAML 2.0 IDPList element);
            DECL_TYPED_CHILDREN(IDPEntry);
            DECL_TYPED_CHILD(GetComplete);
            /** IDPListType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,Scoping,xmltooling::XMLObject,SAML 2.0 Scoping element);
            DECL_INTEGER_ATTRIB(ProxyCount,PROXYCOUNT);
            DECL_TYPED_CHILD(IDPList);
            DECL_TYPED_CHILDREN(RequesterID);
            /** ScopingType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,AuthnRequest,RequestAbstractType,SAML 2.0 AuthnRequest element);
            DECL_BOOLEAN_ATTRIB(ForceAuthn,FORCEAUTHN,false);
            DECL_BOOLEAN_ATTRIB(IsPassive,ISPASSIVE,false);
            DECL_STRING_ATTRIB(ProtocolBinding,PROTOCOLBINDING);
            DECL_INTEGER_ATTRIB(AssertionConsumerServiceIndex,ASSERTIONCONSUMERSERVICEINDEX);
            DECL_STRING_ATTRIB(AssertionConsumerServiceURL,ASSERTIONCONSUMERSERVICEURL);
            DECL_INTEGER_ATTRIB(AttributeConsumingServiceIndex,ATTRIBUTECONSUMINGSERVICEINDEX);
            DECL_STRING_ATTRIB(ProviderName,PROVIDERNAME);

            DECL_TYPED_FOREIGN_CHILD(Subject,saml2);
            DECL_TYPED_CHILD(NameIDPolicy);
            DECL_TYPED_FOREIGN_CHILD(Conditions,saml2);
            DECL_TYPED_CHILD(RequestedAuthnContext);
            DECL_TYPED_CHILD(Scoping);
            /** AuthnRequestType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,Response,StatusResponseType,SAML 2.0 Response element);
            DECL_TYPED_FOREIGN_CHILDREN(Assertion,saml2);
            DECL_TYPED_FOREIGN_CHILDREN(EncryptedAssertion,saml2);
            /** ResponseType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,ArtifactResolve,RequestAbstractType,SAML 2.0 ArtifactResolve element);
            DECL_TYPED_CHILD(Artifact);
            /** ArtifiactResolveType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,ArtifactResponse,StatusResponseType,SAML 2.0 ArtifactResponse element);
            DECL_XMLOBJECT_CHILD(Payload);
            /** ArtifiactResponseType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,Terminate,xmltooling::XMLObject,SAML 2.0 Terminate element);
            /** TerminateType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,NewID,saml2::EncryptableObject,SAML 2.0 NewID element);
            DECL_SIMPLE_CONTENT(NewID);
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,NewEncryptedID,saml2::EncryptedElementType,SAML 2.0 NewEncryptedID element);
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,ManageNameIDRequest,RequestAbstractType,SAML 2.0 ManageNameIDRequest element);
            DECL_TYPED_FOREIGN_CHILD(NameID,saml2);
            DECL_TYPED_FOREIGN_CHILD(EncryptedID,saml2);
            DECL_TYPED_CHILD(NewID);
            DECL_TYPED_CHILD(NewEncryptedID);
            DECL_TYPED_CHILD(Terminate);
            /** ManageNameIDRequestType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,ManageNameIDResponse,StatusResponseType,SAML 2.0 ManageNameIDResponse element);
        END_XMLOBJECT;
        
        BEGIN_XMLOBJECT(SAML_API,LogoutRequest,RequestAbstractType,SAML 2.0 LogoutRequest element);
            DECL_STRING_ATTRIB(Reason,REASON);
            DECL_DATETIME_ATTRIB(NotOnOrAfter,NOTONORAFTER);
            DECL_TYPED_FOREIGN_CHILD(BaseID,saml2);
            DECL_TYPED_FOREIGN_CHILD(NameID,saml2);
            DECL_TYPED_FOREIGN_CHILD(EncryptedID,saml2);
            DECL_TYPED_CHILDREN(SessionIndex);

            /** LogoutRequestType local name */
            static const XMLCh TYPE_NAME[];

            /**
              * @name LogoutRequest Reason URI Constants
              * 
              * URI Constants for the Reason attribute of the LogoutRequest
              * element as defined by SAML 2.0 Core, section 3.7.3.
              */
            /*@{*/
            /** Reason value 'urn:oasis:names:tc:SAML:2.0:logout:user' */
            static const XMLCh REASON_USER[];
            /** Reason value 'urn:oasis:names:tc:SAML:2.0:logout:admin' */
            static const XMLCh REASON_ADMIN[];
            /** Reason value 'urn:oasis:names:tc:SAML:2.0:logout:global-timeout' */
            static const XMLCh REASON_GLOBAL_TIMEOUT[];
            /** Reason value 'urn:oasis:names:tc:SAML:2.0:logout:sp-timeout' */
            static const XMLCh REASON_SP_TIMEOUT[];
            /*@}*/
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,LogoutResponse,StatusResponseType,SAML 2.0 LogoutResponse element);
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,NameIDMappingRequest,RequestAbstractType,SAML 2.0 NameIDMappingRequest element);
            DECL_TYPED_FOREIGN_CHILD(BaseID,saml2);
            DECL_TYPED_FOREIGN_CHILD(NameID,saml2);
            DECL_TYPED_FOREIGN_CHILD(EncryptedID,saml2);
            DECL_TYPED_CHILD(NameIDPolicy);
            /** NameIDMappingRequestType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;

        BEGIN_XMLOBJECT(SAML_API,NameIDMappingResponse,StatusResponseType,SAML 2.0 NameIDMappingResponse element);
            DECL_TYPED_FOREIGN_CHILD(NameID,saml2);
            DECL_TYPED_FOREIGN_CHILD(EncryptedID,saml2);
            /** NameIDMappingResponseType local name */
            static const XMLCh TYPE_NAME[];
        END_XMLOBJECT;


        // Builders
        DECL_SAML2POBJECTBUILDER(Artifact);
        DECL_SAML2POBJECTBUILDER(ArtifactResolve);
        DECL_SAML2POBJECTBUILDER(ArtifactResponse);
        DECL_SAML2POBJECTBUILDER(AssertionIDRequest);
        DECL_SAML2POBJECTBUILDER(AttributeQuery);
        DECL_SAML2POBJECTBUILDER(AuthnQuery);
        DECL_SAML2POBJECTBUILDER(AuthnRequest);
        DECL_SAML2POBJECTBUILDER(AuthzDecisionQuery);
        DECL_SAML2POBJECTBUILDER(Extensions);
        DECL_SAML2POBJECTBUILDER(GetComplete);
        DECL_SAML2POBJECTBUILDER(IDPEntry);
        DECL_SAML2POBJECTBUILDER(IDPList);
        DECL_SAML2POBJECTBUILDER(LogoutRequest);
        DECL_SAML2POBJECTBUILDER(LogoutResponse);
        DECL_SAML2POBJECTBUILDER(ManageNameIDRequest);
        DECL_SAML2POBJECTBUILDER(ManageNameIDResponse);
        DECL_SAML2POBJECTBUILDER(NameIDMappingRequest);
        DECL_SAML2POBJECTBUILDER(NameIDMappingResponse);
        DECL_SAML2POBJECTBUILDER(NameIDPolicy);
        DECL_SAML2POBJECTBUILDER(NewEncryptedID);
        DECL_SAML2POBJECTBUILDER(NewID);
        DECL_SAML2POBJECTBUILDER(RequestedAuthnContext);
        DECL_SAML2POBJECTBUILDER(RequesterID);
        DECL_SAML2POBJECTBUILDER(Response);
        DECL_SAML2POBJECTBUILDER(Scoping);
        DECL_SAML2POBJECTBUILDER(SessionIndex);
        DECL_SAML2POBJECTBUILDER(Status);
        DECL_SAML2POBJECTBUILDER(StatusCode);
        DECL_SAML2POBJECTBUILDER(StatusDetail);
        DECL_SAML2POBJECTBUILDER(StatusMessage);
        DECL_SAML2POBJECTBUILDER(Terminate);
        
        DECL_XMLOBJECTBUILDER(SAML_API,RespondTo,samlconstants::SAML20P_THIRDPARTY_EXT_NS,samlconstants::SAML20P_THIRDPARTY_EXT_PREFIX);

        DECL_XMLOBJECTBUILDER(SAML_API,Asynchronous,samlconstants::SAML20P_ASYNCSLO_EXT_NS,samlconstants::SAML20P_ASYNCSLO_EXT_PREFIX);

        /**
         * Registers builders and validators for SAML 2.0 Protocol classes into the runtime.
         */
        void SAML_API registerProtocolClasses();
    };
};

#endif /* __saml2_protocols_h__ */