1siprealm(1)                      GNU Telephony                     siprealm(1)
2
3
4

NAME

6       siprealm - show or set authentication realm of sipwitch services
7

SYNOPSIS

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

DESCRIPTION

12       Siprealm  is  used  to either set or display the current authentication
13       realm of sipwitch services.  This is used to authenticate sip  clients.
14       If  you are aggegating a group of sipwitch servers from multiple hosts,
15       they should all share the same realm.  If you are running NIS  services
16       then  it  is a reasonable practice to set the realm of your machines to
17       match your NIS domain.  If you are using a stand-alone  sipwitch,  such
18       as  for  an  independent  desktop  workstation, you might want to use a
19       uuid.
20
21       When a proper domain is used as the realm, then sipwitch behaves as  if
22       the  old  stack  domain  property  is  also set.  Realms that look like
23       proper domain names are required to perform internode networking, since
24       the  identity  presented  between  nodes  must  be common (based on the
25       domain) and the authentication realm must  also  match  each  node  for
26       digests  to work between nodes.  Hence, it became much simpler and more
27       consistent to combine authentication realms and identity domains.
28
29       Only the root user can set the sipwitch  domain  or  hash  type.   When
30       either is changed, any sipwitch digest entries cached are automatically
31       cleared.  This means that  if  you  have  sipwitch  setup  to  generate
32       digests  based  on user passwords set through "pam", then you will have
33       to reset or update each user's password if you change the  realm.   For
34       this reason, it's generally advised to set it only once.
35

OPTIONS

37       -md5   Use md5 digest algorithm (default).
38
39       -rmd160
40              Use rmd160 digest algorithm.
41
42       -sha1  Use sha1 digest algorithm.
43

EXIT STATUS

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

AUTHOR

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

REPORTING BUGS

54       Report bugs to sipwitch-devel@gnu.org.
55

57       Copyright © 2010 David Sugar, Tycho Softworks.
58       This is free software; see the source for copying conditions.  There is
59       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
60       PURPOSE.
61
62
63
64
65GNU SIP Witch                    January 2010                      siprealm(1)
Impressum