Botan  2.4.0
Crypto and TLS for C++11
gost_28147.h
Go to the documentation of this file.
1 /*
2 * GOST 28147-89
3 * (C) 1999-2009 Jack Lloyd
4 *
5 * Botan is released under the Simplified BSD License (see license.txt)
6 */
7 
8 #ifndef BOTAN_GOST_28147_89_H_
9 #define BOTAN_GOST_28147_89_H_
10 
11 #include <botan/block_cipher.h>
12 
13 namespace Botan {
14 
15 /**
16 * The GOST 28147-89 block cipher uses a set of 4 bit Sboxes, however
17 * the standard does not actually define these Sboxes; they are
18 * considered a local configuration issue. Several different sets are
19 * used.
20 */
22  {
23  public:
24  /**
25  * @param row the row
26  * @param col the column
27  * @return sbox entry at this row/column
28  */
29  uint8_t sbox_entry(size_t row, size_t col) const;
30 
31  /**
32  * @return name of this parameter set
33  */
34  std::string param_name() const { return m_name; }
35 
36  /**
37  * Return a representation used for building larger tables
38  * For internal use
39  */
40  uint8_t sbox_pair(size_t row, size_t col) const;
41 
42  /**
43  * Default GOST parameters are the ones given in GOST R 34.11 for
44  * testing purposes; these sboxes are also used by Crypto++, and,
45  * at least according to Wikipedia, the Central Bank of Russian
46  * Federation
47  * @param name of the parameter set
48  */
49  explicit GOST_28147_89_Params(const std::string& name = "R3411_94_TestParam");
50  private:
51  const uint8_t* m_sboxes;
52  std::string m_name;
53  };
54 
55 /**
56 * GOST 28147-89
57 */
59  {
60  public:
61  void encrypt_n(const uint8_t in[], uint8_t out[], size_t blocks) const override;
62  void decrypt_n(const uint8_t in[], uint8_t out[], size_t blocks) const override;
63 
64  void clear() override;
65 
66  std::string name() const override;
67  BlockCipher* clone() const override { return new GOST_28147_89(m_SBOX); }
68 
69  /**
70  * @param params the sbox parameters to use
71  */
72  explicit GOST_28147_89(const GOST_28147_89_Params& params);
73 
74  explicit GOST_28147_89(const std::string& param_name) :
75  GOST_28147_89(GOST_28147_89_Params(param_name)) {}
76  private:
77  explicit GOST_28147_89(const std::vector<uint32_t>& other_SBOX) :
78  m_SBOX(other_SBOX), m_EK(8) {}
79 
80  void key_schedule(const uint8_t[], size_t) override;
81 
82  /*
83  * The sbox is not secret, this is just a larger expansion of it
84  * which we generate at runtime for faster execution
85  */
86  std::vector<uint32_t> m_SBOX;
87 
89  };
90 
91 }
92 
93 #endif
std::string param_name() const
Definition: gost_28147.h:34
#define BOTAN_PUBLIC_API(maj, min)
Definition: compiler.h:27
Definition: alg_id.cpp:13
GOST_28147_89(const std::string &param_name)
Definition: gost_28147.h:74
std::vector< T, secure_allocator< T > > secure_vector
Definition: secmem.h:88
BlockCipher * clone() const override
Definition: gost_28147.h:67