-
Notifications
You must be signed in to change notification settings - Fork 908
/
README
85 lines (58 loc) · 2.24 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
wolfSSL TLS Module
Shih-Ping Chan
Copyright © 2022 Chan Shih-Ping
__________________________________________________________________
Table of Contents
1. Admin Guide
1. Overview
2. Quick Start
3. Important Notes
4. Compiling the wolfSSL TLS Module
List of Examples
1.1. Quick Start Basic Config
Chapter 1. Admin Guide
Table of Contents
1. Overview
2. Quick Start
3. Important Notes
4. Compiling the wolfSSL TLS Module
1. Overview
This module implements the TLS transport for Kamailio using the wolfSSL
library (https://www.wolfssl.com). To enable the Kamailio TLS support
this module must be loaded and enable_tls=yes core setting must be
added to the Kamailio config file.
This module is derived from the tls module and adapted to wolfSSL using
the OpenSSL-compatibility layer. Credit goes to the authors of the tls
module.
This module is based on wolfSSL 5.2.0 and 5.3.0 and is not fully
compatible with the tls module (protocol versions < 1.1 not supported
it the Debian package for example.
This user is referred to the documentation of the tls module for
configuration and other information. Not all configuration keys are
implemented (e.g., protocol versions — defaults to 1.2+ and cipher
suites).
2. Quick Start
The default kamailio.cfg file has basic tls support included, it has to
be enabled with "#!define WITH_TLS" directive.
Example 1.1. Quick Start Basic Config
#...
loadmodule "sl.so"
loadmodule "tls_wolfssl.so"
#... refer to Quick Start of tls module
#... for further configuration
3. Important Notes
The wolfSSL TLS module is intended to be compiled with a recent version
of wolfSSL (5.2.0+).
Default compilations of the library will not work with Kamailio's own
memory allocation. See https://github.com/wolfSSL/wolfssl/issues/5264
for more details.
4. Compiling the wolfSSL TLS Module
The development package for wolfSSL is required (libwolfssl-dev or
equivalent).
In most case compiling the wolfSSL TLS module is as simple as:
make -C modules/tls_wolfssl
or
make modules modules=modules/tls_wolfssl
or (compiling whole Kamailio and the tls module)
make all include_modules=tls_wolfssl
.