NAME
sipdigest - compute digest for user's secret in specific sip realm
SYNOPSIS
sipdigest [-realm="string"] [-md5|-sha1|-rmd160] USER SECRET
DESCRIPTION
This is a tool to compute secret digest values for a USER account which
has a SECRET (password) so that the digest can then be safely placed in
the sipwitch XML config files so that the password is not exposed in a
potentially readable file. SIP digests are computed using the
authentication realm of the sip server for a given USER id and SECRET
(password). Hence, it is desirable to set the realm once, because
changing it will also require changing all the user hashes.
By default, sipdigest uses the current sip authentication realm and
algorithm as set by the siprealm command, though alternate realms and
hashing algorithms may also be specified. Since sipdigest can compute
an arbitrary digest it can be useful to build database entries or
config files where secret hashes must be stored.
OPTIONS
-md5 Select md5 digest algorithm.
-realm=STRING
Compute digest based on the STRING realm passed instead of
current server's realm.
-rmd160
Select rmd160 digest algorithm.
-sha1 Select sha1 digest algorithm.
-rmd160
EXIT STATUS
Any error in argument format will return an exit status of 3. The
command will normally return with exit status of 0 after printing the
requested digest.
AUTHOR
sipdigest was written by David Sugar <dyfet@gnutelephony.org>.
REPORTING BUGS
Report bugs to sipwitch-devel@gnu.org.
COPYRIGHT
Copyright (C) 2009 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.