| |
1 /** |
| |
2 * @file ntlm.h |
| |
3 * |
| |
4 * purple |
| |
5 * |
| |
6 * Copyright (C) 2005, Thomas Butter <butter@uni-mannheim.de> |
| |
7 * |
| |
8 * ntlm structs are taken from NTLM description on |
| |
9 * http://www.innovation.ch/java/ntlm.html |
| |
10 * |
| |
11 * This program is free software; you can redistribute it and/or modify |
| |
12 * it under the terms of the GNU General Public License as published by |
| |
13 * the Free Software Foundation; either version 2 of the License, or |
| |
14 * (at your option) any later version. |
| |
15 * |
| |
16 * This program is distributed in the hope that it will be useful, |
| |
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| |
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| |
19 * GNU General Public License for more details. |
| |
20 * |
| |
21 * You should have received a copy of the GNU General Public License |
| |
22 * along with this program; if not, write to the Free Software |
| |
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| |
24 */ |
| |
25 |
| |
26 #ifndef _PURPLE_NTLM_H |
| |
27 #define _PURPLE_NTLM_H |
| |
28 |
| |
29 #ifdef __cplusplus |
| |
30 extern "C" { |
| |
31 #endif |
| |
32 |
| |
33 /** |
| |
34 * Generates the base64 encoded type 1 message needed for NTLM authentication |
| |
35 * |
| |
36 * @param hostname Your hostname |
| |
37 * @param domain The domain to authenticate to |
| |
38 * @return base64 encoded string to send to the server. This should |
| |
39 * be g_free'd by the caller. |
| |
40 */ |
| |
41 gchar *purple_ntlm_gen_type1(const gchar *hostname, const gchar *domain); |
| |
42 |
| |
43 /** |
| |
44 * Parses the ntlm type 2 message |
| |
45 * |
| |
46 * @param type2 String containing the base64 encoded type2 message |
| |
47 * @param flags If not @c NULL, this will store the flags for the message |
| |
48 * |
| |
49 * @return The nonce for use in message type3. This is a statically |
| |
50 * allocated 8 byte binary string. |
| |
51 */ |
| |
52 guint8 *purple_ntlm_parse_type2(const gchar *type2, guint32 *flags); |
| |
53 |
| |
54 /** |
| |
55 * Generates a type3 message |
| |
56 * |
| |
57 * @param username The username |
| |
58 * @param passw The password |
| |
59 * @param hostname The hostname |
| |
60 * @param domain The domain to authenticate against |
| |
61 * @param nonce The nonce returned by purple_ntlm_parse_type2 |
| |
62 * @param flags Pointer to the flags returned by purple_ntlm_parse_type2 |
| |
63 * @return A base64 encoded type3 message. This should be g_free'd by |
| |
64 * the caller. |
| |
65 */ |
| |
66 gchar *purple_ntlm_gen_type3(const gchar *username, const gchar *passw, const gchar *hostname, const gchar *domain, const guint8 *nonce, guint32 *flags); |
| |
67 |
| |
68 #ifdef __cplusplus |
| |
69 } |
| |
70 #endif |
| |
71 |
| |
72 #endif /* _PURPLE_NTLM_H */ |