blob: 32be913a49cd996d1652eef8a1e809e9d5c45fb5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- qmailauthenticator.cpp -->
<head>
<title>QMailAuthenticator Class Reference</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><img src="images/qtlogo.png" align="left" border="0" /></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td>
<td align="right" valign="top" width="230"><img src="images/codeless.png" border="0" /></td></tr></table><h1 class="title">QMailAuthenticator Class Reference</h1>
<p>The QMailAuthenticator class provides a customization point where authentication services can be supplied to the messageserver. <a href="#details">More...</a></p>
<pre> #include <QMailAuthenticator></pre><p><b>This class is under development and is subject to change.</b></p>
<ul>
<li><a href="qmailauthenticator-members.html">List of all members, including inherited members</a></li>
</ul>
<hr />
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><b><a href="qmailauthenticator.html#getAuthentication">getAuthentication</a></b> ( const QMailAccountConfiguration::ServiceConfiguration & <i>svcCfg</i>, const QStringList & <i>capabilities</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><b><a href="qmailauthenticator.html#getResponse">getResponse</a></b> ( const QMailAccountConfiguration::ServiceConfiguration & <i>svcCfg</i>, const QByteArray & <i>challenge</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qmailauthenticator.html#useEncryption">useEncryption</a></b> ( const QMailAccountConfiguration::ServiceConfiguration & <i>svcCfg</i>, const QStringList & <i>capabilities</i> )</td></tr>
</table>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QMailAuthenticator class provides a customization point where authentication services can be supplied to the messageserver.</p>
<p>QMailAuthenticator provides a simple interface for handling authentication exchanges between the messageserver and external services. Protocol plugins operating within the messageserver should use the QMailAuthenticator interface to request the authentication type they should use, and to resolve any challenges required by the external server during the authentication process.</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="getAuthentication"></a><a href="http://doc.trolltech.com/4.5/qbytearray.html">QByteArray</a> QMailAuthenticator::getAuthentication ( const <a href="qmailaccountconfiguration-serviceconfiguration.html">QMailAccountConfiguration::ServiceConfiguration</a> & <i>svcCfg</i>, const <a href="http://doc.trolltech.com/4.5/qstringlist.html">QStringList</a> & <i>capabilities</i> ) <tt> [static]</tt></h3>
<p>Returns the authentication string that should be used to initiate an authentication attempt for the service whose configuration is described by <i>svcCfg</i>. The preferred authentication method may depend upon the service's reported <i>capabilities</i>.</p>
<h3 class="fn"><a name="getResponse"></a><a href="http://doc.trolltech.com/4.5/qbytearray.html">QByteArray</a> QMailAuthenticator::getResponse ( const <a href="qmailaccountconfiguration-serviceconfiguration.html">QMailAccountConfiguration::ServiceConfiguration</a> & <i>svcCfg</i>, const <a href="http://doc.trolltech.com/4.5/qbytearray.html">QByteArray</a> & <i>challenge</i> ) <tt> [static]</tt></h3>
<p>Returns the response string that should be reported as the response to a service's <i>challenge</i>, for the the service desribed by <i>svcCfg</i>.</p>
<p>If the protocol invoking the challenge-response resolution requires encoding for the challenge-response tokens (such as Base64), the challenge should be decoded before invocation, and the result should be encoded for transmission.</p>
<h3 class="fn"><a name="useEncryption"></a>bool QMailAuthenticator::useEncryption ( const <a href="qmailaccountconfiguration-serviceconfiguration.html">QMailAccountConfiguration::ServiceConfiguration</a> & <i>svcCfg</i>, const <a href="http://doc.trolltech.com/4.5/qstringlist.html">QStringList</a> & <i>capabilities</i> ) <tt> [static]</tt></h3>
<p>Returns true if the protocol should immediately switch to using TLS encryption; otherwise returns false. The use of encryption may be preferred depending on the service whose configuration is described by <i>svcCfg</i>, and the service's reported <i>capabilities</i>.</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td align="left">Copyright © 2010 QtSoftware</td>
<td align="right"><div align="right">Messaging Framework</div></td>
</tr></table></div></address></body>
</html>
|
