Goal (short description)

Goal is to server multiple sip domains in one instance of OpenSer or Ser

Applicability

Consider if you want to serve more domain on one server. Don't mess it with aliasing.
Alias: jan@software.cesnet.cz and jan@hardware.cesnet.cz lead to one identity
Multidomain: jan@software.cesnet.cz and jan@hardware.cesnet.cz can lead to diferent identity.
It also used for completely different domains like sipdomainA adn sipdomainB in one server.

Prerequisites (OS, dependencies on other software)

installed OpenSER or SER (tested with 0.9.x)

Configuration (OS agnostic)

configuration file changes

Load the domain module

loadmodule "/usr/local/lib/ser/modules/domain.so"

Set modules
Set all modules that you use and that have use_domain parameter to 1 i.e.:
modparam("usrloc|registrar|auth_db|avpops|group", "use_domain", 1)

Find all uri==myself tests and change them to (is_uri_host_local() || uri==myself) or
just is_uri_host_local(). It depends whether you want to accept uri with server name, server name aliases or server IPs in domain part in particular test.

Find all from_uri==myself tests and change them to is_from_local(). This function checks from domain part against domain table

Remove domain name from authentication challenge. Server challenges several domains so the client is responsible to chose the right one.

    if (!proxy_authorize("", "subscriber")) {
            proxy_challenge("", "0");
            break;
    };


    if (!www_authorize("", "subscriber")) {
            www_challenge("", "0");
            break;
    };

Domain manipulation

serctl domain add domainname adds a new domain
serctl domain rm domainname removes domain

Be careful if you set SIP_DOMAIN, rather delete it to avoid confusion. If you forget to use domain part when you manipulate with users SIP_DOMAIN is used. If it is not set you will warned.

OS specific help

Validation, confirmation tests

Set user accounts in different domains, register clients and try to call them.