Home

uac

Keywords: 2.0.x | Module | uac

Stable

UACi (User Agent Client) module provides some basic UAC functionalities like FROM header manipulation (anonymization) or client authentication.


Ramona-Elena Modroiu


1. UACi Module

Ramona-Elena Modroiu

Voice System

Copyright © 2005 Voice Sistem

Revision History
Revision $Revision: 1.3 $ $Date: 2005/08/24 22:26:20 $

1.1. Overview

UAC (User Agent Client) module provides some basic UAC functionalities like FROM header manipulation (anonymization) or client authentication.

Known limitations in this version:

  • authentication does not support qop

1.2. Dependencies

The following modules must be loaded before this module:

  • TM - Transaction Module.

1.3. Installation And Running

The UAC module requires additional functionality in TM module for implementing full FROM restoring. If you use from_restore_mode 1 or 2, you will need to apply the patch replace_from.patch located in the "doc" directory of UAC module.

1.4. Parameters

Revision History
Revision $Revision: 1.2 $ $Date: 2005/08/24 13:24:35 $

1.4.1. from_store_param (string)

Name of FROM header parameter that will be used to store (encoded) the original FROM URIi.

This parameter is optional, it's default value being "vsf".

Example 1. Set from_store_param parameter 

...
modparam("uac","from_store_param","my_param")
...

1.4.2. from_restore_mode (integer)

There are 3 mode of restoring the original FROM URI:

  • 0 - NO RESTORE - no information about original URI is stored.

  • 1 - AUTO RESTORE - all sequential request will be automatically updated based on stored original URI.

  • 2 - MANUAL RESTORE - all sequential requests/replies must be manually updated based on original URI.

This parameter is optional, it's default value being 0.

Example 2. Set from_restore_mode parameter 

...
modparam("uac","from_restore_mode","1")
...

1.4.3. credential (string)

Contains a multiple definition of credentials used to perform authentication.

This parameter is required if UAC authentication is used.

Example 3. Set credential parameter 

...
modparam("uac","credential","username:domain:password")
...

1.5. Functions

Revision History
Revision $Revision: 1.2.6.1 $ $Date: 2008/06/12 15:37:36 $

1.5.1. uac_replace_from(display,uri)

Replace in FROM header the display name and the URI part.

Example 4. uac_replace_from usage 

...
uac_replace_from("batman","sip:batman@gotham.org");
uac_replace_from("","sip:robin@gotham.org");
uac_replace_from("batman","");
...

1.5.2. uac_replace_from(uri)

Replace in FROM header the URI part without altering the display name.

Example 5. uac_replace_from usage 

...
uac_replace_from("sip:batman@gotham.org");
...

1.5.3. uac_restore_from()

This function will check if the FROM URI was modified and will use the information stored in header parameter to restore the original FROM URI value.

Example 6. uac_restore_from usage 

...
uac_restore_from();
...

1.5.4. uac_auth()

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.

Example 7. uac_auth usage 

...
uac_auth();
...
» login or register to post comments | printer friendly version

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
Subject: Voicemail Features
From: ArunSuresh
Date: 21 July, 2007 - 07:44

Voicemail Features Addition

 

Hello Team,

We have a conceptual idea of adding voicemail feature inSER without using SEMSi, using t_newtrans(), t_reply_with_body functionalties of TM modules, and forkingi another process for RTPi polling and child process would  post the failure route requests to RTP process using unix domain socket. Please let us know the feasibilities of this idea

» login or register to post comments
Subject: Hi ArunThis is feasible.I
From: santoshchintalwar
Date: 23 July, 2007 - 06:28

Hi Arun

This is feasible.

I did the same thing and its working fine.

Hear I wrote one module called play_vm.

Used these functions  and found working .

» login or register to post comments
Home |  Recent changes |  Search |  Glossary |  Sitemap |  Login