blob: 8f5d1cd0a72d19bb705d52f7608f5067c299c60c [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>gSOAP WS-Security: /Users/engelen/Projects/gsoap/doc/wsse/wsseapi.c File Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.3.8 -->
<div class="qindex"><a class="qindex" href="index.html">Main&nbsp;Page</a> | <a class="qindex" href="annotated.html">Class&nbsp;List</a> | <a class="qindex" href="files.html">File&nbsp;List</a> | <a class="qindex" href="functions.html">Class&nbsp;Members</a> | <a class="qindex" href="globals.html">File&nbsp;Members</a> | <a class="qindex" href="pages.html">Related&nbsp;Pages</a></div>
<h1>/Users/engelen/Projects/gsoap/doc/wsse/wsseapi.c File Reference</h1><code>#include "<a class="el" href="wsseapi_8h.html">wsseapi.h</a>"</code><br>
<code>#include "<a class="el" href="smdevp_8h.html">smdevp.h</a>"</code><br>
<code>#include "threads.h"</code><br>
<p>
Include dependency graph for wsseapi.c:<p><center><img src="wsseapi_8c__incl.png" border="0" usemap="#wsseapi.c_map" alt="Include dependency graph"></center>
<map name="wsseapi.c_map">
<area href="wsseapi_8h.html" shape="rect" coords="16,167,85,193" alt="">
<area href="smdevp_8h.html" shape="rect" coords="89,92,156,119" alt="">
</map>
<table border=0 cellpadding=0 cellspacing=0>
<tr><td></td></tr>
<tr><td colspan=2><br><h2>Classes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>struct &nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="structsoap__wsse__session.html">soap_wsse_session</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Digest authentication session data. <a href="structsoap__wsse__session.html#_details">More...</a><br></td></tr>
<tr><td colspan=2><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a0">SOAP_WSSE_MAX_REF</a>&nbsp;&nbsp;&nbsp;(100)</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a1">SOAP_WSSE_CLKSKEW</a>&nbsp;&nbsp;&nbsp;(600)</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a2">SOAP_WSSE_NONCELEN</a>&nbsp;&nbsp;&nbsp;(20)</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a3">SOAP_WSSE_NONCETIME</a>&nbsp;&nbsp;&nbsp;(SOAP_WSSE_CLKSKEW + 240)</td></tr>
<tr><td colspan=2><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a19">soap_wsse_session_verify</a> (struct soap *soap, const char hash[SOAP_SMD_SHA1_SIZE], const char *created, const char *nonce)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies and updates the digest, nonce, and creation time against the digest authentication session database to prevent replay attacks. <a href="#a19"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a20">soap_wsse_session_cleanup</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Removes expired authentication data from the digest authentication session database. <a href="#a20"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a21">calc_digest</a> (struct soap *soap, const char *created, const char *nonce, int noncelen, const char *password, char hash[SOAP_SMD_SHA1_SIZE])</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Calculates digest value SHA1(created, nonce, password). <a href="#a21"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a22">calc_nonce</a> (struct soap *soap, char nonce[SOAP_WSSE_NONCELEN])</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Calculates randomized nonce. <a href="#a22"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a23">soap_wsse_init</a> (struct soap *soap, struct <a class="el" href="structsoap__wsse__data.html">soap_wsse_data</a> *data)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Initializes plugin data. <a href="#a23"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a24">soap_wsse_copy</a> (struct soap *soap, struct soap_plugin *dst, struct soap_plugin *src)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Copies plugin data to localize plugin data for threads. <a href="#a24"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a25">soap_wsse_delete</a> (struct soap *soap, struct soap_plugin *p)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Deletes plugin data. <a href="#a25"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a26">soap_wsse_prepareinit</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Initiates message preprocessing with gSOAP engine's prepareinit callback. <a href="#a26"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a27">soap_wsse_preparesend</a> (struct soap *soap, const char *buf, size_t len)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Takes a piece of the XML message (tokenized) to compute digest. <a href="#a27"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a28">soap_wsse_preparefinal</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Collects the digests of all the wsu:Id elements and populates the SignedInfo. <a href="#a28"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a29">soap_wsse_preparecleanup</a> (struct soap *soap, struct <a class="el" href="structsoap__wsse__data.html">soap_wsse_data</a> *data)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Restores engine state. <a href="#a29"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a30">soap_wsse_disconnect</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verify signature and SignedInfo digests initiated with soap_wsse_verify_auto. <a href="#a30"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="struct__wsse_____security.html">_wsse__Security</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a31">soap_wsse_add_Security</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds Security header element. <a href="#a31"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="struct__wsse_____security.html">_wsse__Security</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a32">soap_wsse_add_Security_actor</a> (struct soap *soap, const char *actor)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds Security header element with actor or role attribute. <a href="#a32"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a33">soap_wsse_delete_Security</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Deletes Security header element. <a href="#a33"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="struct__wsse_____security.html">_wsse__Security</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a34">soap_wsse_Security</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns Security header element if present. <a href="#a34"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structds_____signature_type.html">ds__SignatureType</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a35">soap_wsse_add_Signature</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds Signature header element. <a href="#a35"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>void&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a36">soap_wsse_delete_Signature</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Deletes Signature header element. <a href="#a36"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structds_____signature_type.html">ds__SignatureType</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a37">soap_wsse_Signature</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns Signature header element if present. <a href="#a37"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a38">soap_wsse_add_Timestamp</a> (struct soap *soap, const char *id, time_t lifetime)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds Timestamp element with optional expiration date+time (lifetime). <a href="#a38"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="struct__wsu_____timestamp.html">_wsu__Timestamp</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a39">soap_wsse_Timestamp</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns Timestamp element if present. <a href="#a39"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a40">soap_wsse_verify_Timestamp</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies the Timestamp/Expires element against the current time. <a href="#a40"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a41">soap_wsse_add_UsernameTokenText</a> (struct soap *soap, const char *id, const char *username, const char *password)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds UsernameToken element with optional clear-text password. <a href="#a41"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a42">soap_wsse_add_UsernameTokenDigest</a> (struct soap *soap, const char *id, const char *username, const char *password)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds UsernameToken element for digest authentication. <a href="#a42"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="struct__wsse_____username_token.html">_wsse__UsernameToken</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a43">soap_wsse_UsernameToken</a> (struct soap *soap, const char *id)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns UsernameToken element if present. <a href="#a43"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a44">soap_wsse_get_Username</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns UsernameToken/username string or wsse:FailedAuthentication fault. <a href="#a44"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a45">soap_wsse_verify_Password</a> (struct soap *soap, const char *password)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies the supplied password or sets wsse:FailedAuthentication fault. <a href="#a45"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a46">soap_wsse_add_BinarySecurityToken</a> (struct soap *soap, const char *id, const char *valueType, const unsigned char *data, int size)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds BinarySecurityToken element. <a href="#a46"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a47">soap_wsse_add_BinarySecurityTokenX509</a> (struct soap *soap, const char *id, X509 *cert)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds BinarySecurityToken element with X509 certificate. <a href="#a47"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a48">soap_wsse_add_BinarySecurityTokenPEM</a> (struct soap *soap, const char *id, const char *filename)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds BinarySecurityToken element from a PEM file. <a href="#a48"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="struct__wsse_____binary_security_token.html">_wsse__BinarySecurityToken</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a49">soap_wsse_BinarySecurityToken</a> (struct soap *soap, const char *id)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns BinarySecurityToken element if present. <a href="#a49"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a50">soap_wsse_get_BinarySecurityToken</a> (struct soap *soap, const char *id, char **valueType, unsigned char **data, int *size)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get wsse:BinarySecurityToken element token data in binary form. <a href="#a50"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>X509 *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a51">soap_wsse_get_BinarySecurityTokenX509</a> (struct soap *soap, const char *id)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get X509 wsse:BinarySecurityToken certificate and verify its content. <a href="#a51"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a52">soap_wsse_verify_X509</a> (struct soap *soap, X509 *cert)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies X509 certificate against soap-&gt;cafile, soap-&gt;capath, and soap-&gt;crlfile. <a href="#a52"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structds_____signed_info_type.html">ds__SignedInfoType</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a53">soap_wsse_add_SignedInfo</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds SignedInfo element. <a href="#a53"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a54">soap_wsse_add_SignedInfo_Reference</a> (struct soap *soap, const char *URI, const char *transform, const char *inclusiveNamespaces, const char *HA)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds SignedInfo element with Reference URI, transform algorithm used, and digest value. <a href="#a54"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a55">soap_wsse_add_SignedInfo_SignatureMethod</a> (struct soap *soap, const char *method, int canonical)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds SignedInfo element with SignatureMethod. <a href="#a55"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structds_____signed_info_type.html">ds__SignedInfoType</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a56">soap_wsse_SignedInfo</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns SignedInfo element if present. <a href="#a56"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a57">soap_wsse_get_SignedInfo_SignatureMethod</a> (struct soap *soap, int *alg)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get SignatureMethod algorithm. <a href="#a57"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a58">soap_wsse_add_SignatureValue</a> (struct soap *soap, int alg, const void *key, int keylen)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds SignedInfo/SignatureMethod element, signs the SignedInfo element, and adds the resulting SignatureValue element. <a href="#a58"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a59">soap_wsse_verify_SignatureValue</a> (struct soap *soap, int alg, const void *key, int keylen)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies the SignatureValue of a SignedInfo element. <a href="#a59"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a60">soap_wsse_verify_SignedInfo</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies the digest values of the XML elements referenced by the SignedInfo References. <a href="#a60"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a61">soap_wsse_verify_digest</a> (struct soap *soap, int alg, const char *id, unsigned char hash[SOAP_SMD_MAX_SIZE])</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Verifies the digest value of an XML element referenced by id against the hash. <a href="#a61"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structds_____key_info_type.html">ds__KeyInfoType</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a62">soap_wsse_add_KeyInfo</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds KeyInfo element. <a href="#a62"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structds_____key_info_type.html">ds__KeyInfoType</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a63">soap_wsse_KeyInfo</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns KeyInfo element if present. <a href="#a63"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a64">soap_wsse_add_KeyInfo_KeyName</a> (struct soap *soap, const char *name)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds KeyName element. <a href="#a64"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a65">soap_wsse_get_KeyInfo_KeyName</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns KeyName element if present. <a href="#a65"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a66">soap_wsse_add_KeyInfo_SecurityTokenReferenceURI</a> (struct soap *soap, const char *URI, const char *valueType)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds KeyInfo element with SecurityTokenReference URI. <a href="#a66"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a67">soap_wsse_add_KeyInfo_SecurityTokenReferenceX509</a> (struct soap *soap, const char *URI)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds KeyInfo element with SecurityTokenReference URI to an X509 cert. <a href="#a67"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a68">soap_wsse_get_KeyInfo_SecurityTokenReferenceURI</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns a SecurityTokenReference URI if present. <a href="#a68"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>X509 *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a69">soap_wsse_get_KeyInfo_SecurityTokenReferenceX509</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns a X509 certificate if present as a BinarySecurity token. <a href="#a69"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a70">soap_wsse_add_KeyInfo_SecurityTokenReferenceKeyIdentifier</a> (struct soap *soap, const char *id, const char *valueType, unsigned char *data, int size)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds KeyInfo element with SecurityTokenReference/KeyIdentifier binary data. <a href="#a70"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a71">soap_wsse_get_KeyInfo_SecurityTokenReferenceKeyIdentifierValueType</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns KeyInfo/SecurityTokenReference/KeyIdentifier/ValueType if present. <a href="#a71"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const unsigned char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a72">soap_wsse_get_KeyInfo_SecurityTokenReferenceKeyIdentifier</a> (struct soap *soap, int *size)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns KeyInfo/SecurityTokenReference/KeyIdentifier binary data. <a href="#a72"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a73">soap_wsse_add_KeyInfo_SecurityTokenReferenceEmbedded</a> (struct soap *soap, const char *id, const char *valueType)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Adds KeyInfo element with Embedded SecurityTokenReference. <a href="#a73"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a74">soap_wsse_fault</a> (struct soap *soap, <a class="el" href="wsse_8h.html#a0">wsse__FaultcodeEnum</a> fault, const char *detail)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sets SOAP Fault (sub)code for server response. <a href="#a74"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a75">soap_wsse</a> (struct soap *soap, struct soap_plugin *p, void *arg)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Plugin registry function, used with soap_register_plugin. <a href="#a75"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a76">soap_wsse_sign</a> (struct soap *soap, int alg, const void *key, int keylen)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Uses the wsse plugin to sign all wsu:Id attributed elements. <a href="#a76"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a77">soap_wsse_sign_body</a> (struct soap *soap, int alg, const void *key, int keylen)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Uses the wsse plugin to sign all wsu:Id attributed elements, including the SOAP Body (by adding a wsu:Id="Body" attribute). <a href="#a77"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a78">soap_wsse_verify_init</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Uses the wsse plugin to initiate the verification of the signature and SignedInfo Reference digests. <a href="#a78"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a79">soap_wsse_verify_auto</a> (struct soap *soap, int alg, const void *key, size_t keylen)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Uses the wsse plugin to initiate the automatic verification of the signature and SignedInfo Reference digests. <a href="#a79"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>int&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a80">soap_wsse_verify_done</a> (struct soap *soap)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Terminates the automatic verification of signatures. <a href="#a80"></a><br></td></tr>
<tr><td colspan=2><br><h2>Variables</h2></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a4">soap_wsse_id</a> [14] = SOAP_WSSE_ID</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a5">wsse_PasswordTextURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a6">wsse_PasswordDigestURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a7">wsse_Base64BinaryURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a8">wsse_X509v3URI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a9">wsse_X509v3SubjectKeyIdentifierURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a10">ds_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#sha1"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a11">ds_hmac_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#hmac-sha1"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a12">ds_dsa_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#dsa-sha1"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a13">ds_rsa_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#rsa-sha1"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a14">ds_URI</a> = "http://www.w3.org/2000/09/xmldsig#"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a15">c14n_URI</a> = "http://www.w3.org/2001/10/xml-exc-c14n#"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>const char *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a16">wsu_URI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="structsoap__wsse__session.html">soap_wsse_session</a> *&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a17">soap_wsse_session</a> = NULL</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>MUTEX_TYPE&nbsp;</td><td class="memItemRight" valign=bottom><a class="el" href="wsseapi_8c.html#a18">soap_wsse_session_lock</a></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="a1" doxytag="wsseapi.c::SOAP_WSSE_CLKSKEW" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define SOAP_WSSE_CLKSKEW&nbsp;&nbsp;&nbsp;(600) </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Clock skew between machines (in sec) to fit message expiration in window </td>
</tr>
</table>
<a class="anchor" name="a0" doxytag="wsseapi.c::SOAP_WSSE_MAX_REF" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define SOAP_WSSE_MAX_REF&nbsp;&nbsp;&nbsp;(100) </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Maximum number of SignedInfo References </td>
</tr>
</table>
<a class="anchor" name="a2" doxytag="wsseapi.c::SOAP_WSSE_NONCELEN" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define SOAP_WSSE_NONCELEN&nbsp;&nbsp;&nbsp;(20) </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Size of the random nonce </td>
</tr>
</table>
<a class="anchor" name="a3" doxytag="wsseapi.c::SOAP_WSSE_NONCETIME" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define SOAP_WSSE_NONCETIME&nbsp;&nbsp;&nbsp;(SOAP_WSSE_CLKSKEW + 240) </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Digest authentication accepts messages that are not older than creation time + SOAP_WSSE_NONCETIME </td>
</tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="a21" doxytag="wsseapi.c::calc_digest" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void calc_digest </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>created</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>nonce</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>noncelen</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>password</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>char&nbsp;</td>
<td class="mdname" nowrap> <em>hash</em>[SOAP_SMD_SHA1_SIZE]</td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Calculates digest value SHA1(created, nonce, password).
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>created</em>&nbsp;</td><td>string (XSD dateTime format) </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>nonce</em>&nbsp;</td><td>value </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>noncelen</em>&nbsp;</td><td>length of nonce value </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>password</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>hash</em>&nbsp;</td><td>SHA1 digest </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a22" doxytag="wsseapi.c::calc_nonce" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void calc_nonce </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>char&nbsp;</td>
<td class="mdname" nowrap> <em>nonce</em>[SOAP_WSSE_NONCELEN]</td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Calculates randomized nonce.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>nonce</em>&nbsp;</td><td>value </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a75" doxytag="wsseapi.c::soap_wsse" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>struct soap_plugin *&nbsp;</td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>void *&nbsp;</td>
<td class="mdname" nowrap> <em>arg</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Plugin registry function, used with soap_register_plugin.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in,out]</tt>&nbsp;</td><td valign=top><em>p</em>&nbsp;</td><td>plugin created in registry </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>arg</em>&nbsp;</td><td>passed from soap_register_plugin_arg </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a46" doxytag="wsseapi.c::soap_wsse_add_BinarySecurityToken" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_BinarySecurityToken </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>valueType</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const unsigned char *&nbsp;</td>
<td class="mdname" nowrap> <em>data</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds BinarySecurityToken element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature referencing or NULL </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>valueType</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>data</em>&nbsp;</td><td>points to binary token data </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>size</em>&nbsp;</td><td>is length of binary token </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a48" doxytag="wsseapi.c::soap_wsse_add_BinarySecurityTokenPEM" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_BinarySecurityTokenPEM </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>filename</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds BinarySecurityToken element from a PEM file.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature reference </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>filename</em>&nbsp;</td><td></td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_FAULT with wsse__InvalidSecurity fault when file cannot be read or does not contain a valid certificate</dd></dl>
This function uses PEM_read_X509 from the the OpenSSL library to read a certificate from a PEM formatted file. </td>
</tr>
</table>
<a class="anchor" name="a47" doxytag="wsseapi.c::soap_wsse_add_BinarySecurityTokenX509" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_BinarySecurityTokenX509 </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>X509 *&nbsp;</td>
<td class="mdname" nowrap> <em>cert</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds BinarySecurityToken element with X509 certificate.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature reference </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>cert</em>&nbsp;</td><td>points to the X509 certificate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_EOM</dd></dl>
This function uses i2d_X509 from the the OpenSSL library to convert an X509 object to binary DER format. </td>
</tr>
</table>
<a class="anchor" name="a62" doxytag="wsseapi.c::soap_wsse_add_KeyInfo" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structds_____key_info_type.html">ds__KeyInfoType</a> * soap_wsse_add_KeyInfo </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds KeyInfo element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>ds__KeyInfo object </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a64" doxytag="wsseapi.c::soap_wsse_add_KeyInfo_KeyName" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_KeyInfo_KeyName </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>name</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds KeyName element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>name</em>&nbsp;</td><td>string of the KeyName </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
Note: the recommended method to add Key information is to utilize KeyIdentifier instead of KeyName. A KeyName is useful mainly for internal use. </td>
</tr>
</table>
<a class="anchor" name="a73" doxytag="wsseapi.c::soap_wsse_add_KeyInfo_SecurityTokenReferenceEmbedded" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_KeyInfo_SecurityTokenReferenceEmbedded </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>valueType</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds KeyInfo element with Embedded SecurityTokenReference.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature reference </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>valueType</em>&nbsp;</td><td>string </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
Note: this function is under construction and the result depends on usage scenarios deployed in practice. </td>
</tr>
</table>
<a class="anchor" name="a70" doxytag="wsseapi.c::soap_wsse_add_KeyInfo_SecurityTokenReferenceKeyIdentifier" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_KeyInfo_SecurityTokenReferenceKeyIdentifier </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>valueType</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>unsigned char *&nbsp;</td>
<td class="mdname" nowrap> <em>data</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds KeyInfo element with SecurityTokenReference/KeyIdentifier binary data.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature reference </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>valueType</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>data</em>&nbsp;</td><td>binary data </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>size</em>&nbsp;</td><td>of binary data </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a66" doxytag="wsseapi.c::soap_wsse_add_KeyInfo_SecurityTokenReferenceURI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_KeyInfo_SecurityTokenReferenceURI </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>URI</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>valueType</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds KeyInfo element with SecurityTokenReference URI.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>URI</em>&nbsp;</td><td>string referencing a security token </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>valueType</em>&nbsp;</td><td>string or NULL </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a67" doxytag="wsseapi.c::soap_wsse_add_KeyInfo_SecurityTokenReferenceX509" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_KeyInfo_SecurityTokenReferenceX509 </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>URI</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds KeyInfo element with SecurityTokenReference URI to an X509 cert.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>URI</em>&nbsp;</td><td>string referencing an X509 certificate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a31" doxytag="wsseapi.c::soap_wsse_add_Security" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="struct__wsse_____security.html">_wsse__Security</a> * soap_wsse_add_Security </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds Security header element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="struct__wsse_____security.html">_wsse__Security</a> object </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a32" doxytag="wsseapi.c::soap_wsse_add_Security_actor" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="struct__wsse_____security.html">_wsse__Security</a> * soap_wsse_add_Security_actor </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>actor</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds Security header element with actor or role attribute.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td></td><td valign=top><em>actor</em>&nbsp;</td><td>string </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="struct__wsse_____security.html">_wsse__Security</a> object </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a35" doxytag="wsseapi.c::soap_wsse_add_Signature" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structds_____signature_type.html">ds__SignatureType</a> * soap_wsse_add_Signature </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds Signature header element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="structds_____signature_type.html">ds__SignatureType</a> object </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a58" doxytag="wsseapi.c::soap_wsse_add_SignatureValue" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_SignatureValue </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const void *&nbsp;</td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>keylen</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds SignedInfo/SignatureMethod element, signs the SignedInfo element, and adds the resulting SignatureValue element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>is SOAP_SMD_HMAC_SHA1, SOAP_SMD_SIGN_DSA_SHA1, or SOAP_SMD_SIGN_RSA_SHA1 </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>key</em>&nbsp;</td><td>to use to sign (HMAC or EVP_PKEY) </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>keylen</em>&nbsp;</td><td>length of HMAC key </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK, SOAP_EOM, or fault</dd></dl>
To sign the SignedInfo element with this function, populate SignedInfo with Reference elements first using soap_wsse_add_SignedInfo_Reference. The SignedInfo element must not be modified after signing.<p>
The SOAP_XML_INDENT and SOAP_XML_CANONICAL flags are used to serialize the SignedInfo to compute the signature. </td>
</tr>
</table>
<a class="anchor" name="a53" doxytag="wsseapi.c::soap_wsse_add_SignedInfo" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structds_____signed_info_type.html">ds__SignedInfoType</a> * soap_wsse_add_SignedInfo </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds SignedInfo element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="structds_____signed_info_type.html">ds__SignedInfoType</a> object </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a54" doxytag="wsseapi.c::soap_wsse_add_SignedInfo_Reference" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_SignedInfo_Reference </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>URI</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>transform</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>inclusiveNamespaces</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>HA</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds SignedInfo element with Reference URI, transform algorithm used, and digest value.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>URI</em>&nbsp;</td><td>reference </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>transform</em>&nbsp;</td><td>string should be c14n_URI for exc-c14n or NULL </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>inclusiveNamespaces</em>&nbsp;</td><td>used by the exc-c14n transform or NULL </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>HA</em>&nbsp;</td><td>is the SHA1 digest in binary form (length=SOAP_SMD_SHA1_SIZE) </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_EOM when references exceed SOAP_WSSE_MAX_REF</dd></dl>
This function can be called to add more references to the wsse:SignedInfo element. A maximum number of SOAP_WSSE_MAX_REF references can be added. The digest method is always SHA1. Note: XPath transforms cannot be specified in this release. </td>
</tr>
</table>
<a class="anchor" name="a55" doxytag="wsseapi.c::soap_wsse_add_SignedInfo_SignatureMethod" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_SignedInfo_SignatureMethod </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>method</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>canonical</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds SignedInfo element with SignatureMethod.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>method</em>&nbsp;</td><td>is the URI of the signature algorithm (e.g. ds_rsa_sha1) </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>canonical</em>&nbsp;</td><td>flag indicating that SignedInfo is signed in exc-c14n form </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
Note: the c14n:InclusiveNamespaces/PrefixList is set to "SOAP-ENV wsse". </td>
</tr>
</table>
<a class="anchor" name="a38" doxytag="wsseapi.c::soap_wsse_add_Timestamp" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_Timestamp </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>time_t&nbsp;</td>
<td class="mdname" nowrap> <em>lifetime</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds Timestamp element with optional expiration date+time (lifetime).
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>for signature referencing or NULL </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>lifetime</em>&nbsp;</td><td>expressed in time_t units, or 0 for no expiration </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a42" doxytag="wsseapi.c::soap_wsse_add_UsernameTokenDigest" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_UsernameTokenDigest </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>username</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>password</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds UsernameToken element for digest authentication.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature referencing or NULL </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>username</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>password</em>&nbsp;</td><td>string </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
Computes SHA1 digest of the time stamp, a nonce, and the password. The digest provides the authentication credentials. Passwords are NOT sent in the clear. Note: this release supports the use of at most one UsernameToken in the header. </td>
</tr>
</table>
<a class="anchor" name="a41" doxytag="wsseapi.c::soap_wsse_add_UsernameTokenText" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_add_UsernameTokenText </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>username</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>password</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Adds UsernameToken element with optional clear-text password.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string for signature referencing or NULL </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>username</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>password</em>&nbsp;</td><td>string or NULL to omit the password </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
Passwords are sent in the clear, so transport-level encryption is required. Note: this release supports the use of at most one UsernameToken in the header. </td>
</tr>
</table>
<a class="anchor" name="a49" doxytag="wsseapi.c::soap_wsse_BinarySecurityToken" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="struct__wsse_____binary_security_token.html">_wsse__BinarySecurityToken</a> * soap_wsse_BinarySecurityToken </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns BinarySecurityToken element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string of token to get or NULL </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="struct__wsse_____binary_security_token.html">_wsse__BinarySecurityToken</a> object or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a24" doxytag="wsseapi.c::soap_wsse_copy" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_copy </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>struct soap_plugin *&nbsp;</td>
<td class="mdname" nowrap> <em>dst</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>struct soap_plugin *&nbsp;</td>
<td class="mdname" nowrap> <em>src</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Copies plugin data to localize plugin data for threads.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>dst</em>&nbsp;</td><td>target plugin </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>src</em>&nbsp;</td><td>source plugin </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a25" doxytag="wsseapi.c::soap_wsse_delete" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void soap_wsse_delete </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>struct soap_plugin *&nbsp;</td>
<td class="mdname" nowrap> <em>p</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Deletes plugin data.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in,out]</tt>&nbsp;</td><td valign=top><em>p</em>&nbsp;</td><td>plugin </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a33" doxytag="wsseapi.c::soap_wsse_delete_Security" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void soap_wsse_delete_Security </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Deletes Security header element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a36" doxytag="wsseapi.c::soap_wsse_delete_Signature" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void soap_wsse_delete_Signature </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Deletes Signature header element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a30" doxytag="wsseapi.c::soap_wsse_disconnect" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_disconnect </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verify signature and SignedInfo digests initiated with soap_wsse_verify_auto.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="wsseapi_8h.html#a62">soap_wsse_verify_auto</a></dd></dl>
This callback is invoked just after a message was received. </td>
</tr>
</table>
<a class="anchor" name="a74" doxytag="wsseapi.c::soap_wsse_fault" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_fault </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap><a class="el" href="wsse_8h.html#a0">wsse__FaultcodeEnum</a>&nbsp;</td>
<td class="mdname" nowrap> <em>fault</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>detail</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Sets SOAP Fault (sub)code for server response.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>fault</em>&nbsp;</td><td>is one of wsse:FaultcodeEnum </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>detail</em>&nbsp;</td><td>string with optional text message </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_FAULT </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a50" doxytag="wsseapi.c::soap_wsse_get_BinarySecurityToken" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_get_BinarySecurityToken </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>char **&nbsp;</td>
<td class="mdname" nowrap> <em>valueType</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>unsigned char **&nbsp;</td>
<td class="mdname" nowrap> <em>data</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int *&nbsp;</td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Get wsse:BinarySecurityToken element token data in binary form.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string of token to get or NULL </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>valueType</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>data</em>&nbsp;</td><td>points to binary token data </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>size</em>&nbsp;</td><td>is length of binary token </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_FAULT with wsse:SecurityTokenUnavailable fault </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a51" doxytag="wsseapi.c::soap_wsse_get_BinarySecurityTokenX509" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> X509 * soap_wsse_get_BinarySecurityTokenX509 </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Get X509 wsse:BinarySecurityToken certificate and verify its content.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string of token to get or NULL </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>X509 certificate (dynamically allocated) or NULL with wsse:SecurityTokenUnavailable fault </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a65" doxytag="wsseapi.c::soap_wsse_get_KeyInfo_KeyName" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_get_KeyInfo_KeyName </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns KeyName element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>string or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a72" doxytag="wsseapi.c::soap_wsse_get_KeyInfo_SecurityTokenReferenceKeyIdentifier" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const unsigned char * soap_wsse_get_KeyInfo_SecurityTokenReferenceKeyIdentifier </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int *&nbsp;</td>
<td class="mdname" nowrap> <em>size</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns KeyInfo/SecurityTokenReference/KeyIdentifier binary data.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>size</em>&nbsp;</td><td>is set to the size of the decoded data </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>data or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a71" doxytag="wsseapi.c::soap_wsse_get_KeyInfo_SecurityTokenReferenceKeyIdentifierValueType" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char * soap_wsse_get_KeyInfo_SecurityTokenReferenceKeyIdentifierValueType </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns KeyInfo/SecurityTokenReference/KeyIdentifier/ValueType if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>string or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a68" doxytag="wsseapi.c::soap_wsse_get_KeyInfo_SecurityTokenReferenceURI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char * soap_wsse_get_KeyInfo_SecurityTokenReferenceURI </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns a SecurityTokenReference URI if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>string or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a69" doxytag="wsseapi.c::soap_wsse_get_KeyInfo_SecurityTokenReferenceX509" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> X509 * soap_wsse_get_KeyInfo_SecurityTokenReferenceX509 </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns a X509 certificate if present as a BinarySecurity token.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>X509 object or NULL with wsse:SecurityTokenUnavailable fault </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a57" doxytag="wsseapi.c::soap_wsse_get_SignedInfo_SignatureMethod" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_get_SignedInfo_SignatureMethod </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int *&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Get SignatureMethod algorithm.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[out]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>is SOAP_SMD_HMAC_SHA1, SOAP_SMD_VRFY_DSA_SHA1, or SOAP_SMD_VRFY_RSA_SHA1 </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_FAULT with wsse:UnsupportedAlgorithm or wsse:FailedCheck fault </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a44" doxytag="wsseapi.c::soap_wsse_get_Username" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char * soap_wsse_get_Username </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns UsernameToken/username string or wsse:FailedAuthentication fault.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>UsernameToken/username string or NULL with wsse:FailedAuthentication fault error set </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="wsseapi_8h.html#a28">soap_wsse_verify_Password</a></dd></dl>
The returned username should be used to lookup the user's password in a dictionary or database for server-side authentication with soap_wsse_verify_Password. </td>
</tr>
</table>
<a class="anchor" name="a23" doxytag="wsseapi.c::soap_wsse_init" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_init </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>struct <a class="el" href="structsoap__wsse__data.html">soap_wsse_data</a> *&nbsp;</td>
<td class="mdname" nowrap> <em>data</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Initializes plugin data.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in,out]</tt>&nbsp;</td><td valign=top><em>data</em>&nbsp;</td><td>plugin data </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a63" doxytag="wsseapi.c::soap_wsse_KeyInfo" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structds_____key_info_type.html">ds__KeyInfoType</a> * soap_wsse_KeyInfo </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns KeyInfo element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>ds__KeyInfo object or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a29" doxytag="wsseapi.c::soap_wsse_preparecleanup" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void soap_wsse_preparecleanup </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>struct <a class="el" href="structsoap__wsse__data.html">soap_wsse_data</a> *&nbsp;</td>
<td class="mdname" nowrap> <em>data</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Restores engine state.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in,out]</tt>&nbsp;</td><td valign=top><em>data</em>&nbsp;</td><td>plugin data </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a28" doxytag="wsseapi.c::soap_wsse_preparefinal" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_preparefinal </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Collects the digests of all the wsu:Id elements and populates the SignedInfo.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault</dd></dl>
This callback is invoked just before the message is send. </td>
</tr>
</table>
<a class="anchor" name="a26" doxytag="wsseapi.c::soap_wsse_prepareinit" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_prepareinit </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Initiates message preprocessing with gSOAP engine's prepareinit callback.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault</dd></dl>
This callback is invoked to analyze a message before transmission. </td>
</tr>
</table>
<a class="anchor" name="a27" doxytag="wsseapi.c::soap_wsse_preparesend" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_preparesend </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>size_t&nbsp;</td>
<td class="mdname" nowrap> <em>len</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Takes a piece of the XML message (tokenized) to compute digest.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>buf</em>&nbsp;</td><td>string (XML "tokenized") to be send </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>len</em>&nbsp;</td><td>buf length </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault</dd></dl>
This callback is invoked to analyze a message (usually during the HTTP content length phase). Note: nested elements with wsu:Id attributes cannot be individually signed in this release. </td>
</tr>
</table>
<a class="anchor" name="a34" doxytag="wsseapi.c::soap_wsse_Security" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="struct__wsse_____security.html">_wsse__Security</a> * soap_wsse_Security </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns Security header element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="struct__wsse_____security.html">_wsse__Security</a> object or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a20" doxytag="wsseapi.c::soap_wsse_session_cleanup" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void soap_wsse_session_cleanup </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Removes expired authentication data from the digest authentication session database.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a19" doxytag="wsseapi.c::soap_wsse_session_verify" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_session_verify </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char&nbsp;</td>
<td class="mdname" nowrap> <em>hash</em>[SOAP_SMD_SHA1_SIZE], </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>created</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>nonce</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies and updates the digest, nonce, and creation time against the digest authentication session database to prevent replay attacks.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>hash</em>&nbsp;</td><td>binary digest value of PasswordDigest </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>created</em>&nbsp;</td><td>string </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>nonce</em>&nbsp;</td><td>string (base64) </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_FAULT </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a76" doxytag="wsseapi.c::soap_wsse_sign" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_sign </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const void *&nbsp;</td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>keylen</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Uses the wsse plugin to sign all wsu:Id attributed elements.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>is the signature algorithm SOAP_SMD_HMAC_SHA1, SOAP_SMD_SIGN_DSA_SHA1, or SOAP_SMD_SIGN_RSA_SHA1 </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>key</em>&nbsp;</td><td>is the HMAC secret key or DSA/RSA private EVP_PKEY </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>keylen</em>&nbsp;</td><td>is the HMAC key length </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault</dd></dl>
This function does not actually sign the message, but initiates the plugin's signature algorithm to sign the message upon message transfer. </td>
</tr>
</table>
<a class="anchor" name="a77" doxytag="wsseapi.c::soap_wsse_sign_body" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_sign_body </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const void *&nbsp;</td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>keylen</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Uses the wsse plugin to sign all wsu:Id attributed elements, including the SOAP Body (by adding a wsu:Id="Body" attribute).
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>is the signature algorithm SOAP_SMD_HMAC_SHA1, SOAP_SMD_SIGN_DSA_SHA1, or SOAP_SMD_SIGN_RSA_SHA1 </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>key</em>&nbsp;</td><td>is the HMAC secret key or DSA/RSA private EVP_PKEY </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>keylen</em>&nbsp;</td><td>is the HMAC key length </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
This function does not actually sign the message, but initiates the plugin's signature algorithm to sign the message upon message transfer. </td>
</tr>
</table>
<a class="anchor" name="a37" doxytag="wsseapi.c::soap_wsse_Signature" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structds_____signature_type.html">ds__SignatureType</a> * soap_wsse_Signature </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns Signature header element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="structds_____signature_type.html">ds__SignatureType</a> object or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a56" doxytag="wsseapi.c::soap_wsse_SignedInfo" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="structds_____signed_info_type.html">ds__SignedInfoType</a> * soap_wsse_SignedInfo </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns SignedInfo element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="structds_____signed_info_type.html">ds__SignedInfoType</a> object or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a39" doxytag="wsseapi.c::soap_wsse_Timestamp" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="struct__wsu_____timestamp.html">_wsu__Timestamp</a> * soap_wsse_Timestamp </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns Timestamp element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="struct__wsu_____timestamp.html">_wsu__Timestamp</a> object or NULL </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a43" doxytag="wsseapi.c::soap_wsse_UsernameToken" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="struct__wsse_____username_token.html">_wsse__UsernameToken</a> * soap_wsse_UsernameToken </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Returns UsernameToken element if present.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string of UsernameToken or NULL </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd><a class="el" href="struct__wsse_____username_token.html">_wsse__UsernameToken</a> object or NULL</dd></dl>
Note: this release supports the use of at most one UsernameToken in the header. </td>
</tr>
</table>
<a class="anchor" name="a79" doxytag="wsseapi.c::soap_wsse_verify_auto" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_auto </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const void *&nbsp;</td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>size_t&nbsp;</td>
<td class="mdname" nowrap> <em>keylen</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Uses the wsse plugin to initiate the automatic verification of the signature and SignedInfo Reference digests.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>to verify signature if signature has no secret or public key, use SOAP_SMD_NONE to omit </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>key</em>&nbsp;</td><td>is HMAC key or EVP_PKEY </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>keylen</em>&nbsp;</td><td>is HMAC key length </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
This function does not actually verify the message, but initiates the plugin's algorithm to store the message in a DOM to automatically verify the signature and digestes. If the message does not contain a key to verify the signature, the alg, key, and keylen parameters are used. It is important that the X509 certificate used to verify the signature is verified, which requires soap-&gt;cafile and/or soap-&gt;capath to be set. </td>
</tr>
</table>
<a class="anchor" name="a61" doxytag="wsseapi.c::soap_wsse_verify_digest" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_digest </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>unsigned char&nbsp;</td>
<td class="mdname" nowrap> <em>hash</em>[SOAP_SMD_MAX_SIZE]</td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies the digest value of an XML element referenced by id against the hash.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>digest algorithm </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>id</em>&nbsp;</td><td>string of the XML element to verify </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>hash</em>&nbsp;</td><td>digest value to verify against </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a80" doxytag="wsseapi.c::soap_wsse_verify_done" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_done </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Terminates the automatic verification of signatures.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="a78" doxytag="wsseapi.c::soap_wsse_verify_init" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_init </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Uses the wsse plugin to initiate the verification of the signature and SignedInfo Reference digests.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK</dd></dl>
This function does not actually verify the message, but initiates the plugin's data to store the message in a DOM to verify the signature. The signature and digests in the DOM must be verified manually. </td>
</tr>
</table>
<a class="anchor" name="a45" doxytag="wsseapi.c::soap_wsse_verify_Password" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_Password </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const char *&nbsp;</td>
<td class="mdname" nowrap> <em>password</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies the supplied password or sets wsse:FailedAuthentication fault.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>password</em>&nbsp;</td><td>string to verify against </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK (authorized) or SOAP_FAULT with wsse:FailedAuthentication fault</dd></dl>
The verification supports both clear-text password verification and digest password authentication. For digest authentication a history mechanism with a digest authentication session database ensures protection against replay attacks. Note: this release supports the use of at most one UsernameToken in the header. </td>
</tr>
</table>
<a class="anchor" name="a59" doxytag="wsseapi.c::soap_wsse_verify_SignatureValue" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_SignatureValue </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>alg</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>const void *&nbsp;</td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>int&nbsp;</td>
<td class="mdname" nowrap> <em>keylen</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies the SignatureValue of a SignedInfo element.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>alg</em>&nbsp;</td><td>is SOAP_SMD_HMAC_SHA1, SOAP_SMD_VRFY_DSA_SHA1, or SOAP_SMD_VRFY_RSA_SHA1 determined by the SignedInfo/SignatureMethod </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>key</em>&nbsp;</td><td>to use to verify (HMAC or EVP_PKEY) </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>keylen</em>&nbsp;</td><td>length of HMAC key </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK, SOAP_EOM, or fault</dd></dl>
This function searches for the SignedInfo element in the soap-&gt;dom DOM tree to verify the signature in the SignatureValue element. Using the DOM ensures we will verify the signature of a SignedInfo as it was exactly received by the parser, by using the -DWITH_DOM compile flag and SOAP_XML_DOM runtime flag. If there is no DOM, it verifies the signature of the deserialized SignedInfo element in the SOAP Header. However, serializing deserialized data may change the octet stream that was signed, unless we're using gSOAP as producers and consumers (with the SOAP_XML_INDENT flag reset). </td>
</tr>
</table>
<a class="anchor" name="a60" doxytag="wsseapi.c::soap_wsse_verify_SignedInfo" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_SignedInfo </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies the digest values of the XML elements referenced by the SignedInfo References.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault</dd></dl>
This function searches for the SignedInfo element in the soap-&gt;dom DOM tree to verify the digests contained therein. Using the DOM ensures we will verify the digests of the locally signed elements as they were exactly received by the parser, by using the -DWITH_DOM compile flag and SOAP_XML_DOM runtime flag. If there is no DOM, the function fails. </td>
</tr>
</table>
<a class="anchor" name="a40" doxytag="wsseapi.c::soap_wsse_verify_Timestamp" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_Timestamp </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname1" valign="top" nowrap> <em>soap</em> </td>
<td class="md" valign="top">&nbsp;)&nbsp;</td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies the Timestamp/Expires element against the current time.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or SOAP_FAULT with wsse:FailedAuthentication fault</dd></dl>
Sets wsse:FailedAuthentication fault if wsu:Timestamp is expired. The SOAP_WSSE_CLKSKEW value is used as a margin to mitigate clock skew. Keeps silent when no timestamp is supplied or no expiration date is included in the wsu:Timestamp element. </td>
</tr>
</table>
<a class="anchor" name="a52" doxytag="wsseapi.c::soap_wsse_verify_X509" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> int soap_wsse_verify_X509 </td>
<td class="md" valign="top">(&nbsp;</td>
<td class="md" nowrap valign="top">struct soap *&nbsp;</td>
<td class="mdname" nowrap> <em>soap</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td></td>
<td class="md" nowrap>X509 *&nbsp;</td>
<td class="mdname" nowrap> <em>cert</em></td>
</tr>
<tr>
<td></td>
<td class="md">)&nbsp;</td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Verifies X509 certificate against soap-&gt;cafile, soap-&gt;capath, and soap-&gt;crlfile.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign=top><em>soap</em>&nbsp;</td><td>context </td></tr>
<tr><td><tt>[in]</tt>&nbsp;</td><td valign=top><em>cert</em>&nbsp;</td><td>X509 certificate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>SOAP_OK or fault</dd></dl>
This is an expensive operation, since we read the cafile and create the objects every time we need to verify a certificate. For future releases, we should store this data permanently in the gSOAP engine or plugin. </td>
</tr>
</table>
<hr><h2>Variable Documentation</h2>
<a class="anchor" name="a15" doxytag="wsseapi.c::c14n_URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a12">c14n_URI</a> = "http://www.w3.org/2001/10/xml-exc-c14n#" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a12" doxytag="wsseapi.c::ds_dsa_sha1URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a9">ds_dsa_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#dsa-sha1" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a11" doxytag="wsseapi.c::ds_hmac_sha1URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a8">ds_hmac_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#hmac-sha1" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a13" doxytag="wsseapi.c::ds_rsa_sha1URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a10">ds_rsa_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#rsa-sha1" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a10" doxytag="wsseapi.c::ds_sha1URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a7">ds_sha1URI</a> = "http://www.w3.org/2000/09/xmldsig#sha1" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a14" doxytag="wsseapi.c::ds_URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a11">ds_URI</a> = "http://www.w3.org/2000/09/xmldsig#" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a4" doxytag="wsseapi.c::soap_wsse_id" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char <a class="el" href="wsseapi_8h.html#a1">soap_wsse_id</a>[14] = SOAP_WSSE_ID </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Plugin identification for plugin registry </td>
</tr>
</table>
<a class="anchor" name="a17" doxytag="wsseapi.c::soap_wsse_session" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> struct <a class="el" href="structsoap__wsse__session.html">soap_wsse_session</a>* <a class="el" href="structsoap__wsse__session.html">soap_wsse_session</a> = NULL<code> [static]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
The digest authentication session database </td>
</tr>
</table>
<a class="anchor" name="a18" doxytag="wsseapi.c::soap_wsse_session_lock" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> MUTEX_TYPE <a class="el" href="wsseapi_8c.html#a18">soap_wsse_session_lock</a><code> [static]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
Lock for digest authentication session database exclusive access </td>
</tr>
</table>
<a class="anchor" name="a7" doxytag="wsseapi.c::wsse_Base64BinaryURI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a4">wsse_Base64BinaryURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a6" doxytag="wsseapi.c::wsse_PasswordDigestURI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a3">wsse_PasswordDigestURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a5" doxytag="wsseapi.c::wsse_PasswordTextURI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a2">wsse_PasswordTextURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a9" doxytag="wsseapi.c::wsse_X509v3SubjectKeyIdentifierURI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a6">wsse_X509v3SubjectKeyIdentifierURI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a8" doxytag="wsseapi.c::wsse_X509v3URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a5">wsse_X509v3URI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="a16" doxytag="wsseapi.c::wsu_URI" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* <a class="el" href="wsseapi_8h.html#a13">wsu_URI</a> = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
&nbsp;
</td>
<td>
<p>
</td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Fri Aug 19 10:41:45 2005 for gSOAP WS-Security by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0 ></a> 1.3.8 </small></address>
</body>
</html>