6 use hash
::MessageDigest
;
10 #[derive(Clone, Eq, PartialEq, Hash, Debug)]
11 pub struct KeyIvPair
{
13 pub iv
: Option
<Vec
<u8>>,
16 /// Derives a key and an IV from various parameters.
18 /// If specified, `salt` must be 8 bytes in length.
20 /// If the total key and IV length is less than 16 bytes and MD5 is used then
21 /// the algorithm is compatible with the key derivation algorithm from PKCS#5
22 /// v1.5 or PBKDF1 from PKCS#5 v2.0.
24 /// New applications should not use this and instead use
25 /// `pbkdf2_hmac` or another more modern key derivation algorithm.
28 digest
: MessageDigest
,
32 ) -> Result
<KeyIvPair
, ErrorStack
> {
34 assert
!(data
.len() <= c_int
::max_value() as usize);
35 let salt_ptr
= match salt
{
37 assert_eq
!(salt
.len(), ffi
::PKCS5_SALT_LEN
as usize);
45 let mut iv
= cipher
.iv_len().map(|l
| vec
![0; l
]);
47 let cipher
= cipher
.as_ptr();
48 let digest
= digest
.as_ptr();
50 let len
= cvt(ffi
::EVP_BytesToKey(
61 let mut key
= vec
![0; len
as usize];
62 let iv_ptr
= iv
.as_mut()
63 .map(|v
| v
.as_mut_ptr())
64 .unwrap_or(ptr
::null_mut());
66 cvt(ffi
::EVP_BytesToKey(
77 Ok(KeyIvPair { key: key, iv: iv }
)
81 /// Derives a key from a password and salt using the PBKDF2-HMAC algorithm with a digest function.
88 ) -> Result
<(), ErrorStack
> {
90 assert
!(pass
.len() <= c_int
::max_value() as usize);
91 assert
!(salt
.len() <= c_int
::max_value() as usize);
92 assert
!(key
.len() <= c_int
::max_value() as usize);
95 cvt(ffi
::PKCS5_PBKDF2_HMAC(
96 pass
.as_ptr() as *const _
,
108 /// Derives a key from a password and salt using the scrypt algorithm.
110 /// Requires OpenSSL 1.1.0 or newer.
120 ) -> Result
<(), ErrorStack
> {
123 cvt(ffi
::EVP_PBE_scrypt(
124 pass
.as_ptr() as *const _
,
126 salt
.as_ptr() as *const _
,
132 key
.as_mut_ptr() as *mut _
,
140 use hash
::MessageDigest
;
144 // https://git.lysator.liu.se/nettle/nettle/blob/nettle_3.1.1_release_20150424/testsuite/pbkdf2-test.c
146 fn pbkdf2_hmac_sha256() {
147 let mut buf
= [0; 16];
149 super::pbkdf2_hmac(b
"passwd", b
"salt", 1, MessageDigest
::sha256(), &mut buf
).unwrap();
153 0x55_u8, 0xac_u8, 0x04_u8, 0x6e_u8, 0x56_u8, 0xe3_u8, 0x08_u8, 0x9f_u8, 0xec_u8,
154 0x16_u8, 0x91_u8, 0xc2_u8, 0x25_u8, 0x44_u8, 0xb6_u8, 0x05_u8,
162 MessageDigest
::sha256(),
168 0x4d_u8, 0xdc_u8, 0xd8_u8, 0xf6_u8, 0x0b_u8, 0x98_u8, 0xbe_u8, 0x21_u8, 0x83_u8,
169 0x0c_u8, 0xee_u8, 0x5e_u8, 0xf2_u8, 0x27_u8, 0x01_u8, 0xf9_u8,
175 // https://git.lysator.liu.se/nettle/nettle/blob/nettle_3.1.1_release_20150424/testsuite/pbkdf2-test.c
177 fn pbkdf2_hmac_sha512() {
178 let mut buf
= [0; 64];
180 super::pbkdf2_hmac(b
"password", b
"NaCL", 1, MessageDigest
::sha512(), &mut buf
).unwrap();
184 0x73_u8, 0xde_u8, 0xcf_u8, 0xa5_u8, 0x8a_u8, 0xa2_u8, 0xe8_u8, 0x4f_u8, 0x94_u8,
185 0x77_u8, 0x1a_u8, 0x75_u8, 0x73_u8, 0x6b_u8, 0xb8_u8, 0x8b_u8, 0xd3_u8, 0xc7_u8,
186 0xb3_u8, 0x82_u8, 0x70_u8, 0xcf_u8, 0xb5_u8, 0x0c_u8, 0xb3_u8, 0x90_u8, 0xed_u8,
187 0x78_u8, 0xb3_u8, 0x05_u8, 0x65_u8, 0x6a_u8, 0xf8_u8, 0x14_u8, 0x8e_u8, 0x52_u8,
188 0x45_u8, 0x2b_u8, 0x22_u8, 0x16_u8, 0xb2_u8, 0xb8_u8, 0x09_u8, 0x8b_u8, 0x76_u8,
189 0x1f_u8, 0xc6_u8, 0x33_u8, 0x60_u8, 0x60_u8, 0xa0_u8, 0x9f_u8, 0x76_u8, 0x41_u8,
190 0x5e_u8, 0x9f_u8, 0x71_u8, 0xea_u8, 0x47_u8, 0xf9_u8, 0xe9_u8, 0x06_u8, 0x43_u8,
199 MessageDigest
::sha512(),
205 0x71_u8, 0xa0_u8, 0xec_u8, 0x84_u8, 0x2a_u8, 0xbd_u8, 0x5c_u8, 0x67_u8, 0x8b_u8,
206 0xcf_u8, 0xd1_u8, 0x45_u8, 0xf0_u8, 0x9d_u8, 0x83_u8, 0x52_u8, 0x2f_u8, 0x93_u8,
207 0x36_u8, 0x15_u8, 0x60_u8, 0x56_u8, 0x3c_u8, 0x4d_u8, 0x0d_u8, 0x63_u8, 0xb8_u8,
208 0x83_u8, 0x29_u8, 0x87_u8, 0x10_u8, 0x90_u8, 0xe7_u8, 0x66_u8, 0x04_u8, 0xa4_u8,
209 0x9a_u8, 0xf0_u8, 0x8f_u8, 0xe7_u8, 0xc9_u8, 0xf5_u8, 0x71_u8, 0x56_u8, 0xc8_u8,
210 0x79_u8, 0x09_u8, 0x96_u8, 0xb2_u8, 0x0f_u8, 0x06_u8, 0xbc_u8, 0x53_u8, 0x5e_u8,
211 0x5a_u8, 0xb5_u8, 0x44_u8, 0x0d_u8, 0xf7_u8, 0xe8_u8, 0x78_u8, 0x29_u8, 0x6f_u8,
217 b
"passwordPASSWORDpassword",
220 MessageDigest
::sha512(),
226 0x01_u8, 0x68_u8, 0x71_u8, 0xa4_u8, 0xc4_u8, 0xb7_u8, 0x5f_u8, 0x96_u8, 0x85_u8,
227 0x7f_u8, 0xd2_u8, 0xb9_u8, 0xf8_u8, 0xca_u8, 0x28_u8, 0x02_u8, 0x3b_u8, 0x30_u8,
228 0xee_u8, 0x2a_u8, 0x39_u8, 0xf5_u8, 0xad_u8, 0xca_u8, 0xc8_u8, 0xc9_u8, 0x37_u8,
229 0x5f_u8, 0x9b_u8, 0xda_u8, 0x1c_u8, 0xcd_u8, 0x1b_u8, 0x6f_u8, 0x0b_u8, 0x2f_u8,
230 0xc3_u8, 0xad_u8, 0xda_u8, 0x50_u8, 0x54_u8, 0x12_u8, 0xe7_u8, 0x9d_u8, 0x89_u8,
231 0x00_u8, 0x56_u8, 0xc6_u8, 0x2e_u8, 0x52_u8, 0x4c_u8, 0x7d_u8, 0x51_u8, 0x15_u8,
232 0x4b_u8, 0x1a_u8, 0x85_u8, 0x34_u8, 0x57_u8, 0x5b_u8, 0xd0_u8, 0x2d_u8, 0xee_u8,
240 let salt
= [16_u8, 34_u8, 19_u8, 23_u8, 141_u8, 4_u8, 207_u8, 221_u8];
243 143_u8, 210_u8, 75_u8, 63_u8, 214_u8, 179_u8, 155_u8, 241_u8, 242_u8, 31_u8, 154_u8,
244 56_u8, 198_u8, 145_u8, 192_u8, 64_u8, 2_u8, 245_u8, 167_u8, 220_u8, 55_u8, 119_u8,
245 233_u8, 136_u8, 139_u8, 27_u8, 71_u8, 242_u8, 119_u8, 175_u8, 65_u8, 207_u8,
248 let expected_key
= vec
![
249 249_u8, 115_u8, 114_u8, 97_u8, 32_u8, 213_u8, 165_u8, 146_u8, 58_u8, 87_u8, 234_u8,
250 3_u8, 43_u8, 250_u8, 97_u8, 114_u8, 26_u8, 98_u8, 245_u8, 246_u8, 238_u8, 177_u8,
251 229_u8, 161_u8, 183_u8, 224_u8, 174_u8, 3_u8, 6_u8, 244_u8, 236_u8, 255_u8,
253 let expected_iv
= vec
![
254 4_u8, 223_u8, 153_u8, 219_u8, 28_u8, 142_u8, 234_u8, 68_u8, 227_u8, 69_u8, 98_u8,
255 107_u8, 208_u8, 14_u8, 236_u8, 60_u8,
260 Cipher
::aes_256_cbc(),
261 MessageDigest
::sha1(),
268 iv
: Some(expected_iv
),
278 let pass
= "pleaseletmein";
279 let salt
= "SodiumChloride";
281 "7023bdcb3afd7348461c06cd81fd38ebfda8fbba904f8e3ea9b543f6545da1f2d5432955613\
282 f0fcf62d49705242a9af9e61e85dc0d651e40dfcf017b45575887";
284 let mut actual
= [0; 64];
294 assert_eq
!(hex
::encode(&actual
[..]), expected
);