blob: ca86ab77a726aed46429f98d5b25c762f96626f4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
/*
* S2K
* (C) 1999-2007 Jack Lloyd
*
* Distributed under the terms of the Botan license
*/
#ifndef BOTAN_S2K_H__
#define BOTAN_S2K_H__
#include <botan/symkey.h>
#include <botan/rng.h>
namespace Botan {
/*
* S2K Interface
*/
class BOTAN_DLL S2K
{
public:
/**
* Create a copy of this object.
* @return an auto_ptr to a copy of this object
*/
virtual S2K* clone() const = 0;
/**
* Get the algorithm name.
* @return the name of this S2K algorithm
*/
virtual std::string name() const = 0;
/**
* Clear this objects internal values.
*/
virtual void clear() {}
/**
* Derive a key from a passphrase with this S2K object. It will use
* the salt value and number of iterations configured in this object.
* @param key_len the desired length of the key to produce
* @param passphrase the password to derive the key from
*/
OctetString derive_key(u32bit key_len,
const std::string& passphrase) const;
/**
* Set the number of iterations for the one-way function during
* key generation.
* @param n the desired number of iterations
*/
void set_iterations(u32bit n);
/**
* Set a new salt value.
* @param new_salt a byte array defining the new salt value
* @param len the length of the above byte array
*/
void change_salt(const byte new_salt[], u32bit len);
/**
* Set a new salt value.
* @param new_salt the new salt value
*/
void change_salt(const MemoryRegion<byte>& new_salt);
/**
* Create a new random salt value using the rng
* @param rng the random number generator to use
* @param len the desired length of the new salt value
*/
void new_random_salt(RandomNumberGenerator& rng, u32bit len);
/**
* Get the number of iterations for the key derivation currently
* configured in this S2K object.
* @return the current number of iterations
*/
u32bit iterations() const { return iter; }
/**
* Get the currently configured salt value of this S2K object.
* @return the current salt value
*/
SecureVector<byte> current_salt() const { return salt; }
S2K() { iter = 0; }
virtual ~S2K() {}
S2K(const S2K&) = delete;
S2K& operator=(const S2K&) = delete;
private:
virtual OctetString derive(u32bit, const std::string&,
const byte[], u32bit, u32bit) const = 0;
SecureVector<byte> salt;
u32bit iter;
};
}
#endif
|
