README

   1 This directory holds the library `libgsasl', which implement the
   2 Simple Authentication and Security Layer (SASL), and an application
   3 `gsasl' for interfacing with the library from the command line.
   4
   5 Libgsasl is unstable and in its early steps of development.  You
   6 should expect it to not work as well as having security problems.
   7 Currently there is some support for the following mechanisms:
   8
   9   - CRAM-MD5 (RFC 2195, requires libgcrypt)
  10   - EXTERNAL (RFC 2222)
  11   - GSSAPI (RFC 2222, requires MIT Kerberos 5 GSSAPI library)
  12   - ANONYMOUS (RFC 2245)
  13   - PLAIN (RFC 2595)
  14   - SECURID (RFC 2808)
  15   - DIGEST-MD5 (RFC 2831, requires libgcrypt)
  16   - LOGIN (non-standard)
  17   - NTLM (non-standard, client only, requires libntlm)
  18
  19 Libgsasl has at some point in time passed the self tests on the
  20 following systems, but no guarantees.
  21
  22   - alphaev67-dec-osf5.0 (Compaq Tru64 UNIX C and Tru64 Make)
  23   - i686-pc-linux-gnu (Debian unstable)
  24   - i686-pc-linux-gnu (RedHat 7.2)
  25   - mips-sgi-irix6.5 (MIPS C compiler in 64 bit mode and IRIX make)
  26   - rs6000-ibm-aix4.3.2.0 (GCC 2.9-aix43-000718, GNU make)
  27   - rs6000-ibm-aix4.3.2.0 (IBM C for AIX compiler and AIX Make)
  28   - sparc-sun-solaris2.6 (Sun WorkShop Compiler C 5.0 and Sun make)
  29   - sparc-sun-solaris2.6 (GCC 3.1 and GNU make)
  30   - sparc-sun-solaris2.8 (GCC 3.1 and GNU make)
  31
  32 Things left to do below.  If you like to start working on anything,
  33 please let me know so work duplication can be avoided.
  34
  35   + Authentication infrastructure implementing the callbacks for
  36     PAM, Kerberos, SQL, etc.  Separate project?  GNU Mailutils has
  37     some starting points for this, but the API is inflexible.
  38   + Hide explicit data array handling in a string API
  39   + Port applications to use libgsasl
  40   + More SASL mechanisms
  41   + Security layer improvements, including support for privacy
  42     separation (authenticate in one process, pass state to another).
  43   - Improve documentation
  44   - Port to Cyclone?
  45
  46 The library (lib/) is licensed under the GNU Lesser Public License
  47 license (see COPYING.LIB), the application (src/) is licensed under
  48 the GNU Public License (see COPYING), and the documentation (doc/) is
  49 licensed under the GNU Free Documentation License (see COPYING.DOC).
  50
  51 For updates to the project, see <URL:http://josefsson.org/libgsasl/>.
  52
  53 Send all bug reports by electronic mail to bug-libgsasl@josefsson.org.