sr-dev

sr-dev@lists.kamailio.org

16 participants
45400 discussions

I want Help Understanding Kamailio Modules for Custom SIP Handling
by c7897009＠gmail.com 30 Jun '25

30 Jun '25

Hey everyone, I am diving into Kamailio & trying to wrap my head around how to handle some custom SIP scenarios, when it comes to module integration. I have gone through some of the docs but still feel a bit lost on choosing the right modules & how they interact for use cases such as custom header manipulation or building out a basic call-routing logic beyond the default examples. I am not sure if I should be using `dialog`, `tm`, or maybe even `uac` for this. Also, does anyone here have experience using Kamailio with external APIs for call control or authentication purposes? Any examples, tips or gotchas I should be aware of ? Also i have check this <a href="https://www.kamailio.org/w/features/">https://www.kamailio.org/w/features/</a> <a href="https://www.igmguru.com/project-management/capm-certification-training">capm course</a> witch is good still need your help. I appreciate if someone could point me to a working config or give some practical advice from experience. Still new to SIP routing logic, so trying to learn the right way early on. Thank you.:)

2 1

git:master:75b73da6: modules: readme files regenerated - secsipid ... [skip ci]
by Kamailio Dev 30 Jun '25

30 Jun '25

Module: kamailio Branch: master Commit: 75b73da6a592d42b0334c6fe8cff2f366aa7d25f URL: https://github.com/kamailio/kamailio/commit/75b73da6a592d42b0334c6fe8cff2f3… Author: Kamailio Dev <kamailio.dev(a)kamailio.org> Committer: Kamailio Dev <kamailio.dev(a)kamailio.org> Date: 2025-06-30T08:46:10+02:00 modules: readme files regenerated - secsipid ... [skip ci] --- Modified: src/modules/secsipid/README --- Diff: https://github.com/kamailio/kamailio/commit/75b73da6a592d42b0334c6fe8cff2f3… Patch: https://github.com/kamailio/kamailio/commit/75b73da6a592d42b0334c6fe8cff2f3…

1 0

git:master:64635de5: secsipid: docs update to reflect better the use of private/public key
by Daniel-Constantin Mierla 30 Jun '25

30 Jun '25

