https://wiki.davical.org/index.php?title=Configuration/hooks/Authentication/IMAP&feed=atom&action=historyConfiguration/hooks/Authentication/IMAP - Revision history2024-03-29T05:04:49ZRevision history for this page on the wikiMediaWiki 1.40.1https://wiki.davical.org/index.php?title=Configuration/hooks/Authentication/IMAP&diff=3624&oldid=prevFsfs: delete "known problem" fixed in 1.1.02016-01-02T00:07:11Z<p>delete "known problem" fixed in 1.1.0</p>
<p><b>New page</b></p><div>{{languages|Configuration/hooks/Authentication/IMAP}}<br />
<br />
''Last updated for the [[Release_Notes/1.0.2 | 1.0.2 release.]]''<br />
<br />
Documentation for the IMAP authentication driver (inc/drivers_imap_pam.php).<br />
<br />
This driver allows DAViCal to accept authentication via a local or remote IMAP server.<br />
<br />
PHP IMAP is required as an extra dependency. Install '''php5-imap''' on Debian/Ubuntu based systems.<br />
<br />
== IMAP Settings ==<br />
<br />
The settings for the IMAP server connection go in the config file <tt>/etc/davical/<servername>-conf.php</tt> (this file might be in <tt>/etc/rscds/</tt> if you upgraded from an older installation).<br />
<br />
<pre><br />
$c->authenticate_hook['call'] = 'IMAP_PAM_check';<br />
$c->authenticate_hook['config'] = array(<br />
'imap_url' => '{<IMAP SERVER>}',<br />
'email_base' => '<EMAIL DOMAIN HOST>'<br />
);<br />
include('drivers_imap_pam.php');<br />
</pre><br />
<br />
'''imap_url''' is required. ''IMAP SERVER'' must be an IMAP URL surrounded by curly brackets as [http://php.net/manual/en/function.imap-open.php documented in the PHP manual.] Some common examples are provided below:<br />
<br />
<pre><br />
{localhost:143/imap/} // Insecure on local server<br />
{localhost:143/imap/tls/} // START TLS to a local server<br />
{example.com:993/imap/ssl/} // Legacy SSL on deprecated port<br />
{example.com:143/imap/tls/novalidate-cert} // Self-signed certificate<br />
</pre><br />
<br />
Note that authenticating to an external server over TLS/SSL is slow. The connection to the IMAP server will not request a working mailbox and the server response should thus not be too slow.<br />
<br />
Providing an hostname/mailname (''example.com'') through the '''email_base''' parameter is optional.<br />
<br />
== Example ==<br />
<br />
The following config example allows DAViCal to authenticate users via a secure IMAP server at example.com:<br />
<pre><br />
<?php<br />
$c->authenticate_hook['call'] = 'IMAP_PAM_check';<br />
$c->authenticate_hook['config'] = array(<br />
'imap_url' => '{example.com:143/imap/tls/}',<br />
'email_base' => 'example.com'<br />
);<br />
include('drivers_imap_pam.php');<br />
</pre><br />
<br />
<br />
<br />
[[Category:Configuration]]</div>Fsfs