include/oxs_xml_signature.h

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF 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.
 */

#ifndef OXS_XML_SIGNATURE_H
#define OXS_XML_SIGNATURE_H


/**
  * @file oxs_xml_signature.h
  * @brief Does the XML Signature for OMXMLSecurity  
  */
/**
* @defgroup  oxs_xml_signature XML Signature
* @ingroup oxs
* @{
*/
#include <axis2_defines.h>
#include <oxs_ctx.h>
#include <axutil_env.h>
#include <axiom_node.h>
#include <axiom_element.h>
#include <axutil_qname.h>
#include <oxs_sign_ctx.h>
#include <oxs_sign_part.h>

#ifdef __cplusplus
extern "C"
{
#endif
    /**
     * Sign according to the information available in the @sign_ctx. 
     * @env pointer to environment struct
     * @sign_ctx the signature context
     * @parent the node that the ds:Signature element should be attached.
     * @sig_node a reference to the ds:Signature node
     * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
     */
    AXIS2_EXTERN axis2_status_t AXIS2_CALL
    oxs_xml_sig_sign(const axutil_env_t *env,
                     oxs_sign_ctx_t *sign_ctx,
                     axiom_node_t *parent,
                     axiom_node_t **sig_node);

    /**
     * Verify a complete xml document
     * @env pointer to environment struct
     * @sign_ctx the signature context
     * @signature_node the ds:Signature node
     * @scope_node the root node in which the referenced are found
     * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
     */
    AXIS2_EXTERN axis2_status_t AXIS2_CALL
    oxs_xml_sig_verify(const axutil_env_t *env,
                       oxs_sign_ctx_t *sign_ctx,
                       axiom_node_t *signature_node,
                       axiom_node_t *scope_node);

    /**
     * Verify a single signature part @sign_part.
     * Do transforms, Generate digest and compare with the digest in hand
     * @env pointer to environment struct
     * @sign_part the signature part
     * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
     */
    AXIS2_EXTERN axis2_status_t AXIS2_CALL
    oxs_xml_sig_verify_sign_part(const axutil_env_t *env,
                                 oxs_sign_part_t *sign_part);

    /**
     * Verify all digests in signature parts of a single signature context @sign_ctx
     * @env pointer to environment struct
     * @sign_ctx the signature context
     * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
     */
    AXIS2_EXTERN axis2_status_t AXIS2_CALL
    oxs_xml_sig_verify_digests(const axutil_env_t *env,
                               oxs_sign_ctx_t *sign_ctx);


    /**
     * Process the ds:Reference node. Populate a signature part
     * @env pointer to environment struct
     * @sign_part the signature part
     * @ref_node the ds:Reference node
     * @scope_node the root node in which the referenced are found
     * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
     */
    AXIS2_EXTERN axis2_status_t AXIS2_CALL
    oxs_xml_sig_process_ref_node(const axutil_env_t *env,
                                 oxs_sign_part_t *sign_part,
                                 axiom_node_t *ref_node,
                                 axiom_node_t *scope_node);

    /**
     * Process the ds:Signature node. Populate a signature context
     * @env pointer to environment struct
     * @sign_ctx the signature context
     * @signature_node the ds:Signature node
     * @scope_node the root node in which the referenced are found
     * @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
     */
    AXIS2_EXTERN axis2_status_t AXIS2_CALL
    oxs_xml_sig_process_signature_node(const axutil_env_t *env,
                                       oxs_sign_ctx_t *sign_ctx,
                                       axiom_node_t *signature_node,
                                       axiom_node_t *scope_node);
    /** @} */
#ifdef __cplusplus
}
#endif

#endif                          /* OXS_XML_SIGNATURE_H */