Module: kamailio Branch: master Commit: 64635de552896fbf354e52656ec4ee93f1d87e6f URL: https://github.com/kamailio/kamailio/commit/64635de552896fbf354e52656ec4ee9… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: 2025-06-30T08:33:35+02:00 secsipid: docs update to reflect better the use of private/public key --- Modified: src/modules/secsipid/doc/secsipid_admin.xml --- Diff: https://github.com/kamailio/kamailio/commit/64635de552896fbf354e52656ec4ee9… Patch: https://github.com/kamailio/kamailio/commit/64635de552896fbf354e52656ec4ee9… --- diff --git a/src/modules/secsipid/doc/secsipid_admin.xml b/src/modules/secsipid/doc/secsipid_admin.xml index 4009f745149..ed70d1d2ea1 100644 --- a/src/modules/secsipid/doc/secsipid_admin.xml +++ b/src/modules/secsipid/doc/secsipid_admin.xml @@ -203,9 +203,9 @@ modparam("secsipid", "libopt", "CacheExpires=0") <function moreinfo="none">secsipid_check_identity(keyPath)</function> </title> <para> - Check the validity of the Identity header using the keys stored + Check the validity of the Identity header using the public keys stored in the file specified by "keyPath". If the parameter is empty, - the function is downloading the key using the URL from "info" + the function is downloading the public key using the URL from "info" parameter of the Identity header, using the value of "timeout" parameter to limit the download time. The validity of the JWT body in the Identity header is also checked against the "expire" @@ -271,9 +271,9 @@ request_route { <function moreinfo="none">secsipid_check(sIdentity, keyPath)</function> </title> <para> - Check the validity of the "sIdentity" parameter using the keys stored + Check the validity of the "sIdentity" parameter using the public keys stored in the file specified by "keyPath". If the keyPath parameter is empty, - the function is downloading the key using the URL from "info" + the function is downloading the public key using the URL from "info" parameter of the sIdentity, using the value of "timeout" parameter to limit the download time. The validity of the JWT in the sIdentity value is also checked against the "expire" @@ -384,7 +384,7 @@ request_route { <function moreinfo="none">secsipid_add_identity(origTN, destTN, attest, origID, x5u, keyPath)</function> </title> <para> - Add Identity header using the key specified by "keyPath" to sign the JWT body. + Add Identity header using the private key specified by "keyPath" to sign the JWT body. If origID is empty, a UUID string is generated to fill the field. The origTN represents the origination telephone number; destTN represents the destination telephone number; x5u is the HTTP URL referencing to the public key that @@ -416,7 +416,7 @@ request_route { <function moreinfo="none">secsipid_build_identity(origTN, destTN, attest, origID, x5u, keyPath)</function> </title> <para> - Build Identity value using the key specified by "keyPath" to sign the JWT body. + Build Identity value using the key specified by private "keyPath" to sign the JWT body. If origID is empty, a UUID string is generated to fill the field. The origTN represents the origination telephone number; destTN represents the destination telephone number; x5u is the HTTP URL referencing to the public key that @@ -482,7 +482,7 @@ request_route { <function moreinfo="none">secsipid_sign(sheaders, spaypload, keyPath)</function> </title> <para> - Build Identity value using the key specified by "keyPath" to sign the JWT body. + Build Identity value using the private key specified by "keyPath" to sign the JWT body. The sheaders and spayload have to be string representation of JSON headers and payload to be signed. On success, the Indentity value is stored in variable $secsipid(val). It also sets $secsipid(ret) to

1 0

git:master:b2ac541e: core: formatted the list of dns error messages
by Daniel-Constantin Mierla 30 Jun '25

30 Jun '25

Module: kamailio Branch: master Commit: b2ac541e934bba5758c7af4e59091da24bc96ca6 URL: https://github.com/kamailio/kamailio/commit/b2ac541e934bba5758c7af4e59091da… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: 2025-06-30T08:19:55+02:00 core: formatted the list of dns error messages --- Modified: src/core/dns_cache.c --- Diff: https://github.com/kamailio/kamailio/commit/b2ac541e934bba5758c7af4e59091da… Patch: https://github.com/kamailio/kamailio/commit/b2ac541e934bba5758c7af4e59091da… --- diff --git a/src/core/dns_cache.c b/src/core/dns_cache.c index fbc5e83f27c..6c5f8c38e1b 100644 --- a/src/core/dns_cache.c +++ b/src/core/dns_cache.c @@ -120,14 +120,24 @@ static atomic_t *dns_servers_up = NULL; #endif -static const char *dns_str_errors[] = {"no error", - "no more records", /* not an error, but and end condition */ - "unknown error", "internal error", "bad SRV entry", - "unresolvable SRV request", "bad A or AAAA entry", - "unresolvable A or AAAA request", "invalid ip in A or AAAA record", - "blocklisted ip", "name too long ", /* try again with a shorter name */ - "ip AF mismatch", /* address family mismatch */ - "unresolvable NAPTR request", "bug - critical error"}; +/* clang-format off */ +static const char *dns_str_errors[] = { + "no error", + "no more records", /* not an error, but and end condition */ + "unknown error", + "internal error", + "bad SRV entry", + "unresolvable SRV request", + "bad A or AAAA entry", + "unresolvable A or AAAA request", + "invalid ip in A or AAAA record", + "blocklisted ip", + "name too long ", /* try again with a shorter name */ + "ip AF mismatch", /* address family mismatch */ + "unresolvable NAPTR request", + "bug - critical error" +}; +/* clang-format on */ void dns_set_local_ttl(int ttl)

