openSIPS | Resources / DocsTipsFaqs

Resources -> Documentation -> Tips and FAQa

Table of Content (hide)

1. Tips
2. FAQS
1. 2.1 Changing FROM header
2. 2.2 Recalculating HA1 and HA1B hashes when adding a subscriber

1. Tips

How to do certain things.

1.1 How to recalculate ha1 and ha1b

When you change the domain column in the subscriber table, you have to recalculate ha1 and ha1b fields. In order to do that you must have the password of each subscriber. It is stored in the 'password' column if you have set STORE_PLAINTEXT_PW=1 in opensipsctlrc (default).

HA1 is a MD5 hash of "username:domain:password". For example, if you have created a SIP account 1000@mydomain.com using password 123456, then HA1 is the MD5 hash of "1000:mydomain.com:123456" (without quotes). On the other hand HA1B is the MD5 hash of "username@domain:domain:password"; so using the same example above, HA1B would be the MD5 hash of "1000@mydomain.com:mydomain.com:123456" (without quotes).

To recalculate and update ha1 and ha1b columns in the subscriber table, just execute the following sql statement in mysql:

update subscriber
set ha1 = md5(concat(username, ':', domain, ':', password)),
ha1b = md5(concat(username, '@', domain, ':', domain, ':', password))

Note: the above is only true if you have "use_domain" enabled for auth_db _and_ you do not use a static challenge parameter for www_authorize.

If you use a static challenge for www_authorize (i.e. the first parameter of www_authorize is not the empty string), then HA1 is MD5("username:challenge:password") and HA1B is MD5("username@challenge:challenge:password"). If the challenge parameter of www_authorize is empty, OpenSIPS automatically selects the domain as the challenge value, which gives the solution presented above.

If "use_domain" is false, then the HA1B field must be computed based on "username@:domain:password" or "username@:challenge:password", depending on whether challenge is empty or defined, respectively.

1.2 PHP example to communicate via mi_xmlrpc

#!/usr/bin/php
<?php
$params[] = "dialog:";
$params[] = "tm:";
$method = "get_statistics";
$request = xmlrpc_encode_request($method,$params);

$context = stream_context_create(array('http' => array(
   'method' => "POST",
   'header' => "Content-Type: text/xml",
   'content' => $request
)));
$file = file_get_contents("http://example.opensips.org:8080/RPC2", false, $context);
$response = xmlrpc_decode($file);
if (is_array($response)) {
   trigger_error("xmlrpc: $response[faultString] ($response[faultCode])");
} else {
   print_r($response);
}
?>

1.3 Add a new tip here

2. FAQS

Answers to the most frequent questions

2.1 Changing FROM header

Q) How does one change the FROM Header in OpenSIPS ?

A) Use the uac_replace_from() function in the uac module

2.2 Recalculating HA1 and HA1B hashes when adding a subscriber

Q) How do I re-calculate the ha1 and halb values in the subscriber table for a new subscriber?

A) Run the following mysql operation:

update subscriber set ha1 = md5(concat(username, ':', domain, ':', password)), ha1b = md5(concat(username, '@', domain, ':', domain, ':', password))

This will automatically update the ha1 and ha1b fields for all subscribers.

Resources -> Documentation -> Tips and FAQa

1. Tips

1.1 How to recalculate ha1 and ha1b

1.2 PHP example to communicate via mi_xmlrpc

1.3 Add a new tip here

2. FAQS

2.1 Changing FROM header

2.2 Recalculating HA1 and HA1B hashes when adding a subscriber

OpenSIPS Getting Started

OpenSIPS Devel Course

OpenSIPS 1.8.0

Dynamic Routing

APT repository

OpenSIPS 1.7.2

SIP Validation Support

DNS Caching Support

Distributed Dialog Profiles

Configuration and Scripting Tool

Cassandra driver

LUA integration

OpenSIPS Pavilion @ ITExpo 2012

OpenSIPS and HOMER

OpenSIPS eBootcamp

OpenSIPS 1.7.1

Ratelimit

OpenSIPS VM 1.7.0

MI via HTTP

Events via RabbitMQ

Key-Value Cache/DBs

GRUU support

OpenSIPS 1.8.0 preview

OpenSIPS eBootcamp

OpenSIPS 1.7.0

ClueCon 2011

New in 1.7.0

SVN Freeze

Topology Hiding

New AVP naming

DB Optimization

Event Notification Interface

OpenSIPS eBootcamp

UAC_REGISTRANT module

Performance degradation with complexity

Load and performance monitoring

OpenSIPS 2.0

OpenSIPS Online Meeting

OpenSIPS Social Event

OpenSIPS eBootcamp

OpenSIPS 1.6.4

OpenSIPS media timeout