%general-entities; ]> $LastChangedBy$ $Date$ Cyrus <acronym>SASL</acronym>-&cyrus-sasl-version; Cyrus SASL Introduction to <application>Cyrus <acronym>SASL</acronym></application> The Cyrus SASL package contains a Simple Authentication and Security Layer, a method for adding authentication support to connection-based protocols. To use SASL, a protocol includes a command for identifying and authenticating a user to a server and for optionally negotiating protection of subsequent protocol interactions. If its use is negotiated, a security layer is inserted between the protocol and the connection. Package information Download (HTTP): Download (FTP): Download MD5 sum: &cyrus-sasl-md5sum; Download size: &cyrus-sasl-size; Estimated disk space required: &cyrus-sasl-buildsize; Estimated build time: &cyrus-sasl-time; <application>Cyrus <acronym>SASL</acronym></application> dependencies Required Optional , , or , , , , , , , krb4, SQLite and Dmalloc Installation of <application>Cyrus <acronym>SASL</acronym></application> Install Cyrus SASL by running the following commands: ./configure --prefix=/usr --sysconfdir=/etc \ --with-dbpath=/var/lib/sasl/sasldb2 \ --with-saslauthd=/var/run && make Now, as the root user: make install && install -v -m644 saslauthd/saslauthd.mdoc \ /usr/share/man/man8/saslauthd.8 && install -v -d -m755 /usr/share/doc/cyrus-sasl-&cyrus-sasl-version; && install -v -m644 doc/{*.{html,txt,fig},ONEWS,TODO} \ saslauthd/LDAP_SASLAUTHD /usr/share/doc/cyrus-sasl-&cyrus-sasl-version; && install -v -d -m700 /var/lib/sasl Command explanations --with-dbpath=/var/lib/sasl/sasldb2: This parameter forces the saslauthd database to be created in /var/lib/sasl instead of /etc. --with-saslauthd=/var/run: This parameter forces saslauthd to use the FHS compliant directory /var/run for variable run-time data. --with-ldap: This parameter enables use with OpenLDAP. install -m644 ...: These commands install documentation which is not installed by the make install command. install -d -m700 /var/lib/sasl: This directory must exist when starting saslauthd. If you're not going to be running the daemon, you may omit the creation of this directory. Configuring <application>Cyrus <acronym>SASL</acronym></application> Config Files /etc/saslauthd.conf (for LDAP configuration) and /usr/lib/sasl2/Appname.conf (where "Appname" is the application defined name of the application) /etc/saslauthd.conf Configuration Information See for information on what to include in the application configuration files. See for configuring saslauthd with LDAP. Init Script If you need to run the saslauthd daemon at system startup, install the /etc/rc.d/init.d/cyrus-sasl init script included in the package. cyrus-sasl make install-cyrus-sasl You'll need to modify the init script and replace the [authmech] parameter to the -a switch with your desired authentication mechanism. Contents Installed Programs Installed Libraries Installed Directories saslauthd, sasldblistusers2 and saslpasswd2 libjavasasl.so, libsasl2.so and SASL plugins/JAVA classes /usr/include/sasl, /usr/lib/sasl2, /usr/share/doc/sasl and /var/lib/sasl Short Descriptions saslauthd is the SASL authentication server. saslauthd sasldblistusers2 is used to list the users in the SASL password database. sasldblistusers2 saslpasswd2 is used to set and delete a user's SASL password and mechanism specific secrets in the SASL password database. saslpasswd2 libsasl2.so is a general purpose authentication library for server and client applications. libsasl2.so