(eword-decode-string, eword-decode-region): Mention language info in doc string.
[elisp/flim.git] / sasl-ntlm.el
1 ;;; sasl-ntlm.el --- NTLM (NT Lan Manager) module for the SASL client framework
2
3 ;; Copyright (C) 2000 Free Software Foundation, Inc.
4
5 ;; Author: Taro Kawagishi <tarok@transpulse.org>
6 ;; Keywords: SASL, NTLM
7 ;; Version: 1.00
8 ;; Created: February 2001
9
10 ;; This program is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
13 ;; any later version.
14 ;;
15 ;; This program is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 ;; GNU General Public License for more details.
19 ;;
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with this program; see the file COPYING.  If not, write to the
22 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23 ;; Boston, MA 02110-1301, USA.
24
25 ;;; Commentary:
26
27 ;; This is a SASL interface layer for NTLM authentication message
28 ;; generation by ntlm.el
29
30 ;;; Code:
31
32 (require 'sasl)
33 (require 'ntlm)
34
35 (defconst sasl-ntlm-steps
36   '(ignore                              ;nothing to do before making
37     sasl-ntlm-request                   ;authentication request
38     sasl-ntlm-response)                 ;response to challenge
39   "A list of functions to be called in sequnece for the NTLM
40 authentication steps.  Ther are called by 'sasl-next-step.")
41
42 (defun sasl-ntlm-request (client step)
43   "SASL step function to generate a NTLM authentication request to the server.
44 Called from 'sasl-next-step.
45 CLIENT is a vector [mechanism user service server sasl-client-properties]
46 STEP is a vector [<previous step function> <result of previous step function>]"
47   (let ((user (sasl-client-name client)))
48     (ntlm-build-auth-request user)))
49
50 (defun sasl-ntlm-response (client step)
51   "SASL step function to generate a NTLM response against the server
52 challenge stored in the 2nd element of STEP.  Called from 'sasl-next-step."
53   (let* ((user (sasl-client-name client))
54          (passphrase
55           (sasl-read-passphrase (format "NTLM passphrase for %s: " user)))
56          (challenge (sasl-step-data step)))
57     (ntlm-build-auth-response challenge user
58                               (ntlm-get-password-hashes passphrase))))
59
60 (put 'sasl-ntlm 'sasl-mechanism
61      (sasl-make-mechanism "NTLM" sasl-ntlm-steps))
62
63 (provide 'sasl-ntlm)
64
65 ;;; sasl-ntlm.el ends here