siprealm

Langue: en

Version: January 2010 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

siprealm - show or set authentication realm of sipwitch services

SYNOPSIS

siprealm [ [-md5|-sha1|-rmd160] ''realm'']

DESCRIPTION

Siprealm is used to either set or display the current authentication realm of sipwitch services. This is used to authenticate sip clients. If you are aggegating a group of sipwitch servers from multiple hosts, they should all share the same realm. If you are running NIS services then it is a reasonable practice to set the realm of your machines to match your NIS domain. If you are using a stand-alone sipwitch, such as for an independent desktop workstation, you might want to use a uuid.

When a proper domain is used as the realm, then sipwitch behaves as if the old stack domain property is also set. Realms that look like proper domain names are required to perform internode networking, since the identity presented between nodes must be common (based on the domain) and the authentication realm must also match each node for digests to work between nodes. Hence, it became much simpler and more consistent to combine authentication realms and identity domains.

Only the root user can set the sipwitch domain or hash type. When either is changed, any sipwitch digest entries cached are automatically cleared. This means that if you have sipwitch setup to generate digests based on user passwords set through "pam", then you will have to reset or update each user's password if you change the realm. For this reason, it's generally advised to set it only once.

OPTIONS

-md5
Use md5 digest algorithm (default).
-rmd160
Use rmd160 digest algorithm.
-sha1
Use sha1 digest algorithm.

EXIT STATUS

Any error in argument format will return an exit status of 3. If no realm is set and used to print the current realm, then an exist status of 1 will be returned. The command will normally return with exit status of 0 after printing the curret (or new) sip realm.

AUTHOR

siprealm was written by David Sugar <dyfet@gnutelephony.org>.

REPORTING BUGS

Report bugs to sipwitch-devel@gnu.org. Copyright © 2010 David Sugar, Tycho Softworks.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.