src/monkeysphere-server

   1 #!/usr/bin/env bash
   2
   3 # monkeysphere-server: MonkeySphere server admin tool
   4 #
   5 # The monkeysphere scripts are written by:
   6 # Jameson Rollins <jrollins@fifthhorseman.net>
   7 # Jamie McClelland <jm@mayfirst.org>
   8 # Daniel Kahn Gillmor <dkg@fifthhorseman.net>
   9 #
  10 # They are Copyright 2008, and are all released under the GPL, version 3
  11 # or later.
  12
  13 ########################################################################
  14 PGRM=$(basename $0)
  15
  16 SHARE=${MONKEYSPHERE_SHARE:="/usr/share/monkeysphere"}
  17 export SHARE
  18 . "${SHARE}/common" || exit 1
  19
  20 VARLIB="/var/lib/monkeysphere"
  21 export VARLIB
  22
  23 # UTC date in ISO 8601 format if needed
  24 DATE=$(date -u '+%FT%T')
  25
  26 # unset some environment variables that could screw things up
  27 unset GREP_OPTIONS
  28
  29 # default return code
  30 RETURN=0
  31
  32 ########################################################################
  33 # FUNCTIONS
  34 ########################################################################
  35
  36 usage() {
  37     cat <<EOF >&2
  38 usage: $PGRM <subcommand> [options] [args]
  39 MonkeySphere server admin tool.
  40
  41 subcommands:
  42  update-users (u) [USER]...          update user authorized_keys files
  43
  44  gen-key (g) [NAME[:PORT]]           generate gpg key for the server
  45    --length (-l) BITS                  key length in bits (2048)
  46    --expire (-e) EXPIRE                date to expire
  47    --revoker (-r) FINGERPRINT          add a revoker
  48  extend-key (e) EXPIRE               extend expiration to EXPIRE
  49  add-hostname (n+) NAME[:PORT]       add hostname user ID to server key
  50  revoke-hostname (n-) NAME[:PORT]    revoke hostname user ID
  51  show-key (s)                        output all server host key information
  52  publish-key (p)                     publish server host key to keyserver
  53  diagnostics (d)                     report on server monkeysphere status
  54
  55  add-id-certifier (c+) KEYID         import and tsign a certification key
  56    --domain (-n) DOMAIN                limit ID certifications to DOMAIN
  57    --trust (-t) TRUST                  trust level of certifier (full)
  58    --depth (-d) DEPTH                  trust depth for certifier (1)
  59  remove-id-certifier (c-) KEYID      remove a certification key
  60  list-id-certifiers (c)              list certification keys
  61
  62  gpg-authentication-cmd CMD          gnupg-authentication command
  63
  64  help (h,?)                          this help
  65
  66 EOF
  67 }
  68
  69 su_monkeysphere_user() {
  70     su "$MONKEYSPHERE_USER" -c "$@"
  71 }
  72
  73 # function to interact with the host gnupg keyring
  74 gpg_host() {
  75     local returnCode
  76
  77     GNUPGHOME="$GNUPGHOME_HOST"
  78     export GNUPGHOME
  79
  80     # NOTE: we supress this warning because we need the monkeysphere
  81     # user to be able to read the host pubring.  we realize this might
  82     # be problematic, but it's the simplest solution, without too much
  83     # loss of security.
  84     gpg --no-permission-warning "$@"
  85     returnCode="$?"
  86
  87     # always reset the permissions on the host pubring so that the
  88     # monkeysphere user can read the trust signatures
  89     chgrp "$MONKEYSPHERE_USER" "${GNUPGHOME_HOST}/pubring.gpg"
  90     chmod g+r "${GNUPGHOME_HOST}/pubring.gpg"
  91
  92     return "$returnCode"
  93 }
  94
  95 # function to interact with the authentication gnupg keyring
  96 # FIXME: this function requires basically accepts only a single
  97 # argument because of problems with quote expansion.  this needs to be
  98 # fixed/improved.
  99 gpg_authentication() {
 100     GNUPGHOME="$GNUPGHOME_AUTHENTICATION"
 101     export GNUPGHOME
 102
 103     su_monkeysphere_user "gpg $@"
 104 }
 105
 106 # output just key fingerprint
 107 fingerprint_server_key() {
 108     gpg_host --list-secret-keys --fingerprint \
 109         --with-colons --fixed-list-mode 2> /dev/null | \
 110         grep '^fpr:' | head -1 | cut -d: -f10
 111 }
 112
 113 # output key information
 114 show_server_key() {
 115     local fingerprint
 116     local tmpkey
 117
 118     fingerprint=$(fingerprint_server_key)
 119     gpg_authentication "--fingerprint --list-key --list-options show-unusable-uids $fingerprint"
 120
 121     # dumping to a file named ' ' so that the ssh-keygen output
 122     # doesn't claim any potentially bogus hostname(s):
 123     tmpkey=$(mktemp -d ${TMPDIR:-/tmp}/tmp.XXXXXXXXXX)
 124     gpg_authentication "--export $fingerprint" | openpgp2ssh "$fingerprint" 2>/dev/null > "$tmpkey/ "
 125     echo -n "ssh fingerprint: "
 126     (cd "$tmpkey" && ssh-keygen -l -f ' ' | awk '{ print $2 }')
 127     rm -rf "$tmpkey"
 128     echo -n "OpenPGP fingerprint: "
 129     echo "$fingerprint"
 130 }
 131
 132 # update authorized_keys for users
 133 update_users() {
 134     if [ "$1" ] ; then
 135         # get users from command line
 136         unames="$@"
 137     else
 138         # or just look at all users if none specified
 139         unames=$(getent passwd | cut -d: -f1)
 140     fi
 141
 142     # set mode
 143     MODE="authorized_keys"
 144
 145     # set gnupg home
 146     GNUPGHOME="$GNUPGHOME_AUTHENTICATION"
 147
 148     # check to see if the gpg trust database has been initialized
 149     if [ ! -s "${GNUPGHOME}/trustdb.gpg" ] ; then
 150         failure "GNUPG trust database uninitialized.  Please see MONKEYSPHERE-SERVER(8)."
 151     fi
 152
 153     # make sure the authorized_keys directory exists
 154     mkdir -p "${VARLIB}/authorized_keys"
 155
 156     # loop over users
 157     for uname in $unames ; do
 158         # check all specified users exist
 159         if ! getent passwd "$uname" >/dev/null ; then
 160             log error "----- unknown user '$uname' -----"
 161             continue
 162         fi
 163
 164         # set authorized_user_ids and raw authorized_keys variables,
 165         # translating ssh-style path variables
 166         authorizedUserIDs=$(translate_ssh_variables "$uname" "$AUTHORIZED_USER_IDS")
 167         rawAuthorizedKeys=$(translate_ssh_variables "$uname" "$RAW_AUTHORIZED_KEYS")
 168
 169         # if neither is found, skip user
 170         if [ ! -s "$authorizedUserIDs" ] ; then
 171             if [ "$rawAuthorizedKeys" = '-' -o ! -s "$rawAuthorizedKeys" ] ; then
 172                 continue
 173             fi
 174         fi
 175
 176         log verbose "----- user: $uname -----"
 177
 178         # exit if the authorized_user_ids file is empty
 179         if ! check_key_file_permissions "$uname" "$AUTHORIZED_USER_IDS" ; then
 180             log error "Improper permissions on path '$AUTHORIZED_USER_IDS'."
 181             continue
 182         fi
 183
 184         # check permissions on the authorized_keys file path
 185         if ! check_key_file_permissions "$uname" "$RAW_AUTHORIZED_KEYS" ; then
 186             log error "Improper permissions on path '$RAW_AUTHORIZED_KEYS'."
 187             continue
 188         fi
 189
 190         # make temporary directory
 191         TMPLOC=$(mktemp -d ${TMPDIR:-/tmp}/tmp.XXXXXXXXXX)
 192
 193         # trap to delete temporary directory on exit
 194         trap "rm -rf $TMPLOC" EXIT
 195
 196         # create temporary authorized_user_ids file
 197         TMP_AUTHORIZED_USER_IDS="${TMPLOC}/authorized_user_ids"
 198         touch "$TMP_AUTHORIZED_USER_IDS"
 199
 200         # create temporary authorized_keys file
 201         AUTHORIZED_KEYS="${TMPLOC}/authorized_keys"
 202         touch "$AUTHORIZED_KEYS"
 203
 204         # set restrictive permissions on the temporary files
 205         # FIXME: is there a better way to do this?
 206         chmod 0700 "$TMPLOC"
 207         chmod 0600 "$AUTHORIZED_KEYS"
 208         chmod 0600 "$TMP_AUTHORIZED_USER_IDS"
 209         chown -R "$MONKEYSPHERE_USER" "$TMPLOC"
 210
 211         # if the authorized_user_ids file exists...
 212         if [ -s "$authorizedUserIDs" ] ; then
 213             # copy user authorized_user_ids file to temporary
 214             # location
 215             cat "$authorizedUserIDs" > "$TMP_AUTHORIZED_USER_IDS"
 216
 217             # export needed variables
 218             export AUTHORIZED_KEYS
 219             export TMP_AUTHORIZED_USER_IDS
 220
 221             # process authorized_user_ids file, as monkeysphere
 222             # user
 223             su_monkeysphere_user \
 224                 ". ${SHARE}/common; process_authorized_user_ids $TMP_AUTHORIZED_USER_IDS"
 225             RETURN="$?"
 226         fi
 227
 228         # add user-controlled authorized_keys file path if specified
 229         if [ "$rawAuthorizedKeys" != '-' -a -s "$rawAuthorizedKeys" ] ; then
 230             log verbose "adding raw authorized_keys file... "
 231             cat "$rawAuthorizedKeys" >> "$AUTHORIZED_KEYS"
 232         fi
 233
 234         # openssh appears to check the contents of the
 235         # authorized_keys file as the user in question, so the
 236         # file must be readable by that user at least.
 237         # FIXME: is there a better way to do this?
 238         chown root "$AUTHORIZED_KEYS"
 239         chgrp $(getent passwd "$uname" | cut -f4 -d:) "$AUTHORIZED_KEYS"
 240         chmod g+r "$AUTHORIZED_KEYS"
 241
 242         # move the resulting authorized_keys file into place
 243         mv -f "$AUTHORIZED_KEYS" "${VARLIB}/authorized_keys/${uname}"
 244
 245         # destroy temporary directory
 246         rm -rf "$TMPLOC"
 247     done
 248 }
 249
 250 # generate server gpg key
 251 gen_key() {
 252     local keyType
 253     local keyLength
 254     local keyUsage
 255     local keyExpire
 256     local revoker
 257     local hostName
 258     local userID
 259     local keyParameters
 260     local fingerprint
 261
 262     # set default key parameter values
 263     keyType="RSA"
 264     keyLength="2048"
 265     keyUsage="auth"
 266     keyExpire=
 267     revoker=
 268
 269     # get options
 270     TEMP=$(PATH="/usr/local/bin:$PATH" getopt -o e:l:r -l expire:,length:,revoker: -n "$PGRM" -- "$@") || failure "getopt failed!  Does your getopt support GNU-style long options?"
 271
 272     if [ $? != 0 ] ; then
 273         exit 1
 274     fi
 275
 276     # Note the quotes around `$TEMP': they are essential!
 277     eval set -- "$TEMP"
 278
 279     while true ; do
 280         case "$1" in
 281             -l|--length)
 282                 keyLength="$2"
 283                 shift 2
 284                 ;;
 285             -e|--expire)
 286                 keyExpire="$2"
 287                 shift 2
 288                 ;;
 289             -r|--revoker)
 290                 revoker="$2"
 291                 shift 2
 292                 ;;
 293             --)
 294                 shift
 295                 ;;
 296             *)
 297                 break
 298                 ;;
 299         esac
 300     done
 301
 302     hostName=${1:-$(hostname -f)}
 303     userID="ssh://${hostName}"
 304
 305     # check for presense of key with user ID
 306     if gpg_host --list-key ="$userID" > /dev/null 2>&1 ; then
 307         failure "Key for '$userID' already exists"
 308     fi
 309
 310     # prompt about key expiration if not specified
 311     keyExpire=$(get_gpg_expiration "$keyExpire")
 312
 313     # set key parameters
 314     keyParameters=$(cat <<EOF
 315 Key-Type: $keyType
 316 Key-Length: $keyLength
 317 Key-Usage: $keyUsage
 318 Name-Real: $userID
 319 Expire-Date: $keyExpire
 320 EOF
 321 )
 322
 323     # add the revoker field if specified
 324     # FIXME: the "1:" below assumes that $REVOKER's key is an RSA key.
 325     # FIXME: key is marked "sensitive"?  is this appropriate?
 326     if [ "$revoker" ] ; then
 327         keyParameters="${keyParameters}"$(cat <<EOF
 328 Revoker: 1:$revoker sensitive
 329 EOF
 330 )
 331     fi
 332
 333     echo "The following key parameters will be used for the host private key:"
 334     echo "$keyParameters"
 335
 336     read -p "Generate key? (Y/n) " OK; OK=${OK:=Y}
 337     if [ ${OK/y/Y} != 'Y' ] ; then
 338         failure "aborting."
 339     fi
 340
 341     # add commit command
 342     keyParameters="${keyParameters}"$(cat <<EOF
 343
 344 %commit
 345 %echo done
 346 EOF
 347 )
 348
 349     log verbose "generating server key..."
 350     echo "$keyParameters" | gpg_host --batch --gen-key
 351
 352     # output the server fingerprint
 353     fingerprint_server_key "=${userID}"
 354
 355     # find the key fingerprint of the newly generated key
 356     fingerprint=$(fingerprint_server_key)
 357
 358     # export host ownertrust to authentication keyring
 359     log verbose "setting ultimate owner trust for server key..."
 360     echo "${fingerprint}:6:" | gpg_authentication "--import-ownertrust"
 361
 362     # translate the private key to ssh format, and export to a file
 363     # for sshs usage.
 364     # NOTE: assumes that the primary key is the proper key to use
 365     (umask 077 && \
 366         gpg_host --export-secret-key "$fingerprint" | \
 367         openpgp2ssh "$fingerprint" > "${VARLIB}/ssh_host_rsa_key")
 368     log info "Private SSH host key output to file: ${VARLIB}/ssh_host_rsa_key"
 369 }
 370
 371 # extend the lifetime of a host key:
 372 extend_key() {
 373     local fpr=$(fingerprint_server_key)
 374     local extendTo="$1"
 375
 376     if [ -z "$fpr" ] ; then
 377         failure "You don't appear to have a MonkeySphere host key on this server.  Try 'monkeysphere-server gen-key' first."
 378     fi
 379
 380     # get the new expiration date
 381     extendTo=$(get_gpg_expiration "$extendTo")
 382
 383     gpg_host --quiet --command-fd 0 --edit-key "$fpr" <<EOF
 384 expire
 385 $extendTo
 386 save
 387 EOF
 388
 389     echo
 390     echo "NOTE: Host key expiration date adjusted, but not yet published."
 391     echo "Run '$PGRM publish-key' to publish the new expiration date."
 392 }
 393
 394 # add hostname user ID to server key
 395 add_hostname() {
 396     local userID
 397     local fingerprint
 398     local tmpuidMatch
 399     local line
 400     local adduidCommand
 401
 402     if [ -z "$1" ] ; then
 403         failure "You must specify a hostname to add."
 404     fi
 405
 406     userID="ssh://${1}"
 407
 408     fingerprint=$(fingerprint_server_key)
 409
 410     # match to only ultimately trusted user IDs
 411     tmpuidMatch="u:$(echo $userID | gpg_escape)"
 412
 413     # find the index of the requsted user ID
 414     # NOTE: this is based on circumstantial evidence that the order of
 415     # this output is the appropriate index
 416     if line=$(gpg_host --list-keys --with-colons --fixed-list-mode "0x${fingerprint}!" \
 417         | egrep '^(uid|uat):' | cut -f2,10 -d: | grep -n -x -F "$tmpuidMatch") ; then
 418         failure "Host userID '$userID' already exists."
 419     fi
 420
 421     echo "The following user ID will be added to the host key:"
 422     echo "  $userID"
 423     read -p "Are you sure you would like to add this user ID? (y/N) " OK; OK=${OK:=N}
 424     if [ ${OK/y/Y} != 'Y' ] ; then
 425         failure "User ID not added."
 426     fi
 427
 428     # edit-key script command to add user ID
 429     adduidCommand=$(cat <<EOF
 430 adduid
 431 $userID
 432
 433
 434 save
 435 EOF
 436         )
 437
 438     # execute edit-key script
 439     if echo "$adduidCommand" | \
 440         gpg_host --quiet --command-fd 0 --edit-key "0x${fingerprint}!" ; then
 441
 442         # update the trustdb for the authentication keyring
 443         gpg_authentication "--check-trustdb"
 444
 445         show_server_key
 446
 447         echo
 448         echo "NOTE: User ID added to key, but key not published."
 449         echo "Run '$PGRM publish-key' to publish the new user ID."
 450     else
 451         failure "Problem adding user ID."
 452     fi
 453 }
 454
 455 # revoke hostname user ID to server key
 456 revoke_hostname() {
 457     local userID
 458     local fingerprint
 459     local tmpuidMatch
 460     local line
 461     local uidIndex
 462     local message
 463     local revuidCommand
 464
 465     if [ -z "$1" ] ; then
 466         failure "You must specify a hostname to revoke."
 467     fi
 468
 469     echo "WARNING: There is a known bug in this function."
 470     echo "This function has been known to occasionally revoke the wrong user ID."
 471     echo "Please see the following bug report for more information:"
 472     echo "http://web.monkeysphere.info/bugs/revoke-hostname-revoking-wrong-userid/"
 473     read -p "Are you sure you would like to proceed? (y/N) " OK; OK=${OK:=N}
 474     if [ ${OK/y/Y} != 'Y' ] ; then
 475         failure "aborting."
 476     fi
 477
 478     userID="ssh://${1}"
 479
 480     fingerprint=$(fingerprint_server_key)
 481
 482     # match to only ultimately trusted user IDs
 483     tmpuidMatch="u:$(echo $userID | gpg_escape)"
 484
 485     # find the index of the requsted user ID
 486     # NOTE: this is based on circumstantial evidence that the order of
 487     # this output is the appropriate index
 488     if line=$(gpg_host --list-keys --with-colons --fixed-list-mode "0x${fingerprint}!" \
 489         | egrep '^(uid|uat):' | cut -f2,10 -d: | grep -n -x -F "$tmpuidMatch") ; then
 490         uidIndex=${line%%:*}
 491     else
 492         failure "No non-revoked user ID '$userID' is found."
 493     fi
 494
 495     echo "The following host key user ID will be revoked:"
 496     echo "  $userID"
 497     read -p "Are you sure you would like to revoke this user ID? (y/N) " OK; OK=${OK:=N}
 498     if [ ${OK/y/Y} != 'Y' ] ; then
 499         failure "User ID not revoked."
 500     fi
 501
 502     message="Hostname removed by monkeysphere-server $DATE"
 503
 504     # edit-key script command to revoke user ID
 505     revuidCommand=$(cat <<EOF
 506 $uidIndex
 507 revuid
 508 y
 509 4
 510 $message
 511
 512 y
 513 save
 514 EOF
 515         )
 516
 517     # execute edit-key script
 518     if echo "$revuidCommand" | \
 519         gpg_host --quiet --command-fd 0 --edit-key "0x${fingerprint}!" ; then
 520
 521         # update the trustdb for the authentication keyring
 522         gpg_authentication "--check-trustdb"
 523
 524         show_server_key
 525
 526         echo
 527         echo "NOTE: User ID revoked, but revocation not published."
 528         echo "Run '$PGRM publish-key' to publish the revocation."
 529     else
 530         failure "Problem revoking user ID."
 531     fi
 532 }
 533
 534 # publish server key to keyserver
 535 publish_server_key() {
 536     read -p "Really publish host key to $KEYSERVER? (y/N) " OK; OK=${OK:=N}
 537     if [ ${OK/y/Y} != 'Y' ] ; then
 538         failure "key not published."
 539     fi
 540
 541     # find the key fingerprint
 542     fingerprint=$(fingerprint_server_key)
 543
 544     # publish host key
 545     gpg_authentication "--keyserver $KEYSERVER --send-keys '0x${fingerprint}!'"
 546 }
 547
 548
 549 diagnostics() {
 550 #  * check on the status and validity of the key and public certificates
 551     local seckey
 552     local keysfound
 553     local curdate
 554     local warnwindow
 555     local warndate
 556     local create
 557     local expire
 558     local uid
 559     local fingerprint
 560     local badhostkeys
 561     local sshd_config
 562     local problemsfound=0
 563
 564     # FIXME: what's the correct, cross-platform answer?
 565     sshd_config=/etc/ssh/sshd_config
 566     seckey=$(gpg_host --list-secret-keys --fingerprint --with-colons --fixed-list-mode)
 567     keysfound=$(echo "$seckey" | grep -c ^sec:)
 568     curdate=$(date +%s)
 569     # warn when anything is 2 months away from expiration
 570     warnwindow='2 months'
 571     warndate=$(advance_date $warnwindow +%s)
 572
 573     if ! id monkeysphere >/dev/null ; then
 574         echo "! No monkeysphere user found!  Please create a monkeysphere system user with bash as its shell."
 575         problemsfound=$(($problemsfound+1))
 576     fi
 577
 578     if ! [ -d "$VARLIB" ] ; then
 579         echo "! no $VARLIB directory found.  Please create it."
 580         problemsfound=$(($problemsfound+1))
 581     fi
 582
 583     echo "Checking host GPG key..."
 584     if (( "$keysfound" < 1 )); then
 585         echo "! No host key found."
 586         echo " - Recommendation: run 'monkeysphere-server gen-key'"
 587         problemsfound=$(($problemsfound+1))
 588     elif (( "$keysfound" > 1 )); then
 589         echo "! More than one host key found?"
 590         # FIXME: recommend a way to resolve this
 591         problemsfound=$(($problemsfound+1))
 592     else
 593         create=$(echo "$seckey" | grep ^sec: | cut -f6 -d:)
 594         expire=$(echo "$seckey" | grep ^sec: | cut -f7 -d:)
 595         fingerprint=$(echo "$seckey" | grep ^fpr: | head -n1 | cut -f10 -d:)
 596         # check for key expiration:
 597         if [ "$expire" ]; then
 598             if (( "$expire"  < "$curdate" )); then
 599                 echo "! Host key is expired."
 600                 echo " - Recommendation: extend lifetime of key with 'monkeysphere-server extend-key'"
 601                 problemsfound=$(($problemsfound+1))
 602             elif (( "$expire" < "$warndate" )); then
 603                 echo "! Host key expires in less than $warnwindow:" $(advance_date $(( $expire - $curdate )) seconds +%F)
 604                 echo " - Recommendation: extend lifetime of key with 'monkeysphere-server extend-key'"
 605                 problemsfound=$(($problemsfound+1))
 606             fi
 607         fi
 608
 609         # and weirdnesses:
 610         if [ "$create" ] && (( "$create" > "$curdate" )); then
 611             echo "! Host key was created in the future(?!). Is your clock correct?"
 612             echo " - Recommendation: Check clock ($(date +%F_%T)); use NTP?"
 613             problemsfound=$(($problemsfound+1))
 614         fi
 615
 616         # check for UserID expiration:
 617         echo "$seckey" | grep ^uid: | cut -d: -f6,7,10 | \
 618         while IFS=: read create expire uid ; do
 619             # FIXME: should we be doing any checking on the form
 620             # of the User ID?  Should we be unmangling it somehow?
 621
 622             if [ "$create" ] && (( "$create" > "$curdate" )); then
 623                 echo "! User ID '$uid' was created in the future(?!).  Is your clock correct?"
 624                 echo " - Recommendation: Check clock ($(date +%F_%T)); use NTP?"
 625                 problemsfound=$(($problemsfound+1))
 626             fi
 627             if [ "$expire" ] ; then
 628                 if (( "$expire" < "$curdate" )); then
 629                     echo "! User ID '$uid' is expired."
 630                     # FIXME: recommend a way to resolve this
 631                     problemsfound=$(($problemsfound+1))
 632                 elif (( "$expire" < "$warndate" )); then
 633                     echo "! User ID '$uid' expires in less than $warnwindow:" $(advance_date $(( $expire - $curdate )) seconds +%F)
 634                     # FIXME: recommend a way to resolve this
 635                     problemsfound=$(($problemsfound+1))
 636                 fi
 637             fi
 638         done
 639
 640 # FIXME: verify that the host key is properly published to the
 641 #   keyservers (do this with the non-privileged user)
 642
 643 # FIXME: check that there are valid, non-expired certifying signatures
 644 #   attached to the host key after fetching from the public keyserver
 645 #   (do this with the non-privileged user as well)
 646
 647 # FIXME: propose adding a revoker to the host key if none exist (do we
 648 #   have a way to do that after key generation?)
 649
 650         # Ensure that the ssh_host_rsa_key file is present and non-empty:
 651         echo
 652         echo "Checking host SSH key..."
 653         if [ ! -s "${VARLIB}/ssh_host_rsa_key" ] ; then
 654             echo "! The host key as prepared for SSH (${VARLIB}/ssh_host_rsa_key) is missing or empty."
 655             problemsfound=$(($problemsfound+1))
 656         else
 657             if [ $(ls -l "${VARLIB}/ssh_host_rsa_key" | cut -f1 -d\ ) != '-rw-------' ] ; then
 658                 echo "! Permissions seem wrong for ${VARLIB}/ssh_host_rsa_key -- should be 0600."
 659                 problemsfound=$(($problemsfound+1))
 660             fi
 661
 662             # propose changes needed for sshd_config (if any)
 663             if ! grep -q "^HostKey[[:space:]]\+${VARLIB}/ssh_host_rsa_key$" "$sshd_config"; then
 664                 echo "! $sshd_config does not point to the monkeysphere host key (${VARLIB}/ssh_host_rsa_key)."
 665                 echo " - Recommendation: add a line to $sshd_config: 'HostKey ${VARLIB}/ssh_host_rsa_key'"
 666                 problemsfound=$(($problemsfound+1))
 667             fi
 668             if badhostkeys=$(grep -i '^HostKey' "$sshd_config" | grep -v "^HostKey[[:space:]]\+${VARLIB}/ssh_host_rsa_key$") ; then
 669                 echo "! $sshd_config refers to some non-monkeysphere host keys:"
 670                 echo "$badhostkeys"
 671                 echo " - Recommendation: remove the above HostKey lines from $sshd_config"
 672                 problemsfound=$(($problemsfound+1))
 673             fi
 674         fi
 675     fi
 676
 677 # FIXME: look at the ownership/privileges of the various keyrings,
 678 #    directories housing them, etc (what should those values be?  can
 679 #    we make them as minimal as possible?)
 680
 681 # FIXME: look to see that the ownertrust rules are set properly on the
 682 #    authentication keyring
 683
 684 # FIXME:  make sure that at least one identity certifier exists
 685
 686 # FIXME: look at the timestamps on the monkeysphere-generated
 687 # authorized_keys files -- warn if they seem out-of-date.
 688
 689     echo
 690     echo "Checking for MonkeySphere-enabled public-key authentication for users ..."
 691     # Ensure that User ID authentication is enabled:
 692     if ! grep -q "^AuthorizedKeysFile[[:space:]]\+${VARLIB}/authorized_keys/%u$" "$sshd_config"; then
 693         echo "! $sshd_config does not point to monkeysphere authorized keys."
 694         echo " - Recommendation: add a line to $sshd_config: 'AuthorizedKeysFile ${VARLIB}/authorized_keys/%u'"
 695         problemsfound=$(($problemsfound+1))
 696     fi
 697     if badauthorizedkeys=$(grep -i '^AuthorizedKeysFile' "$sshd_config" | grep -v "^AuthorizedKeysFile[[:space:]]\+${VARLIB}/authorized_keys/%u$") ; then
 698         echo "! $sshd_config refers to non-monkeysphere authorized_keys files:"
 699         echo "$badauthorizedkeys"
 700         echo " - Recommendation: remove the above AuthorizedKeysFile lines from $sshd_config"
 701         problemsfound=$(($problemsfound+1))
 702     fi
 703
 704     if [ "$problemsfound" -gt 0 ]; then
 705         echo "When the above $problemsfound issue"$(if [ "$problemsfound" -eq 1 ] ; then echo " is" ; else echo "s are" ; fi)" resolved, please re-run:"
 706         echo "  monkeysphere-server diagnostics"
 707     else
 708         echo "Everything seems to be in order!"
 709     fi
 710 }
 711
 712 # retrieve key from web of trust, import it into the host keyring, and
 713 # ltsign the key in the host keyring so that it may certify other keys
 714 add_certifier() {
 715     local domain
 716     local trust
 717     local depth
 718     local keyID
 719     local fingerprint
 720     local ltsignCommand
 721     local trustval
 722
 723     # set default values for trust depth and domain
 724     domain=
 725     trust=full
 726     depth=1
 727
 728     # get options
 729     TEMP=$(PATH="/usr/local/bin:$PATH" getopt -o n:t:d: -l domain:,trust:,depth: -n "$PGRM" -- "$@") || failure "getopt failed!  Does your getopt support GNU-style long options?"
 730
 731     if [ $? != 0 ] ; then
 732         exit 1
 733     fi
 734
 735     # Note the quotes around `$TEMP': they are essential!
 736     eval set -- "$TEMP"
 737
 738     while true ; do
 739         case "$1" in
 740             -n|--domain)
 741                 domain="$2"
 742                 shift 2
 743                 ;;
 744             -t|--trust)
 745                 trust="$2"
 746                 shift 2
 747                 ;;
 748             -d|--depth)
 749                 depth="$2"
 750                 shift 2
 751                 ;;
 752             --)
 753                 shift
 754                 ;;
 755             *)
 756                 break
 757                 ;;
 758         esac
 759     done
 760
 761     keyID="$1"
 762     if [ -z "$keyID" ] ; then
 763         failure "You must specify the key ID of a key to add, or specify a file to read the key from."
 764     fi
 765     if [ -f "$keyID" ] ; then
 766         echo "Reading key from file '$keyID':"
 767         importinfo=$(gpg_authentication "--import" < "$keyID" 2>&1) || failure "could not read key from '$keyID'"
 768         # FIXME: if this is tried when the key database is not
 769         # up-to-date, i got these errors (using set -x):
 770
 771 # ++ su -m monkeysphere -c '\''gpg --import'\''
 772 # Warning: using insecure memory!
 773 # gpg: key D21739E9: public key "Daniel Kahn Gillmor <dkg@fifthhorseman.net>" imported
 774 # gpg: Total number processed: 1
 775 # gpg:               imported: 1  (RSA: 1)
 776 # gpg: can'\''t create `/var/monkeysphere/gnupg-host/pubring.gpg.tmp'\'': Permission denied
 777 # gpg: failed to rebuild keyring cache: Permission denied
 778 # gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model
 779 # gpg: depth: 0  valid:   1  signed:   0  trust: 0-, 0q, 0n, 0m, 0f, 1u
 780 # gpg: next trustdb check due at 2009-01-10'
 781 # + failure 'could not read key from '\''/root/dkg.gpg'\'''
 782 # + echo 'could not read key from '\''/root/dkg.gpg'\'''
 783
 784         keyID=$(echo "$importinfo" | grep '^gpg: key ' | cut -f2 -d: | cut -f3 -d\ )
 785         if [ -z "$keyID" ] || [ $(echo "$keyID" | wc -l) -ne 1 ] ; then
 786             failure "Expected there to be a single gpg key in the file."
 787         fi
 788     else
 789         # get the key from the key server
 790         gpg_authentication "--keyserver $KEYSERVER --recv-key '0x${keyID}!'" || failure "Could not receive a key with this ID from the '$KEYSERVER' keyserver."
 791     fi
 792
 793     export keyID
 794
 795
 796     # get the full fingerprint of a key ID
 797     fingerprint=$(gpg_authentication "--list-key --with-colons --with-fingerprint 0x${keyID}!" | \
 798         grep '^fpr:' | grep "$keyID" | cut -d: -f10)
 799
 800     if [ -z "$fingerprint" ] ; then
 801         failure "Key '$keyID' not found."
 802     fi
 803
 804     echo
 805     echo "key found:"
 806     gpg_authentication "--fingerprint 0x${fingerprint}!"
 807
 808     echo "Are you sure you want to add the above key as a"
 809     read -p "certifier of users on this system? (y/N) " OK; OK=${OK:-N}
 810     if [ "${OK/y/Y}" != 'Y' ] ; then
 811         failure "Identity certifier not added."
 812     fi
 813
 814     # export the key to the host keyring
 815     gpg_authentication "--export 0x${fingerprint}!" | gpg_host --import
 816
 817     if [ "$trust" == marginal ]; then
 818         trustval=1
 819     elif [ "$trust" == full ]; then
 820         trustval=2
 821     else
 822         failure "Trust value requested ('$trust') was unclear (only 'marginal' or 'full' are supported)."
 823     fi
 824
 825     # ltsign command
 826     # NOTE: *all* user IDs will be ltsigned
 827     ltsignCommand=$(cat <<EOF
 828 ltsign
 829 y
 830 $trustval
 831 $depth
 832 $domain
 833 y
 834 save
 835 EOF
 836         )
 837
 838     # ltsign the key
 839     if echo "$ltsignCommand" | \
 840         gpg_host --quiet --command-fd 0 --edit-key "0x${fingerprint}!" ; then
 841
 842         # update the trustdb for the authentication keyring
 843         gpg_authentication "--check-trustdb"
 844
 845         echo
 846         echo "Identity certifier added."
 847     else
 848         failure "Problem adding identify certifier."
 849     fi
 850 }
 851
 852 # delete a certifiers key from the host keyring
 853 remove_certifier() {
 854     local keyID
 855     local fingerprint
 856
 857     keyID="$1"
 858     if [ -z "$keyID" ] ; then
 859         failure "You must specify the key ID of a key to remove."
 860     fi
 861
 862     if gpg_authentication "--no-options --list-options show-uid-validity --keyring ${GNUPGHOME_AUTHENTICATION}/pubring.gpg --list-key 0x${keyID}!" ; then
 863         read -p "Really remove above listed identity certifier? (y/N) " OK; OK=${OK:-N}
 864         if [ "${OK/y/Y}" != 'Y' ] ; then
 865             failure "Identity certifier not removed."
 866         fi
 867     else
 868         failure
 869     fi
 870
 871     # delete the requested key
 872     if gpg_authentication "--delete-key --batch --yes 0x${keyID}!" ; then
 873         # delete key from host keyring as well
 874         gpg_host --delete-key --batch --yes "0x${keyID}!"
 875
 876         # update the trustdb for the authentication keyring
 877         gpg_authentication "--check-trustdb"
 878
 879         echo
 880         echo "Identity certifier removed."
 881     else
 882         failure "Problem removing identity certifier."
 883     fi
 884 }
 885
 886 # list the host certifiers
 887 list_certifiers() {
 888     local keys
 889     local key
 890
 891     # find trusted keys in authentication keychain
 892     keys=$(gpg_authentication "--no-options --list-options show-uid-validity --keyring ${GNUPGHOME_AUTHENTICATION}/pubring.gpg --list-keys --with-colons --fingerprint" | \
 893         grep ^pub: | cut -d: -f2,5 | egrep '^(u|f):' | cut -d: -f2)
 894
 895     # output keys
 896     for key in $keys ; do
 897         gpg_authentication "--no-options --list-options show-uid-validity --keyring ${GNUPGHOME_AUTHENTICATION}/pubring.gpg --list-key --fingerprint $key"
 898     done
 899 }
 900
 901 # issue command to gpg-authentication keyring
 902 gpg_authentication_cmd() {
 903     gpg_authentication "$@"
 904 }
 905
 906 ########################################################################
 907 # MAIN
 908 ########################################################################
 909
 910 # unset variables that should be defined only in config file
 911 unset KEYSERVER
 912 unset AUTHORIZED_USER_IDS
 913 unset RAW_AUTHORIZED_KEYS
 914 unset MONKEYSPHERE_USER
 915
 916 # load configuration file
 917 [ -e ${MONKEYSPHERE_SERVER_CONFIG:="${ETC}/monkeysphere-server.conf"} ] && . "$MONKEYSPHERE_SERVER_CONFIG"
 918
 919 # set empty config variable with ones from the environment, or with
 920 # defaults
 921 LOG_LEVEL=${MONKEYSPHERE_LOG_LEVEL:=${LOG_LEVEL:="INFO"}}
 922 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=${KEYSERVER:="subkeys.pgp.net"}}
 923 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:=${AUTHORIZED_USER_IDS:="%h/.monkeysphere/authorized_user_ids"}}
 924 RAW_AUTHORIZED_KEYS=${MONKEYSPHERE_RAW_AUTHORIZED_KEYS:=${RAW_AUTHORIZED_KEYS:="%h/.ssh/authorized_keys"}}
 925 MONKEYSPHERE_USER=${MONKEYSPHERE_MONKEYSPHERE_USER:=${MONKEYSPHERE_USER:="monkeysphere"}}
 926
 927 # other variables
 928 CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:="true"}
 929 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
 930 GNUPGHOME_HOST=${MONKEYSPHERE_GNUPGHOME_HOST:="${VARLIB}/gnupg-host"}
 931 GNUPGHOME_AUTHENTICATION=${MONKEYSPHERE_GNUPGHOME_AUTHENTICATION:="${VARLIB}/gnupg-authentication"}
 932
 933 # export variables needed in su invocation
 934 export DATE
 935 export MODE
 936 export MONKEYSPHERE_USER
 937 export LOG_LEVEL
 938 export KEYSERVER
 939 export CHECK_KEYSERVER
 940 export REQUIRED_USER_KEY_CAPABILITY
 941 export GNUPGHOME_HOST
 942 export GNUPGHOME_AUTHENTICATION
 943 export GNUPGHOME
 944
 945 # get subcommand
 946 COMMAND="$1"
 947 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
 948 shift
 949
 950 case $COMMAND in
 951     'update-users'|'update-user'|'u')
 952         update_users "$@"
 953         ;;
 954
 955     'gen-key'|'g')
 956         gen_key "$@"
 957         ;;
 958
 959     'extend-key'|'e')
 960         extend_key "$@"
 961         ;;
 962
 963     'add-hostname'|'add-name'|'n+')
 964         add_hostname "$@"
 965         ;;
 966
 967     'revoke-hostname'|'revoke-name'|'n-')
 968         revoke_hostname "$@"
 969         ;;
 970
 971     'show-key'|'show'|'s')
 972         show_server_key
 973         ;;
 974
 975     'publish-key'|'publish'|'p')
 976         publish_server_key
 977         ;;
 978
 979     'diagnostics'|'d')
 980         diagnostics
 981         ;;
 982
 983     'add-identity-certifier'|'add-id-certifier'|'add-certifier'|'c+')
 984         add_certifier "$@"
 985         ;;
 986
 987     'remove-identity-certifier'|'remove-id-certifier'|'remove-certifier'|'c-')
 988         remove_certifier "$@"
 989         ;;
 990
 991     'list-identity-certifiers'|'list-id-certifiers'|'list-certifiers'|'list-certifier'|'c')
 992         list_certifiers "$@"
 993         ;;
 994
 995     'gpg-authentication-cmd')
 996         gpg_authentication_cmd "$@"
 997         ;;
 998
 999     '--help'|'help'|'-h'|'h'|'?')
1000         usage
1001         ;;
1002
1003     *)
1004         failure "Unknown command: '$COMMAND'
1005 Type '$PGRM help' for usage."
1006         ;;
1007 esac
1008
1009 exit "$RETURN"