FreeRDP
Loading...
Searching...
No Matches
libfreerdp/core/security.c
1
21#include <freerdp/config.h>
22
23#include "settings.h"
24#include "security.h"
25
26#include <freerdp/log.h>
27#include <winpr/crypto.h>
28
29#define TAG FREERDP_TAG("core")
30
31static const BYTE A[] = { 'A' };
32static const BYTE BB[] = { 'B', 'B' };
33static const BYTE CCC[] = { 'C', 'C', 'C' };
34
35/* 0x36 repeated 40 times */
36static const BYTE pad1[40] = { 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36,
37 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36,
38 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36,
39 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36 };
40
41/* 0x5C repeated 48 times */
42static const BYTE pad2[48] = { 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C,
43 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C,
44 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C,
45 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C,
46 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C, 0x5C };
47
48static const BYTE fips_reverse_table[256] = {
49 0x00, 0x80, 0x40, 0xc0, 0x20, 0xa0, 0x60, 0xe0, 0x10, 0x90, 0x50, 0xd0, 0x30, 0xb0, 0x70, 0xf0,
50 0x08, 0x88, 0x48, 0xc8, 0x28, 0xa8, 0x68, 0xe8, 0x18, 0x98, 0x58, 0xd8, 0x38, 0xb8, 0x78, 0xf8,
51 0x04, 0x84, 0x44, 0xc4, 0x24, 0xa4, 0x64, 0xe4, 0x14, 0x94, 0x54, 0xd4, 0x34, 0xb4, 0x74, 0xf4,
52 0x0c, 0x8c, 0x4c, 0xcc, 0x2c, 0xac, 0x6c, 0xec, 0x1c, 0x9c, 0x5c, 0xdc, 0x3c, 0xbc, 0x7c, 0xfc,
53 0x02, 0x82, 0x42, 0xc2, 0x22, 0xa2, 0x62, 0xe2, 0x12, 0x92, 0x52, 0xd2, 0x32, 0xb2, 0x72, 0xf2,
54 0x0a, 0x8a, 0x4a, 0xca, 0x2a, 0xaa, 0x6a, 0xea, 0x1a, 0x9a, 0x5a, 0xda, 0x3a, 0xba, 0x7a, 0xfa,
55 0x06, 0x86, 0x46, 0xc6, 0x26, 0xa6, 0x66, 0xe6, 0x16, 0x96, 0x56, 0xd6, 0x36, 0xb6, 0x76, 0xf6,
56 0x0e, 0x8e, 0x4e, 0xce, 0x2e, 0xae, 0x6e, 0xee, 0x1e, 0x9e, 0x5e, 0xde, 0x3e, 0xbe, 0x7e, 0xfe,
57 0x01, 0x81, 0x41, 0xc1, 0x21, 0xa1, 0x61, 0xe1, 0x11, 0x91, 0x51, 0xd1, 0x31, 0xb1, 0x71, 0xf1,
58 0x09, 0x89, 0x49, 0xc9, 0x29, 0xa9, 0x69, 0xe9, 0x19, 0x99, 0x59, 0xd9, 0x39, 0xb9, 0x79, 0xf9,
59 0x05, 0x85, 0x45, 0xc5, 0x25, 0xa5, 0x65, 0xe5, 0x15, 0x95, 0x55, 0xd5, 0x35, 0xb5, 0x75, 0xf5,
60 0x0d, 0x8d, 0x4d, 0xcd, 0x2d, 0xad, 0x6d, 0xed, 0x1d, 0x9d, 0x5d, 0xdd, 0x3d, 0xbd, 0x7d, 0xfd,
61 0x03, 0x83, 0x43, 0xc3, 0x23, 0xa3, 0x63, 0xe3, 0x13, 0x93, 0x53, 0xd3, 0x33, 0xb3, 0x73, 0xf3,
62 0x0b, 0x8b, 0x4b, 0xcb, 0x2b, 0xab, 0x6b, 0xeb, 0x1b, 0x9b, 0x5b, 0xdb, 0x3b, 0xbb, 0x7b, 0xfb,
63 0x07, 0x87, 0x47, 0xc7, 0x27, 0xa7, 0x67, 0xe7, 0x17, 0x97, 0x57, 0xd7, 0x37, 0xb7, 0x77, 0xf7,
64 0x0f, 0x8f, 0x4f, 0xcf, 0x2f, 0xaf, 0x6f, 0xef, 0x1f, 0x9f, 0x5f, 0xdf, 0x3f, 0xbf, 0x7f, 0xff
65};
66
67static const BYTE fips_oddparity_table[256] = {
68 0x01, 0x01, 0x02, 0x02, 0x04, 0x04, 0x07, 0x07, 0x08, 0x08, 0x0b, 0x0b, 0x0d, 0x0d, 0x0e, 0x0e,
69 0x10, 0x10, 0x13, 0x13, 0x15, 0x15, 0x16, 0x16, 0x19, 0x19, 0x1a, 0x1a, 0x1c, 0x1c, 0x1f, 0x1f,
70 0x20, 0x20, 0x23, 0x23, 0x25, 0x25, 0x26, 0x26, 0x29, 0x29, 0x2a, 0x2a, 0x2c, 0x2c, 0x2f, 0x2f,
71 0x31, 0x31, 0x32, 0x32, 0x34, 0x34, 0x37, 0x37, 0x38, 0x38, 0x3b, 0x3b, 0x3d, 0x3d, 0x3e, 0x3e,
72 0x40, 0x40, 0x43, 0x43, 0x45, 0x45, 0x46, 0x46, 0x49, 0x49, 0x4a, 0x4a, 0x4c, 0x4c, 0x4f, 0x4f,
73 0x51, 0x51, 0x52, 0x52, 0x54, 0x54, 0x57, 0x57, 0x58, 0x58, 0x5b, 0x5b, 0x5d, 0x5d, 0x5e, 0x5e,
74 0x61, 0x61, 0x62, 0x62, 0x64, 0x64, 0x67, 0x67, 0x68, 0x68, 0x6b, 0x6b, 0x6d, 0x6d, 0x6e, 0x6e,
75 0x70, 0x70, 0x73, 0x73, 0x75, 0x75, 0x76, 0x76, 0x79, 0x79, 0x7a, 0x7a, 0x7c, 0x7c, 0x7f, 0x7f,
76 0x80, 0x80, 0x83, 0x83, 0x85, 0x85, 0x86, 0x86, 0x89, 0x89, 0x8a, 0x8a, 0x8c, 0x8c, 0x8f, 0x8f,
77 0x91, 0x91, 0x92, 0x92, 0x94, 0x94, 0x97, 0x97, 0x98, 0x98, 0x9b, 0x9b, 0x9d, 0x9d, 0x9e, 0x9e,
78 0xa1, 0xa1, 0xa2, 0xa2, 0xa4, 0xa4, 0xa7, 0xa7, 0xa8, 0xa8, 0xab, 0xab, 0xad, 0xad, 0xae, 0xae,
79 0xb0, 0xb0, 0xb3, 0xb3, 0xb5, 0xb5, 0xb6, 0xb6, 0xb9, 0xb9, 0xba, 0xba, 0xbc, 0xbc, 0xbf, 0xbf,
80 0xc1, 0xc1, 0xc2, 0xc2, 0xc4, 0xc4, 0xc7, 0xc7, 0xc8, 0xc8, 0xcb, 0xcb, 0xcd, 0xcd, 0xce, 0xce,
81 0xd0, 0xd0, 0xd3, 0xd3, 0xd5, 0xd5, 0xd6, 0xd6, 0xd9, 0xd9, 0xda, 0xda, 0xdc, 0xdc, 0xdf, 0xdf,
82 0xe0, 0xe0, 0xe3, 0xe3, 0xe5, 0xe5, 0xe6, 0xe6, 0xe9, 0xe9, 0xea, 0xea, 0xec, 0xec, 0xef, 0xef,
83 0xf1, 0xf1, 0xf2, 0xf2, 0xf4, 0xf4, 0xf7, 0xf7, 0xf8, 0xf8, 0xfb, 0xfb, 0xfd, 0xfd, 0xfe, 0xfe
84};
85
86static BOOL security_salted_hash(const BYTE* salt, size_t salt_len, const BYTE* input,
87 size_t length, const BYTE* salt1, size_t salt1_len,
88 const BYTE* salt2, size_t salt2_len, BYTE* output, size_t out_len)
89{
90 WINPR_DIGEST_CTX* sha1 = nullptr;
91 WINPR_DIGEST_CTX* md5 = nullptr;
92 BYTE sha1_digest[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
93 BOOL result = FALSE;
94
95 /* SaltedHash(Salt, Input, Salt1, Salt2) = MD5(S + SHA1(Input + Salt + Salt1 + Salt2)) */
96 WINPR_ASSERT(out_len >= WINPR_MD5_DIGEST_LENGTH);
97
98 /* SHA1_Digest = SHA1(Input + Salt + Salt1 + Salt2) */
99 if (!(sha1 = winpr_Digest_New()))
100 goto out;
101
102 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1))
103 goto out;
104
105 if (!winpr_Digest_Update(sha1, input, length)) /* Input */
106 goto out;
107
108 WINPR_ASSERT(salt_len == 48);
109 if (!winpr_Digest_Update(sha1, salt, salt_len)) /* Salt (48 bytes) */
110 goto out;
111
112 WINPR_ASSERT(salt1_len == 32);
113 if (!winpr_Digest_Update(sha1, salt1, salt1_len)) /* Salt1 (32 bytes) */
114 goto out;
115
116 WINPR_ASSERT(salt2_len == 32);
117 if (!winpr_Digest_Update(sha1, salt2, salt2_len)) /* Salt2 (32 bytes) */
118 goto out;
119
120 if (!winpr_Digest_Final(sha1, sha1_digest, sizeof(sha1_digest)))
121 goto out;
122
123 /* SaltedHash(Salt, Input, Salt1, Salt2) = MD5(S + SHA1_Digest) */
124 if (!(md5 = winpr_Digest_New()))
125 goto out;
126
127 /* Allow FIPS override for use of MD5 here, this is used for creating hashes of the
128 * premaster_secret and master_secret */
129 /* used for RDP licensing as described in MS-RDPELE. This is for RDP licensing packets */
130 /* which will already be encrypted under FIPS, so the use of MD5 here is not for sensitive data
131 * protection. */
132 if (!winpr_Digest_Init_Allow_FIPS(md5, WINPR_MD_MD5))
133 goto out;
134
135 if (!winpr_Digest_Update(md5, salt, 48)) /* Salt (48 bytes) */
136 goto out;
137
138 if (!winpr_Digest_Update(md5, sha1_digest, sizeof(sha1_digest))) /* SHA1_Digest */
139 goto out;
140
141 if (!winpr_Digest_Final(md5, output, out_len))
142 goto out;
143
144 result = TRUE;
145out:
146 winpr_Digest_Free(sha1);
147 winpr_Digest_Free(md5);
148 return result;
149}
150
151static BOOL security_premaster_hash(const BYTE* input, size_t length, const BYTE* premaster_secret,
152 size_t pre_len, const BYTE* client_random, size_t client_len,
153 const BYTE* server_random, size_t server_len, BYTE* output,
154 size_t out_len)
155{
156 /* PremasterHash(Input) = SaltedHash(PremasterSecret, Input, ClientRandom, ServerRandom) */
157 return security_salted_hash(premaster_secret, pre_len, input, length, client_random, client_len,
158 server_random, server_len, output, out_len);
159}
160
161BOOL security_master_secret(const BYTE* premaster_secret, size_t pre_len, const BYTE* client_random,
162 size_t client_len, const BYTE* server_random, size_t server_len,
163 BYTE* output, size_t out_len)
164{
165 /* MasterSecret = PremasterHash('A') + PremasterHash('BB') + PremasterHash('CCC') */
166 WINPR_ASSERT(out_len >= 32);
167 return security_premaster_hash(A, sizeof(A), premaster_secret, pre_len, client_random,
168 client_len, server_random, server_len, &output[0], out_len) &&
169 security_premaster_hash(BB, sizeof(BB), premaster_secret, pre_len, client_random,
170 client_len, server_random, server_len, &output[16],
171 out_len - 16) &&
172 security_premaster_hash(CCC, sizeof(CCC), premaster_secret, pre_len, client_random,
173 client_len, server_random, server_len, &output[32],
174 out_len - 32);
175}
176
177static BOOL security_master_hash(const BYTE* input, size_t length, const BYTE* master_secret,
178 size_t master_len, const BYTE* client_random, size_t client_len,
179 const BYTE* server_random, size_t server_len, BYTE* output,
180 size_t out_len)
181{
182 /* MasterHash(Input) = SaltedHash(MasterSecret, Input, ServerRandom, ClientRandom) */
183 return security_salted_hash(master_secret, master_len, input, length, server_random, server_len,
184 client_random, client_len, output, out_len);
185}
186
187BOOL security_session_key_blob(const BYTE* master_secret, size_t master_len,
188 const BYTE* client_random, size_t client_len,
189 const BYTE* server_random, size_t server_len, BYTE* output,
190 size_t out_len)
191{
192 /* MasterHash = MasterHash('A') + MasterHash('BB') + MasterHash('CCC') */
193 WINPR_ASSERT(out_len >= 32);
194 return security_master_hash(A, sizeof(A), master_secret, master_len, client_random, client_len,
195 server_random, server_len, &output[0], 16) &&
196 security_master_hash(BB, sizeof(BB), master_secret, master_len, client_random,
197 client_len, server_random, server_len, &output[16], 16) &&
198 security_master_hash(CCC, sizeof(CCC), master_secret, master_len, client_random,
199 client_len, server_random, server_len, &output[32], out_len - 32);
200}
201
202void security_mac_salt_key(const BYTE* session_key_blob, WINPR_ATTR_UNUSED size_t session_len,
203 WINPR_ATTR_UNUSED const BYTE* client_random,
204 WINPR_ATTR_UNUSED size_t client_len,
205 WINPR_ATTR_UNUSED const BYTE* server_random,
206 WINPR_ATTR_UNUSED size_t server_len, BYTE* output,
207 WINPR_ATTR_UNUSED size_t out_len)
208{
209 /* MacSaltKey = First128Bits(SessionKeyBlob) */
210 WINPR_ASSERT(out_len >= 16);
211 WINPR_ASSERT(session_len >= 16);
212 memcpy(output, session_key_blob, 16);
213}
214
215static BOOL security_md5_16_32_32(const BYTE* in0, const BYTE* in1, const BYTE* in2, BYTE* output,
216 size_t out_len)
217{
218 WINPR_DIGEST_CTX* md5 = nullptr;
219 BOOL result = FALSE;
220
221 WINPR_ASSERT(WINPR_MD5_DIGEST_LENGTH <= out_len);
222
223 if (!(md5 = winpr_Digest_New()))
224 return FALSE;
225
226 if (!winpr_Digest_Init(md5, WINPR_MD_MD5))
227 goto out;
228
229 if (!winpr_Digest_Update(md5, in0, 16))
230 goto out;
231
232 if (!winpr_Digest_Update(md5, in1, 32))
233 goto out;
234
235 if (!winpr_Digest_Update(md5, in2, 32))
236 goto out;
237
238 if (!winpr_Digest_Final(md5, output, out_len))
239 goto out;
240
241 result = TRUE;
242out:
243 winpr_Digest_Free(md5);
244 return result;
245}
246
247static BOOL security_md5_16_32_32_Allow_FIPS(const BYTE* in0, const BYTE* in1, const BYTE* in2,
248 BYTE* output, size_t out_len)
249{
250 WINPR_DIGEST_CTX* md5 = nullptr;
251 BOOL result = FALSE;
252
253 WINPR_ASSERT(out_len >= WINPR_MD5_DIGEST_LENGTH);
254
255 if (!(md5 = winpr_Digest_New()))
256 return FALSE;
257 if (!winpr_Digest_Init_Allow_FIPS(md5, WINPR_MD_MD5))
258 goto out;
259 if (!winpr_Digest_Update(md5, in0, 16))
260 goto out;
261 if (!winpr_Digest_Update(md5, in1, 32))
262 goto out;
263 if (!winpr_Digest_Update(md5, in2, 32))
264 goto out;
265 if (!winpr_Digest_Final(md5, output, out_len))
266 goto out;
267
268 result = TRUE;
269out:
270 winpr_Digest_Free(md5);
271 return result;
272}
273
274BOOL security_licensing_encryption_key(const BYTE* session_key_blob, size_t session_len,
275 const BYTE* client_random, size_t client_len,
276 const BYTE* server_random, size_t server_len, BYTE* output,
277 size_t out_len)
278{
279 if (session_len < 16)
280 return FALSE;
281 if (client_len < 32)
282 return FALSE;
283 if (server_len < 32)
284 return FALSE;
285 /* LicensingEncryptionKey = MD5(Second128Bits(SessionKeyBlob) + ClientRandom + ServerRandom))
286 * Allow FIPS use of MD5 here, this is just used for creating the licensing encryption key as
287 * described in MS-RDPELE. This is for RDP licensing packets which will already be encrypted
288 * under FIPS, so the use of MD5 here is not for sensitive data protection. */
289 return security_md5_16_32_32_Allow_FIPS(&session_key_blob[16], client_random, server_random,
290 output, out_len);
291}
292
293static void security_UINT32_le(BYTE* output, WINPR_ATTR_UNUSED size_t out_len, UINT32 value)
294{
295 WINPR_ASSERT(output);
296 WINPR_ASSERT(out_len >= 4);
297 output[0] = (value)&0xFF;
298 output[1] = (value >> 8) & 0xFF;
299 output[2] = (value >> 16) & 0xFF;
300 output[3] = (value >> 24) & 0xFF;
301}
302
303BOOL security_mac_data(const BYTE* mac_salt_key, size_t mac_salt_key_length, const BYTE* data,
304 size_t length, BYTE* output, size_t output_length)
305{
306 WINPR_DIGEST_CTX* sha1 = nullptr;
307 WINPR_DIGEST_CTX* md5 = nullptr;
308 BYTE length_le[4] = WINPR_C_ARRAY_INIT;
309 BYTE sha1_digest[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
310 BOOL result = FALSE;
311
312 WINPR_ASSERT(length <= UINT32_MAX);
313 WINPR_ASSERT(mac_salt_key_length == WINPR_MD5_DIGEST_LENGTH);
314 WINPR_ASSERT(output_length == WINPR_MD5_DIGEST_LENGTH);
315
316 /* MacData = MD5(MacSaltKey + pad2 + SHA1(MacSaltKey + pad1 + length + data)) */
317 security_UINT32_le(length_le, sizeof(length_le),
318 (UINT32)length); /* length must be little-endian */
319
320 /* SHA1_Digest = SHA1(MacSaltKey + pad1 + length + data) */
321 if (!(sha1 = winpr_Digest_New()))
322 goto out;
323
324 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1))
325 goto out;
326
327 if (!winpr_Digest_Update(sha1, mac_salt_key, mac_salt_key_length)) /* MacSaltKey */
328 goto out;
329
330 if (!winpr_Digest_Update(sha1, pad1, sizeof(pad1))) /* pad1 */
331 goto out;
332
333 if (!winpr_Digest_Update(sha1, length_le, sizeof(length_le))) /* length */
334 goto out;
335
336 if (!winpr_Digest_Update(sha1, data, length)) /* data */
337 goto out;
338
339 if (!winpr_Digest_Final(sha1, sha1_digest, sizeof(sha1_digest)))
340 goto out;
341
342 /* MacData = MD5(MacSaltKey + pad2 + SHA1_Digest) */
343 if (!(md5 = winpr_Digest_New()))
344 goto out;
345
346 /* Allow FIPS override for use of MD5 here, this is only used for creating the MACData field of
347 * the */
348 /* Client Platform Challenge Response packet (from MS-RDPELE section 2.2.2.5). This is for RDP
349 * licensing packets */
350 /* which will already be encrypted under FIPS, so the use of MD5 here is not for sensitive data
351 * protection. */
352 if (!winpr_Digest_Init_Allow_FIPS(md5, WINPR_MD_MD5))
353 goto out;
354
355 if (!winpr_Digest_Update(md5, mac_salt_key, 16)) /* MacSaltKey */
356 goto out;
357
358 if (!winpr_Digest_Update(md5, pad2, sizeof(pad2))) /* pad2 */
359 goto out;
360
361 if (!winpr_Digest_Update(md5, sha1_digest, sizeof(sha1_digest))) /* SHA1_Digest */
362 goto out;
363
364 if (!winpr_Digest_Final(md5, output, output_length))
365 goto out;
366
367 result = TRUE;
368out:
369 if (!result)
370 WLog_ERR(TAG, "failed to create security mac");
371 winpr_Digest_Free(sha1);
372 winpr_Digest_Free(md5);
373 return result;
374}
375
376BOOL security_mac_signature(rdpRdp* rdp, const BYTE* data, UINT32 length, BYTE* output,
377 size_t out_len)
378{
379 WINPR_DIGEST_CTX* sha1 = nullptr;
380 WINPR_DIGEST_CTX* md5 = nullptr;
381 BYTE length_le[4] = WINPR_C_ARRAY_INIT;
382 BYTE md5_digest[WINPR_MD5_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
383 BYTE sha1_digest[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
384 BOOL result = FALSE;
385
386 WINPR_ASSERT(rdp);
387 WINPR_ASSERT(data || (length == 0));
388 WINPR_ASSERT(output);
389 WINPR_ASSERT(out_len >= 8);
390 if (out_len < 8)
391 return FALSE;
392
393 security_UINT32_le(length_le, sizeof(length_le), length); /* length must be little-endian */
394
395 /* SHA1_Digest = SHA1(MACKeyN + pad1 + length + data) */
396 if (!(sha1 = winpr_Digest_New()))
397 goto out;
398
399 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1))
400 goto out;
401
402 if (!winpr_Digest_Update(sha1, rdp->sign_key, rdp->rc4_key_len)) /* MacKeyN */
403 goto out;
404
405 if (!winpr_Digest_Update(sha1, pad1, sizeof(pad1))) /* pad1 */
406 goto out;
407
408 if (!winpr_Digest_Update(sha1, length_le, sizeof(length_le))) /* length */
409 goto out;
410
411 if (!winpr_Digest_Update(sha1, data, length)) /* data */
412 goto out;
413
414 if (!winpr_Digest_Final(sha1, sha1_digest, sizeof(sha1_digest)))
415 goto out;
416
417 /* MACSignature = First64Bits(MD5(MACKeyN + pad2 + SHA1_Digest)) */
418 if (!(md5 = winpr_Digest_New()))
419 goto out;
420
421 if (!winpr_Digest_Init(md5, WINPR_MD_MD5))
422 goto out;
423
424 if (!winpr_Digest_Update(md5, rdp->sign_key, rdp->rc4_key_len)) /* MacKeyN */
425 goto out;
426
427 if (!winpr_Digest_Update(md5, pad2, sizeof(pad2))) /* pad2 */
428 goto out;
429
430 if (!winpr_Digest_Update(md5, sha1_digest, sizeof(sha1_digest))) /* SHA1_Digest */
431 goto out;
432
433 if (!winpr_Digest_Final(md5, md5_digest, sizeof(md5_digest)))
434 goto out;
435
436 memcpy(output, md5_digest, 8);
437 result = TRUE;
438out:
439 if (!result)
440 WLog_WARN(TAG, "security mac generation failed");
441 winpr_Digest_Free(sha1);
442 winpr_Digest_Free(md5);
443 return result;
444}
445
446BOOL security_salted_mac_signature(rdpRdp* rdp, const BYTE* data, UINT32 length, BOOL encryption,
447 BYTE* output, size_t out_len)
448{
449 WINPR_DIGEST_CTX* sha1 = nullptr;
450 WINPR_DIGEST_CTX* md5 = nullptr;
451 BYTE length_le[4] = WINPR_C_ARRAY_INIT;
452 BYTE use_count_le[4] = WINPR_C_ARRAY_INIT;
453 BYTE md5_digest[WINPR_MD5_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
454 BYTE sha1_digest[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
455 BOOL result = FALSE;
456
457 WINPR_ASSERT(rdp);
458 WINPR_ASSERT(data || (length == 0));
459 WINPR_ASSERT(output);
460 WINPR_ASSERT(out_len >= 8);
461 if (out_len < 8)
462 return FALSE;
463
464 security_UINT32_le(length_le, sizeof(length_le), length); /* length must be little-endian */
465
466 if (encryption)
467 {
468 security_UINT32_le(use_count_le, sizeof(use_count_le), rdp->encrypt_checksum_use_count);
469 }
470 else
471 {
472 /*
473 * We calculate checksum on plain text, so we must have already
474 * decrypt it, which means decrypt_checksum_use_count is off by one.
475 */
476 security_UINT32_le(use_count_le, sizeof(use_count_le),
477 rdp->decrypt_checksum_use_count - 1u);
478 }
479
480 /* SHA1_Digest = SHA1(MACKeyN + pad1 + length + data) */
481 if (!(sha1 = winpr_Digest_New()))
482 goto out;
483
484 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1))
485 goto out;
486
487 if (!winpr_Digest_Update(sha1, rdp->sign_key, rdp->rc4_key_len)) /* MacKeyN */
488 goto out;
489
490 if (!winpr_Digest_Update(sha1, pad1, sizeof(pad1))) /* pad1 */
491 goto out;
492
493 if (!winpr_Digest_Update(sha1, length_le, sizeof(length_le))) /* length */
494 goto out;
495
496 if (!winpr_Digest_Update(sha1, data, length)) /* data */
497 goto out;
498
499 if (!winpr_Digest_Update(sha1, use_count_le, sizeof(use_count_le))) /* encryptionCount */
500 goto out;
501
502 if (!winpr_Digest_Final(sha1, sha1_digest, sizeof(sha1_digest)))
503 goto out;
504
505 /* MACSignature = First64Bits(MD5(MACKeyN + pad2 + SHA1_Digest)) */
506 if (!(md5 = winpr_Digest_New()))
507 goto out;
508
509 if (!winpr_Digest_Init(md5, WINPR_MD_MD5))
510 goto out;
511
512 if (!winpr_Digest_Update(md5, rdp->sign_key, rdp->rc4_key_len)) /* MacKeyN */
513 goto out;
514
515 if (!winpr_Digest_Update(md5, pad2, sizeof(pad2))) /* pad2 */
516 goto out;
517
518 if (!winpr_Digest_Update(md5, sha1_digest, sizeof(sha1_digest))) /* SHA1_Digest */
519 goto out;
520
521 if (!winpr_Digest_Final(md5, md5_digest, sizeof(md5_digest)))
522 goto out;
523
524 memcpy(output, md5_digest, 8);
525 result = TRUE;
526out:
527 if (!result)
528 WLog_WARN(TAG, "security mac signature generation failed");
529
530 winpr_Digest_Free(sha1);
531 winpr_Digest_Free(md5);
532 return result;
533}
534
535static BOOL security_A(const BYTE* master_secret, size_t master_len, const BYTE* client_random,
536 size_t client_len, const BYTE* server_random, size_t server_len,
537 BYTE* output, size_t out_len)
538{
539 WINPR_ASSERT(out_len >= 32);
540
541 return security_premaster_hash(A, sizeof(A), master_secret, master_len, client_random,
542 client_len, server_random, server_len, &output[0], 16) &&
543 security_premaster_hash(BB, sizeof(BB), master_secret, master_len, client_random,
544 client_len, server_random, server_len, &output[16], 16) &&
545 security_premaster_hash(CCC, sizeof(CCC), master_secret, master_len, client_random,
546 client_len, server_random, server_len, &output[32],
547 out_len - 32);
548}
549
550static BOOL security_X(const BYTE* master_secret, size_t master_len, const BYTE* client_random,
551 size_t client_len, const BYTE* server_random, size_t server_len,
552 BYTE* output, size_t out_len)
553{
554 const BYTE X[] = { 'X' };
555 const BYTE YY[] = { 'Y', 'Y' };
556 const BYTE ZZZ[] = { 'Z', 'Z', 'Z' };
557
558 WINPR_ASSERT(out_len >= 32);
559
560 return security_premaster_hash(X, sizeof(X), master_secret, master_len, client_random,
561 client_len, server_random, server_len, &output[0], 16) &&
562 security_premaster_hash(YY, sizeof(YY), master_secret, master_len, client_random,
563 client_len, server_random, server_len, &output[16], 16) &&
564 security_premaster_hash(ZZZ, sizeof(ZZZ), master_secret, master_len, client_random,
565 client_len, server_random, server_len, &output[32],
566 out_len - 32);
567}
568
569static void fips_expand_key_bits(const BYTE* in, WINPR_ATTR_UNUSED size_t in_len, BYTE* out,
570 WINPR_ATTR_UNUSED size_t out_len)
571{
572 BYTE buf[21] = WINPR_C_ARRAY_INIT;
573
574 WINPR_ASSERT(in);
575 WINPR_ASSERT(in_len >= sizeof(buf));
576
577 WINPR_ASSERT(out);
578 WINPR_ASSERT(out_len >= 24);
579
580 /* reverse every byte in the key */
581 for (size_t i = 0; i < sizeof(buf); i++)
582 buf[i] = fips_reverse_table[in[i]];
583
584 /* insert a zero-bit after every 7th bit */
585 size_t b = 0;
586 for (size_t i = 0; i < 24; i++, b += 7)
587 {
588 const size_t p = b / 8;
589 const size_t r = b % 8;
590
591 WINPR_ASSERT(p < sizeof(buf));
592 if (r <= 1)
593 {
594 out[i] = (buf[p] << r) & 0xfe;
595 }
596 else
597 {
598 WINPR_ASSERT(p + 1 < sizeof(buf));
599 /* c is accumulator */
600 BYTE c = (BYTE)(buf[p] << r) & 0xFF;
601 c |= buf[p + 1] >> (8 - r);
602 out[i] = c & 0xfe;
603 }
604 }
605
606 /* reverse every byte */
607 /* alter lsb so the byte has odd parity */
608 for (size_t i = 0; i < 24; i++)
609 out[i] = fips_oddparity_table[fips_reverse_table[out[i]]];
610}
611
612BOOL security_establish_keys(rdpRdp* rdp)
613{
614 BYTE pre_master_secret[48] = WINPR_C_ARRAY_INIT;
615 BYTE master_secret[48] = WINPR_C_ARRAY_INIT;
616 BYTE session_key_blob[48] = WINPR_C_ARRAY_INIT;
617 BYTE salt[] = { 0xD1, 0x26, 0x9E }; /* 40 bits: 3 bytes, 56 bits: 1 byte */
618 BOOL status = FALSE;
619
620 WINPR_ASSERT(rdp);
621 const rdpSettings* settings = rdp->settings;
622 WINPR_ASSERT(settings);
623
624 const BYTE* server_random = freerdp_settings_get_pointer(settings, FreeRDP_ServerRandom);
625 const BYTE* client_random = freerdp_settings_get_pointer(settings, FreeRDP_ClientRandom);
626 WINPR_ASSERT(client_random);
627 WINPR_ASSERT(server_random);
628
629 const UINT32 ClientRandomLength =
630 freerdp_settings_get_uint32(settings, FreeRDP_ClientRandomLength);
631 const UINT32 ServerRandomLength =
632 freerdp_settings_get_uint32(settings, FreeRDP_ServerRandomLength);
633 /* The server random is peer supplied (gcc_read_server_security_data rejects only a length
634 * of 0) while both randoms are consumed below as fixed 32 byte values, so a shorter buffer
635 * would be read past its end. WINPR_ASSERT is compiled out in release builds, enforce the
636 * length at runtime. */
637 if ((ClientRandomLength != 32) || (ServerRandomLength != 32))
638 {
639 WLog_ERR(TAG, "invalid client (%" PRIu32 ") or server (%" PRIu32 ") random length",
640 ClientRandomLength, ServerRandomLength);
641 return FALSE;
642 }
643
644 if (settings->EncryptionMethods == ENCRYPTION_METHOD_FIPS)
645 {
646 BYTE client_encrypt_key_t[WINPR_SHA1_DIGEST_LENGTH + 1] = WINPR_C_ARRAY_INIT;
647 BYTE client_decrypt_key_t[WINPR_SHA1_DIGEST_LENGTH + 1] = WINPR_C_ARRAY_INIT;
648 WINPR_DIGEST_CTX* sha1 = winpr_Digest_New();
649 if (!sha1)
650 return FALSE;
651
652 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1) ||
653 !winpr_Digest_Update(sha1, client_random + 16, 16) ||
654 !winpr_Digest_Update(sha1, server_random + 16, 16) ||
655 !winpr_Digest_Final(sha1, client_encrypt_key_t, sizeof(client_encrypt_key_t)))
656 {
657 winpr_Digest_Free(sha1);
658 return FALSE;
659 }
660
661 client_encrypt_key_t[20] = client_encrypt_key_t[0];
662
663 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1) ||
664 !winpr_Digest_Update(sha1, client_random, 16) ||
665 !winpr_Digest_Update(sha1, server_random, 16) ||
666 !winpr_Digest_Final(sha1, client_decrypt_key_t, sizeof(client_decrypt_key_t)))
667 {
668 winpr_Digest_Free(sha1);
669 return FALSE;
670 }
671
672 client_decrypt_key_t[20] = client_decrypt_key_t[0];
673
674 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1) ||
675 !winpr_Digest_Update(sha1, client_decrypt_key_t, WINPR_SHA1_DIGEST_LENGTH) ||
676 !winpr_Digest_Update(sha1, client_encrypt_key_t, WINPR_SHA1_DIGEST_LENGTH) ||
677 !winpr_Digest_Final(sha1, rdp->fips_sign_key, WINPR_SHA1_DIGEST_LENGTH))
678 {
679 winpr_Digest_Free(sha1);
680 return FALSE;
681 }
682
683 winpr_Digest_Free(sha1);
684
685 if (settings->ServerMode)
686 {
687 fips_expand_key_bits(client_encrypt_key_t, sizeof(client_encrypt_key_t),
688 rdp->fips_decrypt_key, sizeof(rdp->fips_decrypt_key));
689 fips_expand_key_bits(client_decrypt_key_t, sizeof(client_decrypt_key_t),
690 rdp->fips_encrypt_key, sizeof(rdp->fips_encrypt_key));
691 }
692 else
693 {
694 fips_expand_key_bits(client_encrypt_key_t, sizeof(client_encrypt_key_t),
695 rdp->fips_encrypt_key, sizeof(rdp->fips_encrypt_key));
696 fips_expand_key_bits(client_decrypt_key_t, sizeof(client_decrypt_key_t),
697 rdp->fips_decrypt_key, sizeof(rdp->fips_decrypt_key));
698 }
699 }
700
701 memcpy(pre_master_secret, client_random, 24);
702 memcpy(pre_master_secret + 24, server_random, 24);
703
704 if (!security_A(pre_master_secret, sizeof(pre_master_secret), client_random, ClientRandomLength,
705 server_random, ServerRandomLength, master_secret, sizeof(master_secret)) ||
706 !security_X(master_secret, sizeof(master_secret), client_random, ClientRandomLength,
707 server_random, ServerRandomLength, session_key_blob, sizeof(session_key_blob)))
708 {
709 return FALSE;
710 }
711
712 memcpy(rdp->sign_key, session_key_blob, 16);
713
714 if (settings->ServerMode)
715 {
716 status = security_md5_16_32_32(&session_key_blob[16], client_random, server_random,
717 rdp->encrypt_key, sizeof(rdp->encrypt_key));
718 status &= security_md5_16_32_32(&session_key_blob[32], client_random, server_random,
719 rdp->decrypt_key, sizeof(rdp->decrypt_key));
720 }
721 else
722 {
723 /* Allow FIPS use of MD5 here, this is just used for generation of the SessionKeyBlob as
724 * described in MS-RDPELE. */
725 /* This is for RDP licensing packets which will already be encrypted under FIPS, so the use
726 * of MD5 here is not */
727 /* for sensitive data protection. */
728 status =
729 security_md5_16_32_32_Allow_FIPS(&session_key_blob[16], client_random, server_random,
730 rdp->decrypt_key, sizeof(rdp->decrypt_key));
731 status &=
732 security_md5_16_32_32_Allow_FIPS(&session_key_blob[32], client_random, server_random,
733 rdp->encrypt_key, sizeof(rdp->encrypt_key));
734 }
735
736 if (!status)
737 return FALSE;
738
739 if (settings->EncryptionMethods == ENCRYPTION_METHOD_40BIT)
740 {
741 memcpy(rdp->sign_key, salt, 3);
742 memcpy(rdp->decrypt_key, salt, 3);
743 memcpy(rdp->encrypt_key, salt, 3);
744 rdp->rc4_key_len = 8;
745 }
746 else if (settings->EncryptionMethods == ENCRYPTION_METHOD_56BIT)
747 {
748 memcpy(rdp->sign_key, salt, 1);
749 memcpy(rdp->decrypt_key, salt, 1);
750 memcpy(rdp->encrypt_key, salt, 1);
751 rdp->rc4_key_len = 8;
752 }
753 else if (settings->EncryptionMethods == ENCRYPTION_METHOD_128BIT)
754 {
755 rdp->rc4_key_len = 16;
756 }
757
758 security_lock(rdp);
759 memcpy(rdp->decrypt_update_key, rdp->decrypt_key, 16);
760 memcpy(rdp->encrypt_update_key, rdp->encrypt_key, 16);
761 rdp->decrypt_use_count = 0;
762 rdp->decrypt_checksum_use_count = 0;
763 rdp->encrypt_use_count = 0;
764 rdp->encrypt_checksum_use_count = 0;
765
766 security_unlock(rdp);
767 return TRUE;
768}
769
770static BOOL security_key_update(BYTE* key, BYTE* update_key, size_t key_len, rdpRdp* rdp)
771{
772 BYTE sha1h[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
773 WINPR_DIGEST_CTX* sha1 = nullptr;
774 WINPR_DIGEST_CTX* md5 = nullptr;
775 WINPR_RC4_CTX* rc4 = nullptr;
776 BYTE salt[] = { 0xD1, 0x26, 0x9E }; /* 40 bits: 3 bytes, 56 bits: 1 byte */
777 BOOL result = FALSE;
778 WLog_DBG(TAG, "updating RDP key");
779
780 if (!(sha1 = winpr_Digest_New()))
781 goto out;
782
783 if (!winpr_Digest_Init(sha1, WINPR_MD_SHA1))
784 goto out;
785
786 if (!winpr_Digest_Update(sha1, update_key, key_len))
787 goto out;
788
789 if (!winpr_Digest_Update(sha1, pad1, sizeof(pad1)))
790 goto out;
791
792 if (!winpr_Digest_Update(sha1, key, key_len))
793 goto out;
794
795 if (!winpr_Digest_Final(sha1, sha1h, sizeof(sha1h)))
796 goto out;
797
798 if (!(md5 = winpr_Digest_New()))
799 goto out;
800
801 if (!winpr_Digest_Init(md5, WINPR_MD_MD5))
802 goto out;
803
804 if (!winpr_Digest_Update(md5, update_key, key_len))
805 goto out;
806
807 if (!winpr_Digest_Update(md5, pad2, sizeof(pad2)))
808 goto out;
809
810 if (!winpr_Digest_Update(md5, sha1h, sizeof(sha1h)))
811 goto out;
812
813 if (!winpr_Digest_Final(md5, key, WINPR_MD5_DIGEST_LENGTH))
814 goto out;
815
816 if (!(rc4 = winpr_RC4_New(key, key_len)))
817 goto out;
818
819 if (!winpr_RC4_Update(rc4, key_len, key, key))
820 goto out;
821
822 if (rdp->settings->EncryptionMethods == ENCRYPTION_METHOD_40BIT)
823 memcpy(key, salt, 3);
824 else if (rdp->settings->EncryptionMethods == ENCRYPTION_METHOD_56BIT)
825 memcpy(key, salt, 1);
826
827 result = TRUE;
828out:
829 winpr_Digest_Free(sha1);
830 winpr_Digest_Free(md5);
831 winpr_RC4_Free(rc4);
832 return result;
833}
834
835BOOL security_encrypt(BYTE* data, size_t length, rdpRdp* rdp)
836{
837 BOOL rc = FALSE;
838
839 WINPR_ASSERT(rdp);
840 if (!rdp->rc4_encrypt_key)
841 {
842 WLog_ERR(TAG, "rdp->rc4_encrypt_key=nullptr");
843 goto fail;
844 }
845
846 if (rdp->encrypt_use_count >= 4096)
847 {
848 if (!security_key_update(rdp->encrypt_key, rdp->encrypt_update_key, rdp->rc4_key_len, rdp))
849 goto fail;
850
851 if (!rdp_reset_rc4_encrypt_keys(rdp))
852 goto fail;
853 }
854
855 if (!winpr_RC4_Update(rdp->rc4_encrypt_key, length, data, data))
856 goto fail;
857
858 rdp->encrypt_use_count++;
859 rdp->encrypt_checksum_use_count++;
860 rc = TRUE;
861fail:
862 return rc;
863}
864
865BOOL security_decrypt(BYTE* data, size_t length, rdpRdp* rdp)
866{
867 BOOL rc = FALSE;
868
869 WINPR_ASSERT(data || (length == 0));
870 WINPR_ASSERT(rdp);
871
872 if (!rdp->rc4_decrypt_key)
873 {
874 WLog_ERR(TAG, "rdp->rc4_decrypt_key=nullptr");
875 goto fail;
876 }
877
878 if (rdp->decrypt_use_count >= 4096)
879 {
880 if (!security_key_update(rdp->decrypt_key, rdp->decrypt_update_key, rdp->rc4_key_len, rdp))
881 goto fail;
882
883 if (!rdp_reset_rc4_decrypt_keys(rdp))
884 goto fail;
885 }
886
887 if (!winpr_RC4_Update(rdp->rc4_decrypt_key, length, data, data))
888 goto fail;
889
890 rdp->decrypt_use_count += 1;
891 rdp->decrypt_checksum_use_count++;
892 rc = TRUE;
893fail:
894 if (!rc)
895 WLog_WARN(TAG, "Failed to decrypt security");
896 return rc;
897}
898
899BOOL security_hmac_signature(const BYTE* data, size_t length, BYTE* output, size_t out_len,
900 rdpRdp* rdp)
901{
902 BYTE buf[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
903 BYTE use_count_le[4] = WINPR_C_ARRAY_INIT;
904 WINPR_HMAC_CTX* hmac = nullptr;
905 BOOL result = FALSE;
906
907 WINPR_ASSERT(rdp);
908 WINPR_ASSERT(output);
909 if (out_len < 8)
910 return FALSE;
911
912 security_UINT32_le(use_count_le, sizeof(use_count_le), rdp->encrypt_use_count);
913
914 if (!(hmac = winpr_HMAC_New()))
915 return FALSE;
916
917 if (!winpr_HMAC_Init(hmac, WINPR_MD_SHA1, rdp->fips_sign_key, WINPR_SHA1_DIGEST_LENGTH))
918 goto out;
919
920 if (!winpr_HMAC_Update(hmac, data, length))
921 goto out;
922
923 if (!winpr_HMAC_Update(hmac, use_count_le, 4))
924 goto out;
925
926 if (!winpr_HMAC_Final(hmac, buf, WINPR_SHA1_DIGEST_LENGTH))
927 goto out;
928
929 memmove(output, buf, 8);
930 result = TRUE;
931out:
932 winpr_HMAC_Free(hmac);
933 return result;
934}
935
936BOOL security_fips_encrypt(BYTE* data, size_t length, rdpRdp* rdp)
937{
938 BOOL rc = FALSE;
939 size_t olen = 0;
940
941 if (!winpr_Cipher_Update(rdp->fips_encrypt, data, length, data, &olen))
942 goto fail;
943
944 rdp->encrypt_use_count++;
945 rc = TRUE;
946fail:
947 return rc;
948}
949
950BOOL security_fips_decrypt(BYTE* data, size_t length, rdpRdp* rdp)
951{
952 size_t olen = 0;
953
954 if (!rdp || !rdp->fips_decrypt)
955 {
956 WLog_ERR(TAG, "rdp=%p, rdp->fips_decrypt=%p", WINPR_CXX_COMPAT_CAST(const void*, rdp),
957 WINPR_CXX_COMPAT_CAST(const void*, rdp ? rdp->fips_decrypt : nullptr));
958 return FALSE;
959 }
960
961 if (!winpr_Cipher_Update(rdp->fips_decrypt, data, length, data, &olen))
962 return FALSE;
963
964 return TRUE;
965}
966
967BOOL security_fips_check_signature(const BYTE* data, size_t length, const BYTE* sig, size_t sig_len,
968 rdpRdp* rdp)
969{
970 BYTE buf[WINPR_SHA1_DIGEST_LENGTH] = WINPR_C_ARRAY_INIT;
971 BYTE use_count_le[4] = WINPR_C_ARRAY_INIT;
972 WINPR_HMAC_CTX* hmac = nullptr;
973 BOOL result = FALSE;
974
975 security_UINT32_le(use_count_le, sizeof(use_count_le), rdp->decrypt_use_count++);
976
977 if (!(hmac = winpr_HMAC_New()))
978 goto out;
979
980 if (!winpr_HMAC_Init(hmac, WINPR_MD_SHA1, rdp->fips_sign_key, WINPR_SHA1_DIGEST_LENGTH))
981 goto out;
982
983 if (!winpr_HMAC_Update(hmac, data, length))
984 goto out;
985
986 if (!winpr_HMAC_Update(hmac, use_count_le, 4))
987 goto out;
988
989 if (!winpr_HMAC_Final(hmac, buf, WINPR_SHA1_DIGEST_LENGTH))
990 goto out;
991
992 if ((sig_len >= 8) && (memcmp(sig, buf, 8) == 0))
993 result = TRUE;
994
995out:
996 if (!result)
997 WLog_WARN(TAG, "signature check failed");
998 winpr_HMAC_Free(hmac);
999 return result;
1000}
1001
1002void security_lock(rdpRdp* rdp)
1003{
1004 WINPR_ASSERT(rdp);
1005 EnterCriticalSection(&rdp->critical);
1006}
1007
1008void security_unlock(rdpRdp* rdp)
1009{
1010 WINPR_ASSERT(rdp);
1011 LeaveCriticalSection(&rdp->critical);
1012}
freerdp_settings_get_pointer
WINPR_ATTR_NODISCARD FREERDP_API const void * freerdp_settings_get_pointer(const rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a immutable pointer settings value.
Definition common/settings.c:1414
freerdp_settings_get_uint32
WINPR_ATTR_NODISCARD FREERDP_API UINT32 freerdp_settings_get_uint32(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id)
Returns a UINT32 settings value.