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
Copyright (C) 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.