Table of Contents
List of Tables
List of Examples
restore_mode parameter
restore_passwd parameterrr_from_store_param parameterrr_to_store_param parameterforce_dialog parameteruac_replace_from/uac_replace_to usageuac_replace_from/uac_replace_to usageuac_restore_from/uac_restore_to usageuac_auth usageUAC (User Agent Client) module provides some basic UAC functionalities like FROM / TO header manipulation (anonymization) or client authentication.
If the dialog module is loaded and a dialog can be created, then the auto mode can be done more efficiently.
Known limitations in this version:
authentication does not support qop auth-int, just qop auth;
CSeq not increased during authentication - the response may be rejected.
The following modules must be loaded before this module:
TM - Transaction Module.
RR - Record-Route Module, but only if restore mode for FROM URI is set to “auto”.
UAC_AUTH - UAC Authentication Module.
Dialog Module, if “force_dialog” module parameter is enabled, or a dialog is created from the configuration script.
There are 3 mode of restoring the original headers (FROM/TO) URI:
“none” - no information about original URI is stored; restoration is not possible.
“manual” - all following replies will be restored, except for the sequential requests - these must be manually updated based on original URI.
“auto” - all sequential requests and replies will be automatically updated based on stored original URI.
This parameter is optional, it's default value being “auto”.
String password to be used to encrypt the RR storing parameter (when replacing the TO/FROM headers). If empty, no encryption will be used.
Default value of this parameter is empty.
Example 1.2. Set restore_passwd parameter
...
modparam("uac","restore_passwd","my_secret_passwd")
...
Name of Record-Route header parameter that will be used to store (encoded) the original FROM URI.
This parameter is optional, it's default value being “vsf”.
Example 1.3. Set rr_from_store_param parameter
...
modparam("uac","rr_from_store_param","my_Fparam")
...
Replace in FROM/TO header the display name and the URI part.
display and URI parameters can include pseudo-variables.
IMPORTANT: calling the function more than once per branch will lead to inconsistent changes over the request.Be sure you do the change only ONCE per branch. Note that calling the function from REQUEST ROUTE affects all the branches!, so no other change will be possible in the future. For per branch changes use BRANCH and FAILURE route.
This function can be used from REQUEST_ROUTE, BRANCH_ROUTE and FAILURE_ROUTE.
Example 1.6. uac_replace_from/uac_replace_to usage
...
# replace both display and uri
uac_replace_from("$avp(display)","$avp(uri)");
# replace only display and do not touch uri
uac_replace_from("batman","");
# remove display and replace uri
uac_replace_from("","sip:robin@gotham.org");
# remove display and do not touch uri
uac_replace_from("","");
...
Replace in FROM/TO header the URI part without altering the display name.
URI parameter can include pseudo-variables.
This function can be used from REQUEST_ROUTE.
Example 1.7. uac_replace_from/uac_replace_to usage
...
uac_replace_from("sip:batman@gotham.org");
...
This function will check if the FROM/TO URI was modified and will use the information stored in header parameter to restore the original FROM/TO URI value.
NOTE - this function should be used only if you configured MANUAL restoring of the headers (see restore_mode param). For AUTO and NONE, there is no need to use this function.
This function can be used from REQUEST_ROUTE.
This function can be called only from failure route and will build the authentication response header and insert it into the request without sending anything. Credentials for buiding the authentication response will be taken from the list of credentials provided by the uac_auth module (static or via AVPs).
This function can be used from FAILURE_ROUTE.
2.1. | What happened with auth_username_avp, auth_realm_avp and auth_password_avp parameters |
Due some restructuring of the UAC auth modules, these parameters were moved into the "uac_auth" module. This module is now responsible for handling all the credentials (static defined or dynamically defined via AVPs). The UAC module will still see the credentials defined via the AVPs. | |
2.2. | Where can I find more about OpenSIPS? |
Take a look at https://opensips.org/. | |
2.3. | Where can I post a question about this module? |
First at all check if your question was already answered on one of our mailing lists:
E-mails regarding any stable OpenSIPS release should be sent to
If you want to keep the mail private, send it to
| |
2.4. | How can I report a bug? |
Please follow the guidelines provided at: https://github.com/OpenSIPS/opensips/issues. |
Table 3.1. Top contributors by DevScore(1), authored commits(2) and lines added/removed(3)
| Name | DevScore | Commits | Lines ++ | Lines -- | |
|---|---|---|---|---|---|
| 1. | Bogdan-Andrei Iancu (@bogdan-iancu) | 123 | 71 | 4130 | 1024 |
| 2. | Ovidiu Sas (@ovidiusas) | 35 | 7 | 371 | 1346 |
| 3. | Razvan Crainea (@razvancrainea) | 29 | 22 | 485 | 148 |
| 4. | Liviu Chircu (@liviuchircu) | 23 | 14 | 266 | 297 |
| 5. | Daniel-Constantin Mierla (@miconda) | 15 | 11 | 138 | 88 |
| 6. | Vlad Paiu (@vladpaiu) | 8 | 5 | 243 | 18 |
| 7. | Andreas Heise | 7 | 3 | 105 | 129 |
| 8. | Edson Gellert Schubert | 5 | 1 | 0 | 201 |
| 9. | Elena-Ramona Modroiu | 4 | 2 | 95 | 42 |
| 10. | Henning Westerholt (@henningw) | 4 | 2 | 15 | 15 |
All remaining contributors: Konstantin Bokarius, Dan Pascu (@danpascu), Dusan Klinec (@ph4r05), Jesus Rodrigues, Sergio Gutierrez, Vlad Patrascu (@rvlad-patrascu).
(1) DevScore = author_commits + author_lines_added / (project_lines_added / project_commits) + author_lines_deleted / (project_lines_deleted / project_commits)
(2) including any documentation-related commits, excluding merge commits. Regarding imported patches/code, we do our best to count the work on behalf of the proper owner, as per the "fix_authors" and "mod_renames" arrays in opensips/doc/build-contrib.sh. If you identify any patches/commits which do not get properly attributed to you, please submit a pull request which extends "fix_authors" and/or "mod_renames".
(3) ignoring whitespace edits, renamed files and auto-generated files
Table 3.2. Most recently active contributors(1) to this module
| Name | Commit Activity | |
|---|---|---|
| 1. | Liviu Chircu (@liviuchircu) | Mar 2014 - Sep 2020 |
| 2. | Bogdan-Andrei Iancu (@bogdan-iancu) | Jun 2005 - Jun 2020 |
| 3. | Razvan Crainea (@razvancrainea) | Aug 2010 - Sep 2019 |
| 4. | Vlad Patrascu (@rvlad-patrascu) | May 2017 - May 2017 |
| 5. | Dusan Klinec (@ph4r05) | Dec 2015 - Dec 2015 |
| 6. | Vlad Paiu (@vladpaiu) | Aug 2011 - Sep 2015 |
| 7. | Ovidiu Sas (@ovidiusas) | Mar 2011 - Oct 2013 |
| 8. | Sergio Gutierrez | Nov 2008 - Nov 2008 |
| 9. | Dan Pascu (@danpascu) | Nov 2008 - Nov 2008 |
| 10. | Daniel-Constantin Mierla (@miconda) | Nov 2006 - Mar 2008 |
All remaining contributors: Konstantin Bokarius, Edson Gellert Schubert, Henning Westerholt (@henningw), Jesus Rodrigues, Andreas Heise, Elena-Ramona Modroiu.
(1) including any documentation-related commits, excluding merge commits
Last edited by: Bogdan-Andrei Iancu (@bogdan-iancu), Liviu Chircu (@liviuchircu), Razvan Crainea (@razvancrainea), Ovidiu Sas (@ovidiusas), Daniel-Constantin Mierla (@miconda), Konstantin Bokarius, Edson Gellert Schubert, Jesus Rodrigues, Elena-Ramona Modroiu.
doc copyrights:
Copyright © 2005-2009 Voice Sistem SRL