Module: kamailio
Branch: master
Commit: 4e9f49a5e8ebd90d6b6913310402acea7f5a3ca9
URL: https://github.com/kamailio/kamailio/commit/4e9f49a5e8ebd90d6b6913310402ace…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2019-10-07T15:07:41+02:00
tls: docs - relocated the note about krand and fastrand from default value paragraph
- rephrased a bit to avoid eventual confusion they are not production ready
---
Modified: src/modules/tls/doc/params.xml
---
Diff: https://github.com/kamailio/kamailio/commit/4e9f49a5e8ebd90d6b6913310402ace…
Patch: https://github.com/kamailio/kamailio/commit/4e9f49a5e8ebd90d6b6913310402ace…
---
diff --git a/src/modules/tls/doc/params.xml b/src/modules/tls/doc/params.xml
index 72d3278ed7..dc6494c2db 100644
--- a/src/modules/tls/doc/params.xml
+++ b/src/modules/tls/doc/params.xml
@@ -1259,13 +1259,16 @@ end
<itemizedlist>
<listitem><para>krand - use internal kam_rand() function</para></listitem>
<listitem><para>fastrand - use internal fastrand function</para></listitem>
- <listitem><para>cryptorand - use internal cryptorand function</para></listitem>
+ <listitem><para>cryptorand - use internal cryptorand (fortuna) function</para></listitem>
</itemizedlist>
+ <para>
+ Note: the krand and fastrand engines are not recommended for use on
+ systems requiring strong security, as they may not generate numbers
+ with enough randomness.
+ </para>
<para>
The default value is empty (not set) for libssl v1.0.x or older, and
- "cryptorand" for libssl v1.1.x or newer. The krand and fastrand engines are
- not recommended for production use, as they will not generate secure enough
- random numbers.
+ "cryptorand" for libssl v1.1.x or newer.
</para>
<example>
<title>Set <varname>rand_engine</varname> parameter</title>
Module: kamailio
Branch: 5.2
Commit: a365a8d3519d33f5314a9c3bdab4e1c1ea465642
URL: https://github.com/kamailio/kamailio/commit/a365a8d3519d33f5314a9c3bdab4e1c…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2019-10-07T15:31:30+02:00
modules: readme files regenerated - modules ... [skip ci]
---
Modified: src/modules/tls/README
---
Diff: https://github.com/kamailio/kamailio/commit/a365a8d3519d33f5314a9c3bdab4e1c…
Patch: https://github.com/kamailio/kamailio/commit/a365a8d3519d33f5314a9c3bdab4e1c…
---
diff --git a/src/modules/tls/README b/src/modules/tls/README
index bf9f693bd0..5a0d9dab1f 100644
--- a/src/modules/tls/README
+++ b/src/modules/tls/README
@@ -1427,14 +1427,19 @@ end
v1.1.x is not designed for multi-process applications and can result in
a crash. Therefore set the PRNG engine to one of the options listed in
this section. If libssl 1.1.x (or newer) is detected at compile time,
- then the PRNG engine is set to "fastrand".
+ then the PRNG engine is set to "cryptorand".
The following options are avaialble:
* krand - use internal kam_rand() function
* fastrand - use internal fastrand function
+ * cryptorand - use internal cryptorand (fortuna) function
+
+ Note: the krand and fastrand engines are not recommended for use on
+ systems requiring strong security, as they may not generate numbers
+ with enough randomness.
The default value is empty (not set) for libssl v1.0.x or older, and
- "fastrand" for libssl v1.1.x or newer.
+ "cryptorand" for libssl v1.1.x or newer.
Example 1.45. Set rand_engine parameter
...
Module: kamailio
Branch: 5.2
Commit: dde78715ce88c8bfb6530559fcaa3a182ca72af7
URL: https://github.com/kamailio/kamailio/commit/dde78715ce88c8bfb6530559fcaa3a1…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2019-10-07T15:16:27+02:00
tls: docs - documented cryptorand engine for prng
(cherry picked from commit 398641926648a32b635f39f655ae3231038b9c3d)
---
Modified: src/modules/tls/doc/params.xml
---
Diff: https://github.com/kamailio/kamailio/commit/dde78715ce88c8bfb6530559fcaa3a1…
Patch: https://github.com/kamailio/kamailio/commit/dde78715ce88c8bfb6530559fcaa3a1…
---
diff --git a/src/modules/tls/doc/params.xml b/src/modules/tls/doc/params.xml
index 6028642b5f..dc6494c2db 100644
--- a/src/modules/tls/doc/params.xml
+++ b/src/modules/tls/doc/params.xml
@@ -1251,7 +1251,7 @@ end
is not designed for multi-process applications and can result in a crash.
Therefore set the PRNG engine to one of the options listed in this
section. If libssl 1.1.x (or newer) is detected at compile time, then
- the PRNG engine is set to "fastrand".
+ the PRNG engine is set to "cryptorand".
</para>
<para>
The following options are avaialble:
@@ -1259,10 +1259,16 @@ end
<itemizedlist>
<listitem><para>krand - use internal kam_rand() function</para></listitem>
<listitem><para>fastrand - use internal fastrand function</para></listitem>
+ <listitem><para>cryptorand - use internal cryptorand (fortuna) function</para></listitem>
</itemizedlist>
+ <para>
+ Note: the krand and fastrand engines are not recommended for use on
+ systems requiring strong security, as they may not generate numbers
+ with enough randomness.
+ </para>
<para>
The default value is empty (not set) for libssl v1.0.x or older, and
- "fastrand" for libssl v1.1.x or newer.
+ "cryptorand" for libssl v1.1.x or newer.
</para>
<example>
<title>Set <varname>rand_engine</varname> parameter</title>