2 Unix SMB/CIFS implementation.
3 SMB parameters and setup
4 Copyright (C) Andrew Tridgell 1992-1998
5 Modified by Jeremy Allison 1995.
6 Copyright (C) Jeremy Allison 1995-2000.
7 Copyright (C) Luke Kennethc Casson Leighton 1996-2000.
8 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2002-2003
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 of the License, or
13 (at your option) any later version.
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.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #include "byteorder.h"
29 This implements the X/Open SMB password encryption
30 It takes a password ('unix' string), a 8 byte "crypt key"
31 and puts 24 bytes of encrypted password into p24
33 Returns False if password must have been truncated to create LM hash
35 BOOL SMBencrypt(const char *passwd, const uint8_t *c8, uint8_t p24[24])
41 ret = E_deshash(passwd, p21);
43 SMBOWFencrypt(p21, c8, p24);
46 DEBUG(100,("SMBencrypt: lm#, challenge, response\n"));
47 dump_data(100, (char *)p21, 16);
48 dump_data(100, (const char *)c8, 8);
49 dump_data(100, (char *)p24, 24);
56 * Creates the MD4 Hash of the users password in NT UNICODE.
57 * @param passwd password in 'unix' charset.
58 * @param p16 return password hashed with md4, caller allocated 16 byte buffer
61 void E_md4hash(const char *passwd, uint8_t p16[16])
66 /* Password must be converted to NT unicode - null terminated. */
67 push_ucs2(NULL, wpwd, (const char *)passwd, 256, STR_UNICODE|STR_NOALIGN|STR_TERMINATE);
68 /* Calculate length in bytes */
69 len = strlen_w(wpwd) * sizeof(int16_t);
71 mdfour(p16, (uint8_t *)wpwd, len);
76 * Creates the DES forward-only Hash of the users password in DOS ASCII charset
77 * @param passwd password in 'unix' charset.
78 * @param p16 return password hashed with DES, caller allocated 16 byte buffer
79 * @return False if password was > 14 characters, and therefore may be incorrect, otherwise True
80 * @note p16 is filled in regardless
83 BOOL E_deshash(const char *passwd, uint8_t p16[16])
89 /* Password must be converted to DOS charset - null terminated, uppercase. */
90 push_ascii(dospwd, passwd, sizeof(dospwd), STR_UPPER|STR_TERMINATE);
92 /* Only the fisrt 14 chars are considered, password need not be null terminated. */
93 E_P16((const uint8_t *)dospwd, p16);
95 if (strlen(dospwd) > 14) {
104 /* Does both the NTLMv2 owfs of a user's password */
105 BOOL ntv2_owf_gen(const uint8_t owf[16],
106 const char *user_in, const char *domain_in,
107 BOOL upper_case_domain, /* Transform the domain into UPPER case */
113 size_t user_byte_len;
114 size_t domain_byte_len;
118 user_byte_len = push_ucs2_allocate(&user, user_in);
119 if (user_byte_len == (size_t)-1) {
120 DEBUG(0, ("push_uss2_allocate() for user returned -1 (probably malloc() failure)\n"));
124 domain_byte_len = push_ucs2_allocate(&domain, domain_in);
125 if (domain_byte_len == (size_t)-1) {
126 DEBUG(0, ("push_uss2_allocate() for domain returned -1 (probably malloc() failure)\n"));
132 if (upper_case_domain)
135 SMB_ASSERT(user_byte_len >= 2);
136 SMB_ASSERT(domain_byte_len >= 2);
138 /* We don't want null termination */
139 user_byte_len = user_byte_len - 2;
140 domain_byte_len = domain_byte_len - 2;
142 hmac_md5_init_limK_to_64(owf, 16, &ctx);
143 hmac_md5_update((const uint8_t *)user, user_byte_len, &ctx);
144 hmac_md5_update((const uint8_t *)domain, domain_byte_len, &ctx);
145 hmac_md5_final(kr_buf, &ctx);
147 #ifdef DEBUG_PASSWORD
148 DEBUG(100, ("ntv2_owf_gen: user, domain, owfkey, kr\n"));
149 dump_data(100, (const char *)user, user_byte_len);
150 dump_data(100, (const char *)domain, domain_byte_len);
151 dump_data(100, owf, 16);
152 dump_data(100, kr_buf, 16);
160 /* Does the des encryption from the NT or LM MD4 hash. */
161 void SMBOWFencrypt(const uint8_t passwd[16], const uint8_t *c8, uint8_t p24[24])
167 memcpy(p21, passwd, 16);
171 /* Does the NT MD4 hash then des encryption. */
173 void SMBNTencrypt(const char *passwd, uint8_t *c8, uint8_t *p24)
179 E_md4hash(passwd, p21);
180 SMBOWFencrypt(p21, c8, p24);
182 #ifdef DEBUG_PASSWORD
183 DEBUG(100,("SMBNTencrypt: nt#, challenge, response\n"));
184 dump_data(100, (char *)p21, 16);
185 dump_data(100, (char *)c8, 8);
186 dump_data(100, (char *)p24, 24);
190 /* Does the md5 encryption from the Key Response for NTLMv2. */
191 void SMBOWFencrypt_ntv2(const uint8_t kr[16],
192 const DATA_BLOB *srv_chal,
193 const DATA_BLOB *cli_chal,
194 uint8_t resp_buf[16])
198 hmac_md5_init_limK_to_64(kr, 16, &ctx);
199 hmac_md5_update(srv_chal->data, srv_chal->length, &ctx);
200 hmac_md5_update(cli_chal->data, cli_chal->length, &ctx);
201 hmac_md5_final(resp_buf, &ctx);
203 #ifdef DEBUG_PASSWORD
204 DEBUG(100, ("SMBOWFencrypt_ntv2: srv_chal, cli_chal, resp_buf\n"));
205 dump_data(100, srv_chal->data, srv_chal->length);
206 dump_data(100, cli_chal->data, cli_chal->length);
207 dump_data(100, resp_buf, 16);
211 void SMBsesskeygen_ntv2(const uint8_t kr[16],
212 const uint8_t * nt_resp, uint8_t sess_key[16])
214 /* a very nice, 128 bit, variable session key */
218 hmac_md5_init_limK_to_64(kr, 16, &ctx);
219 hmac_md5_update(nt_resp, 16, &ctx);
220 hmac_md5_final((uint8_t *)sess_key, &ctx);
222 #ifdef DEBUG_PASSWORD
223 DEBUG(100, ("SMBsesskeygen_ntv2:\n"));
224 dump_data(100, sess_key, 16);
228 void SMBsesskeygen_ntv1(const uint8_t kr[16], uint8_t sess_key[16])
230 /* yes, this session key does not change - yes, this
231 is a problem - but it is 128 bits */
233 mdfour((uint8_t *)sess_key, kr, 16);
235 #ifdef DEBUG_PASSWORD
236 DEBUG(100, ("SMBsesskeygen_ntv1:\n"));
237 dump_data(100, sess_key, 16);
241 void SMBsesskeygen_lm_sess_key(const uint8_t lm_hash[16],
242 const uint8_t lm_resp[24], /* only uses 8 */
243 uint8_t sess_key[16])
245 /* Calculate the LM session key (effective length 40 bits,
246 but changes with each session) */
251 memcpy(p21, lm_hash, 8);
252 memset(p21 + 8, 0xbd, 8);
254 E_P24(p21, lm_resp, p24);
256 memcpy(sess_key, p24, 16);
258 #ifdef DEBUG_PASSWORD
259 DEBUG(100, ("SMBsesskeygen_lm_sess_key: \n"));
260 dump_data(100, sess_key, 16);
264 DATA_BLOB NTLMv2_generate_names_blob(TALLOC_CTX *mem_ctx,
265 const char *hostname,
268 DATA_BLOB names_blob = data_blob_talloc(mem_ctx, NULL, 0);
270 msrpc_gen(mem_ctx, &names_blob, "aaa",
271 NTLMSSP_NAME_TYPE_DOMAIN, domain,
272 NTLMSSP_NAME_TYPE_SERVER, hostname,
277 static DATA_BLOB NTLMv2_generate_client_data(TALLOC_CTX *mem_ctx, const DATA_BLOB *names_blob)
279 uint8_t client_chal[8];
280 DATA_BLOB response = data_blob(NULL, 0);
284 unix_to_nt_time(&nttime, time(NULL));
286 generate_random_buffer(client_chal, sizeof(client_chal), False);
288 push_nttime(long_date, 0, nttime);
290 /* See http://www.ubiqx.org/cifs/SMB.html#SMB.8.5 */
292 msrpc_gen(mem_ctx, &response, "ddbbdb",
293 0x00000101, /* Header */
295 long_date, 8, /* Timestamp */
296 client_chal, 8, /* client challenge */
298 names_blob->data, names_blob->length); /* End of name list */
303 static DATA_BLOB NTLMv2_generate_response(const uint8_t ntlm_v2_hash[16],
304 const DATA_BLOB *server_chal,
305 const DATA_BLOB *names_blob)
307 uint8_t ntlmv2_response[16];
308 DATA_BLOB ntlmv2_client_data;
309 DATA_BLOB final_response;
311 TALLOC_CTX *mem_ctx = talloc_init("NTLMv2_generate_response internal context");
314 return data_blob(NULL, 0);
318 /* generate some data to pass into the response function - including
319 the hostname and domain name of the server */
320 ntlmv2_client_data = NTLMv2_generate_client_data(mem_ctx, names_blob);
322 /* Given that data, and the challenge from the server, generate a response */
323 SMBOWFencrypt_ntv2(ntlm_v2_hash, server_chal, &ntlmv2_client_data, ntlmv2_response);
325 final_response = data_blob(NULL, sizeof(ntlmv2_response) + ntlmv2_client_data.length);
327 memcpy(final_response.data, ntlmv2_response, sizeof(ntlmv2_response));
329 memcpy(final_response.data+sizeof(ntlmv2_response),
330 ntlmv2_client_data.data, ntlmv2_client_data.length);
332 talloc_destroy(mem_ctx);
334 return final_response;
337 static DATA_BLOB LMv2_generate_response(const uint8_t ntlm_v2_hash[16],
338 const DATA_BLOB *server_chal)
340 uint8_t lmv2_response[16];
341 DATA_BLOB lmv2_client_data = data_blob(NULL, 8);
342 DATA_BLOB final_response = data_blob(NULL, 24);
345 /* client-supplied random data */
346 generate_random_buffer(lmv2_client_data.data, lmv2_client_data.length, False);
348 /* Given that data, and the challenge from the server, generate a response */
349 SMBOWFencrypt_ntv2(ntlm_v2_hash, server_chal, &lmv2_client_data, lmv2_response);
350 memcpy(final_response.data, lmv2_response, sizeof(lmv2_response));
352 /* after the first 16 bytes is the random data we generated above,
353 so the server can verify us with it */
354 memcpy(final_response.data+sizeof(lmv2_response),
355 lmv2_client_data.data, lmv2_client_data.length);
357 data_blob_free(&lmv2_client_data);
359 return final_response;
362 BOOL SMBNTLMv2encrypt(const char *user, const char *domain, const char *password,
363 const DATA_BLOB *server_chal,
364 const DATA_BLOB *names_blob,
365 DATA_BLOB *lm_response, DATA_BLOB *nt_response,
366 DATA_BLOB *user_session_key)
369 uint8_t ntlm_v2_hash[16];
370 E_md4hash(password, nt_hash);
372 /* We don't use the NT# directly. Instead we use it mashed up with
373 the username and domain.
374 This prevents username swapping during the auth exchange
376 if (!ntv2_owf_gen(nt_hash, user, domain, True, ntlm_v2_hash)) {
381 *nt_response = NTLMv2_generate_response(ntlm_v2_hash, server_chal,
383 if (user_session_key) {
384 *user_session_key = data_blob(NULL, 16);
386 /* The NTLMv2 calculations also provide a session key, for signing etc later */
387 /* use only the first 16 bytes of nt_response for session key */
388 SMBsesskeygen_ntv2(ntlm_v2_hash, nt_response->data, user_session_key->data);
395 *lm_response = LMv2_generate_response(ntlm_v2_hash, server_chal);
401 /***********************************************************
402 encode a password buffer with a unicode password. The buffer
403 is filled with random data to make it harder to attack.
404 ************************************************************/
405 BOOL encode_pw_buffer(char buffer[516], const char *password, int string_flags)
410 new_pw_len = push_string(NULL, new_pw,
412 sizeof(new_pw), string_flags);
414 memcpy(&buffer[512 - new_pw_len], new_pw, new_pw_len);
416 generate_random_buffer((uint8_t *)buffer, 512 - new_pw_len, False);
419 * The length of the new password is in the last 4 bytes of
422 SIVAL(buffer, 512, new_pw_len);
428 /***********************************************************
429 decode a password buffer
430 *new_pw_len is the length in bytes of the possibly mulitbyte
431 returned password including termination.
432 ************************************************************/
433 BOOL decode_pw_buffer(char in_buffer[516], char *new_pwrd,
434 int new_pwrd_size, uint32_t *new_pw_len,
440 Warning !!! : This function is called from some rpc call.
441 The password IN the buffer may be a UNICODE string.
442 The password IN new_pwrd is an ASCII string
443 If you reuse that code somewhere else check first.
446 /* The length of the new password is in the last 4 bytes of the data buffer. */
448 byte_len = IVAL(in_buffer, 512);
450 #ifdef DEBUG_PASSWORD
451 dump_data(100, in_buffer, 516);
454 /* Password cannot be longer than the size of the password buffer */
455 if ( (byte_len < 0) || (byte_len > 512)) {
456 DEBUG(0, ("decode_pw_buffer: incorrect password length (%d).\n", byte_len));
457 DEBUG(0, ("decode_pw_buffer: check that 'encrypt passwords = yes'\n"));
461 /* decode into the return buffer. Buffer length supplied */
462 *new_pw_len = pull_string(NULL, new_pwrd, &in_buffer[512 - byte_len], new_pwrd_size,
463 byte_len, string_flags);
465 #ifdef DEBUG_PASSWORD
466 DEBUG(100,("decode_pw_buffer: new_pwrd: "));
467 dump_data(100, (char *)new_pwrd, *new_pw_len);
468 DEBUG(100,("multibyte len:%d\n", *new_pw_len));
469 DEBUG(100,("original char len:%d\n", byte_len/2));