blob: 4551011f5ca9ef2b1131b1e331ffe2418936f247 [file] [log] [blame]
Gregory P. Smithf21a5f72005-08-21 18:45:59 +00001# Test hashlib module
2#
3# $Id$
4#
Benjamin Peterson46a99002010-01-09 18:45:30 +00005# Copyright (C) 2005-2010 Gregory P. Smith (greg@krypto.org)
Gregory P. Smithf21a5f72005-08-21 18:45:59 +00006# Licensed to PSF under a Contributor Agreement.
7#
8
Benjamin Petersona28e7022010-01-09 18:53:06 +00009import array
Christian Heimes39093e92016-09-06 20:22:28 +020010from binascii import unhexlify
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000011import hashlib
Benjamin Peterson77526f02018-01-29 18:03:01 -080012import importlib
Benjamin Petersona28e7022010-01-09 18:53:06 +000013import itertools
Antoine Pitrou019ff192012-05-16 16:41:26 +020014import os
Gregory P. Smithcd54e542010-01-03 00:29:15 +000015import sys
Christian Heimes909b5712020-05-22 20:04:33 +020016import sysconfig
Antoine Pitroua6a4dc82017-09-07 18:56:24 +020017import threading
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000018import unittest
Gregory P. Smithcd54e542010-01-03 00:29:15 +000019import warnings
Benjamin Petersonee8712c2008-05-20 21:35:26 +000020from test import support
Hai Shideb01622020-07-06 20:29:49 +080021from test.support import _4G, bigmemtest
22from test.support.import_helper import import_fresh_module
Hai Shie80697d2020-05-28 06:10:27 +080023from test.support import threading_helper
Christian Heimes81188242016-09-08 10:53:40 +020024from http.client import HTTPException
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000025
Gregory P. Smithcd54e542010-01-03 00:29:15 +000026# Were we compiled --with-pydebug or with #define Py_DEBUG?
27COMPILED_WITH_PYDEBUG = hasattr(sys, 'gettotalrefcount')
28
Christian Heimes3626a502013-10-19 14:12:02 +020029c_hashlib = import_fresh_module('hashlib', fresh=['_hashlib'])
30py_hashlib = import_fresh_module('hashlib', blocked=['_hashlib'])
Gregory P. Smithcd54e542010-01-03 00:29:15 +000031
Christian Heimes909b5712020-05-22 20:04:33 +020032builtin_hashes = sysconfig.get_config_var("PY_BUILTIN_HASHLIB_HASHES")
33if builtin_hashes is None:
34 builtin_hashes = {'md5', 'sha1', 'sha256', 'sha512', 'sha3', 'blake2'}
35else:
36 builtin_hashes = {
37 m.strip() for m in builtin_hashes.strip('"').lower().split(",")
38 }
39
Christian Heimes121b9482016-09-06 22:03:25 +020040try:
Christian Heimes909b5712020-05-22 20:04:33 +020041 from _hashlib import HASH, HASHXOF, openssl_md_meth_names
Christian Heimes995b5d32019-09-13 15:31:19 +020042except ImportError:
43 HASH = None
Christian Heimesd5b3f6b2020-05-16 22:27:06 +020044 HASHXOF = None
Christian Heimes909b5712020-05-22 20:04:33 +020045 openssl_md_meth_names = frozenset()
Christian Heimes995b5d32019-09-13 15:31:19 +020046
47try:
Christian Heimes121b9482016-09-06 22:03:25 +020048 import _blake2
49except ImportError:
50 _blake2 = None
51
52requires_blake2 = unittest.skipUnless(_blake2, 'requires _blake2')
53
Christian Heimes6fe2a752016-09-07 11:58:24 +020054try:
55 import _sha3
56except ImportError:
57 _sha3 = None
58
59requires_sha3 = unittest.skipUnless(_sha3, 'requires _sha3')
60
Christian Heimes121b9482016-09-06 22:03:25 +020061
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000062def hexstr(s):
Guido van Rossum5ed033b2007-07-09 14:29:40 +000063 assert isinstance(s, bytes), repr(s)
Guido van Rossum558ca842007-07-10 20:31:05 +000064 h = "0123456789abcdef"
65 r = ''
Guido van Rossum5ed033b2007-07-09 14:29:40 +000066 for i in s:
Guido van Rossum558ca842007-07-10 20:31:05 +000067 r += h[(i >> 4) & 0xF] + h[i & 0xF]
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000068 return r
69
70
Christian Heimes59a04642016-09-07 01:21:14 +020071URL = "http://www.pythontest.net/hashlib/{}.txt"
Christian Heimes121b9482016-09-06 22:03:25 +020072
73def read_vectors(hash_name):
Christian Heimes81188242016-09-08 10:53:40 +020074 url = URL.format(hash_name)
75 try:
76 testdata = support.open_urlresource(url)
77 except (OSError, HTTPException):
78 raise unittest.SkipTest("Could not retrieve {}".format(url))
79 with testdata:
80 for line in testdata:
Christian Heimes121b9482016-09-06 22:03:25 +020081 line = line.strip()
82 if line.startswith('#') or not line:
83 continue
84 parts = line.split(',')
85 parts[0] = bytes.fromhex(parts[0])
86 yield parts
87
88
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000089class HashLibTestCase(unittest.TestCase):
90 supported_hash_names = ( 'md5', 'MD5', 'sha1', 'SHA1',
91 'sha224', 'SHA224', 'sha256', 'SHA256',
Christian Heimes121b9482016-09-06 22:03:25 +020092 'sha384', 'SHA384', 'sha512', 'SHA512',
Christian Heimes6fe2a752016-09-07 11:58:24 +020093 'blake2b', 'blake2s',
94 'sha3_224', 'sha3_256', 'sha3_384', 'sha3_512',
95 'shake_128', 'shake_256')
96
97 shakes = {'shake_128', 'shake_256'}
Gregory P. Smithf21a5f72005-08-21 18:45:59 +000098
Antoine Pitrou019ff192012-05-16 16:41:26 +020099 # Issue #14693: fallback modules are always compiled under POSIX
100 _warn_on_extension_import = os.name == 'posix' or COMPILED_WITH_PYDEBUG
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000101
102 def _conditional_import_module(self, module_name):
103 """Import a module and return a reference to it or None on failure."""
104 try:
Benjamin Peterson77526f02018-01-29 18:03:01 -0800105 return importlib.import_module(module_name)
106 except ModuleNotFoundError as error:
stratakis236a0f52020-06-17 19:26:08 +0200107 if self._warn_on_extension_import and module_name in builtin_hashes:
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000108 warnings.warn('Did a C extension fail to compile? %s' % error)
Benjamin Peterson77526f02018-01-29 18:03:01 -0800109 return None
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000110
111 def __init__(self, *args, **kwargs):
112 algorithms = set()
113 for algorithm in self.supported_hash_names:
114 algorithms.add(algorithm.lower())
Christian Heimes121b9482016-09-06 22:03:25 +0200115
116 _blake2 = self._conditional_import_module('_blake2')
117 if _blake2:
118 algorithms.update({'blake2b', 'blake2s'})
119
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000120 self.constructors_to_test = {}
121 for algorithm in algorithms:
122 self.constructors_to_test[algorithm] = set()
123
124 # For each algorithm, test the direct constructor and the use
125 # of hashlib.new given the algorithm name.
126 for algorithm, constructors in self.constructors_to_test.items():
127 constructors.add(getattr(hashlib, algorithm))
Christian Heimes121b9482016-09-06 22:03:25 +0200128 def _test_algorithm_via_hashlib_new(data=None, _alg=algorithm, **kwargs):
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000129 if data is None:
Christian Heimes121b9482016-09-06 22:03:25 +0200130 return hashlib.new(_alg, **kwargs)
131 return hashlib.new(_alg, data, **kwargs)
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000132 constructors.add(_test_algorithm_via_hashlib_new)
133
134 _hashlib = self._conditional_import_module('_hashlib')
Christian Heimes90558152019-09-27 15:03:53 +0200135 self._hashlib = _hashlib
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000136 if _hashlib:
137 # These two algorithms should always be present when this module
138 # is compiled. If not, something was compiled wrong.
Gregory P. Smith914061a2013-08-05 13:14:37 -0700139 self.assertTrue(hasattr(_hashlib, 'openssl_md5'))
140 self.assertTrue(hasattr(_hashlib, 'openssl_sha1'))
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000141 for algorithm, constructors in self.constructors_to_test.items():
142 constructor = getattr(_hashlib, 'openssl_'+algorithm, None)
143 if constructor:
Christian Heimes90558152019-09-27 15:03:53 +0200144 try:
145 constructor()
146 except ValueError:
147 # default constructor blocked by crypto policy
148 pass
149 else:
150 constructors.add(constructor)
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000151
Christian Heimese5351072013-10-22 14:59:12 +0200152 def add_builtin_constructor(name):
153 constructor = getattr(hashlib, "__get_builtin_constructor")(name)
154 self.constructors_to_test[name].add(constructor)
155
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000156 _md5 = self._conditional_import_module('_md5')
157 if _md5:
Christian Heimese5351072013-10-22 14:59:12 +0200158 add_builtin_constructor('md5')
Gregory P. Smithb04ded42010-01-03 00:38:10 +0000159 _sha1 = self._conditional_import_module('_sha1')
160 if _sha1:
Christian Heimese5351072013-10-22 14:59:12 +0200161 add_builtin_constructor('sha1')
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000162 _sha256 = self._conditional_import_module('_sha256')
163 if _sha256:
Christian Heimese5351072013-10-22 14:59:12 +0200164 add_builtin_constructor('sha224')
165 add_builtin_constructor('sha256')
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000166 _sha512 = self._conditional_import_module('_sha512')
167 if _sha512:
Christian Heimese5351072013-10-22 14:59:12 +0200168 add_builtin_constructor('sha384')
169 add_builtin_constructor('sha512')
Christian Heimes121b9482016-09-06 22:03:25 +0200170 if _blake2:
171 add_builtin_constructor('blake2s')
172 add_builtin_constructor('blake2b')
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000173
Christian Heimes6fe2a752016-09-07 11:58:24 +0200174 _sha3 = self._conditional_import_module('_sha3')
175 if _sha3:
176 add_builtin_constructor('sha3_224')
177 add_builtin_constructor('sha3_256')
178 add_builtin_constructor('sha3_384')
179 add_builtin_constructor('sha3_512')
180 add_builtin_constructor('shake_128')
181 add_builtin_constructor('shake_256')
182
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000183 super(HashLibTestCase, self).__init__(*args, **kwargs)
184
Christian Heimes65aa5732013-07-30 15:33:30 +0200185 @property
186 def hash_constructors(self):
187 constructors = self.constructors_to_test.values()
188 return itertools.chain.from_iterable(constructors)
189
Christian Heimes909b5712020-05-22 20:04:33 +0200190 @property
191 def is_fips_mode(self):
192 if hasattr(self._hashlib, "get_fips_mode"):
193 return self._hashlib.get_fips_mode()
194 else:
195 return None
196
Benjamin Petersona28e7022010-01-09 18:53:06 +0000197 def test_hash_array(self):
198 a = array.array("b", range(10))
Christian Heimes65aa5732013-07-30 15:33:30 +0200199 for cons in self.hash_constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200200 c = cons(a, usedforsecurity=False)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200201 if c.name in self.shakes:
202 c.hexdigest(16)
203 else:
204 c.hexdigest()
Benjamin Petersona28e7022010-01-09 18:53:06 +0000205
Gregory P. Smith13b55292010-09-06 08:30:23 +0000206 def test_algorithms_guaranteed(self):
207 self.assertEqual(hashlib.algorithms_guaranteed,
Raymond Hettingerbf1d2bc2011-01-24 04:52:27 +0000208 set(_algo for _algo in self.supported_hash_names
Gregory P. Smith86508cc2010-03-01 02:05:26 +0000209 if _algo.islower()))
210
Gregory P. Smith13b55292010-09-06 08:30:23 +0000211 def test_algorithms_available(self):
212 self.assertTrue(set(hashlib.algorithms_guaranteed).
213 issubset(hashlib.algorithms_available))
214
Christian Heimes909b5712020-05-22 20:04:33 +0200215 def test_usedforsecurity_true(self):
216 hashlib.new("sha256", usedforsecurity=True)
217 if self.is_fips_mode:
218 self.skipTest("skip in FIPS mode")
Christian Heimes7cad53e2019-09-13 02:30:00 +0200219 for cons in self.hash_constructors:
220 cons(usedforsecurity=True)
Christian Heimes7cad53e2019-09-13 02:30:00 +0200221 cons(b'', usedforsecurity=True)
Christian Heimes909b5712020-05-22 20:04:33 +0200222 hashlib.new("md5", usedforsecurity=True)
223 hashlib.md5(usedforsecurity=True)
224 if self._hashlib is not None:
225 self._hashlib.new("md5", usedforsecurity=True)
226 self._hashlib.openssl_md5(usedforsecurity=True)
227
228 def test_usedforsecurity_false(self):
Christian Heimes7cad53e2019-09-13 02:30:00 +0200229 hashlib.new("sha256", usedforsecurity=False)
Christian Heimes909b5712020-05-22 20:04:33 +0200230 for cons in self.hash_constructors:
231 cons(usedforsecurity=False)
232 cons(b'', usedforsecurity=False)
233 hashlib.new("md5", usedforsecurity=False)
234 hashlib.md5(usedforsecurity=False)
Christian Heimes90558152019-09-27 15:03:53 +0200235 if self._hashlib is not None:
236 self._hashlib.new("md5", usedforsecurity=False)
237 self._hashlib.openssl_md5(usedforsecurity=False)
Christian Heimes7cad53e2019-09-13 02:30:00 +0200238
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000239 def test_unknown_hash(self):
Amaury Forgeot d'Arc3a3dc172012-06-29 01:53:13 +0200240 self.assertRaises(ValueError, hashlib.new, 'spam spam spam spam spam')
241 self.assertRaises(TypeError, hashlib.new, 1)
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000242
Christian Heimes5a4f82f2019-09-12 14:42:07 +0200243 def test_new_upper_to_lower(self):
244 self.assertEqual(hashlib.new("SHA256").name, "sha256")
245
Gregory P. Smith12c9d022011-05-14 15:15:49 -0700246 def test_get_builtin_constructor(self):
Christian Heimese5351072013-10-22 14:59:12 +0200247 get_builtin_constructor = getattr(hashlib,
248 '__get_builtin_constructor')
249 builtin_constructor_cache = getattr(hashlib,
250 '__builtin_constructor_cache')
Gregory P. Smith12c9d022011-05-14 15:15:49 -0700251 self.assertRaises(ValueError, get_builtin_constructor, 'test')
252 try:
253 import _md5
254 except ImportError:
Benjamin Peterson95441802018-01-29 22:14:17 -0800255 self.skipTest("_md5 module not available")
Gregory P. Smith12c9d022011-05-14 15:15:49 -0700256 # This forces an ImportError for "import _md5" statements
257 sys.modules['_md5'] = None
Christian Heimese5351072013-10-22 14:59:12 +0200258 # clear the cache
259 builtin_constructor_cache.clear()
Gregory P. Smith12c9d022011-05-14 15:15:49 -0700260 try:
261 self.assertRaises(ValueError, get_builtin_constructor, 'md5')
262 finally:
263 if '_md5' in locals():
264 sys.modules['_md5'] = _md5
265 else:
266 del sys.modules['_md5']
Gregory P. Smith76c28f72012-07-21 21:19:53 -0700267 self.assertRaises(TypeError, get_builtin_constructor, 3)
Christian Heimese5351072013-10-22 14:59:12 +0200268 constructor = get_builtin_constructor('md5')
269 self.assertIs(constructor, _md5.md5)
270 self.assertEqual(sorted(builtin_constructor_cache), ['MD5', 'md5'])
Gregory P. Smith12c9d022011-05-14 15:15:49 -0700271
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000272 def test_hexdigest(self):
Christian Heimes65aa5732013-07-30 15:33:30 +0200273 for cons in self.hash_constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200274 h = cons(usedforsecurity=False)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200275 if h.name in self.shakes:
276 self.assertIsInstance(h.digest(16), bytes)
277 self.assertEqual(hexstr(h.digest(16)), h.hexdigest(16))
278 else:
279 self.assertIsInstance(h.digest(), bytes)
280 self.assertEqual(hexstr(h.digest()), h.hexdigest())
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000281
Serhiy Storchaka9b8c2e72018-10-11 07:41:00 +0300282 def test_digest_length_overflow(self):
283 # See issue #34922
284 large_sizes = (2**29, 2**32-10, 2**32+10, 2**61, 2**64-10, 2**64+10)
285 for cons in self.hash_constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200286 h = cons(usedforsecurity=False)
Serhiy Storchaka9b8c2e72018-10-11 07:41:00 +0300287 if h.name not in self.shakes:
288 continue
Christian Heimesd5b3f6b2020-05-16 22:27:06 +0200289 if HASH is not None and isinstance(h, HASH):
290 # _hashopenssl's take a size_t
291 continue
Serhiy Storchaka9b8c2e72018-10-11 07:41:00 +0300292 for digest in h.digest, h.hexdigest:
293 self.assertRaises(ValueError, digest, -10)
294 for length in large_sizes:
295 with self.assertRaises((ValueError, OverflowError)):
296 digest(length)
297
Jason R. Coombsb2aa6f42013-08-03 11:39:39 +0200298 def test_name_attribute(self):
299 for cons in self.hash_constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200300 h = cons(usedforsecurity=False)
Gregory P. Smith914061a2013-08-05 13:14:37 -0700301 self.assertIsInstance(h.name, str)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200302 if h.name in self.supported_hash_names:
303 self.assertIn(h.name, self.supported_hash_names)
304 else:
305 self.assertNotIn(h.name, self.supported_hash_names)
Christian Heimes909b5712020-05-22 20:04:33 +0200306 self.assertEqual(
307 h.name,
308 hashlib.new(h.name, usedforsecurity=False).name
309 )
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000310
311 def test_large_update(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000312 aas = b'a' * 128
313 bees = b'b' * 127
314 cees = b'c' * 126
Christian Heimes65aa5732013-07-30 15:33:30 +0200315 dees = b'd' * 2048 # HASHLIB_GIL_MINSIZE
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000316
Christian Heimes65aa5732013-07-30 15:33:30 +0200317 for cons in self.hash_constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200318 m1 = cons(usedforsecurity=False)
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000319 m1.update(aas)
320 m1.update(bees)
321 m1.update(cees)
Christian Heimes65aa5732013-07-30 15:33:30 +0200322 m1.update(dees)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200323 if m1.name in self.shakes:
324 args = (16,)
325 else:
326 args = ()
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000327
Christian Heimes909b5712020-05-22 20:04:33 +0200328 m2 = cons(usedforsecurity=False)
Christian Heimes65aa5732013-07-30 15:33:30 +0200329 m2.update(aas + bees + cees + dees)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200330 self.assertEqual(m1.digest(*args), m2.digest(*args))
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000331
Christian Heimes909b5712020-05-22 20:04:33 +0200332 m3 = cons(aas + bees + cees + dees, usedforsecurity=False)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200333 self.assertEqual(m1.digest(*args), m3.digest(*args))
Christian Heimes65aa5732013-07-30 15:33:30 +0200334
335 # verify copy() doesn't touch original
Christian Heimes909b5712020-05-22 20:04:33 +0200336 m4 = cons(aas + bees + cees, usedforsecurity=False)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200337 m4_digest = m4.digest(*args)
Christian Heimes65aa5732013-07-30 15:33:30 +0200338 m4_copy = m4.copy()
339 m4_copy.update(dees)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200340 self.assertEqual(m1.digest(*args), m4_copy.digest(*args))
341 self.assertEqual(m4.digest(*args), m4_digest)
Christian Heimes65aa5732013-07-30 15:33:30 +0200342
Christian Heimes6fe2a752016-09-07 11:58:24 +0200343 def check(self, name, data, hexdigest, shake=False, **kwargs):
344 length = len(hexdigest)//2
Christian Heimes65aa5732013-07-30 15:33:30 +0200345 hexdigest = hexdigest.lower()
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000346 constructors = self.constructors_to_test[name]
347 # 2 is for hashlib.name(...) and hashlib.new(name, ...)
348 self.assertGreaterEqual(len(constructors), 2)
349 for hash_object_constructor in constructors:
Christian Heimes121b9482016-09-06 22:03:25 +0200350 m = hash_object_constructor(data, **kwargs)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200351 computed = m.hexdigest() if not shake else m.hexdigest(length)
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000352 self.assertEqual(
Christian Heimes65aa5732013-07-30 15:33:30 +0200353 computed, hexdigest,
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000354 "Hash algorithm %s constructed using %s returned hexdigest"
355 " %r for %d byte input data that should have hashed to %r."
356 % (name, hash_object_constructor,
Christian Heimes65aa5732013-07-30 15:33:30 +0200357 computed, len(data), hexdigest))
Christian Heimes6fe2a752016-09-07 11:58:24 +0200358 computed = m.digest() if not shake else m.digest(length)
Christian Heimes65aa5732013-07-30 15:33:30 +0200359 digest = bytes.fromhex(hexdigest)
360 self.assertEqual(computed, digest)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200361 if not shake:
362 self.assertEqual(len(digest), m.digest_size)
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000363
Gregory P. Smith365a1862009-02-12 07:35:29 +0000364 def check_no_unicode(self, algorithm_name):
365 # Unicode objects are not allowed as input.
Gregory P. Smithcd54e542010-01-03 00:29:15 +0000366 constructors = self.constructors_to_test[algorithm_name]
367 for hash_object_constructor in constructors:
368 self.assertRaises(TypeError, hash_object_constructor, 'spam')
Gregory P. Smith365a1862009-02-12 07:35:29 +0000369
370 def test_no_unicode(self):
371 self.check_no_unicode('md5')
372 self.check_no_unicode('sha1')
373 self.check_no_unicode('sha224')
374 self.check_no_unicode('sha256')
375 self.check_no_unicode('sha384')
376 self.check_no_unicode('sha512')
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000377
Christian Heimes121b9482016-09-06 22:03:25 +0200378 @requires_blake2
379 def test_no_unicode_blake2(self):
380 self.check_no_unicode('blake2b')
381 self.check_no_unicode('blake2s')
382
Christian Heimes6fe2a752016-09-07 11:58:24 +0200383 @requires_sha3
384 def test_no_unicode_sha3(self):
385 self.check_no_unicode('sha3_224')
386 self.check_no_unicode('sha3_256')
387 self.check_no_unicode('sha3_384')
388 self.check_no_unicode('sha3_512')
389 self.check_no_unicode('shake_128')
390 self.check_no_unicode('shake_256')
391
392 def check_blocksize_name(self, name, block_size=0, digest_size=0,
393 digest_length=None):
Christian Heimes65aa5732013-07-30 15:33:30 +0200394 constructors = self.constructors_to_test[name]
395 for hash_object_constructor in constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200396 m = hash_object_constructor(usedforsecurity=False)
Christian Heimes65aa5732013-07-30 15:33:30 +0200397 self.assertEqual(m.block_size, block_size)
398 self.assertEqual(m.digest_size, digest_size)
Christian Heimes6fe2a752016-09-07 11:58:24 +0200399 if digest_length:
400 self.assertEqual(len(m.digest(digest_length)),
401 digest_length)
402 self.assertEqual(len(m.hexdigest(digest_length)),
403 2*digest_length)
404 else:
405 self.assertEqual(len(m.digest()), digest_size)
406 self.assertEqual(len(m.hexdigest()), 2*digest_size)
Christian Heimes37d5ceb2013-08-15 18:31:48 +0200407 self.assertEqual(m.name, name)
Christian Heimesd49a3712013-07-30 15:35:54 +0200408 # split for sha3_512 / _sha3.sha3 object
Christian Heimes37d5ceb2013-08-15 18:31:48 +0200409 self.assertIn(name.split("_")[0], repr(m))
Christian Heimes65aa5732013-07-30 15:33:30 +0200410
411 def test_blocksize_name(self):
412 self.check_blocksize_name('md5', 64, 16)
413 self.check_blocksize_name('sha1', 64, 20)
414 self.check_blocksize_name('sha224', 64, 28)
415 self.check_blocksize_name('sha256', 64, 32)
416 self.check_blocksize_name('sha384', 128, 48)
417 self.check_blocksize_name('sha512', 128, 64)
Christian Heimese3704092016-09-23 11:32:30 +0200418
419 @requires_sha3
420 def test_blocksize_name_sha3(self):
Christian Heimes6fe2a752016-09-07 11:58:24 +0200421 self.check_blocksize_name('sha3_224', 144, 28)
422 self.check_blocksize_name('sha3_256', 136, 32)
423 self.check_blocksize_name('sha3_384', 104, 48)
424 self.check_blocksize_name('sha3_512', 72, 64)
425 self.check_blocksize_name('shake_128', 168, 0, 32)
426 self.check_blocksize_name('shake_256', 136, 0, 64)
Christian Heimes65aa5732013-07-30 15:33:30 +0200427
Christian Heimese3704092016-09-23 11:32:30 +0200428 def check_sha3(self, name, capacity, rate, suffix):
429 constructors = self.constructors_to_test[name]
430 for hash_object_constructor in constructors:
431 m = hash_object_constructor()
Christian Heimes995b5d32019-09-13 15:31:19 +0200432 if HASH is not None and isinstance(m, HASH):
433 # _hashopenssl's variant does not have extra SHA3 attributes
434 continue
Christian Heimese3704092016-09-23 11:32:30 +0200435 self.assertEqual(capacity + rate, 1600)
436 self.assertEqual(m._capacity_bits, capacity)
437 self.assertEqual(m._rate_bits, rate)
438 self.assertEqual(m._suffix, suffix)
439
440 @requires_sha3
441 def test_extra_sha3(self):
442 self.check_sha3('sha3_224', 448, 1152, b'\x06')
443 self.check_sha3('sha3_256', 512, 1088, b'\x06')
444 self.check_sha3('sha3_384', 768, 832, b'\x06')
445 self.check_sha3('sha3_512', 1024, 576, b'\x06')
446 self.check_sha3('shake_128', 256, 1344, b'\x1f')
447 self.check_sha3('shake_256', 512, 1088, b'\x1f')
448
Christian Heimes121b9482016-09-06 22:03:25 +0200449 @requires_blake2
450 def test_blocksize_name_blake2(self):
451 self.check_blocksize_name('blake2b', 128, 64)
452 self.check_blocksize_name('blake2s', 64, 32)
453
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000454 def test_case_md5_0(self):
Christian Heimes909b5712020-05-22 20:04:33 +0200455 self.check(
456 'md5', b'', 'd41d8cd98f00b204e9800998ecf8427e',
457 usedforsecurity=False
458 )
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000459
460 def test_case_md5_1(self):
Christian Heimes909b5712020-05-22 20:04:33 +0200461 self.check(
462 'md5', b'abc', '900150983cd24fb0d6963f7d28e17f72',
463 usedforsecurity=False
464 )
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000465
466 def test_case_md5_2(self):
Christian Heimes909b5712020-05-22 20:04:33 +0200467 self.check(
468 'md5',
469 b'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789',
470 'd174ab98d277d9f5a5611c2c9f419d9f',
471 usedforsecurity=False
472 )
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000473
Serhiy Storchaka4847e4e2014-01-10 13:37:54 +0200474 @unittest.skipIf(sys.maxsize < _4G + 5, 'test cannot run on 32-bit systems')
475 @bigmemtest(size=_4G + 5, memuse=1, dry_run=False)
Benjamin Peterson78cb4912008-09-24 22:53:33 +0000476 def test_case_md5_huge(self, size):
Serhiy Storchaka4847e4e2014-01-10 13:37:54 +0200477 self.check('md5', b'A'*size, 'c9af2dff37468ce5dfee8f2cfc0a9c6d')
Benjamin Peterson78cb4912008-09-24 22:53:33 +0000478
Serhiy Storchaka4847e4e2014-01-10 13:37:54 +0200479 @unittest.skipIf(sys.maxsize < _4G - 1, 'test cannot run on 32-bit systems')
480 @bigmemtest(size=_4G - 1, memuse=1, dry_run=False)
Benjamin Peterson78cb4912008-09-24 22:53:33 +0000481 def test_case_md5_uintmax(self, size):
Serhiy Storchaka4847e4e2014-01-10 13:37:54 +0200482 self.check('md5', b'A'*size, '28138d306ff1b8281f1a9067e1a1a2b3')
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000483
484 # use the three examples from Federal Information Processing Standards
485 # Publication 180-1, Secure Hash Standard, 1995 April 17
486 # http://www.itl.nist.gov/div897/pubs/fip180-1.htm
487
488 def test_case_sha1_0(self):
Guido van Rossum5ed033b2007-07-09 14:29:40 +0000489 self.check('sha1', b"",
Guido van Rossum558ca842007-07-10 20:31:05 +0000490 "da39a3ee5e6b4b0d3255bfef95601890afd80709")
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000491
492 def test_case_sha1_1(self):
Guido van Rossum5ed033b2007-07-09 14:29:40 +0000493 self.check('sha1', b"abc",
Guido van Rossum558ca842007-07-10 20:31:05 +0000494 "a9993e364706816aba3e25717850c26c9cd0d89d")
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000495
496 def test_case_sha1_2(self):
Guido van Rossum5ed033b2007-07-09 14:29:40 +0000497 self.check('sha1',
498 b"abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq",
Guido van Rossum558ca842007-07-10 20:31:05 +0000499 "84983e441c3bd26ebaae4aa1f95129e5e54670f1")
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000500
501 def test_case_sha1_3(self):
Guido van Rossum5ed033b2007-07-09 14:29:40 +0000502 self.check('sha1', b"a" * 1000000,
Guido van Rossum558ca842007-07-10 20:31:05 +0000503 "34aa973cd4c4daa4f61eeb2bdbad27316534016f")
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000504
505
506 # use the examples from Federal Information Processing Standards
507 # Publication 180-2, Secure Hash Standard, 2002 August 1
508 # http://csrc.nist.gov/publications/fips/fips180-2/fips180-2.pdf
509
510 def test_case_sha224_0(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000511 self.check('sha224', b"",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000512 "d14a028c2a3a2bc9476102bb288234c415a2b01f828ea62ac5b3e42f")
513
514 def test_case_sha224_1(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000515 self.check('sha224', b"abc",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000516 "23097d223405d8228642a477bda255b32aadbce4bda0b3f7e36c9da7")
517
518 def test_case_sha224_2(self):
519 self.check('sha224',
Guido van Rossume22905a2007-08-27 23:09:25 +0000520 b"abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000521 "75388b16512776cc5dba5da1fd890150b0c6455cb4f58b1952522525")
522
523 def test_case_sha224_3(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000524 self.check('sha224', b"a" * 1000000,
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000525 "20794655980c91d8bbb4c1ea97618a4bf03f42581948b2ee4ee7ad67")
526
527
528 def test_case_sha256_0(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000529 self.check('sha256', b"",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000530 "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855")
531
532 def test_case_sha256_1(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000533 self.check('sha256', b"abc",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000534 "ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad")
535
536 def test_case_sha256_2(self):
537 self.check('sha256',
Guido van Rossume22905a2007-08-27 23:09:25 +0000538 b"abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000539 "248d6a61d20638b8e5c026930c3e6039a33ce45964ff2167f6ecedd419db06c1")
540
541 def test_case_sha256_3(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000542 self.check('sha256', b"a" * 1000000,
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000543 "cdc76e5c9914fb9281a1c7e284d73e67f1809a48a497200e046d39ccc7112cd0")
544
545
546 def test_case_sha384_0(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000547 self.check('sha384', b"",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000548 "38b060a751ac96384cd9327eb1b1e36a21fdb71114be07434c0cc7bf63f6e1da"+
549 "274edebfe76f65fbd51ad2f14898b95b")
550
551 def test_case_sha384_1(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000552 self.check('sha384', b"abc",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000553 "cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed"+
554 "8086072ba1e7cc2358baeca134c825a7")
555
556 def test_case_sha384_2(self):
557 self.check('sha384',
Guido van Rossume22905a2007-08-27 23:09:25 +0000558 b"abcdefghbcdefghicdefghijdefghijkefghijklfghijklmghijklmn"+
559 b"hijklmnoijklmnopjklmnopqklmnopqrlmnopqrsmnopqrstnopqrstu",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000560 "09330c33f71147e83d192fc782cd1b4753111b173b3b05d22fa08086e3b0f712"+
561 "fcc7c71a557e2db966c3e9fa91746039")
562
563 def test_case_sha384_3(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000564 self.check('sha384', b"a" * 1000000,
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000565 "9d0e1809716474cb086e834e310a4a1ced149e9c00f248527972cec5704c2a5b"+
566 "07b8b3dc38ecc4ebae97ddd87f3d8985")
567
568
569 def test_case_sha512_0(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000570 self.check('sha512', b"",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000571 "cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce"+
572 "47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e")
573
574 def test_case_sha512_1(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000575 self.check('sha512', b"abc",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000576 "ddaf35a193617abacc417349ae20413112e6fa4e89a97ea20a9eeee64b55d39a"+
577 "2192992a274fc1a836ba3c23a3feebbd454d4423643ce80e2a9ac94fa54ca49f")
578
579 def test_case_sha512_2(self):
580 self.check('sha512',
Guido van Rossume22905a2007-08-27 23:09:25 +0000581 b"abcdefghbcdefghicdefghijdefghijkefghijklfghijklmghijklmn"+
582 b"hijklmnoijklmnopjklmnopqklmnopqrlmnopqrsmnopqrstnopqrstu",
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000583 "8e959b75dae313da8cf4f72814fc143f8f7779c6eb9f7fa17299aeadb6889018"+
584 "501d289e4900f7e4331b99dec4b5433ac7d329eeb6dd26545e96e55b874be909")
585
586 def test_case_sha512_3(self):
Guido van Rossume22905a2007-08-27 23:09:25 +0000587 self.check('sha512', b"a" * 1000000,
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000588 "e718483d0ce769644e2e42c7bc15b4638e1f98b13b2044285632a803afa973eb"+
589 "de0ff244877ea60a4cb0432ce577c31beb009c5c2c49aa2e4eadb217ad8cc09b")
590
Christian Heimes121b9482016-09-06 22:03:25 +0200591 def check_blake2(self, constructor, salt_size, person_size, key_size,
592 digest_size, max_offset):
593 self.assertEqual(constructor.SALT_SIZE, salt_size)
594 for i in range(salt_size + 1):
595 constructor(salt=b'a' * i)
596 salt = b'a' * (salt_size + 1)
597 self.assertRaises(ValueError, constructor, salt=salt)
598
599 self.assertEqual(constructor.PERSON_SIZE, person_size)
600 for i in range(person_size+1):
601 constructor(person=b'a' * i)
602 person = b'a' * (person_size + 1)
603 self.assertRaises(ValueError, constructor, person=person)
604
605 self.assertEqual(constructor.MAX_DIGEST_SIZE, digest_size)
606 for i in range(1, digest_size + 1):
607 constructor(digest_size=i)
608 self.assertRaises(ValueError, constructor, digest_size=-1)
609 self.assertRaises(ValueError, constructor, digest_size=0)
610 self.assertRaises(ValueError, constructor, digest_size=digest_size+1)
611
612 self.assertEqual(constructor.MAX_KEY_SIZE, key_size)
613 for i in range(key_size+1):
614 constructor(key=b'a' * i)
615 key = b'a' * (key_size + 1)
616 self.assertRaises(ValueError, constructor, key=key)
617 self.assertEqual(constructor().hexdigest(),
618 constructor(key=b'').hexdigest())
619
620 for i in range(0, 256):
621 constructor(fanout=i)
622 self.assertRaises(ValueError, constructor, fanout=-1)
623 self.assertRaises(ValueError, constructor, fanout=256)
624
625 for i in range(1, 256):
626 constructor(depth=i)
627 self.assertRaises(ValueError, constructor, depth=-1)
628 self.assertRaises(ValueError, constructor, depth=0)
629 self.assertRaises(ValueError, constructor, depth=256)
630
631 for i in range(0, 256):
632 constructor(node_depth=i)
633 self.assertRaises(ValueError, constructor, node_depth=-1)
634 self.assertRaises(ValueError, constructor, node_depth=256)
635
636 for i in range(0, digest_size + 1):
637 constructor(inner_size=i)
638 self.assertRaises(ValueError, constructor, inner_size=-1)
639 self.assertRaises(ValueError, constructor, inner_size=digest_size+1)
640
641 constructor(leaf_size=0)
642 constructor(leaf_size=(1<<32)-1)
Serhiy Storchaka7cb7bcf2018-07-26 13:22:16 +0300643 self.assertRaises(ValueError, constructor, leaf_size=-1)
Christian Heimes121b9482016-09-06 22:03:25 +0200644 self.assertRaises(OverflowError, constructor, leaf_size=1<<32)
645
646 constructor(node_offset=0)
647 constructor(node_offset=max_offset)
Serhiy Storchaka7cb7bcf2018-07-26 13:22:16 +0300648 self.assertRaises(ValueError, constructor, node_offset=-1)
Christian Heimes121b9482016-09-06 22:03:25 +0200649 self.assertRaises(OverflowError, constructor, node_offset=max_offset+1)
650
Serhiy Storchakaf1d36d82018-07-31 09:50:16 +0300651 self.assertRaises(TypeError, constructor, data=b'')
652 self.assertRaises(TypeError, constructor, string=b'')
653 self.assertRaises(TypeError, constructor, '')
654
Christian Heimes121b9482016-09-06 22:03:25 +0200655 constructor(
Serhiy Storchakaf1d36d82018-07-31 09:50:16 +0300656 b'',
Christian Heimes121b9482016-09-06 22:03:25 +0200657 key=b'',
658 salt=b'',
659 person=b'',
660 digest_size=17,
661 fanout=1,
662 depth=1,
663 leaf_size=256,
664 node_offset=512,
665 node_depth=1,
666 inner_size=7,
667 last_node=True
668 )
669
670 def blake2_rfc7693(self, constructor, md_len, in_len):
671 def selftest_seq(length, seed):
672 mask = (1<<32)-1
673 a = (0xDEAD4BAD * seed) & mask
674 b = 1
675 out = bytearray(length)
676 for i in range(length):
677 t = (a + b) & mask
678 a, b = b, t
679 out[i] = (t >> 24) & 0xFF
680 return out
681 outer = constructor(digest_size=32)
682 for outlen in md_len:
683 for inlen in in_len:
684 indata = selftest_seq(inlen, inlen)
685 key = selftest_seq(outlen, outlen)
686 unkeyed = constructor(indata, digest_size=outlen)
687 outer.update(unkeyed.digest())
688 keyed = constructor(indata, key=key, digest_size=outlen)
689 outer.update(keyed.digest())
690 return outer.hexdigest()
691
692 @requires_blake2
693 def test_blake2b(self):
694 self.check_blake2(hashlib.blake2b, 16, 16, 64, 64, (1<<64)-1)
695 b2b_md_len = [20, 32, 48, 64]
696 b2b_in_len = [0, 3, 128, 129, 255, 1024]
697 self.assertEqual(
698 self.blake2_rfc7693(hashlib.blake2b, b2b_md_len, b2b_in_len),
699 "c23a7800d98123bd10f506c61e29da5603d763b8bbad2e737f5e765a7bccd475")
700
701 @requires_blake2
702 def test_case_blake2b_0(self):
703 self.check('blake2b', b"",
704 "786a02f742015903c6c6fd852552d272912f4740e15847618a86e217f71f5419"+
705 "d25e1031afee585313896444934eb04b903a685b1448b755d56f701afe9be2ce")
706
707 @requires_blake2
708 def test_case_blake2b_1(self):
709 self.check('blake2b', b"abc",
710 "ba80a53f981c4d0d6a2797b69f12f6e94c212f14685ac4b74b12bb6fdbffa2d1"+
711 "7d87c5392aab792dc252d5de4533cc9518d38aa8dbf1925ab92386edd4009923")
712
713 @requires_blake2
Jack O'Connordcfb0e32017-11-03 15:02:41 -0400714 def test_case_blake2b_all_parameters(self):
715 # This checks that all the parameters work in general, and also that
716 # parameter byte order doesn't get confused on big endian platforms.
717 self.check('blake2b', b"foo",
718 "920568b0c5873b2f0ab67bedb6cf1b2b",
719 digest_size=16,
720 key=b"bar",
721 salt=b"baz",
722 person=b"bing",
723 fanout=2,
724 depth=3,
725 leaf_size=4,
726 node_offset=5,
727 node_depth=6,
728 inner_size=7,
729 last_node=True)
730
731 @requires_blake2
Christian Heimes121b9482016-09-06 22:03:25 +0200732 def test_blake2b_vectors(self):
733 for msg, key, md in read_vectors('blake2b'):
734 key = bytes.fromhex(key)
735 self.check('blake2b', msg, md, key=key)
736
737 @requires_blake2
738 def test_blake2s(self):
739 self.check_blake2(hashlib.blake2s, 8, 8, 32, 32, (1<<48)-1)
740 b2s_md_len = [16, 20, 28, 32]
741 b2s_in_len = [0, 3, 64, 65, 255, 1024]
742 self.assertEqual(
743 self.blake2_rfc7693(hashlib.blake2s, b2s_md_len, b2s_in_len),
744 "6a411f08ce25adcdfb02aba641451cec53c598b24f4fc787fbdc88797f4c1dfe")
745
746 @requires_blake2
747 def test_case_blake2s_0(self):
748 self.check('blake2s', b"",
749 "69217a3079908094e11121d042354a7c1f55b6482ca1a51e1b250dfd1ed0eef9")
750
751 @requires_blake2
752 def test_case_blake2s_1(self):
753 self.check('blake2s', b"abc",
754 "508c5e8c327c14e2e1a72ba34eeb452f37458b209ed63a294d999b4c86675982")
755
756 @requires_blake2
Jack O'Connordcfb0e32017-11-03 15:02:41 -0400757 def test_case_blake2s_all_parameters(self):
758 # This checks that all the parameters work in general, and also that
759 # parameter byte order doesn't get confused on big endian platforms.
760 self.check('blake2s', b"foo",
761 "bf2a8f7fe3c555012a6f8046e646bc75",
762 digest_size=16,
763 key=b"bar",
764 salt=b"baz",
765 person=b"bing",
766 fanout=2,
767 depth=3,
768 leaf_size=4,
769 node_offset=5,
770 node_depth=6,
771 inner_size=7,
772 last_node=True)
773
774 @requires_blake2
Christian Heimes121b9482016-09-06 22:03:25 +0200775 def test_blake2s_vectors(self):
776 for msg, key, md in read_vectors('blake2s'):
777 key = bytes.fromhex(key)
778 self.check('blake2s', msg, md, key=key)
779
Christian Heimes6fe2a752016-09-07 11:58:24 +0200780 @requires_sha3
781 def test_case_sha3_224_0(self):
782 self.check('sha3_224', b"",
783 "6b4e03423667dbb73b6e15454f0eb1abd4597f9a1b078e3f5b5a6bc7")
784
785 @requires_sha3
786 def test_case_sha3_224_vector(self):
787 for msg, md in read_vectors('sha3_224'):
788 self.check('sha3_224', msg, md)
789
790 @requires_sha3
791 def test_case_sha3_256_0(self):
792 self.check('sha3_256', b"",
793 "a7ffc6f8bf1ed76651c14756a061d662f580ff4de43b49fa82d80a4b80f8434a")
794
795 @requires_sha3
796 def test_case_sha3_256_vector(self):
797 for msg, md in read_vectors('sha3_256'):
798 self.check('sha3_256', msg, md)
799
800 @requires_sha3
801 def test_case_sha3_384_0(self):
802 self.check('sha3_384', b"",
803 "0c63a75b845e4f7d01107d852e4c2485c51a50aaaa94fc61995e71bbee983a2a"+
804 "c3713831264adb47fb6bd1e058d5f004")
805
806 @requires_sha3
807 def test_case_sha3_384_vector(self):
808 for msg, md in read_vectors('sha3_384'):
809 self.check('sha3_384', msg, md)
810
811 @requires_sha3
812 def test_case_sha3_512_0(self):
813 self.check('sha3_512', b"",
814 "a69f73cca23a9ac5c8b567dc185a756e97c982164fe25859e0d1dcc1475c80a6"+
815 "15b2123af1f5f94c11e3e9402c3ac558f500199d95b6d3e301758586281dcd26")
816
817 @requires_sha3
818 def test_case_sha3_512_vector(self):
819 for msg, md in read_vectors('sha3_512'):
820 self.check('sha3_512', msg, md)
821
822 @requires_sha3
823 def test_case_shake_128_0(self):
824 self.check('shake_128', b"",
825 "7f9c2ba4e88f827d616045507605853ed73b8093f6efbc88eb1a6eacfa66ef26",
826 True)
827 self.check('shake_128', b"", "7f9c", True)
828
829 @requires_sha3
830 def test_case_shake128_vector(self):
831 for msg, md in read_vectors('shake_128'):
832 self.check('shake_128', msg, md, True)
833
834 @requires_sha3
835 def test_case_shake_256_0(self):
836 self.check('shake_256', b"",
837 "46b9dd2b0ba88d13233b3feb743eeb243fcd52ea62b81b82b50c27646ed5762f",
838 True)
839 self.check('shake_256', b"", "46b9", True)
840
841 @requires_sha3
842 def test_case_shake256_vector(self):
843 for msg, md in read_vectors('shake_256'):
844 self.check('shake_256', msg, md, True)
845
Antoine Pitroubcd5cbe2009-01-08 21:17:16 +0000846 def test_gil(self):
847 # Check things work fine with an input larger than the size required
848 # for multithreaded operation (which is hardwired to 2048).
849 gil_minsize = 2048
850
Christian Heimes65aa5732013-07-30 15:33:30 +0200851 for cons in self.hash_constructors:
Christian Heimes909b5712020-05-22 20:04:33 +0200852 m = cons(usedforsecurity=False)
Christian Heimes4a0270d2012-10-06 02:23:36 +0200853 m.update(b'1')
854 m.update(b'#' * gil_minsize)
855 m.update(b'1')
856
Christian Heimes909b5712020-05-22 20:04:33 +0200857 m = cons(b'x' * gil_minsize, usedforsecurity=False)
Christian Heimes4a0270d2012-10-06 02:23:36 +0200858 m.update(b'1')
859
Christian Heimes909b5712020-05-22 20:04:33 +0200860 m = hashlib.sha256()
Antoine Pitroubcd5cbe2009-01-08 21:17:16 +0000861 m.update(b'1')
862 m.update(b'#' * gil_minsize)
863 m.update(b'1')
Christian Heimes909b5712020-05-22 20:04:33 +0200864 self.assertEqual(
865 m.hexdigest(),
866 '1cfceca95989f51f658e3f3ffe7f1cd43726c9e088c13ee10b46f57cef135b94'
867 )
Antoine Pitroubcd5cbe2009-01-08 21:17:16 +0000868
Christian Heimes909b5712020-05-22 20:04:33 +0200869 m = hashlib.sha256(b'1' + b'#' * gil_minsize + b'1')
870 self.assertEqual(
871 m.hexdigest(),
872 '1cfceca95989f51f658e3f3ffe7f1cd43726c9e088c13ee10b46f57cef135b94'
873 )
Gregory P. Smithf21a5f72005-08-21 18:45:59 +0000874
Hai Shie80697d2020-05-28 06:10:27 +0800875 @threading_helper.reap_threads
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000876 def test_threaded_hashing(self):
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000877 # Updating the same hash object from several threads at once
878 # using data chunk sizes containing the same byte sequences.
879 #
880 # If the internal locks are working to prevent multiple
881 # updates on the same object from running at once, the resulting
882 # hash will be the same as doing it single threaded upfront.
883 hasher = hashlib.sha1()
884 num_threads = 5
885 smallest_data = b'swineflu'
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700886 data = smallest_data * 200000
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000887 expected_hash = hashlib.sha1(data*num_threads).hexdigest()
888
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700889 def hash_in_chunks(chunk_size):
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000890 index = 0
891 while index < len(data):
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700892 hasher.update(data[index:index + chunk_size])
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000893 index += chunk_size
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000894
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700895 threads = []
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000896 for threadnum in range(num_threads):
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700897 chunk_size = len(data) // (10 ** threadnum)
Gregory P. Smith914061a2013-08-05 13:14:37 -0700898 self.assertGreater(chunk_size, 0)
899 self.assertEqual(chunk_size % len(smallest_data), 0)
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700900 thread = threading.Thread(target=hash_in_chunks,
901 args=(chunk_size,))
902 threads.append(thread)
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000903
Victor Stinner8dcf22f2017-09-14 08:43:22 -0700904 for thread in threads:
905 thread.start()
906 for thread in threads:
907 thread.join()
Gregory P. Smith3f61d612009-05-04 00:45:33 +0000908
909 self.assertEqual(expected_hash, hasher.hexdigest())
910
Victor Stinnere3dfb9b2020-04-29 18:04:22 +0200911 def test_get_fips_mode(self):
Christian Heimes909b5712020-05-22 20:04:33 +0200912 fips_mode = self.is_fips_mode
913 if fips_mode is not None:
914 self.assertIsInstance(fips_mode, int)
Victor Stinnere3dfb9b2020-04-29 18:04:22 +0200915
Christian Heimesd5b3f6b2020-05-16 22:27:06 +0200916 @unittest.skipUnless(HASH is not None, 'need _hashlib')
917 def test_internal_types(self):
918 # internal types like _hashlib.HASH are not constructable
919 with self.assertRaisesRegex(
920 TypeError, "cannot create 'HASH' instance"
921 ):
922 HASH()
923 with self.assertRaisesRegex(
924 TypeError, "cannot create 'HASHXOF' instance"
925 ):
926 HASHXOF()
927
Christian Heimes3626a502013-10-19 14:12:02 +0200928
Christian Heimes0fbd94c2013-10-19 19:40:49 +0200929class KDFTests(unittest.TestCase):
Christian Heimes3626a502013-10-19 14:12:02 +0200930
Christian Heimese92ef132013-10-13 00:52:43 +0200931 pbkdf2_test_vectors = [
932 (b'password', b'salt', 1, None),
933 (b'password', b'salt', 2, None),
934 (b'password', b'salt', 4096, None),
935 # too slow, it takes over a minute on a fast CPU.
936 #(b'password', b'salt', 16777216, None),
937 (b'passwordPASSWORDpassword', b'saltSALTsaltSALTsaltSALTsaltSALTsalt',
938 4096, -1),
939 (b'pass\0word', b'sa\0lt', 4096, 16),
940 ]
941
Christian Heimes39093e92016-09-06 20:22:28 +0200942 scrypt_test_vectors = [
943 (b'', b'', 16, 1, 1, unhexlify('77d6576238657b203b19ca42c18a0497f16b4844e3074ae8dfdffa3fede21442fcd0069ded0948f8326a753a0fc81f17e8d3e0fb2e0d3628cf35e20c38d18906')),
944 (b'password', b'NaCl', 1024, 8, 16, unhexlify('fdbabe1c9d3472007856e7190d01e9fe7c6ad7cbc8237830e77376634b3731622eaf30d92e22a3886ff109279d9830dac727afb94a83ee6d8360cbdfa2cc0640')),
945 (b'pleaseletmein', b'SodiumChloride', 16384, 8, 1, unhexlify('7023bdcb3afd7348461c06cd81fd38ebfda8fbba904f8e3ea9b543f6545da1f2d5432955613f0fcf62d49705242a9af9e61e85dc0d651e40dfcf017b45575887')),
946 ]
947
Christian Heimese92ef132013-10-13 00:52:43 +0200948 pbkdf2_results = {
949 "sha1": [
Martin Panter46f50722016-05-26 05:35:26 +0000950 # official test vectors from RFC 6070
Christian Heimese92ef132013-10-13 00:52:43 +0200951 (bytes.fromhex('0c60c80f961f0e71f3a9b524af6012062fe037a6'), None),
952 (bytes.fromhex('ea6c014dc72d6f8ccd1ed92ace1d41f0d8de8957'), None),
953 (bytes.fromhex('4b007901b765489abead49d926f721d065a429c1'), None),
954 #(bytes.fromhex('eefe3d61cd4da4e4e9945b3d6ba2158c2634e984'), None),
955 (bytes.fromhex('3d2eec4fe41c849b80c8d83662c0e44a8b291a964c'
956 'f2f07038'), 25),
957 (bytes.fromhex('56fa6aa75548099dcc37d7f03425e0c3'), None),],
958 "sha256": [
959 (bytes.fromhex('120fb6cffcf8b32c43e7225256c4f837'
960 'a86548c92ccc35480805987cb70be17b'), None),
961 (bytes.fromhex('ae4d0c95af6b46d32d0adff928f06dd0'
962 '2a303f8ef3c251dfd6e2d85a95474c43'), None),
963 (bytes.fromhex('c5e478d59288c841aa530db6845c4c8d'
964 '962893a001ce4e11a4963873aa98134a'), None),
965 #(bytes.fromhex('cf81c66fe8cfc04d1f31ecb65dab4089'
966 # 'f7f179e89b3b0bcb17ad10e3ac6eba46'), None),
967 (bytes.fromhex('348c89dbcbd32b2f32d814b8116e84cf2b17'
968 '347ebc1800181c4e2a1fb8dd53e1c635518c7dac47e9'), 40),
969 (bytes.fromhex('89b69d0516f829893c696226650a8687'), None),],
970 "sha512": [
971 (bytes.fromhex('867f70cf1ade02cff3752599a3a53dc4af34c7a669815ae5'
972 'd513554e1c8cf252c02d470a285a0501bad999bfe943c08f'
973 '050235d7d68b1da55e63f73b60a57fce'), None),
974 (bytes.fromhex('e1d9c16aa681708a45f5c7c4e215ceb66e011a2e9f004071'
975 '3f18aefdb866d53cf76cab2868a39b9f7840edce4fef5a82'
976 'be67335c77a6068e04112754f27ccf4e'), None),
977 (bytes.fromhex('d197b1b33db0143e018b12f3d1d1479e6cdebdcc97c5c0f8'
978 '7f6902e072f457b5143f30602641b3d55cd335988cb36b84'
979 '376060ecd532e039b742a239434af2d5'), None),
980 (bytes.fromhex('8c0511f4c6e597c6ac6315d8f0362e225f3c501495ba23b8'
981 '68c005174dc4ee71115b59f9e60cd9532fa33e0f75aefe30'
982 '225c583a186cd82bd4daea9724a3d3b8'), 64),
983 (bytes.fromhex('9d9e9c4cd21fe4be24d5b8244c759665'), None),],
984 }
985
Christian Heimes909b5712020-05-22 20:04:33 +0200986 def _test_pbkdf2_hmac(self, pbkdf2, supported):
Christian Heimese92ef132013-10-13 00:52:43 +0200987 for digest_name, results in self.pbkdf2_results.items():
Christian Heimes909b5712020-05-22 20:04:33 +0200988 if digest_name not in supported:
989 continue
Christian Heimese92ef132013-10-13 00:52:43 +0200990 for i, vector in enumerate(self.pbkdf2_test_vectors):
991 password, salt, rounds, dklen = vector
992 expected, overwrite_dklen = results[i]
993 if overwrite_dklen:
994 dklen = overwrite_dklen
995 out = pbkdf2(digest_name, password, salt, rounds, dklen)
996 self.assertEqual(out, expected,
997 (digest_name, password, salt, rounds, dklen))
998 out = pbkdf2(digest_name, memoryview(password),
999 memoryview(salt), rounds, dklen)
Christian Heimes909b5712020-05-22 20:04:33 +02001000 self.assertEqual(out, expected)
Christian Heimese92ef132013-10-13 00:52:43 +02001001 out = pbkdf2(digest_name, bytearray(password),
1002 bytearray(salt), rounds, dklen)
1003 self.assertEqual(out, expected)
1004 if dklen is None:
1005 out = pbkdf2(digest_name, password, salt, rounds)
1006 self.assertEqual(out, expected,
1007 (digest_name, password, salt, rounds))
1008
Christian Heimese92ef132013-10-13 00:52:43 +02001009 with self.assertRaisesRegex(ValueError, 'unsupported hash type'):
1010 pbkdf2('unknown', b'pass', b'salt', 1)
Christian Heimesbe630192020-05-26 12:26:29 +02001011
1012 if 'sha1' in supported:
1013 self.assertRaises(
1014 TypeError, pbkdf2, b'sha1', b'pass', b'salt', 1
1015 )
1016 self.assertRaises(
1017 TypeError, pbkdf2, 'sha1', 'pass', 'salt', 1
1018 )
1019 self.assertRaises(
1020 ValueError, pbkdf2, 'sha1', b'pass', b'salt', 0
1021 )
1022 self.assertRaises(
1023 ValueError, pbkdf2, 'sha1', b'pass', b'salt', -1
1024 )
1025 self.assertRaises(
1026 ValueError, pbkdf2, 'sha1', b'pass', b'salt', 1, 0
1027 )
1028 self.assertRaises(
1029 ValueError, pbkdf2, 'sha1', b'pass', b'salt', 1, -1
1030 )
1031 out = pbkdf2(hash_name='sha1', password=b'password', salt=b'salt',
1032 iterations=1, dklen=None)
1033 self.assertEqual(out, self.pbkdf2_results['sha1'][0][0])
Christian Heimese92ef132013-10-13 00:52:43 +02001034
Christian Heimes0fbd94c2013-10-19 19:40:49 +02001035 def test_pbkdf2_hmac_py(self):
Christian Heimes909b5712020-05-22 20:04:33 +02001036 self._test_pbkdf2_hmac(py_hashlib.pbkdf2_hmac, builtin_hashes)
Gregory P. Smithf21a5f72005-08-21 18:45:59 +00001037
Christian Heimes0fbd94c2013-10-19 19:40:49 +02001038 @unittest.skipUnless(hasattr(c_hashlib, 'pbkdf2_hmac'),
1039 ' test requires OpenSSL > 1.0')
1040 def test_pbkdf2_hmac_c(self):
Christian Heimes909b5712020-05-22 20:04:33 +02001041 self._test_pbkdf2_hmac(c_hashlib.pbkdf2_hmac, openssl_md_meth_names)
Christian Heimes3626a502013-10-19 14:12:02 +02001042
1043
Christian Heimes39093e92016-09-06 20:22:28 +02001044 @unittest.skipUnless(hasattr(c_hashlib, 'scrypt'),
1045 ' test requires OpenSSL > 1.1')
1046 def test_scrypt(self):
1047 for password, salt, n, r, p, expected in self.scrypt_test_vectors:
1048 result = hashlib.scrypt(password, salt=salt, n=n, r=r, p=p)
1049 self.assertEqual(result, expected)
1050
1051 # this values should work
1052 hashlib.scrypt(b'password', salt=b'salt', n=2, r=8, p=1)
1053 # password and salt must be bytes-like
1054 with self.assertRaises(TypeError):
1055 hashlib.scrypt('password', salt=b'salt', n=2, r=8, p=1)
1056 with self.assertRaises(TypeError):
1057 hashlib.scrypt(b'password', salt='salt', n=2, r=8, p=1)
1058 # require keyword args
1059 with self.assertRaises(TypeError):
1060 hashlib.scrypt(b'password')
1061 with self.assertRaises(TypeError):
1062 hashlib.scrypt(b'password', b'salt')
1063 with self.assertRaises(TypeError):
1064 hashlib.scrypt(b'password', 2, 8, 1, salt=b'salt')
1065 for n in [-1, 0, 1, None]:
1066 with self.assertRaises((ValueError, OverflowError, TypeError)):
1067 hashlib.scrypt(b'password', salt=b'salt', n=n, r=8, p=1)
1068 for r in [-1, 0, None]:
1069 with self.assertRaises((ValueError, OverflowError, TypeError)):
1070 hashlib.scrypt(b'password', salt=b'salt', n=2, r=r, p=1)
1071 for p in [-1, 0, None]:
1072 with self.assertRaises((ValueError, OverflowError, TypeError)):
1073 hashlib.scrypt(b'password', salt=b'salt', n=2, r=8, p=p)
1074 for maxmem in [-1, None]:
1075 with self.assertRaises((ValueError, OverflowError, TypeError)):
1076 hashlib.scrypt(b'password', salt=b'salt', n=2, r=8, p=1,
1077 maxmem=maxmem)
1078 for dklen in [-1, None]:
1079 with self.assertRaises((ValueError, OverflowError, TypeError)):
1080 hashlib.scrypt(b'password', salt=b'salt', n=2, r=8, p=1,
1081 dklen=dklen)
1082
Christian Heimes995b5d32019-09-13 15:31:19 +02001083 def test_normalized_name(self):
1084 self.assertNotIn("blake2b512", hashlib.algorithms_available)
1085 self.assertNotIn("sha3-512", hashlib.algorithms_available)
1086
Christian Heimes39093e92016-09-06 20:22:28 +02001087
Gregory P. Smithf21a5f72005-08-21 18:45:59 +00001088if __name__ == "__main__":
Brett Cannon3e9a9ae2013-06-12 21:25:59 -04001089 unittest.main()