diff options
| author | René Korthaus <[email protected]> | 2016-11-14 11:54:18 +0100 |
|---|---|---|
| committer | René Korthaus <[email protected]> | 2016-11-28 17:18:20 +0100 |
| commit | f633344890006ffeeadf5aedcf3e7ee4d81d12ab (patch) | |
| tree | be26357fc7117b0bb8e7876efb07c67124b035f7 /doc | |
| parent | 9a8ec147287ab07fac3ee3d918f508da920c30c8 (diff) | |
Add note on rfc6979 signatures to manual [ci skip]
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual/index.rst | 4 | ||||
| -rw-r--r-- | doc/manual/pubkey.rst | 12 |
2 files changed, 14 insertions, 2 deletions
diff --git a/doc/manual/index.rst b/doc/manual/index.rst index 1bfc01d30..42f3bceb6 100644 --- a/doc/manual/index.rst +++ b/doc/manual/index.rst @@ -8,3 +8,7 @@ References ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The :ref:`genindex` and :ref:`search` may be useful. + +.. toctree:: + :maxdepth: 1 + :numbered: diff --git a/doc/manual/pubkey.rst b/doc/manual/pubkey.rst index bf47b631d..f401d3512 100644 --- a/doc/manual/pubkey.rst +++ b/doc/manual/pubkey.rst @@ -47,7 +47,7 @@ like key agreement, the two keys *must* use the same group. There are currently two kinds of discrete logarithm groups supported in botan: the integers modulo a prime, represented by :ref:`dl_group`, and elliptic curves in GF(p), represented by :ref:`ec_group`. A rough generalization is that the -larger the group is, the more secure the algorithm is, but coorespondingly the +larger the group is, the more secure the algorithm is, but correspondingly the slower the operations will be. Given a ``DL_Group``, you can create new DSA, Diffie-Hellman, and @@ -71,7 +71,7 @@ Nyberg-Rueppel key pairs with :ref:`pbkdf` for how to do that) as a private key value. Normally, you would leave the value as zero, letting the class generate a new random key. -Finally, given an ``EC_Group`` object, you can create a new ECDSA, +Finally, given an ``EC_Group`` object, you can create a new ECDSA, ECKCDSA, ECGDSA, ECDH, or GOST 34.10-2001 private key with .. cpp:function:: ECDSA_PrivateKey::ECDSA_PrivateKey(RandomNumberGenerator& rng, \ @@ -467,6 +467,14 @@ Signature generation is performed using 34.10-2001, Nyberg-Rueppel, and Rabin-Williams. Other signature schemes may be supported in the future. + .. note:: + + Botan both supports non-deterministic and deterministic (as per RFC + 6979) DSA and ECDSA signatures. Deterministic signatures are compatible + in the way that they can be verified with a non-deterministic implementation. + If the ``rfc6979`` module is enabled, deterministic DSA and ECDSA signatures + will be generated. + Currently available values for *emsa* include EMSA1, EMSA2, EMSA3, EMSA4, and Raw. All of them, except Raw, take a parameter naming a message digest function to hash the message with. The Raw encoding signs the |