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

NAME

6       sipdigest - compute digest for user's secret in specific sip realm
7

SYNOPSIS

9       sipdigest [-realm="string"] [-md5|-sha1|-rmd160] USER SECRET
10

DESCRIPTION

12       This is a tool to compute secret digest values for a USER account which
13       has a SECRET (password) so that the digest can then be safely placed in
14       the  sipwitch XML config files so that the password is not exposed in a
15       potentially readable file.  SIP digests are computed using the  authen‐
16       tication  realm of the sip server for a given USER id and SECRET (pass‐
17       word).  Hence, it is desirable to set the realm once, because  changing
18       it will also require changing all the user hashes.
19
20       By  default,  sipdigest  uses  the current sip authentication realm and
21       algorithm as set by the siprealm command, though alternate  realms  and
22       hashing  algorithms may also be specified.  Since sipdigest can compute
23       an arbitrary digest it can be useful to build database entries or  con‐
24       fig files where secret hashes must be stored.
25

OPTIONS

27       -md5   Select md5 digest algorithm.
28
29       -realm=STRING
30              Compute  digest based on the STRING realm passed instead of cur‐
31              rent server's realm.
32
33       -rmd160
34              Select rmd160 digest algorithm.
35
36       -sha1  Select sha1 digest algorithm.
37
38       -rmd160
39

EXIT STATUS

41       Any error in argument format will return an exit status of 3.  The com‐
42       mand  will  normally  return  with  exit status of 0 after printing the
43       requested digest.
44

AUTHOR

46       sipdigest was written by David Sugar <dyfet@gnutelephony.org>.
47

REPORTING BUGS

49       Report bugs to sipwitch-devel@gnu.org.
50

52       Copyright © 2009 David Sugar, Tycho Softworks.
53       This is free software; see the source for copying conditions.  There is
54       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
55       PURPOSE.
56
57
58
59
60GNU SIP Witch                    December 2009                    sipdigest(1)
Impressum