1 0

git:6.0:567a0e75: modules: readme files regenerated - modules ... [skip ci]
by Kamailio Dev 28 Jun '25

28 Jun '25

Module: kamailio Branch: 6.0 Commit: 567a0e75e3ee780641365b9a3fb2747d57b3e4ab URL: https://github.com/kamailio/kamailio/commit/567a0e75e3ee780641365b9a3fb2747… Author: Kamailio Dev <kamailio.dev(a)kamailio.org> Committer: Kamailio Dev <kamailio.dev(a)kamailio.org> Date: 2025-06-28T04:46:18+02:00 modules: readme files regenerated - modules ... [skip ci] --- Modified: src/modules/tls/README --- Diff: https://github.com/kamailio/kamailio/commit/567a0e75e3ee780641365b9a3fb2747… Patch: https://github.com/kamailio/kamailio/commit/567a0e75e3ee780641365b9a3fb2747… --- diff --git a/src/modules/tls/README b/src/modules/tls/README index 21250d76373..3a8f18e5774 100644 --- a/src/modules/tls/README +++ b/src/modules/tls/README @@ -72,6 +72,7 @@ Olle E. Johansson 10.38. engine_config (string) 10.39. engine_algorithms (string) 10.40. verify_client (string) + 10.41. provider_quirks (integer) 11. Functions @@ -209,6 +210,7 @@ Chapter 1. Admin Guide 10.38. engine_config (string) 10.39. engine_algorithms (string) 10.40. verify_client (string) + 10.41. provider_quirks (integer) 11. Functions @@ -648,6 +650,7 @@ Place holder 10.38. engine_config (string) 10.39. engine_algorithms (string) 10.40. verify_client (string) + 10.41. provider_quirks (integer) 10.1. tls_method (string) @@ -1638,6 +1641,13 @@ method = TLSv1.2 verify_client = optional_no_ca ... +10.41. provider_quirks (integer) + + Sets a flag to configure OpenSSL 3 behaviour. Currently only 1 + * 0 - no flags set (default) + * 1 - create a new `OSSL_LIB_CTX` context in the child process. Known + to be required when using OpenSSL 3 pkcs11-provider. + 11. Functions 11.1. is_peer_verified()

1 0

git:6.0:27f09f6e: tls: document provider_quirks parameter
by S-P Chan 28 Jun '25

28 Jun '25

Module: kamailio Branch: 6.0 Commit: 27f09f6ee73b1eb65db839e213069511a2e8434c URL: https://github.com/kamailio/kamailio/commit/27f09f6ee73b1eb65db839e21306951… Author: S-P Chan <shihping.chan(a)gmail.com> Committer: S-P Chan <shihping.chan(a)gmail.com> Date: 2025-06-28T10:40:31+08:00 tls: document provider_quirks parameter (cherry picked from commit e93de1d71513b444054bac0b9b668205655bf268) --- Modified: src/modules/tls/doc/params.xml --- Diff: https://github.com/kamailio/kamailio/commit/27f09f6ee73b1eb65db839e21306951… Patch: https://github.com/kamailio/kamailio/commit/27f09f6ee73b1eb65db839e21306951… --- diff --git a/src/modules/tls/doc/params.xml b/src/modules/tls/doc/params.xml index c6dc019c5c7..0ed54a2208a 100644 --- a/src/modules/tls/doc/params.xml +++ b/src/modules/tls/doc/params.xml @@ -1490,4 +1490,20 @@ verify_client = optional_no_ca </programlisting> </example> </section> + <section id="tls.p.provider_quirks"> + <title><varname>provider_quirks</varname> (integer)</title> + <para> + Sets a flag to configure OpenSSL 3 behaviour. Currently only <varname>1</varname> + </para> + <itemizedlist> + <listitem> + <para><emphasis>0</emphasis> - no flags set (default)</para> + </listitem> + <listitem> + <para><emphasis>1</emphasis> - create a new `OSSL_LIB_CTX` context in the child process. + Known to be required when using OpenSSL 3 pkcs11-provider. + </para> + </listitem> + </itemizedlist> + </section> </section>

