news.texi

   1 @node News
   2 @unnumbered News
   3
   4 @table @strong
   5
   6 @anchor{Release 5.10}
   7 @item 5.10
   8 Added ISO 10126 @code{pygost.gost3413.(un)pad_iso10126} padding support.
   9
  10 @anchor{Release 5.9}
  11 @item 5.9
  12 Fixed @code{wrap.wrap_cryptopro}, that ignored Sbox for key diversification.
  13
  14 @anchor{Release 5.8}
  15 @item 5.8
  16 Added human-readable name of the curve in @code{GOST3410Curve.name}.
  17
  18 @anchor{Release 5.7}
  19 @item 5.7
  20 Fixed MGM ignoring of the set tag size.
  21
  22 @anchor{Release 5.6}
  23 @item 5.6
  24 Fixed lint errors for previous release.
  25
  26 @anchor{Release 5.5}
  27 @item 5.5
  28 More 34.10 curve parameters aliases:
  29 @verbatim
  30 id-tc26-gost-3410-2012-256-paramSetA -> id-tc26-gost-3410-12-256-paramSetA
  31 id-tc26-gost-3410-2012-256-paramSetB -> id-tc26-gost-3410-12-256-paramSetB
  32 id-tc26-gost-3410-2012-256-paramSetC -> id-tc26-gost-3410-12-256-paramSetC
  33 id-tc26-gost-3410-2012-256-paramSetD -> id-tc26-gost-3410-12-256-paramSetD
  34 id-tc26-gost-3410-2012-512-paramSetTest -> id-tc26-gost-3410-12-512-paramSetTest
  35 id-tc26-gost-3410-2012-512-paramSetA -> id-tc26-gost-3410-12-512-paramSetA
  36 id-tc26-gost-3410-2012-512-paramSetB -> id-tc26-gost-3410-12-512-paramSetB
  37 id-tc26-gost-3410-2012-512-paramSetC -> id-tc26-gost-3410-12-512-paramSetC
  38 @end verbatim
  39
  40 @anchor{Release 5.4}
  41 @item 5.4
  42 @code{gost3410.prv_marshal} helper can make private keys that are
  43 in curve's Q field, for better compatibility with some implementations.
  44
  45 @anchor{Release 5.3}
  46 @item 5.3
  47     @itemize
  48     @item More than 4 times speed increase of @code{gost34112012}.
  49     @item @command{asn1schemas/cert-selfsigned-example.py} optionally
  50         can issue CA signed child certificate.
  51     @end itemize
  52
  53 @anchor{Release 5.2}
  54 @item 5.2
  55     @itemize
  56     @item @code{GOST3410Curve} has @code{.contains(point)} method for
  57         checking if point is on the curve.
  58     @item @code{gost3410_vko} functions check if remote peer's public
  59         key is on the curve.
  60     @item Small typing stubs fixes.
  61     @end itemize
  62
  63 @anchor{Release 5.1}
  64 @item 5.1
  65 Small typing stubs fixes.
  66
  67 @anchor{Release 5.0}
  68 @item 5.0
  69     @itemize
  70     @item Backward incompatible removing of misleading and excess
  71         @option{mode} keyword argument from all @code{gost3410*} related
  72         functions. Point/key sizes are determined by looking at curve's
  73         parameters size.
  74     @item @command{asn1schemas/cert-selfsigned-example.py} optionally
  75         can create CA certificate.
  76     @end itemize
  77
  78 @anchor{Release 4.9}
  79 @item 4.9
  80     @itemize
  81     @item @strong{Fixed} nasty bug with Edwards curves using in
  82         34.10-VKO functions: curve's cofactor has not been used
  83     @item CTR-ACPKM mode of operation
  84     @item OMAC-ACPKM-Master moder of operation
  85     @item KExp15/KImp15 key export/import functions
  86     @item KDF_GOSTR3411_2012_256, KDF_TREE_GOSTR3411_2012_256
  87     @item KEG export key generation function
  88     @end itemize
  89
  90 @anchor{Release 4.8}
  91 @item 4.8
  92 MGM AEAD mode for 64 and 128 bit ciphers.
  93
  94 @anchor{Release 4.7}
  95 @item 4.7
  96 Removed @code{gost28147.addmod} for simplicity.
  97
  98 @anchor{Release 4.6}
  99 @item 4.6
 100 Fix invalid @code{gost28147.addmod}'s behaviour with much bigger values
 101 than the modulo.
 102
 103 @anchor{Release 4.5}
 104 @item 4.5
 105 Fixed digest endianness and more RFC4491bis conformance in
 106 @command{asn1schemas/cert-selfsigned-example.py} certificate's.
 107
 108 @anchor{Release 4.4}
 109 @item 4.4
 110     @itemize
 111     @item @code{id-tc26-gost-3410-2012-512-paramSetTest} curve
 112     @item Simple FAQ
 113     @item More test vectors for 34.10-2012
 114     @item More X.509, PKCS #10 and corresponding ASN.1 helper structures
 115     @end itemize
 116
 117 @anchor{Release 4.3}
 118 @item 4.3
 119 Dummy release with fixed @code{pygost.__version__}.
 120
 121 @anchor{Release 4.2}
 122 @item 4.2
 123     @itemize
 124     @item @code{pygost.gost3410.sign} accepts predefined random
 125         data used for k/r generation
 126     @item More test vectors for 34.10-2012
 127     @end itemize
 128
 129 @anchor{Release 4.1}
 130 @item 4.1
 131     @itemize
 132     @item PEP-396 compatible module's @code{__version__}
 133     @item Curve parameters aliases:
 134 @verbatim
 135 id-GostR3410-2001-CryptoPro-XchA-ParamSet -> id-GostR3410-2001-CryptoPro-A-ParamSet
 136 id-GostR3410-2001-CryptoPro-XchB-ParamSet -> id-GostR3410-2001-CryptoPro-C-ParamSet
 137 id-tc26-gost-3410-2012-256-paramSetB      -> id-GostR3410-2001-CryptoPro-A-ParamSet
 138 id-tc26-gost-3410-2012-256-paramSetC      -> id-GostR3410-2001-CryptoPro-B-ParamSet
 139 id-tc26-gost-3410-2012-256-paramSetD      -> id-GostR3410-2001-CryptoPro-C-ParamSet
 140 @end verbatim
 141     @item Forbid any later GNU GPL version autousage (project's licence
 142         now is GNU GPLv3 only)
 143     @end itemize
 144
 145 @anchor{Release 4.0}
 146 @item 4.0
 147     @itemize
 148     @item 34.10-2012 TC26 twisted Edwards curve related parameters
 149     @item Coordinates conversion from twisted Edwards to Weierstrass
 150         form and vice versa
 151     @item More test vectors
 152     @item Backward incompatible Sbox and curves parameters renaming,
 153         to comply with OIDs identifying them:
 154 @verbatim
 155 Gost2814789_TestParamSet       -> id-Gost28147-89-TestParamSet
 156 Gost28147_CryptoProParamSetA   -> id-Gost28147-89-CryptoPro-A-ParamSet
 157 Gost28147_CryptoProParamSetB   -> id-Gost28147-89-CryptoPro-B-ParamSet
 158 Gost28147_CryptoProParamSetC   -> id-Gost28147-89-CryptoPro-C-ParamSet
 159 Gost28147_CryptoProParamSetD   -> id-Gost28147-89-CryptoPro-D-ParamSet
 160 Gost28147_tc26_ParamZ          -> id-tc26-gost-28147-param-Z
 161 GostR3411_94_TestParamSet      -> id-GostR3411-94-TestParamSet
 162 GostR3411_94_CryptoProParamSet -> id-GostR3411-94-CryptoProParamSet
 163
 164 GostR3410_2001_TestParamSet            -> id-GostR3410-2001-TestParamSet
 165 GostR3410_2001_CryptoPro_A_ParamSet    -> id-GostR3410-2001-CryptoPro-A-ParamSet
 166 GostR3410_2001_CryptoPro_B_ParamSet    -> id-GostR3410-2001-CryptoPro-B-ParamSet
 167 GostR3410_2001_CryptoPro_C_ParamSet    -> id-GostR3410-2001-CryptoPro-C-ParamSet
 168 GostR3410_2001_CryptoPro_XchA_ParamSet -> id-GostR3410-2001-CryptoPro-XchA-ParamSet
 169 GostR3410_2001_CryptoPro_XchB_ParamSet -> id-GostR3410-2001-CryptoPro-XchB-ParamSet
 170 GostR3410_2012_TC26_256_ParamSetA      -> id-tc26-gost-3410-2012-256-paramSetA
 171 GostR3410_2012_TC26_ParamSetA          -> id-tc26-gost-3410-12-512-paramSetA
 172 GostR3410_2012_TC26_ParamSetB          -> id-tc26-gost-3410-12-512-paramSetB
 173 GostR3410_2012_TC26_ParamSetC          -> id-tc26-gost-3410-2012-512-paramSetC
 174 @end verbatim
 175     @item Backward incompatible @code{GOST3410Curve} initialization: all
 176         parameters are passed not as big-endian encoded binaries, but as
 177         integers
 178     @item Backward incompatible change: @code{gost3410.CURVE_PARAMS} is
 179       disappeared. @code{gost3410.CURVES} dictionary holds already
 180       initialized @code{GOST3410Curve}. Just use
 181       @code{CURVES["id-tc26-gost-3410-12-512-paramSetA"]} instead of
 182       @code{GOST3410Curve(*CURVE_PARAMS["id-tc26-gost-3410-12-512-paramSetA"])}
 183     @end itemize
 184
 185 @anchor{Release 3.15}
 186 @item 3.15
 187     @itemize
 188     @item Licence changed back to GNU GPLv3+. GNU LGPLv3+ licenced
 189         versions are not available anymore
 190     @item More ASN.1-based test vectors
 191         (@url{http://www.pyderasn.cypherpunks.ru/, PyDERASN} dependency required)
 192     @end itemize
 193
 194 @anchor{Release 3.14}
 195 @item 3.14
 196 Add missing typing stubs related to previous release.
 197
 198 @anchor{Release 3.13}
 199 @item 3.13
 200     @itemize
 201     @item Ability to explicitly specify used 28147-89 Sbox in
 202         @code{pygost.wrap.*} functions
 203     @item Ability to use key meshing in 28147-89 CBC mode
 204     @end itemize
 205
 206 @anchor{Release 3.12}
 207 @item 3.12
 208     @itemize
 209     @item Added mode argument to @code{pygost.gost3410_vko.kek_34102012256},
 210         because 256-bit private keys can be used with that algorithm too.
 211     @item Fix incorrect degree sanitizing in
 212         @code{pygost.gost3410.GOST3410Curve.exp} preventing using of
 213         @code{UKM=1} in @code{pygost.gost3410_vko.kek_*} functions.
 214     @end itemize
 215
 216 @anchor{Release 3.11}
 217 @item 3.11
 218 Fixed PEP247 typing stub with invalid hexdigest method.
 219
 220 @anchor{Release 3.10}
 221 @item 3.10
 222 Additional missing 34.11-* typing stubs.
 223
 224 @anchor{Release 3.9}
 225 @item 3.9
 226 Add missing 34.11-2012 PBKDF2 typing stub.
 227
 228 @anchor{Release 3.8}
 229 @item 3.8
 230     @itemize
 231     @item 34.11-2012 based PBKDF2 function added
 232     @item 34.13-2015 does not require double blocksized IVs
 233     @end itemize
 234
 235 @anchor{Release 3.7}
 236 @item 3.7
 237 Fixed 34.13-2015 OFB bug with IVs longer than 2 blocks.
 238
 239 @anchor{Release 3.6}
 240 @item 3.6
 241 Fixed source files installation during @command{setup.py install} invocation.
 242
 243 @anchor{Release 3.5}
 244 @item 3.5
 245 Dummy release: added long description in package metadata.
 246
 247 @anchor{Release 3.4}
 248 @item 3.4
 249     @itemize
 250     @item Small mypy stubs related fixes
 251     @item Licence changed from GNU GPLv3+ to GNU LGPLv3+
 252     @end itemize
 253
 254 @anchor{Release 3.3}
 255 @item 3.3
 256     @itemize
 257     @item @code{GOST3412Kuz} renamed to @code{GOST3412Kuznechik}
 258     @item @code{GOST3412Magma} implements GOST R 34.12-2015 Magma 64-bit
 259         block cipher
 260     @end itemize
 261
 262 @anchor{Release 3.2}
 263 @item 3.2
 264 34.13-2015 block cipher modes of operation implementations.
 265
 266 @anchor{Release 3.1}
 267 @item 3.1
 268 Fixed mypy stubs related to PEP247-successors.
 269
 270 @anchor{Release 3.0}
 271 @item 3.0
 272     @itemize
 273     @item @code{gost3411_94} renamed to @code{gost341194}
 274     @item @code{gost3411_2012} renamed and split to
 275         @code{gost34112012256}, @code{gost34112012512}
 276     @item @code{GOST34112012} split to
 277         @code{GOST34112012256}, @code{GOST34112012512}
 278     @item @code{gost3410.kek} moved to separate
 279         @code{gost3410_vko.kek_34102001}
 280     @item VKO GOST R 34.10-2012 appeared in @code{gost3410_vko},
 281         with test vectors
 282     @item 34.11-94 digest is reversed, to be compatible with HMAC and
 283         PBKDF2 test vectors describe in TC26 documents
 284     @item 34.11-94 PBKDF2 test vectors added
 285     @item @code{gost3410.prv_unmarshal},
 286         @code{gost3410.pub_marshal},
 287         @code{gost3410.pub_unmarshal}
 288         helpers added, removing the need of @code{x509} module at all
 289     @item @code{gost3410.verify} requires @code{(pubX, pubY)} tuple,
 290         instead of two separate @code{pubX}, @code{pubY} arguments
 291     @item 34.11-94 based PBKDF2 function added
 292     @end itemize
 293
 294 @anchor{Release 2.4}
 295 @item 2.4
 296 Fixed 34.13 mypy stub.
 297
 298 @anchor{Release 2.3}
 299 @item 2.3
 300 Typo and pylint fixes.
 301
 302 @item 2.2
 303 GOST R 34.13-2015 padding methods.
 304
 305 @item 2.1
 306 Documentation and supplementary files refactoring.
 307
 308 @item 2.0
 309 PEP-0247 compatible hashers and MAC.
 310
 311 @item 1.0
 312     @itemize
 313     @item Ability to specify curve in pygost.x509 module
 314     @item Ability to use 34.10-2012 in pygost.x509 functions
 315     @item Renamed classes and modules:
 316 @verbatim
 317 pygost.gost3410.SIZE_34100 -> pygost.gost3410.SIZE_3410_2001
 318 pygost.gost3410.SIZE_34112 -> pygost.gost3410.SIZE_3410_2012
 319 pygost.gost3411_12.GOST341112 -> pygost.gost3411_2012.GOST34112012
 320 @end verbatim
 321     @end itemize
 322
 323 @item 0.16
 324 34.10-2012 TC26 curve parameters.
 325
 326 @item 0.15
 327 PEP-0484 static typing hints.
 328
 329 @item 0.14
 330 34.10-2012 workability fix.
 331
 332 @item 0.13
 333 Python3 compatibility.
 334
 335 @item 0.11
 336 GOST R 34.12-2015 Кузнечик (Kuznechik) implementation.
 337
 338 @item 0.10
 339 CryptoPro and GOST key wrapping, CryptoPro key meshing.
 340
 341 @end table