Module: kamailio
Branch: 5.2
Commit: 52e348087551b42c97bcb235dabbc95255a83b1a
URL: https://github.com/kamailio/kamailio/commit/52e348087551b42c97bcb235dabbc95…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2019-10-07T11:43:55+02:00
tls: docs for rand_engine parameter
(cherry picked from commit 787b95a5a0573d4e81b2475a84bad59076e34faf)
(cherry picked from commit 3c11a405344af55aa4b9c8d35e1c181473cbdf42)
---
Modified: src/modules/tls/doc/params.xml
---
Diff: https://github.com/kamailio/kamailio/commit/52e348087551b42c97bcb235dabbc95…
Patch: https://github.com/kamailio/kamailio/commit/52e348087551b42c97bcb235dabbc95…
---
diff --git a/src/modules/tls/doc/params.xml b/src/modules/tls/doc/params.xml
index 6ef2d4123f..6028642b5f 100644
--- a/src/modules/tls/doc/params.xml
+++ b/src/modules/tls/doc/params.xml
@@ -1241,6 +1241,39 @@ end
</example>
</section>
+ <section id="tls.p.rand_engine">
+ <title><varname>rand_engine</varname> (str)</title>
+ <para>
+ Set the ranondom number generator engine for libssl.
+ </para>
+ <para>
+ Note: the default random number generator (PRNG) engine of libssl 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".
+ </para>
+ <para>
+ The following options are avaialble:
+ </para>
+ <itemizedlist>
+ <listitem><para>krand - use internal kam_rand() function</para></listitem>
+ <listitem><para>fastrand - use internal fastrand function</para></listitem>
+ </itemizedlist>
+ <para>
+ The default value is empty (not set) for libssl v1.0.x or older, and
+ "fastrand" for libssl v1.1.x or newer.
+ </para>
+ <example>
+ <title>Set <varname>rand_engine</varname> parameter</title>
+ <programlisting>
+...
+modparam("tls", "rand_engine", "fastrand")
+...
+ </programlisting>
+ </example>
+ </section>
+
<section id="tls.p.engine">
<title><varname>engine</varname> (string)</title>
<para>
Module: kamailio
Branch: master
Commit: b1886c15ba562fef987fe6361df2cb3bbe00888c
URL: https://github.com/kamailio/kamailio/commit/b1886c15ba562fef987fe6361df2cb3…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2019-10-07T11:02:17+02:00
modules: readme files regenerated - tls ... [skip ci]
---
Modified: src/modules/tls/README
---
Diff: https://github.com/kamailio/kamailio/commit/b1886c15ba562fef987fe6361df2cb3…
Patch: https://github.com/kamailio/kamailio/commit/b1886c15ba562fef987fe6361df2cb3…
---
diff --git a/src/modules/tls/README b/src/modules/tls/README
index 295306a74e..b0d9fa2601 100644
--- a/src/modules/tls/README
+++ b/src/modules/tls/README
@@ -1430,14 +1430,17 @@ 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 function
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. The krand and fastrand engines
+ are not recommended for production use, as they will not generate
+ secure enough random numbers.
Example 1.45. Set rand_engine parameter
...