1 0

git:master:ac5b3678: modules: readme files regenerated - tls ... [skip ci]
by Kamailio Dev 27 Jun '25

27 Jun '25

Module: kamailio Branch: master Commit: ac5b3678ad088c81932b1272bb7a0a711c66649f URL: https://github.com/kamailio/kamailio/commit/ac5b3678ad088c81932b1272bb7a0a7… Author: Kamailio Dev <kamailio.dev(a)kamailio.org> Committer: Kamailio Dev <kamailio.dev(a)kamailio.org> Date: 2025-06-28T01:46:14+02:00 modules: readme files regenerated - tls ... [skip ci] --- Modified: src/modules/tls/README --- Diff: https://github.com/kamailio/kamailio/commit/ac5b3678ad088c81932b1272bb7a0a7… Patch: https://github.com/kamailio/kamailio/commit/ac5b3678ad088c81932b1272bb7a0a7… --- diff --git a/src/modules/tls/README b/src/modules/tls/README index 21250d76373..3a8f18e5774 100644 --- a/src/modules/tls/README +++ b/src/modules/tls/README @@ -72,6 +72,7 @@ Olle E. Johansson 10.38. engine_config (string) 10.39. engine_algorithms (string) 10.40. verify_client (string) + 10.41. provider_quirks (integer) 11. Functions @@ -209,6 +210,7 @@ Chapter 1. Admin Guide 10.38. engine_config (string) 10.39. engine_algorithms (string) 10.40. verify_client (string) + 10.41. provider_quirks (integer) 11. Functions @@ -648,6 +650,7 @@ Place holder 10.38. engine_config (string) 10.39. engine_algorithms (string) 10.40. verify_client (string) + 10.41. provider_quirks (integer) 10.1. tls_method (string) @@ -1638,6 +1641,13 @@ method = TLSv1.2 verify_client = optional_no_ca ... +10.41. provider_quirks (integer) + + Sets a flag to configure OpenSSL 3 behaviour. Currently only 1 + * 0 - no flags set (default) + * 1 - create a new `OSSL_LIB_CTX` context in the child process. Known + to be required when using OpenSSL 3 pkcs11-provider. + 11. Functions 11.1. is_peer_verified()

1 0

git:master:e93de1d7: tls: document provider_quirks parameter
by S-P Chan 27 Jun '25

27 Jun '25

Module: kamailio Branch: master Commit: e93de1d71513b444054bac0b9b668205655bf268 URL: https://github.com/kamailio/kamailio/commit/e93de1d71513b444054bac0b9b66820… Author: S-P Chan <shihping.chan(a)gmail.com> Committer: S-P Chan <shihping.chan(a)gmail.com> Date: 2025-06-28T07:42:41+08:00 tls: document provider_quirks parameter --- Modified: src/modules/tls/doc/params.xml --- Diff: https://github.com/kamailio/kamailio/commit/e93de1d71513b444054bac0b9b66820… Patch: https://github.com/kamailio/kamailio/commit/e93de1d71513b444054bac0b9b66820… --- diff --git a/src/modules/tls/doc/params.xml b/src/modules/tls/doc/params.xml index c6dc019c5c7..0ed54a2208a 100644 --- a/src/modules/tls/doc/params.xml +++ b/src/modules/tls/doc/params.xml @@ -1490,4 +1490,20 @@ verify_client = optional_no_ca </programlisting> </example> </section> + <section id="tls.p.provider_quirks"> + <title><varname>provider_quirks</varname> (integer)</title> + <para> + Sets a flag to configure OpenSSL 3 behaviour. Currently only <varname>1</varname> + </para> + <itemizedlist> + <listitem> + <para><emphasis>0</emphasis> - no flags set (default)</para> + </listitem> + <listitem> + <para><emphasis>1</emphasis> - create a new `OSSL_LIB_CTX` context in the child process. + Known to be required when using OpenSSL 3 pkcs11-provider. + </para> + </listitem> + </itemizedlist> + </section> </section>

