<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Cyrus SASL 2.1.x Release Notes — Cyrus SASL 2.1.27 documentation</title>
<link rel="shortcut icon" href="../../../_static/favicon.ico"/>
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/cyrus.css" type="text/css" />
<link rel="index" title="Index"
href="../../../genindex.html"/>
<link rel="search" title="Search" href="../../../search.html"/>
<link rel="top" title="Cyrus SASL 2.1.27 documentation" href="../../../index.html"/>
<link rel="up" title="Release Notes" href="../index.html"/>
<link rel="next" title="Cyrus SASL 2.0.x Release Notes" href="../2.0/index.html"/>
<link rel="prev" title="Release Notes" href="../index.html"/>
</head>
<body class="wy-body-for-nav" role="document">
<div class="pageheader">
<ul>
<li><a href="../../../index.html">Home</a></li>
<li><a href="http://www.cyrusimap.org">Cyrus IMAP</a></li>
<li><a href="../../../download.html">Download</a></li>
<li><a href="../../../contribute.html">Contribute</a></li>
</ul>
<div>
<a href="../../../index.html">
<img src="../../../_static/logo.gif" alt="CYRUS SASL" />
</a>
</div>
</div>
<div style="clear: both;"></div>
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-nav-search">
<a href="../../../index.html">
<img src="../../../_static/logo.gif" />
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Cyrus SASL</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="../../../download.html">Download</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../../../getsasl.html">Get SASL</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../installation.html">Installation</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#quick-install-guide">Quick install guide</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#detailed-installation-guide">Detailed installation guide</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#supported-platforms">Supported platforms</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2 current"><a class="reference internal" href="../index.html">Release Notes</a><ul class="current">
<li class="toctree-l3 current"><a class="reference internal" href="../index.html#supported-product-series">Supported Product Series</a><ul class="current">
<li class="toctree-l4 current"><a class="reference internal" href="../index.html#series-2-1">Series 2.1</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../index.html#older-versions">Older Versions</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../index.html#series-2-2-0">Series 2: 2.0</a></li>
<li class="toctree-l4"><a class="reference internal" href="../index.html#series-1">Series 1</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../../packager.html">Note for Packagers</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../quickstart.html">Quickstart guide</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../quickstart.html#features">Features</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../quickstart.html#typical-installation">Typical Installation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../quickstart.html#configuration">Configuration</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../concepts.html">Concepts</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#sasl">SASL</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#sasl-authentication-mechanisms">SASL Authentication Mechanisms</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#security-layers">Security Layers</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#channel-binding">Channel Binding</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#realms">Realms</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#protocols">Protocols</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#cyrus-sasl">Cyrus SASL</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#the-glue-library">The Glue Library</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#auxiliary-properties">Auxiliary Properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../concepts.html#plugins">Plugins</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../../setup.html">Setup</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../installation.html">Installation</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../installation.html#quick-install-guide">Quick install guide</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#tarball-installation">Tarball installation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#unix-package-installation">Unix package Installation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#configuration">Configuration</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../installation.html#detailed-installation-guide">Detailed installation guide</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#requirements">Requirements</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#build-configuration">Build Configuration</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#building-and-installation">Building and Installation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#compilation-hints">Compilation Hints</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation.html#application-configuration">Application Configuration</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../installation.html#supported-platforms">Supported platforms</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../upgrading.html">Upgrading from v1 to v2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../upgrading.html#backwards-compatibility">Backwards Compatibility</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../upgrading.html#coexistence-with-saslv1">Coexistence with SASLv1</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../upgrading.html#database-upgrades">Database Upgrades</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../upgrading.html#errors-on-migration">Errors on migration</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../components.html">Components</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../components.html#the-application">The Application</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../components.html#the-sasl-glue-layer">The SASL Glue Layer</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../components.html#plugins">Plugins</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../components.html#plugins-general">Plugins: General</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../components.html#plugins-sasl-mechanisms">Plugins: SASL Mechanisms</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../components.html#plugins-auxiliary-property">Plugins: Auxiliary Property</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../components.html#plugins-username-canonicalization">Plugins: Username Canonicalization</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../components.html#password-verification-services">Password Verification Services</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../options.html">Options</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#sasl-library">SASL Library</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#auxiliary-property-plugin">Auxiliary Property Plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#gssapi">GSSAPI</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#ldapdb">LDAPDB</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../options.html#notes-on-ldapdb">Notes on LDAPDB</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../options.html#examples">Examples</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#ntlm">NTLM</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#otp">OTP</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#digest-md5">Digest-md5</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#sasldb">SASLDB</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../options.html#notes-on-sasldb-with-lmdb">Notes on sasldb with LMDB</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#sql-plugin">SQL Plugin</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../options.html#notes-on-sql">Notes on SQL</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../options.html#id2">Examples</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#srp">SRP</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../options.html#kerberos-v4">Kerberos V4</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../advanced.html">Advanced Usage</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../advanced.html#notes-for-advanced-usage-of-libsasl">Notes for Advanced Usage of libsasl</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../advanced.html#using-cyrus-sasl-as-a-static-library">Using Cyrus SASL as a static library</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../../operations.html">Operations</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../sysadmin.html">System Administrators</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../sysadmin.html#what-sasl-is">What SASL is</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#authentication-and-authorization-identifiers">Authentication and authorization identifiers</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#realms">Realms</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../sysadmin.html#how-sasl-works">How SASL works</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#the-plain-mechanism-sasl-checkpass-and-plaintext-passwords">The PLAIN mechanism, <code class="docutils literal"><span class="pre">sasl_checkpass()</span></code>, and plaintext passwords</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#shared-secrets-mechanisms">Shared secrets mechanisms</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#kerberos-mechanisms">Kerberos mechanisms</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#the-otp-mechanism">The OTP mechanism</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../sysadmin.html#auxiliary-properties">Auxiliary Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../sysadmin.html#how-to-set-configuration-options">How to set configuration options</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#the-default-configuration-file">The default configuration file</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../sysadmin.html#application-configuration">Application configuration</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../sysadmin.html#troubleshooting">Troubleshooting</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../manpages.html">Man pages</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../manpages.html#library-files">(3) Library Files</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl.html"><strong>SASL</strong> - SASL Authentication Library</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_authorize_t.html"><strong>sasl_authorize_t</strong> - The SASL authorization callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_auxprop.html"><strong>sasl_auxprop</strong> - How to work with SASL auxiliary properties</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_auxprop_add_plugin.html"><strong>sasl_auxprop_add_plugin</strong> - add a SASL auxiliary property plugin</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_auxprop_getctx.html"><strong>sasl_auxprop_getctx</strong> - Acquire an auxiliary property context</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_auxprop_request.html"><strong>sasl_auxprop_request</strong> - Request auxiliary properties from SASL</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_callbacks.html"><strong>sasl_callbacks</strong> - How to work with SASL callbacks</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_canon_user_t.html"><strong>sasl_canon_user_t</strong> - Application-supplied user canonicalization function</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_canonuser_add_plugin.html"><strong>sasl_canonuser_add_plugin</strong> - add a SASL user canonicalization plugin</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_chalprompt_t.html"><strong>sasl_chalprompt_t</strong> - Realm acquisition callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_checkapop.html"><strong>sasl_checkapop</strong> - Check an APOP challenge/response</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_checkpass.html"><strong>sasl_checkpass</strong> - Check a plaintext password</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_add_plugin.html"><strong>sasl_client_add_plugin</strong> - add a SASL client plugin</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_done.html"><strong>sasl_client_done</strong> - Cleanup function</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_init.html"><strong>sasl_client_init</strong> - SASL client authentication initialization</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_new.html"><strong>sasl_client_new</strong> - Create a new client authentication object</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_plug_init_t.html"><strong>sasl_client_plug_init_t</strong> - client plug‐in entry point</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_start.html"><strong>sasl_client_start</strong> - Begin an authentication negotiation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_client_step.html"><strong>sasl_client_step</strong> - Perform a step in the authentication negotiation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_decode.html"><strong>sasl_decode</strong> - Decode data received</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_decode64.html"><strong>sasl_decode64</strong> - Decode base64 string</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_dispose.html"><strong>sasl_dispose</strong> - Dispose of a SASL connection object</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_done.html"><strong>sasl_done</strong> - Dispose of a SASL connection object</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_encode.html"><strong>sasl_encode</strong> - Encode data for transport to authenticated host</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_encode64.html"><strong>sasl_encode64</strong> - Encode base64 string</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_encodev.html"><strong>sasl_encodev</strong> - Encode data for transport to authenticated host</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_erasebuffer.html"><strong>sasl_erasebuffer</strong> - erase buffer</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_errdetail.html"><strong>sasl_errdetail</strong> - Retrieve detailed information about an error</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_errors.html"><strong>sasl_errors</strong> - SASL error codes</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_errstring.html"><strong>sasl_errstring</strong> - Translate a SASL return code to a human-readable form</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getcallback_t.html"><strong>sasl_getcallback_t</strong> - callback function to lookup a sasl_callback_t for a connection</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getconfpath_t.html"><strong>sasl_getconfpath_t</strong> - The SASL callback to indicate location of the config files</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getopt_t.html"><strong>sasl_getopt_t</strong> - The SASL get option callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getpath_t.html"><strong>sasl_getpath_t</strong> - The SASL callback to indicate location of the mechanism drivers</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getprop.html"><strong>sasl_getprop</strong> - Get a SASL property</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getrealm_t.html"><strong>sasl_getrealm_t</strong> - Realm Acquisition Callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getsecret_t.html"><strong>sasl_getsecret_t</strong> - The SASL callback for secrets (passwords)</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_getsimple_t.html"><strong>sasl_getsimple_t</strong> - The SASL callback for username/authname/realm</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_global_listmech.html"><strong>sasl_global_listmech</strong> - Retrieve a list of the supported SASL mechanisms</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_idle.html"><strong>sasl_idle</strong> - Perform precalculations during an idle period</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_listmech.html"><strong>sasl_listmech</strong> - Retrieve a list of the supported SASL mechanisms</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_log_t.html"><strong>sasl_log_t</strong> - The SASL logging callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_add_plugin.html"><strong>sasl_server_add_plugin</strong> - add a SASL server plugin</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_done.html"><strong>sasl_server_done</strong> - Cleanup function</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_init.html"><strong>sasl_server_init</strong> - SASL server authentication initialization</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_new.html"><strong>sasl_server_new</strong> - Create a new server authentication object</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_plug_init_t.html"><strong>sasl_server_plug_init_t</strong> - server plug‐in entry point</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_start.html"><strong>sasl_server_start</strong> - Begin an authentication negotiation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_step.html"><strong>sasl_server_step</strong> - Perform a step in the authentication negotiation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_userdb_checkpass_t.html"><strong>sasl_server_userdb_checkpass_t</strong> - Plaintext Password Verification Callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_server_userdb_setpass_t.html"><strong>sasl_server_userdb_setpass_t</strong> - UserDB Plaintext Password Setting Callback</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_set_alloc.html"><strong>sasl_set_alloc</strong> - set the memory allocation functions used by the SASL library</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_set_mutex.html"><strong>sasl_set_mutex</strong> - set the mutex lock functions used by the SASL library</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_seterror.html"><strong>sasl_seterror</strong> - set the error string</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_setpass.html"><strong>sasl_setpass</strong> - Check a plaintext password</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_setprop.html"><strong>sasl_setprop</strong> - Set a SASL property</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_user_exists.html"><strong>sasl_user_exists</strong> - Check if a user exists on server</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_usererr.html"><strong>sasl_usererr</strong> - Remove information leak about accounts from sasl error codes</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_utf8verify.html"><strong>sasl_utf8verify</strong> - Verify a string is valid utf8</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../reference/manpages/library/sasl_verifyfile_t.html"><strong>sasl_verifyfile_t</strong> - The SASL file verification</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../auxiliary_properties.html">Auxiliary Properties</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../auxiliary_properties.html#auxiliary-properties-and-the-glue-layer">Auxiliary Properties and the Glue Layer</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../auxiliary_properties.html#passwords-and-other-data">Passwords and other Data</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../auxiliary_properties.html#sasldb">sasldb</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../auxiliary_properties.html#ldapdb">ldapdb</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../auxiliary_properties.html#sql">sql</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../auxiliary_properties.html#user-canonicalization">User Canonicalization</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../authentication_mechanisms.html">Authentication Mechanisms</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../authentication_mechanisms.html#mechanisms">Mechanisms</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#anonymous">ANONYMOUS</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#cram-md5">CRAM-MD5</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#digest-md5">DIGEST-MD5</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#external">EXTERNAL</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#g2">G2</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#gssapi">GSSAPI</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#gss-spegno">GSS-SPEGNO</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#kerberos-v4">KERBEROS_V4</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#login">LOGIN</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#ntlm">NTLM</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#otp">OTP</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#passdss">PASSDSS</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#plain">PLAIN</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#scram">SCRAM</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#srp">SRP</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../authentication_mechanisms.html#non-sasl-authentication">Non-SASL Authentication</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../authentication_mechanisms.html#summary">Summary</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../pwcheck.html">Pwcheck</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../pwcheck.html#auxprop">Auxprop</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../pwcheck.html#auxprop-hashed">Auxprop-hashed</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../pwcheck.html#saslauthd">Saslauthd</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../pwcheck.html#authdaemon">Authdaemon</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../pwcheck.html#alwaystrue">Alwaystrue</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../pwcheck.html#auto-transition">Auto Transition</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../faq.html">Frequently Asked Questions</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../faqs/authorize-vs-authenticate.html">What is the difference between an Authorization ID and a Authentication ID?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../faqs/crammd5-digestmd5.html">Why do CRAM-MD5 and DIGEST-MD5 not work with CyrusSaslauthd?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../faqs/openldap-sasl-gssapi.html">How do I configure OpenLDAP +SASL+GSSAPI?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../faqs/plaintextpasswords.html">Why does CyrusSasl store plaintext passwords in its databases?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../faqs/rfcs.html">RFCs and drafts</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../faqs/upgrade-saslv2.html">Why am I having a problem running dbconverter-2 to upgrade from SASLv1 to SASLv2?</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../resources.html">Other Documentation & Resources</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer.html">Developers</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../appconvert.html">Converting Applications from v1 to v2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../appconvert.html#tips-for-both-clients-and-servers">Tips for both clients and servers</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../appconvert.html#tips-for-clients">Tips for clients</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../appconvert.html#tips-for-servers">Tips for Servers</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../developer/programming.html">Application Programmer’s Guide</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#introduction">Introduction</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#about-this-guide">About this Guide</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#what-is-sasl">What is SASL?</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#background">Background</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#how-did-the-world-work-before-sasl">How did the world work before SASL?</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#sasl-to-the-rescue">SASL to the rescue!</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#briefly">Briefly</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#what-is-the-cyrus-sasl-library-good-for">What is the Cyrus SASL library good for?</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#what-does-the-cyrus-sasl-library-do">What does the Cyrus SASL library do?</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#what-doesn-t-the-cyrus-sasl-library-do">What doesn’t the Cyrus SASL library do?</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#client-only-section">Client-only Section</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#a-typical-interaction-from-the-client-s-perspective">A typical interaction from the client’s perspective</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#how-does-this-look-in-code">How does this look in code</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#server-only-section">Server-only Section</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#a-typical-interaction-from-the-server-s-perspective">A typical interaction from the server’s perspective</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#id1">How does this look in code?</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#common-section">Common Section</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#callbacks-and-interactions">Callbacks and Interactions</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#security-layers">Security layers</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#example-applications-that-come-with-the-cyrus-sasl-library">Example applications that come with the Cyrus SASL library</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#sample-client-and-sample-server"><cite>sample-client</cite> and <cite>sample-server</cite></a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#cyrus-imapd-v2-1-0-or-later">Cyrus imapd v2.1.0 or later</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#imtest-from-cyrus-2-1-0-or-later"><cite>imtest</cite>, from Cyrus 2.1.0 or later</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/programming.html#miscellaneous-information">Miscellaneous Information</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#empty-exchanges">Empty exchanges</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/programming.html#idle">Idle</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../developer/plugprog.html">Plugin Programmer’s Guide</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../developer/plugprog.html#introduction">Introduction</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#about-this-guide">About this Guide</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#what-is-sasl">What is SASL?</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/plugprog.html#common-section">Common Section</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#overview-of-plugin-programming">Overview of Plugin Programming</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#use-of-sasl-utils-t">Use of sasl_utils_t</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#error-reporting">Error Reporting</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#memory-allocation">Memory Allocation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../developer/plugprog.html#client-send-first-server-send-last">Client Send First / Server Send Last</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/plugprog.html#client-plugins">Client Plugins</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/plugprog.html#server-plugins">Server Plugins</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/plugprog.html#user-canonicalization-canon-user-plugins">User Canonicalization (canon_user) Plugins</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/plugprog.html#auxiliary-property-auxprop-plugins">Auxiliary Property (auxprop) Plugins</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../developer/testing.html">Testing</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../developer/testing.html#testing-the-cmu-sasl-library-with-the-included-sample-applications">Testing the CMU SASL Library with the included sample applications</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../developer/testing.html#example">Example</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../developer/testing.html#running-the-testsuite-application">Running the Testsuite application</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../../support.html">Support/Community</a></li>
</ul>
<p class="caption"><span class="caption-text">IMAP</span></p>
<ul>
<li class="toctree-l1"><a class="reference external" href="http://www.cyrusimap.org">Cyrus IMAP</a></li>
</ul>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../../index.html">Cyrus SASL</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../../index.html">Docs v2.1.27</a> »</li>
<li><a href="../../../download.html">Download</a> »</li>
<li><a href="../index.html">Release Notes</a> »</li>
<li>Cyrus SASL 2.1.x Release Notes</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/cyrusimap/cyrus-sasl/blob/master/docsrc/sasl/release-notes/2.1/index.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document">
<div class="section" id="cyrus-sasl-2-1-x-release-notes">
<h1>Cyrus SASL 2.1.x Release Notes<a class="headerlink" href="#cyrus-sasl-2-1-x-release-notes" title="Permalink to this headline">¶</a></h1>
<div class="section" id="new-in-2-1-27">
<h2>New in 2.1.27<a class="headerlink" href="#new-in-2-1-27" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Added support for OpenSSL 1.1</li>
<li>Added support for lmdb (from Howard Chu)</li>
<li>Lots of build fixes (from Ignacio Casal Quinteiro and others)</li>
<li>Treat SCRAM and DIGEST-MD5 as more secure than PLAIN when selecting client mech</li>
<li>DIGEST-MD5 plugin:<ul>
<li>Fixed memory leaks</li>
<li>Fixed a segfault when looking for non-existent reauth cache</li>
<li>Prevent client from going from step 3 back to step 2</li>
<li>Allow cmusaslsecretDIGEST-MD5 property to be disabled</li>
</ul>
</li>
<li>GSSAPI plugin:<ul>
<li>Added support for retrieving negotiated SSF</li>
<li>Fixed GSS-SPNEGO to use flags negotiated by GSSAPI for SSF</li>
<li>Properly compute maxbufsize AFTER security layers have been set</li>
</ul>
</li>
<li>SCRAM plugin:<ul>
<li>Added support for SCRAM-SHA-256</li>
</ul>
</li>
<li>LOGIN plugin:<ul>
<li>Don’t prompt client for password until requested by server</li>
</ul>
</li>
<li>NTLM plugin:<ul>
<li>Fixed crash due to uninitialized HMAC context</li>
</ul>
</li>
<li>saslauthd:<ul>
<li>cache.c:<ul>
<li>Don’t use cached credentials if timeout has expired</li>
<li>Fixed debug logging output</li>
</ul>
</li>
<li>ipc_doors.c:<ul>
<li>Fixed potential DoS attack (from Oracle)</li>
</ul>
</li>
<li>ipc_unix.c:<ul>
<li>Prevent premature closing of socket</li>
</ul>
</li>
<li>auth_rimap.c:<ul>
<li>Added support LOGOUT command</li>
<li>Added support for unsolicited CAPABILITY responses in LOGIN reply</li>
<li>Properly detect end of responses (don’t needlessly wait)</li>
<li>Properly handle backslash in passwords</li>
</ul>
</li>
<li>auth_httpform:<ul>
<li>Fix off-by-one error in string termination</li>
<li>Added support for 204 success response</li>
</ul>
</li>
<li>auth_krb5.c:<ul>
<li>Added krb5_conv_krb4_instance option</li>
<li>Added more verbose error logging</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="new-in-2-1-26">
<h2>New in 2.1.26<a class="headerlink" href="#new-in-2-1-26" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Modernize SASL malloc/realloc callback prototypes</li>
<li>Added sasl_config_done() to plug a memory leak when using an application
specific config file</li>
<li>Fixed PLAIN/LOGIN authentication failure when using saslauthd
with no auxprop plugins (bug # 3590).</li>
<li>unlock the mutex in sasl_dispose if the context was freed by another thread</li>
<li>MINGW32 compatibility patches</li>
<li>Fixed broken logic in get_fqhostname() when abort_if_no_fqdn is 0</li>
<li>Fixed some memory leaks in libsasl</li>
<li>GSSAPI plugin:<ul>
<li>Fixed a segfault in gssapi.c introduced in 2.1.25.</li>
<li>Code refactoring</li>
<li>Added support for GSS-SPNEGO SASL mechanism (Unix only), which is also
HTTP capable</li>
</ul>
</li>
<li>GS2 plugin:<ul>
<li>Updated GS2 plugin not to lose minor GSS-API status codes on errors</li>
</ul>
</li>
<li>DIGEST-MD5 plugin:<ul>
<li>Correctly send “stale” directive to prevent clients from (re)promtping
for password</li>
<li>Better handling of HTTP reauthentication cases</li>
<li>fixed some memory leaks</li>
</ul>
</li>
<li>SASLDB plugin:<ul>
<li>Added support for BerkleyDB 5.X or later</li>
</ul>
</li>
<li>OTP plugin:<ul>
<li>Removed calling of EVP_cleanup() on plugin shutdown in order to prevent
TLS from failing in calling applications</li>
</ul>
</li>
<li>SRP plugin:<ul>
<li>Removed calling of EVP_cleanup() on plugin shutdown in order to prevent
TLS from failing in calling applications</li>
</ul>
</li>
<li>saslauthd:<ul>
<li>auth_rimap.c: qstring incorrectly appending the closing double quote,
which might be causing crashes</li>
<li>auth_rimap.c: read the whole IMAP greeting</li>
<li>better error reporting from some drivers</li>
<li>fixed some memory leaks</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="new-in-2-1-25">
<h2>New in 2.1.25<a class="headerlink" href="#new-in-2-1-25" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Make sure that a failed authorization doesn’t preclude
further server-side SASL authentication attempts from working.</li>
<li>Fixed a crash caused by aborted SASL authentication
and initiation of another one using the same SASL context.</li>
<li>(Windows) Fixed the random number generator to actually produce random
output on each run.</li>
<li>Be protective against calling sasl_server_step once authentication
has failed (multiple SASL plugins)</li>
<li>Fixed several bugs in the mech_avail callback handling
in the server side code.</li>
<li>Added support for channel bindings</li>
<li>Added support for ordering SASL mechanisms by strength (on the client side),
or using the “client_mech_list” option.</li>
<li>server_idle needs to obey server’s SASL mechanism list from the server
context.</li>
<li>Better server plugin API mismatch reporting</li>
<li>Build:
- Updated config to the latest GNU snapshot
- Fixed SASL’s libtool MacOS/X 64-bit file magic</li>
<li>New SASL plugin: SCRAM</li>
<li>New SASL plugin: GS2</li>
<li>DIGEST-MD5 plugin:</li>
</ul>
<blockquote>
<div><ul class="simple">
<li>Allow DIGEST-MD5 plugin to be used for client-side and
server-side HTTP Digest, including running over non-persistent
connections (RFC 2617)</li>
<li>Use the same username for reauthentication cache lookup and update</li>
<li>Minimize the number of auxprop lookups in the server side DIGEST-MD5
plugin for the most common case when authentication and authorization
identities are the same.</li>
<li>Updated digestmd5_server_mech_step2() to be more defensive against
empty client input.</li>
<li>Fixed some memory leaks on failed plugin initialization.
Prevent potential race condition when freeding plugin state.
Set the freed reauthentication cache mutex to NULL, to make errors
due to mutex access after free more obvious.</li>
<li>Test against broken UTF-8 based hashes if calculation using special
ISO-8859-1 code fails.</li>
<li>Fixed an interop problem with some LDAP clients ignoring server
advertised realm and providing their own.</li>
</ul>
</div></blockquote>
<ul class="simple">
<li>GSSAPI plugin:<ul>
<li>Fix to build GSSAPI with Heimdal</li>
<li>Properly set serveroutlen to 0 in one place.
Don’t send empty challenge once server context establishment is done,
as this is in violation of the RFC 2222 and its successor.</li>
<li>Don’t send maxbuf, if no security layer can be established.
Added additional checks for buffer lengths.</li>
</ul>
</li>
<li>LDAPDB plugin:
- build fixes</li>
</ul>
</div>
<div class="section" id="new-in-2-1-24">
<h2>New in 2.1.24<a class="headerlink" href="#new-in-2-1-24" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Order advertised server-side SASL mechanisms per the specified ‘mech_list’
option or by relative “strength”</li>
<li>Make sure that sasl_set_alloc() has no effect once sasl_client_init()
or sasl_server_init() is called</li>
<li>Fixed sasl_set_mutex() to disallow changing mutex management functions
once sasl_server_init()/sasl_client_init() is called (bug # 3083)</li>
<li>Removed unused mutexes in lib/client.c and lib/server.c (bug # 3141)</li>
<li>Added direct support for hashed password to auxprop API</li>
<li>Don’t treat a constraint violation as an error to store an auxprop property</li>
<li>Extended libsasl (auxprop) to support user deletion</li>
<li>Extended SASL auxprop_lookup to return error code</li>
<li>Updated sasl_user_exists() so that it can handle passwordless accounts (e.g. disabled)</li>
<li>(Windows) Free handles of shared libraries on Windows that were loaded
but are not SASL plugins (bug # 2089)</li>
<li>Prevent freeing of common state on a subsequent call to _sasl_common_init.
Make sure that the last global callback always wins.</li>
<li>Implemented sasl_client_done()/sasl_server_done()</li>
<li>Added automatic hostname canonicalization inside libsasl</li>
<li>Made sasl_config_init() public</li>
<li>Strip trailing spaces from server config file option values (bug # 3139, bug # 3041)</li>
<li>Fixed potential buffer overflow in saslautd_verify_password().</li>
<li>Fixed segfault in dlclose() on HPUX</li>
<li>Various bugfixes for 64bit platforms</li>
<li>Fixed bug # 2895 (passing LF to sasl_decode64) in sample/sample-client.c,
sample/sample-server.c, utils/smtptest.c</li>
<li>pluginviewer: Code cleanup, improved human readable messages</li>
<li>Build:
- (Windows) Updated makefiles to build with VC 8.0 (VC++ 2005)
- (Windows) Added Windows64 build
- Updated to use .plugin extension on MacOS
- Changed 64bit HP-UX build to use .so for shared libraries</li>
<li>saslauthd:<ul>
<li>Fixed bug counting double-quotes in username/password in
auth_rimap.c. Also fixed bug zeroing password.</li>
<li>auth_krb.c: improved diagnostic in the k5support_verify_tgt() function.</li>
<li>auth_sasldb.c: pid_file_lock is created with a mask of 644 instead of 0644</li>
<li>auth_shadow.c: Define _XOPEN_SOURCE before including unistd.h,
so that crypt is correctly defined</li>
<li>auth_getpwent.c: Fixed Solaris build</li>
</ul>
</li>
<li>SASLDB plugin:<ul>
<li>Fixed spurious ‘user not found’ errors caused by an attempt
to delete a non-existent property</li>
<li>Added direct support for hashed password to auxprop API</li>
<li>Sleepycat driver: Return SASL_NOUSER instead of SASL_FAIL when the database
file doesn’t exist</li>
<li>Ignore properties starting with ‘*’ in the auxprop store function</li>
</ul>
</li>
<li>SQL plugin:
- Added support for SQLITE3
- Uninitialized variables can cause crash when the searched user is not found
- Added direct support for hashed password
- Ignore properties starting with ‘*’ in the auxprop store function</li>
<li>LDAPDB plugin:<ul>
<li>Added code to extend LDAPDB into a canon_user plugin in addition
to its existing auxprop plugin functionality</li>
</ul>
</li>
<li>PLAIN plugin:
- Advertise SASL_SEC_PASS_CREDENTIALS feature</li>
<li>LOGIN plugin:
- Advertise SASL_SEC_PASS_CREDENTIALS feature</li>
<li>DIGEST-MD5 plugin:<ul>
<li>Fixed a memory leak in the DIGEST-MD5 security layer</li>
<li>Fixed memory leaks in client-side reauth and other places</li>
<li>More detailed error reporting.</li>
<li>Fixed parsing of challenges/responses with extra commas.</li>
<li>Allow for multiple qop options from the server and require
a single qop option from the client.</li>
</ul>
</li>
<li>GSSAPI plugin:
- Check that params->serverFQDN is not NULL before using strlen on it
- Make auxprop lookup calls optional</li>
<li>EXTERNAL plugin:
- Make auxprop lookup calls optional</li>
<li>NTLM plugin:
- allow a comma separated list of servernames in ‘ntlm_server’ option
- Fixed crash in calculating NTv2 reponse</li>
<li>OTP plugin:
- Don’t use a stack variable for an OTP prompt (bug # 2822)
- Downgrade the failure to store OTP secret to debug level</li>
<li>KERBEROS_V4 plugin:
- Make auxprop lookup calls optional</li>
</ul>
</div>
<div class="section" id="new-in-2-1-23">
<h2>New in 2.1.23<a class="headerlink" href="#new-in-2-1-23" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed CERT VU#238019 (make sure sasl_encode64() always NUL
terminates output or returns SASL_BUFOVER)</li>
</ul>
</div>
<div class="section" id="new-in-2-1-22">
<h2>New in 2.1.22<a class="headerlink" href="#new-in-2-1-22" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Added support for spliting big data blocks (bigger than maxbuf)
into multiple SASL packets in sasl_encodev</li>
<li>Various sasl_decode64() fixes</li>
<li>Increase canonicalization buffer size to 1024 bytes</li>
<li>Call do_authorization() after successful APOP authentication</li>
<li>Allow for configuration file location to be configurable independently
of plugin location (bug # 2795)</li>
<li>Added sasl_set_path function, which provides a more convenient way
of setting plugin and config paths. Changed the default
sasl_getpath_t/sasl_getconfpath_t callbacks to calculate
the value only once and cache it for later use.</li>
<li>Fixed load_config to search for the config file in all directories
(bug # 2796). Changed the default search path to be
/usr/lib/sasl2:/etc/sasl2</li>
<li>Don’t ignore log_level configuration option in default UNIX syslog
logging callback</li>
<li>(Windows) Minor IPv6 related changes in Makefiles for Visual Studio 6</li>
<li>(Windows) Fixed bug of not setting the CODEGEN (code generation option)
nmake option if STATIC nmake option is set.</li>
<li>Several fixed to DIGEST-MD5 plugin:<ul>
<li>Enable RC4 cipher in Windows build of DIGEST-MD5</li>
<li>Server side: handle missing realm option as if realm=”” was sent</li>
<li>Fix DIGEST-MD5 to properly advertise maxssf when both DES and RC4
are disabled</li>
<li>Check that DIGEST-MD5 SASL packet are no shorter than 16 bytes</li>
</ul>
</li>
<li>Several changes/fixed to SASLDB plugin:<ul>
<li>Prevent spurious SASL_NOUSER errors</li>
<li>Added ability to keep BerkleyDB handle open between operations
(for performance reason). New behavior can be enabled
with –enable-keep-db-open.</li>
</ul>
</li>
<li>Better error checking in SQL (MySQL) auxprop plugin code</li>
<li>Added support for HTTP POST password validation in saslauthd</li>
<li>Added new application (“pluginviewer”) that helps report information
about installed plugins</li>
<li>Allow for building with OpenSSL 0.9.8</li>
<li>Allow for building with OpenLDAP 2.3+</li>
<li>Several quoting fixes to configure script</li>
<li>A large number of other minor bugfixes and cleanups</li>
</ul>
</div>
<div class="section" id="new-in-2-1-21">
<h2>New in 2.1.21<a class="headerlink" href="#new-in-2-1-21" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixes DIGEST-MD5 server side segfault caused by the client not sending
any realms</li>
<li>Minor Other bugfixes</li>
</ul>
</div>
<div class="section" id="new-in-2-1-20">
<h2>New in 2.1.20<a class="headerlink" href="#new-in-2-1-20" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixes to cram plugin to avoid attempting to canonify uninitialized data.</li>
<li>NTLM portability fixes.</li>
<li>Avoid potential attack using SASL_PATH when sasl is used in a setuid
environment.</li>
<li>A trivial number of small bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-19">
<h2>New in 2.1.19<a class="headerlink" href="#new-in-2-1-19" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixes to saslauthd to allow better integration with realms (-r flag to
saslauthd, %R token in LDAP module)</li>
<li>Support for forwarding of GSSAPI credentials</li>
<li>SQLite support for the SQL plugin</li>
<li>A nontrivial number of small bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-18">
<h2>New in 2.1.18<a class="headerlink" href="#new-in-2-1-18" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>saslauthd/LDAP no longer tagged “experimental”</li>
<li>Add group membership check to saslauthd/LDAP</li>
<li>Fix Solaris 9 “NI_WITHSCOPEID” issue</li>
<li>Fix missing “getaddrinfo.c” and other distribution problems</li>
<li>Significant Windows enhancements</li>
<li>A large number of other minor bugfixes and cleanups</li>
</ul>
</div>
<div class="section" id="new-in-2-1-17">
<h2>New in 2.1.17<a class="headerlink" href="#new-in-2-1-17" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Allow selection of GSSAPI implementation explicitly (–with-gss_impl)</li>
<li>Other GSSAPI detection improvements</li>
<li>Now correctly do authorizaton callback in sasl_checkpass()</li>
<li>Disable KERBEROS_V4 by default</li>
<li>Continued Win32/Win64 Improvements</li>
<li>Minor Other bugfixes</li>
</ul>
</div>
<div class="section" id="new-in-2-1-16-beta">
<h2>New in 2.1.16-BETA<a class="headerlink" href="#new-in-2-1-16-beta" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Significantly improved Win32 support</li>
<li>Writable auxprop support</li>
<li>Expanded SQL support (including postgres)</li>
<li>Significantly improved documentation</li>
<li>Improved realm/username handling with saslauthd</li>
<li>Support for modern automake and autoconf</li>
</ul>
</div>
<div class="section" id="new-in-2-1-15">
<h2>New in 2.1.15<a class="headerlink" href="#new-in-2-1-15" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix a number of build issues</li>
<li>Add a doc/components.html that hopefully describes how things
interact better.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-14">
<h2>New in 2.1.14<a class="headerlink" href="#new-in-2-1-14" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>OS X 10.2 support</li>
<li>Support for the Sun SEAM GSSAPI implementation</li>
<li>Support for MySQL 4</li>
<li>A number of build fixes</li>
<li>Other minor bugfixes</li>
</ul>
</div>
<div class="section" id="new-in-2-1-13">
<h2>New in 2.1.13<a class="headerlink" href="#new-in-2-1-13" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Add a configure option to allow specification of what /dev/random to use.</li>
<li>Addition of a saslauthd credential cache feature (-c option).</li>
<li>Unification of the saslauthd ipc method code.</li>
<li>Fix a number of autoconf issues.</li>
<li>A significant number of fixes throughout the library from Sun Microsystems.</li>
<li>Other minor bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-12">
<h2>New in 2.1.12<a class="headerlink" href="#new-in-2-1-12" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Distribute in Solaris tar (not GNU tar format)</li>
<li>Fix a number of build/configure related issues.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-11">
<h2>New in 2.1.11<a class="headerlink" href="#new-in-2-1-11" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Add the fastbind auth method to the saslauthd LDAP module.</li>
<li>Fix a potential memory leak in the doors version of saslauthd.</li>
<li>NTLM now only requires one of LM or NT, not both.</li>
<li>Fix a variety of Berkeley DB, LDAP, OpenSSL, and other build issues.</li>
<li>Win32 support compiles, but no documentation as of yet.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-10">
<h2>New in 2.1.10<a class="headerlink" href="#new-in-2-1-10" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Further DIGEST-MD5 DES interoperability fixes. Now works against Active
Directory.</li>
<li>Fix some potential buffer overflows.</li>
<li>Misc. cleanups in the saslauthd LDAP module</li>
<li>Fix security properties of NTLM and EXTERNAL</li>
</ul>
</div>
<div class="section" id="new-in-2-1-9">
<h2>New in 2.1.9<a class="headerlink" href="#new-in-2-1-9" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Include missing lib/staticopen.h file.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-8">
<h2>New in 2.1.8<a class="headerlink" href="#new-in-2-1-8" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Support for the NTLM mechanism (Ken Murchison <<a class="reference external" href="mailto:ken%40oceana.com">ken<span>@</span>oceana<span>.</span>com</a>>)</li>
<li>Support libtool –enable-shared and –enable-static
(Howard Chu <<a class="reference external" href="mailto:hyc%40highlandsun.com">hyc<span>@</span>highlandsun<span>.</span>com</a>>)</li>
<li>OS/390 Support (Howard Chu <<a class="reference external" href="mailto:hyc%40highlandsun.com">hyc<span>@</span>highlandsun<span>.</span>com</a>>)</li>
<li>Berkeley DB 4.1 Support (Mika Iisakkila <<a class="reference external" href="mailto:mika.iisakkila%40pingrid.fi">mika<span>.</span>iisakkila<span>@</span>pingrid<span>.</span>fi</a>>)</li>
<li>Documentation fixes</li>
<li>The usual round of assorted other minor bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-7">
<h2>New in 2.1.7<a class="headerlink" href="#new-in-2-1-7" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Add SASL_AUTHUSER as a parameter to sasl_getprop</li>
<li>Allow applications to require proxy-capable mechanisms (SASL_NEED_PROXY)</li>
<li>Performance improvements in our treatment of /dev/random</li>
<li>Removal of buggy DIGEST-MD5 reauth support.</li>
<li>Documentation fixes</li>
<li>Assorted other minor bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-6">
<h2>New in 2.1.6<a class="headerlink" href="#new-in-2-1-6" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Security fix for the CRAM-MD5 plugin to check the full length of the
digest string.</li>
<li>Return of the Experimental LDAP saslauthd module.</li>
<li>Addition of Experimental MySQL auxprop plugin.</li>
<li>Can now select multiple auxprop plugins (and a priority ordering)</li>
<li>Mechanism selection now includes number of security flags</li>
<li>Mac OS X 10.1 Fixes</li>
<li>Misc other minor bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-5">
<h2>New in 2.1.5<a class="headerlink" href="#new-in-2-1-5" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Remove LDAP support due to copyright concerns.</li>
<li>Minor bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-4">
<h2>New in 2.1.4<a class="headerlink" href="#new-in-2-1-4" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Enhancements and cleanup to the experimental LDAP saslauthd module
(Igor Brezac <<a class="reference external" href="mailto:igor%40ipass.net">igor<span>@</span>ipass<span>.</span>net</a>>)</li>
<li>Addition of a new sasl_version() API</li>
<li>Misc. Bugfixes</li>
</ul>
</div>
<div class="section" id="new-in-2-1-3-beta">
<h2>New in 2.1.3-BETA<a class="headerlink" href="#new-in-2-1-3-beta" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Significant amount of plugin cleanup / standardization. A good deal of code
is now shared between them. (mostly due to Ken Murchison <<a class="reference external" href="mailto:ken%40oceana.com">ken<span>@</span>oceana<span>.</span>com</a>>)</li>
<li>DIGEST-MD5 now supports reauthentication. Also has a fix for DES
interoperability.</li>
<li>saslauthd now supports the Solaris “doors” IPC method
(–with-ipctype=doors)</li>
<li>Significant GSSAPI fixes (mostly due to Howard Chu <<a class="reference external" href="mailto:hyc%40highlandsun.com">hyc<span>@</span>highlandsun<span>.</span>com</a>>)</li>
<li>Auxprop interface now correctly deals with the * prefix indicating
authid vs. authzid. (May break some incompatible auxprop plugins).</li>
<li>We now allow multiple pwcheck_method(s). Also you can restrict auxprop
plugins to the use of a single plugin.</li>
<li>Added an experimental saslauthd LDAP module (Igor Brezac <<a class="reference external" href="mailto:igor%40ipass.net">igor<span>@</span>ipass<span>.</span>net</a>>)</li>
<li>Removed check for db3/db.h</li>
<li>Misc. documentation updates. (Marshall Rose, and others)</li>
<li>Other misc. bugfixes.</li>
</ul>
</div>
<div class="section" id="new-in-2-1-2">
<h2>New in 2.1.2<a class="headerlink" href="#new-in-2-1-2" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Mostly a minor-bugfix release</li>
<li>Improved documentation / cleanup of old references to obsolete
pwcheck_methods</li>
<li>Better error reporting for auxprop password verifiers</li>
</ul>
</div>
<div class="section" id="new-in-2-1-1">
<h2>New in 2.1.1<a class="headerlink" href="#new-in-2-1-1" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Many minor bugfixes throughout.</li>
<li>Improvements to OTP and SRP mechanisms (now compliant with
draft-burdis-cat-srp-sasl-06.txt)</li>
<li>API additions including sasl_global_listmech, and a cleaner handling of
client-first and server-last semantics (no application level changes)</li>
<li>Minor documentation improvements</li>
</ul>
</div>
<div class="section" id="new-in-2-1-0">
<h2>New in 2.1.0<a class="headerlink" href="#new-in-2-1-0" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>The Cyrus SASL library is now considered stable. It is still not backwards
compatible with applications that require SASLv1.</li>
<li>Minor API changes occured, namely the canon_user callback interface.</li>
<li>saslauthd now preforks a number of processes to handle connections</li>
<li>Many bugfixes through the entire library.</li>
</ul>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="../2.0/index.html" class="btn btn-neutral float-right" title="Cyrus SASL 2.0.x Release Notes" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="../index.html" class="btn btn-neutral" title="Release Notes" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 1993-2016, The Cyrus Team.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6 using a modified <a href="https://readthedocs.org">Read the Docs</a> <a href="https://github.com/snide/sphinx_rtd_theme">theme</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../../',
VERSION:'2.1.27',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../../../_static/jquery.js"></script>
<script type="text/javascript" src="../../../_static/underscore.js"></script>
<script type="text/javascript" src="../../../_static/doctools.js"></script>
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js"></script>
<script type="text/javascript" src="../../../_static/js/theme.js"></script>
<script type="text/javascript">
<!-- jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
}); -->
</script>
</body>
</html>