1 0

git:master:36c5fc49: modules: readme files regenerated - file_out ... [skip ci]
by Kamailio Dev 27 Jun '25

27 Jun '25

Module: kamailio Branch: master Commit: 36c5fc499289ef192caeb769db6224e7f2d47a81 URL: https://github.com/kamailio/kamailio/commit/36c5fc499289ef192caeb769db6224e… Author: Kamailio Dev <kamailio.dev(a)kamailio.org> Committer: Kamailio Dev <kamailio.dev(a)kamailio.org> Date: 2025-06-27T16:01:09+02:00 modules: readme files regenerated - file_out ... [skip ci] --- Modified: src/modules/file_out/README --- Diff: https://github.com/kamailio/kamailio/commit/36c5fc499289ef192caeb769db6224e… Patch: https://github.com/kamailio/kamailio/commit/36c5fc499289ef192caeb769db6224e… --- diff --git a/src/modules/file_out/README b/src/modules/file_out/README index 0fcbf640251..e750c7caad5 100644 --- a/src/modules/file_out/README +++ b/src/modules/file_out/README @@ -147,7 +147,7 @@ modparam("file_out", "file", "name=accounting;extension=.txt") Example 1.3. Set worker_usleep parameter ... -modparam("file_out", "worker_usleep", "1000") +modparam("file_out", "worker_usleep", 1000) ... 3.4. timer_interval (int) @@ -159,7 +159,7 @@ modparam("file_out", "worker_usleep", "1000") Example 1.4. Set timer_interval parameter ... -modparam("file_out", "timer_interval", "60") +modparam("file_out", "timer_interval", 60) ... 4. Functions

1 0

git:master:f5c5a531: file_out: Fix example docs
by Xenofon Karamanos 27 Jun '25

27 Jun '25

Module: kamailio Branch: master Commit: f5c5a531e47f75bf0f2c8046cac2c8daec0f3da5 URL: https://github.com/kamailio/kamailio/commit/f5c5a531e47f75bf0f2c8046cac2c8d… Author: Xenofon Karamanos <xk(a)gilawa.com> Committer: Xenofon Karamanos <xk(a)gilawa.com> Date: 2025-06-27T13:58:59Z file_out: Fix example docs - Use integers instead of string in modparams --- Modified: src/modules/file_out/doc/file_out_admin.xml --- Diff: https://github.com/kamailio/kamailio/commit/f5c5a531e47f75bf0f2c8046cac2c8d… Patch: https://github.com/kamailio/kamailio/commit/f5c5a531e47f75bf0f2c8046cac2c8d… --- diff --git a/src/modules/file_out/doc/file_out_admin.xml b/src/modules/file_out/doc/file_out_admin.xml index 83b84b6abc6..1932d2f0103 100644 --- a/src/modules/file_out/doc/file_out_admin.xml +++ b/src/modules/file_out/doc/file_out_admin.xml @@ -184,7 +184,7 @@ modparam("file_out", "file", "name=accounting;extension=.txt") <title>Set <varname>worker_usleep</varname> parameter</title> <programlisting format="linespecific"> ... -modparam("file_out", "worker_usleep", "1000") +modparam("file_out", "worker_usleep", 1000) ... </programlisting> </example> @@ -208,7 +208,7 @@ modparam("file_out", "worker_usleep", "1000") <title>Set <varname>timer_interval</varname> parameter</title> <programlisting format="linespecific"> ... -modparam("file_out", "timer_interval", "60") +modparam("file_out", "timer_interval", 60) ... </programlisting> </example>

1 0

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

sr-dev